So funktioniert die Konfiguration
docs/ai/config.md ist die Datei, die steuert, wie am Projekt gearbeitet wird. Sie besteht aus Markdown-Tabellen, ein Abschnitt pro Thema. init trägt die Werte ein, die es erfragt oder erkannt hat; du änderst sie jederzeit. Nichts braucht einen Neuaufbau: Der Hook beim Sitzungsstart liest die Datei und meldet, was sich seit dem letzten Abgleich geändert hat. Jeder Schlüssel mit seinen erlaubten Werten steht in der Konfigurationsreferenz; diese Seite erklärt, wofür die Gruppen da sind. /act-config zeigt und setzt diese Werte ohne Modellrunde, siehe Die Datei ändern.
Gruppen
Abschnitt betitelt „Gruppen“- Project: Name, Owner,
language-chatundlanguage-docs,stack, diecommandsfür Lint/Typecheck/Test (wahlweise ein vierter für die ganze oder die E2E-Suite, vor einem Push), dietools, die du nutzt, und dermode(solooderteam, siehe Inbox, Aufgaben und Journal).language-chatist die Sprache, in der der Assistent mit dir spricht (autofolgt deinen Nachrichten);language-docsist die Sprache von allem, was er unterdocs/schreibt..act/bleibt in beiden Fällen Englisch. Ein Befehl mit(not set)überspringt die zugehörige Prüfung vor einem Commit.runist der Befehl, der die Anwendung startet;(not set)heißt, dass keiner hinterlegt ist. - Scope:
profile(minimal,standardoderfull; ein fehlender Schlüssel gilt alsfull;initschreibtfullfür ein Web-Projekt undstandardfür jedes andere,--scopeentscheidet anders,updateändert es nie) undexclude(noneoder eine kommagetrennte Liste) beschneiden das Template je Projekt:standardlässt die Web-, Design- und Teaching-Skills weg,minimalbehält nur die Kern-Skills und -Rollen (act-packagesgehört dazu), undexcludenennt zusätzlich einzelne Skills, Rollen, Regeldateien wieorchestrator/30-cost.mdoder Topics. Der Sitzungsstart entfernt die Kopien des Weggelassenen, stellt die Import-Zeile einer ausgeschlossenen Regeldatei indocs/ai/rules.mdauf einen bloßen Pfad um (Claude Code lädt sie dann nicht mehr) und sagt das in einer Zeile; eine Änderung gilt ab der nächsten Sitzung.shared/10-safety.mdlässt sich nicht ausschließen, und die Prüfungen bleiben in jedem Fall aktiv. Zum Zurücknehmenprofileauffullundexcludeaufnonesetzen.methods(Standardnone, sonst eine kommagetrennte Liste austest-first,spec-firstundsimple-changes) schaltet Arbeitsmethoden ein: Regelsätze dafür, wie der Assistent arbeitet, aus.act/methods/oder eigene unterdocs/ai/local/methods/. Der Sitzungsstart,act-updateundpython .act/scripts/rules.py --sync-methodstragen jede genannte Methode als importierten Satz indocs/project/coding_rules.mdein, sodass der Orchestrator und jeder Worker sie laden; einzelne Gruppen lassen sich dort abwählen.initfragt einmal, undact-doctormeldet einen Namen ohne Datei oder einen Abschnitt, der nicht mehr zur Zeile passt. Die Listen der Skills und Rollen stehen in der Konfigurationsreferenz. - Board:
boardwählt, wohin das erzeugte Board geht (docs,shared,local);board-othersschaltet den Abschnitt für Aufgaben um, die anderen Personen zugewiesen sind. - Inbox:
inbox-decisionsbestimmt, wo eine offene Entscheidung wartet. Mitimmediatelandet sie in der Inbox, sobald sie verbucht ist; mitat-startdarf ein Backlog-Eintrag sie behalten, bis die Arbeit daran beginnt.quick-capture(onoderoff, Standardon) lässt den HookUserPromptSubmiteine Chat-Nachricht, die mittodo:,note:oderidea:beginnt, ohne Modell-Durchlauf ablegen, siehe Inbox, Aufgaben und Journal. - Output depth:
output-depth(verbose,normal,sparse) steuert, wie viel der Assistent im Chat schreibt, nicht was dein Werkzeug anzeigt. - Session length:
context-hint(eine Token-Zahl, Standard 180000, oderoff) ist die Kontextgröße, ab der der Assistent an der nächsten Aufgabengrenze/clearoder eine neue Sitzung vorschlägt. Bevor er „jetzt/clear“ sagt, prüft der Assistent die Übergabe selbst (handover.py); es gibt keinen Satz zum Kopieren mehr, und nach/clearnimmt ein schlichtes „weiter“ den Faden vom Board auf.session-name(project,autooder ein beliebiger anderer Text, Standardproject) setzt den Sitzungstitel in Claude Code beim Start, beim Fortsetzen und beim Gabeln einer Sitzung:projectnimmt dennamedes Projekts (sonst den Ordnernamen), sodass eine Remote-Control-Sitzung auf dem Handy zeigt, zu welchem Projekt sie gehört;autoüberlässt es dem Werkzeug; anderer Text wird zum Titel. Ein mit/renameoderclaude -ngesetzter Titel wird nie überschrieben.task-wait-hours(Standard 12) ist die Zeit, die eine begonnene Aufgabe ruhen darf, bevor sie als wartend gilt.board-at-start(onoderoff, Standardon) gibt dem Sitzungsstart einen Auszug des Boards mit.artifacts(onoderoff, Standardoff) aufoffhält Claude Code davon ab, das WerkzeugArtifactzu laden, etwa 13.700 Token weniger bei jedem Sitzungsstart. - Teaching:
teach-lessons(local,docs) legt fest, woact-teachseine Lektionen ablegt:localunter.act-local/learn/nur für dich,docsversioniert unterdocs/learn/für das Team. Der Lernstand bleibt in beiden Fällen lokal. - Dependencies und Docs audit:
dependency-checkunddocs-audit-duesteuern die Erinnerungen,act-depsundact-audit-docsauszuführen. Neue Projekte bekommendependency-check: regularly: Der Sitzungsstart weist einmal darauf hin, dass noch keinact-deps-Lauf verbucht ist, danach wieder, sobald der letzte älter als 30 Tage ist.oncelegt stattdessen nachiniteinmalig einen Inbox-Eintrag an; bereits gesetzte Werte bleiben. - Update:
update-channel(releaseoderlatest, Standardrelease) wählt, wasact-updatebringt:releasenur das neueste stabile Release-Tag der Template-Quelle,latestdie Spitze ihres Default-Branches. Der Sitzungsstart meldet ein neues Release (auflatest: eine neuere Spitze), und/act-versionzeigt drei Zeilen (installiert, neuester Stand im Channel, ob ein Update bereitsteht),/act-version --alldie volle Liste (update.py --versions) mit den Releases und dem, was ein Update nähme. Die Meldung ist nicht einmalig: Die tägliche Prüfung hält sie fest, der Sitzungsstart wiederholt sie bei jedem Start, das Board führt sie unter Status, und die Statuszeile von Claude Code zeigtupdate: 2.4.0(auflatest:update: <Datum>), bis das Update eingespielt ist.--versions,--planund ein Update-Lauf frischen den Hinweis auf oder löschen ihn, wenn das Projekt aktuell ist.update-checkschaltet den Hinweis ab.initfragt nach dem Wert;act-doctormeldet einen ungültigen. Eine Quelle ohne Release-Tags wird an ihrer Spitze verfolgt, mit Hinweis. Dasgit ls-remoteder täglichen Prüfung erlaubt nur die Protokollefile,git,http,httpsundssh; eine Quelle hinter einem anderen Remote Helper (etwaext::) bekommt beim Sitzungsstart keinen Hinweis,act-updateselbst ändert sich nicht.advisory-check(onoderoff, Standardon) lässt dieselbe tägliche Prüfung die Template-Quelle nach Warnungen zu Template-Versionen mit bekanntem ernstem Problem fragen; die zur installierten Version passenden erscheinen beim Sitzungsstart;critical-Warnungen zusätzlich in der Statuszeile (⚠ A<n>), direkt unter dem Board-Titel und einmal als Inbox-Todo (ein Todo, das erledigt und gelöscht wurde, wird in der Git-Historie nachgeschlagen, nur lesend und innerhalb weniger Sekunden, damit ein anderer Arbeitsplatz es nicht ein zweites Mal anlegt). Sie enden, wenn ein Update eine Version außerhalb des betroffenen Bereichs bringt, wenn die in der Warnung genannten Dateien den fehlerhaften Text nicht mehr enthalten oder wenn du sie quittierst („Warnung quittiert“ sagen oderpython .act/scripts/advisory.py --ack A<n>ausführen).offfragt nichts und zeigt nichts;update-check: offstoppt die Abfrage ebenfalls;advisory.py --statuszeigt den Stand. Siehe Update-Channel. - Packages:
packages-unverified(block,scanoderallow, Standardblock) entscheidet, waspackages.pymit einem Package ohne gültige Signatur des Template-Autors tut; eine Signatur, die nicht passt, wird immer verweigert.packages-sourcesnennt, wopackages.py fetch <id>sucht (einehttps://-Adresse oder ein Ordner mit einerindex.json), undpackages-update(askoderoff, Standardask) lässtact-updatejedes installierte Package mit neuerer Version anbieten, siehe Update. - Archive:
archive-compact(<n>d <n>oderoff, Standard30d 300) bestimmt, wann der Sitzungsstart meldet, dassact-compactfällig ist: Der älteste Eintrag im Archiv- oder Journal-Ordner ist älter als so viele Tage, oder der Ordner enthält mehr als so viele Dateien.act-compactführt nur wortgetreu zusammen; der frühere Schlüsselarchive-shortenist entfallen, ein im Projekt verbliebener Wert wird übergangen. Ein erledigter Eintrag wird immer ins Archiv verschoben, und nichts verlässtdocs/, bevor es in seiner Monatsdatei steht. Der frühere Schlüsseldone-entriesundentries.py purgesind entfallen: Eine übrig gebliebene Zeiledone-entrieswird übergangen und vom Update entfernt, ein Aufruf vonpurgegibt nur einen Hinweis aus. Siehe Inbox, Aufgaben und Journal. - Formats: wie der Assistent formuliert, was er schreibt.
commit-format(auto,conventional,plain),changelog-format(keep-a-changelog,at-release),release-notes-format(standard,changelog-copy) undreadme-format(standard,with-toc,minimal) wählen je ein Preset aus.act/formats/; eine Dateidocs/project/formats/<name>.md(commit.md,changelog.md,release-notes.md,project-readme.md) ersetzt das Format der Vorlage für diesen Gegenstand vollständig und geht der Zeile vor.changelog(file,release-notes-only,off; Standardfile) bestimmt, ob das Projekt eineCHANGELOG.mdim Stammordner führt:initlegt sie mit einem leeren## [Unreleased]an,act-updatebietet sie einem älteren Projekt einmal an, und keines von beiden überschreibt eine vorhandene Datei oder legt neben einem Changelog unter anderem Namen ein zweites an. Mit dem Standardformat ergänztact-commitfür jeden Commit mit sichtbarer Wirkung eine Zeile unter[Unreleased]und hält die Kopfzeile des Abschnitts (ein Satz) aktuell;at-releaseüberlässt dasact-release. Eine vorhandeneconfig.mdhat keinen Abschnitt Formats, bis er von Hand aus.act/skeleton/config.mdergänzt wird. Siehe die Konfigurationsreferenz. - Git hosting:
target-branch,forgeundforge-hostsagen dem Pull-Request-Skill, wohin er gehen soll. github.com und gitlab.com bekommen den Token, ohne genannt zu werden; ein selbst gehosteter Host erst, nachdem du ihn genannt hast. - Checks: mechanische Wächter, die vor einer Aktion laufen (siehe unten).
- Logging:
loggingundlog-levelschreiben jede Agenten-Aktion nachai.logim Projektwurzelverzeichnis, nicht versioniert, praktisch zum Mitverfolgen in einem zweiten Terminal. - Feedback: freiwilliges Feedback an den Autor des Templates; neue Projekte starten mit
feedback: confirm, es wird also nichts ohne dein Ja gesendet.feedback: localheißt: Das Projekt sendet nie etwas an den Autor des Templates;feedback.py --send,--directund--addverweigern sich, Erinnerungen werden nie fällig, und ein Template-Fehler, ein handgeschriebenesfeedback: <Text>oder ein wiederkehrender Befund wird stattdessen ein Backlog-Eintrag im Projekt. Siehe Feedback. - Tips:
tips(never,occasionally,regularly) steuert, wie oft der Sitzungsstart einen Tipp zeigt. Deine eigenen Erinnerungen indocs/ai/local/reminders.mdbleiben davon unberührt. - Roles: Overrides von Tier und Reasoning pro Rolle (und pro Skill) sowie der Copilot-Modelle, siehe Tiers und Reasoning.
Prüfungen: block, warn, off
Abschnitt betitelt „Prüfungen: block, warn, off“Jede Zeile der Prüfungstabelle benennt einen Wächter, der vor der Aktion läuft, die er beschreibt, zum Beispiel einem Commit, einem Schreibzugriff unter .act/ oder einem Worker, der seinen Write Scope verlässt.
| Wert | Wirkung |
|---|---|
block |
die Aktion wird verweigert |
warn |
die Aktion läuft mit einem Hinweis weiter |
off |
die Prüfung wird ganz übersprungen |
Eine Prüfung, die in der Tabelle als „never refuses” markiert ist, behandelt block wie warn. Eine Prüfung ist anders: security-check nimmt off, local, deps oder full, siehe Sicherheitsprüfung.
Eine abgelaufene Zeitgrenze oder ein Absturz ist nie ein Durchlass: Eine Prüfung, die ablehnen kann, lehnt den Aufruf ab, wenn ihr die Zeit ausgeht oder sie abstürzt (im Modus warn gibt sie einen Hinweis), und nennt die Zeile, die sie abschaltet (<row>: off); führe den Befehl erneut aus. Eine Prüfung, die nie ablehnt, meldet „incomplete“, statt zu schweigen.
Eine Prüfung herunterzustufen ist deine Entscheidung. Prüfungen wie secret-scan oder git-reset-hard schützen vor Dingen, die sich nicht rückgängig machen lassen; senke sie nur mit Grund.
secret-scan hält einen Commit an, dessen gestagter Diff ein Schlüssel- oder Token-Muster enthält. Eine Zeile mit einem act:allow-secret-Kommentar ist ausgenommen. Für eine Datei ohne Kommentare (JSON) steht die Zeile in docs/ai/local/secret-accepted.md als - <path> <hash>: <reason>; die Sperrmeldung druckt die fertige Zeile (Pfad und Zeilen-Hash, nie den Wert). Eine geänderte Zeile, dieselbe Zeile in einer anderen Datei oder eine fehlende oder unlesbare Liste sperrt wieder. Die Override-Hashes, die doctor --accept in .act-lock.json im Projektwurzelverzeichnis schreibt (eine Regel-ID als Schlüssel, genau 64 kleine Hex-Ziffern als Wert, sonst nichts auf der Zeile), hält secret-scan nicht an. Was jede Prüfung erkennt und wo ihre Grenzen liegen, steht auf der Seite zu den Prüfungen.
protected-watch (Standard block; warn oder off) überwacht die Dateien, die R-safe-git-metadata schützt (Git-Hooks und die Config-Schlüssel, die Code starten, Claude-Einstellungen, Agents, Skills und Commands, Copilot-Rollendateien unter .github/agents/, .mcp.json, .envrc, .devcontainer/**, .vscode/tasks.json): Nach jedem Tool-Aufruf vergleicht es sie mit einem Snapshot vom Sitzungsstart und sieht so auch eine Änderung durch eine Script-Datei oder Inline-Code, die die statische Prüfung git-metadata-guard nicht lesen kann. Bei block wird eine Änderung im Aufruf eines Workers sofort zurückgesetzt, die geänderte Fassung bleibt unter .act-local/protected-watch/kept/; eine Änderung des Orchestrators wird nur gemeldet, samt dem Befehl, der die vorige Fassung wiederherstellt. Bei warn wird jede Änderung nur gemeldet. Claude Codes eigene „Always allow“-Einträge in settings.local.json bleiben unberührt und werden nur gemeldet. Es meldet nach dem Aufruf und verhindert nichts; seine Grenzen stehen auf der Seite zu den Prüfungen.
model-switch (Standard warn, off schaltet es ab; es verweigert nie) meldet dir, wenn ein Worker oder die Sitzung selbst mit einem anderen Modell weiterläuft, typischerweise nachdem der Sicherheitsfilter eine Anfrage abgelehnt hat, was Claude Code in einem Sub-Agent nicht ankündigt: Bei SubagentStop und Stop erfährt der Orchestrator es mit seinem nächsten Tool-Aufruf, mit Rolle und Modellen, und sagt es dir im Chat. Der Hook selbst zeigt dir nichts, denn Claude Code zeichnet die Meldung dieser Ereignisse auf, zeigt sie aber nie an.
outside-root hält Lesen und Schreiben im Projektordner und seinen erlaubten Orten, für den Assistenten und seine Worker. In neuen Projekten steht es auf block; ein Projekt ohne die Zeile führt es als warn aus. Ausnahmen kommen in outside-root-allow: Pfade relativ zum Projektordner, mit ~ beginnend oder absolut, jeweils optional gefolgt von (read). Ein absoluter Eintrag außerhalb des Projekts und deines Home-Ordners, etwa der Programmordner eines Browsers (D:/Program Files/Browser), ist wie (read) nur lesbar (einer mit einem Glob-Zeichen bleibt beschreibbar, solange kein (read) folgt): Der Assistent darf darunter lesen und Programme starten, die Schreibzugriffe, die die Prüfung erkennt, werden verweigert. Ein file:-Eintrag wird ignoriert, eine file:-URL in einem Befehl wird als der Pfad gelesen, den sie nennt. Beide Zeilen stehen in der Konfigurationsreferenz, die Regel in R-safe-outside-root.
secret-read-allow (Standard none) nennt Dateien, die secret-read durchlassen darf, obwohl sie wie Geheimnisse aussehen: relativ zum Projektwurzelordner, mit ~ beginnend oder absolut, ein * nur im letzten Teil des Pfads. Jede andere Geheimnis-Datei bleibt gesperrt. Nur du schreibst diese Zeile; ein Package kann sie nicht setzen.
docs-order (Standard warn) prüft, dass die Projektdoku auffindbar bleibt (R-docs-order): Jeder Ordner unter docs/project/ mit fünf oder mehr Einträgen hat eine README.md mit einer Zeile je Datei und Unterordner. Der Doctor meldet eine fehlende oder veraltete Indexzeile, einen toten Link und ein Konzept, das schon entschieden ist. Er vermerkt außerdem, ohne etwas abzulehnen, eine Datei unter docs/project/ ab 300 Zeilen (in einen Ordner mit README.md aufteilen) und eine Indexzeile in docs/README.md, die unter einen Unterordner zeigt (sie gehört in die README.md dieses Ordners). move_doc.py verschiebt ein Dokument und zieht Links und Indexzeile mit.
cd-git (Standard block; warn oder off; läuft nur, wenn tools claude-code enthält) lehnt einen Bash-Aufruf ab, der cd oder pushd mit git verkettet, weil Claude Code für diese Kombination jedes Mal um Freigabe fragt, und nennt stattdessen git -C <folder> <command> in einem eigenen Aufruf. warn nennt den Weg und lässt den Aufruf durch.
commit-hashes (Standard warn, off schaltet es ab; es verweigert nie) vermerkt einen Commit-Hash in Backticks, den kein Repository kennt, in einer Commit-Nachricht oder in einer Zeile, die einer gestagten Journal-Datei hinzugefügt wird. Ein Vorlagen-Commit, den .act-lock.json verzeichnet, gilt als bekannt; der Wechsel des Basis-Commits, den ein Update ins Journal schreibt, bringt also keinen Hinweis. commit-hashes-repos nennt weitere Repositories, in denen gesucht wird (none oder kommagetrennte Pfade wie ../agentic-coding-template), für ein Journal, das Commits eines anderen Repositories nennt (R-work-evidence).
throwaway-place (Standard warn, off schaltet es ab; es verweigert nie) vermerkt, nur in der Hauptsitzung, einen Befehl oder Dateischreibzugriff, der Wegwerf-Ausgaben ins temporäre Verzeichnis des Systems oder direkt unter .act-local/ legt, und nennt stattdessen .act-local/tmp/<task-id>-<slug>/ oder .act-local/tmp/<YYYYMMDD>-<slug>/ (R-work-throwaway). Alle drei Zeilen stehen in der Konfigurationsreferenz.
changelog-length (Standard warn, off schaltet es ab; es verweigert nie) lässt act-doctor einen Eintrag unter [Unreleased] in CHANGELOG.md nennen, der länger als 250 Zeichen ist, mit seinen ersten Worten.
own-rules-budget (Standard 6000 Zeichen, off oder 0 schaltet es ab) hält die eigenen Regeln kurz. act-doctor warnt, wenn die Abschnitte „Own rules“ von docs/ai/rules.md und docs/project/coding_rules.md zusammen mehr haben, nennt die Größe und bis zu fünf Zeilen, die wie Verlauf lesen (ein Datum, eine Eintragskennung, „früher … seit …“) mit dem Rat, was davon jedem Projekt nützen würde, als Feedback zu senden (act-feedback), und blockiert nie. Der Abschnitt „Own rules“ im Gerüst von coding_rules.md hat eine Tabelle, wohin welche Art von Regel gehört.
own-rules-review (Standard warn, off schaltet es ab; es lehnt nie ab) hat zwei Teile. act-doctor nennt einen lokalen Skill, der einen Template-Skill gleichen Namens überschreibt, bis du ihn mit python .act/scripts/doctor.py --accept skill:<name> behältst (ein behaltener erscheint als veraltet, wenn sich der Template-Skill ändert). Nach einem Update stellt act-update die neuen und geänderten Regeln und Skills des Updates deinen eigenen Regeln, Overrides und Skills in einer Inbox-Frage gegenüber: verwerfen, behalten oder anpassen; nichts wird gelöscht.
act-local-tidy hält .act-local/ klein. Beim Sitzungsstart entfernt es, höchstens einmal am Tag und in einem Hintergrundprozess, tmp/-Einträge und unbekannte Einträge direkt unter .act-local/ (keine, die ein Skript der Vorlage anlegt), die älter als 7 Tage sind und deren Name nicht mit der Id einer offenen Aufgabe beginnt, alle bis auf die neuesten 5 Backups von update und kompilierte Moduldateien unter .act-local/pyc/, die zu einer anderen Python-Version als der laufenden gehören und älter als 7 Tage sind. Der nächste Sitzungsstart meldet Anzahl, Größe und Art; mit Namen nennt er nur Einträge, die sich nicht entfernen ließen. Der erste Lauf in einem Projekt meldet nur, was er entfernen würde; entfernt wird an einem späteren Tag, nachdem ein Sitzungsstart diese Meldung gezeigt hat. warn meldet nur, off überspringt die Prüfung. act-local-keep listet Muster relativ zu .act-local/ (zum Beispiel exports, tmp/long-*), die nie entfernt werden, oder none. python .act/scripts/act_local_tidy.py zeigt den Plan, ohne etwas zu entfernen. Die Regel dahinter ist R-work-throwaway.
Ignore-Dateien und was die Prüfungen nicht sind
Abschnitt betitelt „Ignore-Dateien und was die Prüfungen nicht sind“Eine .claudeignore gibt es nicht: Claude Code übergeht eine solche Datei kommentarlos. Seine Werkzeuge Glob und Grep lassen schon aus, was .gitignore ausschließt, node_modules und Build-Ordner eingeschlossen; die Vorlage legt deshalb keine eigene Ignore-Datei an. permissions.deny mit Read(...)-Regeln erreicht die eigenen Datei-Werkzeuge von Claude Code, einen Shell-Befehl aber nur, wo seine Sandbox eingeschaltet ist. Ein gezielter, begrenzter Blick in die Quellen einer Bibliothek (grep -n … | head) bleibt erlaubt; oft findet sich so ein Fehler in einer Abhängigkeit (R-work-bounded-output). Geheimnis-Dateien sperrt secret-read, auch in Shell-Befehlen, in den Grenzen, die seine Regel nennt (R-safe-no-secret-read). Die Prüfungen sind Leitplanken gegen Versehen, keine Sandbox: Weder eine Ignore-Datei noch eine deny-Regel hält für sich allein einen Agenten, oder einen in seinen Prompt eingeschleusten Text, davon ab, eine Datei über die Shell zu lesen. Dafür braucht es eine Trennung außerhalb des Agenten, etwa einen Container oder die Sandbox des Werkzeugs. Welche Schalter die Tools dafür bieten und wo sie enden, steht in der Isolation-Anleitung.
Datei und Umgebung
Abschnitt betitelt „Datei und Umgebung“config.md beschreibt das Projekt und ist versioniert. Secrets und Abweichungen pro Rechner oder pro Lauf gehören in die Umgebung (zum Beispiel AGENTIC_FEEDBACK_URL oder ACT_FORGE_API_URL); sie überschreibt die Datei für diesen Lauf, nie umgekehrt. Der Sitzungsstart nennt jeden aktiven Override aus der Umgebung, nur die Namen, nie die Werte.
Die Datei ändern
Abschnitt betitelt „Die Datei ändern“/act-config listet alle Einstellungen, /act-config <Schlüssel> zeigt eine mit ihren erlaubten Werten, dem Standard und dem Zeitpunkt, ab dem eine Änderung wirkt, und /act-config <Schlüssel> <Wert> schreibt den Wert in genau diese Tabellenzelle. Es wird nichts committet, der Rest der Datei bleibt Byte für Byte gleich. In Claude Code beantwortet der UserPromptSubmit-Hook den Befehl; sonst läuft python .act/scripts/config.py [<Schlüssel> [<Wert>]]. Die Roles-Tabelle wird angezeigt, aber von Hand bearbeitet.
Von Hand ändere die Werte in den Tabellen, nicht die Schlüsselnamen oder die Marken (<!-- act:... -->): Die liest die Mechanik. Ein Update behält deine Werte. act-doctor prüft den Wert jedes Schlüssels mit fester Liste oder festem Format und meldet einen ungültigen als config-value. Ändert sich das Projekt auf eine Weise, die config.md beschreibt, aktualisiert der Assistent sie im selben Schritt.