Zum Inhalt springen

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.

  • Project: Name, Owner, language-chat und language-docs, stack, die commands für Lint/Typecheck/Test (wahlweise ein vierter für die ganze oder die E2E-Suite, vor einem Push), die tools, die du nutzt, und der mode (solo oder team, siehe Inbox, Aufgaben und Journal). language-chat ist die Sprache, in der der Assistent mit dir spricht (auto folgt deinen Nachrichten); language-docs ist die Sprache von allem, was er unter docs/ schreibt. .act/ bleibt in beiden Fällen Englisch. Ein Befehl mit (not set) überspringt die zugehörige Prüfung vor einem Commit. run ist der Befehl, der die Anwendung startet; (not set) heißt, dass keiner hinterlegt ist.
  • Scope: profile (minimal, standard oder full; ein fehlender Schlüssel gilt als full; init schreibt full für ein Web-Projekt und standard für jedes andere, --scope entscheidet anders, update ändert es nie) und exclude (none oder eine kommagetrennte Liste) beschneiden das Template je Projekt: standard lässt die Web-, Design- und Teaching-Skills weg, minimal behält nur die Kern-Skills und -Rollen (act-packages gehört dazu), und exclude nennt zusätzlich einzelne Skills, Rollen, Regeldateien wie orchestrator/30-cost.md oder Topics. Der Sitzungsstart entfernt die Kopien des Weggelassenen, stellt die Import-Zeile einer ausgeschlossenen Regeldatei in docs/ai/rules.md auf 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.md lässt sich nicht ausschließen, und die Prüfungen bleiben in jedem Fall aktiv. Zum Zurücknehmen profile auf full und exclude auf none setzen. methods (Standard none, sonst eine kommagetrennte Liste aus test-first, spec-first und simple-changes) schaltet Arbeitsmethoden ein: Regelsätze dafür, wie der Assistent arbeitet, aus .act/methods/ oder eigene unter docs/ai/local/methods/. Der Sitzungsstart, act-update und python .act/scripts/rules.py --sync-methods tragen jede genannte Methode als importierten Satz in docs/project/coding_rules.md ein, sodass der Orchestrator und jeder Worker sie laden; einzelne Gruppen lassen sich dort abwählen. init fragt einmal, und act-doctor meldet einen Namen ohne Datei oder einen Abschnitt, der nicht mehr zur Zeile passt. Die Listen der Skills und Rollen stehen in der Konfigurationsreferenz.
  • Board: board wählt, wohin das erzeugte Board geht (docs, shared, local); board-others schaltet den Abschnitt für Aufgaben um, die anderen Personen zugewiesen sind.
  • Inbox: inbox-decisions bestimmt, wo eine offene Entscheidung wartet. Mit immediate landet sie in der Inbox, sobald sie verbucht ist; mit at-start darf ein Backlog-Eintrag sie behalten, bis die Arbeit daran beginnt. quick-capture (on oder off, Standard on) lässt den Hook UserPromptSubmit eine Chat-Nachricht, die mit todo:, note: oder idea: 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, oder off) ist die Kontextgröße, ab der der Assistent an der nächsten Aufgabengrenze /clear oder 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 /clear nimmt ein schlichtes „weiter“ den Faden vom Board auf. session-name (project, auto oder ein beliebiger anderer Text, Standard project) setzt den Sitzungstitel in Claude Code beim Start, beim Fortsetzen und beim Gabeln einer Sitzung: project nimmt den name des 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 /rename oder claude -n gesetzter 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 (on oder off, Standard on) gibt dem Sitzungsstart einen Auszug des Boards mit. artifacts (on oder off, Standard off) auf off hält Claude Code davon ab, das Werkzeug Artifact zu laden, etwa 13.700 Token weniger bei jedem Sitzungsstart.
  • Teaching: teach-lessons (local, docs) legt fest, wo act-teach seine Lektionen ablegt: local unter .act-local/learn/ nur für dich, docs versioniert unter docs/learn/ für das Team. Der Lernstand bleibt in beiden Fällen lokal.
  • Dependencies und Docs audit: dependency-check und docs-audit-due steuern die Erinnerungen, act-deps und act-audit-docs auszuführen. Neue Projekte bekommen dependency-check: regularly: Der Sitzungsstart weist einmal darauf hin, dass noch kein act-deps-Lauf verbucht ist, danach wieder, sobald der letzte älter als 30 Tage ist. once legt stattdessen nach init einmalig einen Inbox-Eintrag an; bereits gesetzte Werte bleiben.
  • Update: update-channel (release oder latest, Standard release) wählt, was act-update bringt: release nur das neueste stabile Release-Tag der Template-Quelle, latest die Spitze ihres Default-Branches. Der Sitzungsstart meldet ein neues Release (auf latest: eine neuere Spitze), und /act-version zeigt drei Zeilen (installiert, neuester Stand im Channel, ob ein Update bereitsteht), /act-version --all die 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 zeigt update: 2.4.0 (auf latest: update: <Datum>), bis das Update eingespielt ist. --versions, --plan und ein Update-Lauf frischen den Hinweis auf oder löschen ihn, wenn das Projekt aktuell ist. update-check schaltet den Hinweis ab. init fragt nach dem Wert; act-doctor meldet einen ungültigen. Eine Quelle ohne Release-Tags wird an ihrer Spitze verfolgt, mit Hinweis. Das git ls-remote der täglichen Prüfung erlaubt nur die Protokolle file, git, http, https und ssh; eine Quelle hinter einem anderen Remote Helper (etwa ext::) bekommt beim Sitzungsstart keinen Hinweis, act-update selbst ändert sich nicht. advisory-check (on oder off, Standard on) 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 oder python .act/scripts/advisory.py --ack A<n> ausführen). off fragt nichts und zeigt nichts; update-check: off stoppt die Abfrage ebenfalls; advisory.py --status zeigt den Stand. Siehe Update-Channel.
  • Packages: packages-unverified (block, scan oder allow, Standard block) entscheidet, was packages.py mit einem Package ohne gültige Signatur des Template-Autors tut; eine Signatur, die nicht passt, wird immer verweigert. packages-sources nennt, wo packages.py fetch <id> sucht (eine https://-Adresse oder ein Ordner mit einer index.json), und packages-update (ask oder off, Standard ask) lässt act-update jedes installierte Package mit neuerer Version anbieten, siehe Update.
  • Archive: archive-compact (<n>d <n> oder off, Standard 30d 300) bestimmt, wann der Sitzungsstart meldet, dass act-compact fä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-compact führt nur wortgetreu zusammen; der frühere Schlüssel archive-shorten ist entfallen, ein im Projekt verbliebener Wert wird übergangen. Ein erledigter Eintrag wird immer ins Archiv verschoben, und nichts verlässt docs/, bevor es in seiner Monatsdatei steht. Der frühere Schlüssel done-entries und entries.py purge sind entfallen: Eine übrig gebliebene Zeile done-entries wird übergangen und vom Update entfernt, ein Aufruf von purge gibt 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) und readme-format (standard, with-toc, minimal) wählen je ein Preset aus .act/formats/; eine Datei docs/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; Standard file) bestimmt, ob das Projekt eine CHANGELOG.md im Stammordner führt: init legt sie mit einem leeren ## [Unreleased] an, act-update bietet 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änzt act-commit für jeden Commit mit sichtbarer Wirkung eine Zeile unter [Unreleased] und hält die Kopfzeile des Abschnitts (ein Satz) aktuell; at-release überlässt das act-release. Eine vorhandene config.md hat keinen Abschnitt Formats, bis er von Hand aus .act/skeleton/config.md ergänzt wird. Siehe die Konfigurationsreferenz.
  • Git hosting: target-branch, forge und forge-host sagen 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: logging und log-level schreiben jede Agenten-Aktion nach ai.log im 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: local heißt: Das Projekt sendet nie etwas an den Autor des Templates; feedback.py --send, --direct und --add verweigern sich, Erinnerungen werden nie fällig, und ein Template-Fehler, ein handgeschriebenes feedback: <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 in docs/ai/local/reminders.md bleiben davon unberührt.
  • Roles: Overrides von Tier und Reasoning pro Rolle (und pro Skill) sowie der Copilot-Modelle, siehe Tiers und Reasoning.

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.

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.

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.

/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.