Update
act-update holt einen neueren Stand des Templates in dein Projekt: Du siehst den Diff, du stimmst zu, und
python .act/scripts/update.py erledigt den Rest. Es gibt keinen Merge und nichts, was du von Hand auflösen
müsstest. Sag Prüfe, ob es ein Template-Update gibt oder führe das Script selbst aus.
Bevor du anfängst
Abschnitt betitelt „Bevor du anfängst“Committe oder beende offene Arbeit zuerst (git status sollte sauber sein). Das Update braucht Git 2.25 oder neuer. Die Adresse des Templates steht in
.act-lock.json (template.source); mit --source und --ref wählst du eine andere Quelle oder ein Tag. Die dort
eingetragene Quelle hat Vorrang: ein Git-Remote namens template wird nur genommen, wenn die Lock-Datei keine Quelle
nennt, und das Script sagt, welche es genommen hat. Schlägt der Abruf fehl, nennt die Meldung die Quelle, woher sie
stammt, und den Ausweg (--source, --ref).
Eine Quelle, die selbst ein eingerichtetes Projekt ist, wird abgelehnt; update.py nennt --source <Template-Adresse>, lass es dann einmal damit laufen.
Ein Projekt auf einer Template-Version älter als v2.2.0 wird nicht mehr aktualisiert: update.py bricht ab, bevor es
etwas ändert, und nennt act-adopt (aus einem
aktuellen Template-Checkout oder Projekt gestartet, mit diesem Ordner als <dir>), das die Doku und eigenen Regeln des
Projekts übernimmt.
python .act/scripts/update.py --plan # show the diff and describe the later steps, write nothing but the update notepython .act/scripts/update.py # the real run, asks for consent--plan nennt den geholten Commit und hält ihn eine Stunde. Ein echter Lauf in dieser Stunde (gleiche Quelle und
gleicher Channel, kein --ref) spielt genau diesen Commit ein und sagt es, wenn die Quelle inzwischen weitergezogen
ist; eine umgeschriebene Quelle wird abgelehnt. Eine Quelle, die ein einfacher Ordner ist, hat keinen Commit und
bekommt deshalb keine Plan-Datei.
Update-Channel
Abschnitt betitelt „Update-Channel“update-channel in docs/ai/config.md § Update bestimmt, was act-update anbietet. init fragt danach und schreibt ihn.
release(Standard) ist das neueste stabile TagvX.Y.Zder Quelle. Ein Projekt, das schon darüber liegt, etwa weil esmaingefolgt ist, hört „ahead of the newest release“ und behält seinen Stand.latestist die Spitze des Default-Branches der Quelle.--channel release|latestüberschreibt den Schlüssel für einen Lauf;--ref <Tag-oder-Commit>geht beiden vor.- Eine Quelle ohne Release-Tags wird an ihrer Spitze verfolgt, mit einem Hinweis, solange
releaseder Standard ist oder indocs/ai/config.mdsteht.--channel releaseund ein ungültiger Wert brechen mit dem Hinweis ab,--refoderlatestzu nehmen. - Auf
releasemeldet der Sitzungsstart „template release vX.Y.Z available“, auflatest„a template update is available“..act-lock.jsonhält alstemplate.refaufreleasedas installierte Tag fest, auflatestden Branch. - Ein ausstehendes Update bleibt sichtbar, bis es installiert ist: Der Sitzungsstart nennt es in der Zeile, die du
siehst (
update 2.4.0 available), und wiederholt es bei jedem Start gegenüber dem Assistenten, das Board führt es unter Status, und die Statuszeile von Claude Code zeigtupdate: 2.4.0aufreleaseoderupdate: <Datum>auflatest(das Datum des neueren Commits, alsDD.MM.YYYY, wennlanguage-docsdeist, sonstYYYY-MM-DD; dessen kurzer Hash, wo sich das Datum nicht ohne Netz lesen lässt). Ist die Sperrdatei seit der Prüfung weitergezogen (ein Update aus einem anderen Checkout), fällt der alte Befund weg, und die nächste Prüfung läuft sofort. - Bestehende Projekte behalten ihre
config.md; ohne den Schlüssel bekommen sie einen einmaligen Hinweis vonact-update.act-doctormeldet einen Wert außerreleaseoderlatest.
Wo du stehst, siehst du mit /act-version: Ein Hook beantwortet es, bevor das Modell es sieht, in drei Zeilen
(die installierte Version und wann sie kam, der neueste Stand der Quelle im Channel mit Datum, und ob ein Update
bereitsteht). /act-version --all gibt die lange Liste, die auch python .act/scripts/update.py --versions ausgibt
(--versions --short ist die Dreizeilenform): die installierte Version und den Channel, die Releases der Quelle
(--all für alle statt der fünf neuesten), die Spitze des Default-Branches und was act-update nehmen würde. Die lange
Liste nutzt nur git ls-remote; die Dreizeilenform holt unter Umständen zusätzlich das einzelne Commit-Objekt, um sein
Datum zu lesen (ohne Bäume, nichts ausgecheckt); keine von beiden klont. Geschrieben wird
nur die lokale Update-Notiz unter .act-local/ (Statuszeile, Board), beurteilt für den eigenen Channel und die eigene
Quelle des Projekts. Auch --plan und ein Update-Lauf frischen diese Notiz auf (oder löschen sie, wenn das Projekt auf
dem neuesten Stand ist); --channel, --source und --ref richten einen einzelnen Lauf woandershin und lassen sie
unberührt. act-update beantwortet die Frage nach der installierten oder neuesten Version mit update.py --versions --short.
Advisories
Abschnitt betitelt „Advisories“Der Autor des Templates kann Projekte warnen, die eine betroffene Template-Version nutzen. Die tägliche
Update-Prüfung im Hintergrund schaut auch auf den Branch advisories der Template-Quelle und holt, wenn er sich
geändert hat, nur diesen Branch nach .act-local/advisories.git (nie ins .git des Projekts). Verwendet wird nur
geprüftes JSON; ein Link wird angezeigt, nie geöffnet. Ein critical-Advisory, das zur installierten Version passt,
erscheint bei jedem Sitzungsstart, als ⚠ A<n> in der Statuszeile, unter dem Board-Titel und einmal als Inbox-Todo;
ein warning nur beim Sitzungsstart, einmal oder bei jedem Start, wie das Advisory es festlegt.
Ein Advisory endet, wenn act-update eine Version außerhalb seines Bereichs bringt, wenn du „Warnung quittiert“
sagst (oder python .act/scripts/advisory.py --ack A<n> ausführst) oder wenn die genannten Dateien den fehlerhaften
Ausschnitt nicht mehr enthalten. Ein kritisches Advisory, dessen Inbox-Todo erledigt und gelöscht wurde (eine ältere Template-Version löschte erledigte Einträge), wird auf einem anderen Arbeitsplatz nicht erneut angelegt: advisory.py durchsucht auch die Git-Historie, nur lesend und zeitbegrenzt (die neuesten 2000 Commits, die Inbox oder Archiv berührten, höchstens 3 Kandidatendateien, etwa 4 Sekunden), nach einem gelöschten Todo mit derselben Überschrift. advisory-check: off in docs/ai/config.md schaltet es aus; advisory.py --status
zeigt den Stand, --refresh prüft sofort. Das git ls-remote der Prüfung erlaubt nur die Protokolle file, git,
http, https und ssh: Eine Quelle hinter einem anderen Remote-Helper bekommt beim Sitzungsstart keine
Update-Notiz, act-update selbst bleibt unverändert.
Die zehn Schritte
Abschnitt betitelt „Die zehn Schritte“- Holen des Templates in einen temporären Checkout. Nichts daraus wird ausgeführt.
- Lokale Änderungen. Prüft, ob du
.act/seit dem letzten Update bearbeitet hast.--on-local-changes rescue|discard|abortbeantwortet das vorab;rescueverschiebt deine Änderungen zuerst nachdocs/ai/local/. - Diff von alt nach neu, mit Regel- und Coding-Regel-IDs einzeln.
- Zustimmung. Nichts wird ersetzt, bevor zugestimmt wird. Vor der Rückfrage steht jede fällige Migration mit ihrer Wirkung, eine Zeile je Migration (
--planzeigt dasselbe).--yesüberspringt die Rückfrage, wenn schon zugestimmt wurde. .act/ersetzen, als Ganzes.- Die Kopien auffrischen außerhalb von
.act/: unveränderte Skill-Kopien und Rollen-Brücken werden ersetzt, von dir bearbeitete Kopien bleiben erhalten und werden gemeldet. Kopien, dieprofileoderexclude(Scope) auslassen, werden nicht geschrieben; eine schon vorhandene unbearbeitete Kopie wird entfernt, eine bearbeitete bleibt, beides wird gemeldet. Eigene Skills und Rollen unterdocs/ai/local/bekommen ihre Kopien hier ebenfalls. Neue Coding-Sätze und -Gruppen trägtact-updateindocs/project/coding_rules.mdein (ein neuer Satz nicht angekreuzt, eine neue Gruppe eines angekreuzten Satzes angekreuzt; siehe Eigene Skills, Rollen und Regeln). Solangedocs/project/coding_rules.mdÄnderungen hat, die nicht committet sind, wird nichts eingetragen (der Update-Commit würde sie mitnehmen):update.pysagt das in diesem Schritt und in den Schlussnotizen und nennt den Befehl für nach dem Commit,python .act/scripts/rules.py --add-new-coding.--planzeigt vorab, welche Sätze und Gruppen ein Update eintragen würde. Eine geänderte Zeilemethodsindocs/ai/config.mdwird hier ebenfalls angewendet (python .act/scripts/rules.py --sync-methodstut dasselbe allein). Hast dudocs/ai/rules.mdbearbeitet, nimmt eine Regel, die in eine andere Regeldatei gewandert ist, ihre Kästchenzeile mit (Kreuz und Begründung unverändert, eine abgeschaltete Regel bleibt also aus); importierst du die neue Datei nicht, wird sie nur gemeldet, ebenso eine Regel, die in eine Datei gewandert ist, die das Projekt mit einer eigenen Kopie unterdocs/ai/local/rules/überschattet, in der die Regel fehlt (sie wird nicht geladen). Eine unbearbeitetedocs/ai/rules.mdwird wie bisher neu abgeleitet. In einer bearbeiteten trägt das Update ein, was das Template an Regeln oder Regeldateien ergänzt hat: eine Kästchenzeile je neue Regel, eine neue Regeldatei als Import-Block am Ende ihres Abschnitts. Dein eigener Text, abgewählte Kästen und entfernte Imports bleiben unangetastet;.act-lock.jsonhält fest, was angeboten wurde (rules_offered), eine entfernte Zeile kehrt also nicht zurück, und ihre Regel gilt weiter als eingeschaltet (ausgeschaltet wird sie über das Kreuz). Was sich nicht sicher eintragen lässt, nenntpython .act/scripts/rules.py --add-missing; der Sitzungsstart trägt neue Regeln ebenso ein. Nurbuilderundreviewerbehalten eine-high-Variante: erzeugte Varianten der übrigen Rollen des Templates werden entfernt, jede in Vorschau und Zusammenfassung genannt. Die Rollen des Templates (und ihre-high-Varianten) bekommenomitClaudeMd: true, Worker ladenCLAUDE.mdalso nicht mehr; eigene Rollen und ein ausdrücklichesomitClaudeMd: falsebleiben unverändert, eine eigene Rolle ohne das Feld lädt weiterCLAUDE.md. Claude Code vor 2.1.271 ignoriert das Feld, Worker bekommen die Regeln dort doppelt (kostet nur Tokens). - Hooks und Git-Dateien. Gleicht die Hook-Einträge in
.claude/settings.jsonund die Blöcke des Templates in.gitattributesund.gitignoreab, setzt dortPYTHON_BASIC_REPL=1unterenv(unter Windows hängt ein leeres Heredoc in einem Bash-Aufruf unter Python 3.13 und neuer nicht mehr; ein selbst gesetzter Wert bleibt, der Bericht nennt die ergänzten env-Schlüssel) und"enableArtifact": false, außerdocs/ai/config.mdhatartifacts: on. Ein bestehendes Projekt startet nach dem Update deshalb ohne das WerkzeugArtifact. Außerdem ergänzt dieser Schritt denStop-Eintrag der Prüfungmodel-switch(sie meldet zusammen mitSubagentStop, wenn ein Worker oder die Sitzung auf einem anderen Modell weiterlief) und die 12SubagentStart-Einträge, die Workern ihre Regeln ohne die Orchestrator-Regeln geben (siehe Schritt 6); ein älterer Satz von sechs wird ersetzt, eigene Hooks bleiben.python .act/scripts/rules.py --workerzeigt, was ein Worker bekommt. Außerdem hält er.act-local/aus den Indizes der IDEs heraus: einexcludeFolderin jeder JetBrains-.idea/*.imlundfiles.watcherExcludein.vscode/settings.json, wo.vscode/existiert. - Migrationen. Führt alle fälligen aus. Jede schreibt eine betroffene Datei einmal um und lässt sie danach in Ruhe. Drei legen einem bestehenden Projekt einmal eine fehlende Datei an:
docs/ai/local/resources.md(die Leseliste),docs/project/README.md(der Index der Projektdoku) und über007-changelog-filedieCHANGELOG.mdim Projektstamm. Eine vorhandene Datei bleibt unberührt, eine gelöschte kommt nicht zurück.007-changelog-fileüberschreibt oder legt eineCHANGELOG.mdnie neu an; keine bekommt ein Projekt, das seinen Changelog unter anderem Namen führt (changelog.md,CHANGES.md,HISTORY.md,NEWS.md) oder unter § Formatschangelog: release-notes-onlyoderoffhat.008-done-entries-keepentfernt die abgeschaffte Zeiledone-entriessamt Erklärung ausdocs/ai/config.md(siehe Erledigte Einträge); der Plan nennt, was es herausschneiden würde. - Brücken und Doctor. Zuerst werden unbearbeitete erzeugte Brücken (
CLAUDE.md,AGENTS.md,docs/ai/rules.md) aufgefrischt; stehtsession-start-refreshindocs/ai/config.md§ Checks aufwarnoderoff, werden sie nur gemeldet („would refresh … not written“). Danach prüftdoctor.pyauf Abweichungen; Befunde landen indocs/ai/inbox/, nie als stille Korrektur. Darunter: ein Override unterdocs/ai/local/, dessen Gegenstück unter.act/fehlt (das Template hat es umbenannt oder entfernt, der Override wirkt also nicht), mit dem ähnlichsten Namen unter.act/; Regel-Overrides, Rollen und eigene Skills bleiben außen vor, ebenso ein eigenes Script oder ein eigener Coding-Satz, es sei denn, ein Name ist der Anfang des anderen oder unterscheidet sich nur in der Endung. Ein lokaler Skill, der einen Template-Skill gleichen Namens überschreibt, ist ebenfalls ein Befund, bis du ihn mitpython .act/scripts/doctor.py --accept skill:<name>behältst oder löschst (own-rules-review). Ein neuer Tier-Vorschlag wird dort als eigene Frage angelegt, und erst, wenn eine Rolle auf einem Tier 30 erfasste Ergebnisse hat und mindestens 60 % der letzten 30 nachgearbeitet oder eskaliert wurden. Die Frage ist kurz und empfiehlt Option a), zuerst die Fälle anzusehen; ihre Zahlen stehen in einem eigenen Inbox-Bericht,report-<Datum>-<Uhrzeit>-tier-numbers-<Rolle>-<Tier>.md. Der Commit nimmt den Bericht und die Fragen mit, und die Zusammenfassung nennt beide. - Lock und Commit.
.act-lock.jsonwird neu geschrieben und ein Commit angelegt, außer du gibst--no-commitan. Ein Pfad, den.gitignoreignoriert (etwa mit einer Allowlist wie*,!docs/), bleibt aus dem Commit, der ihn nennt. Nicht committete Änderungen von dir andocs/ai/rules.md,.gitignoreund.gitattributesbleiben ebenfalls aus ihm: das Update schreibt seine Ergänzung trotzdem dort hinein und nennt jede solche Datei, damit du sie selbst committest;--plannennt vorab die, in die es schreiben würde.
Die Zusammenfassung sagt auch, wie viel der nächste Sitzungsstart aus .act-local/ entfernen wird (die Prüfung
act-local-tidy, siehe unten).
In einem Copilot-Projekt (copilot in tools) gleichst du nach dem Update die Modelle in .github/agents/ mit /model
ab, trägst Abweichungen in die Spalte Copilot von docs/ai/config.md § Roles ein und führst dann
python .act/scripts/update.py --catch-up --yes aus.
Solange own-rules-review nicht off ist, stellt act-update danach die neuen und geänderten Regeln und Skills des Updates deinen eigenen Regeln, Overrides und Skills gegenüber und stellt, wo es Überschneidungen findet, eine Inbox-Frage: verwerfen, behalten oder anpassen; nichts wird gelöscht.
Danach folgt der Package-Schritt. Mit packages-update: ask (der Standard, Packages) holt act-update jedes aktive Package (python .act/scripts/packages.py fetch <id>) und führt für jedes mit neuerer Version /act-packages update <id> aus (Skill act-packages): Plan und Diff, dein Ja zu diesem Plan, erst dann die Änderung. Ein Ja je Package, nie eines für alle; eine Quelle, die nichts liefern kann, wird genannt und übersprungen. packages-update: off oder kein aktives Package überspringt den Schritt. update.py selbst nennt nur ein Package, dessen requires-template das neue Template nicht mehr erfüllt oder dessen neuere Zip schon da ist.
Ist .act-local ein Link aus dem Projekt hinaus, wird ein Worker-Start mit einer Zeile Write scope: oder Tests: jetzt abgelehnt: mach daraus einen gewöhnlichen Ordner oder setze worker-write-scope und worker-scope-overlap auf warn.
Hat das Template keinen neueren Stand, melden --plan und der echte Lauf „nothing to update“. Eine Brückendatei, deren
Inhalt gleich bliebe, wird nicht neu geschrieben. Ein großes Update scheitert unter Windows nicht mehr mit WinError 206.
Wenn eine Frage keine Eingabe bekommt
Abschnitt betitelt „Wenn eine Frage keine Eingabe bekommt“Fragt update.py und kommt keine Eingabe an, obwohl stdin wie ein Terminal aussieht (unter Windows zählt
< /dev/null dazu), nimmt es den sicheren Standardwert statt mit einem Traceback abzubrechen: keine Zustimmung zum
Update und abort bei lokalen Änderungen in .act/.
.act-local/ aufräumen
Abschnitt betitelt „.act-local/ aufräumen“Die Prüfung act-local-tidy läuft beim Sitzungsstart einmal am Tag im Hintergrund. Sie entfernt Einträge unter tmp/
und unbekannte Einträge direkt unter .act-local/, die älter als 7 Tage sind (außer ihr Name beginnt mit der Id einer
offenen Aufgabe oder act-local-keep in docs/ai/config.md § Checks nennt sie; Wegwerfmaterial liegt in tmp/<task-id>-<slug>/, bei Arbeit ohne Aufgabe in tmp/<YYYYMMDD>-<slug>/), alle bis auf die neuesten 5
Backups von update und kompilierte Moduldateien (.pyc) unter .act-local/pyc/, die zu einer anderen Python-Version als der laufenden gehören und älter als 7 Tage sind (Links werden nicht verfolgt, Dateien der laufenden Version nie angetastet). Der erste Lauf meldet nur, was er entfernen würde; entfernt wird ab dem Tag nach einem
Sitzungsstart, der diese Meldung gezeigt hat. act-local-tidy: warn meldet nur, off überspringt sie.
python .act/scripts/act_local_tidy.py listet, was gehen würde.
Danach ergänzt der Assistent eine Journalzeile mit der Änderung des Basis-Commits und der Zahl der Befunde.
Upgrade auf 2.6.0
Abschnitt betitelt „Upgrade auf 2.6.0“Von v2.5.0 aus wird act-update wie gewohnt ausgeführt, danach eine neue Sitzung gestartet.
- Aufträge, die Tests ausführen, brauchen eine Zeile
Tests:nebenWrite scope:; Worker führen Tests nur damit aus (siehe Rollen). - Migration
008-done-entries-keepläuft einmal: Sie entfernt die Zeiledone-entriesund ihren Erklärungsabsatz ausdocs/ai/config.md. Ein Projekt, dasdeletehatte (der Standard unter Git), archiviert erledigte Einträge von nun an; siehe Erledigte Einträge. cd-git(nur mitclaude-codeintools) verweigert einen Bash-Aufruf, dercdundgitverbindet, und nenntgit -C <Ordner>; um nur gewarnt zu werden, die Zeilecd-gitmitwarnunter § Checks ergänzen (Checks).git branch -Deiner Branch, die HEAD nicht enthält (etwa eine per Cherry-pick übernommene), wird verweigert; sie zuerst mergen odergit-discard: warnsetzen.CHANGELOG.md:act-updatelegt sie an, undact-commitergänzt von da an Einträge; um das zu vermeiden, zuvor die Zeilechangelogmitoffunter § Formats vondocs/ai/config.mdergänzen (Formats);config.pykann eine fehlende Zeile nicht setzen,.act/skeleton/config.mdzeigt ihre Form.- Overrides der Kernregeln: überschreibt
docs/ai/local/die Dateien.act/rules/shared/00-core.md,10-safety.mdoder20-code.md, die neuen Sätze vonR-role-worker,R-work-bounded-output,R-safe-approvalundR-code-encodingdort nachtragen. outside-root-allow: Ein absoluter Eintrag außerhalb von Projekt und Home-Ordner ist jetzt nur lesend, Schreiben dort wird verweigert. Einfile:-Eintrag wird ignoriert; stattdessen den Pfad schreiben.- Lock-Dateien: Ein Commit, der eine Lock-Datei berührt, wird gehalten, solange der Scan-Cache-Ordner ein Link oder
eine Junction ist; die Meldung nennt ihn. Ihn zu einem echten Ordner machen oder
security-check: offsetzen. - Neue Coding-Regelsätze werden übersprungen, solange
docs/project/coding_rules.mdnicht committete Änderungen hat (Schritt 6). Committen, dannpython .act/scripts/rules.py --add-new-codingausführen. - Befunde von
act-doctorundrules.py: Dateien unterdocs/ai/local/, deren Template-Datei weg ist, und Regeldateien, die eine eigene Kopie unterdocs/ai/local/rules/überschattet. Genanntes beheben. - Neue Schlüssel (§ Formats,
methods,cd-git,protected-watch…) haben ihren Standardwert, bis du ihre Zeile aus.act/skeleton/config.mdkopierst;/act-configändert nur vorhandene Zeilen. - Älter als v2.2.0: Ein solches Projekt wird nicht mehr aktualisiert;
update.pybricht ab und nenntact-adopt(siehe Bevor du anfängst). - Lange
[Unreleased]-Einträge:act-doctornennt die Einträge deinerCHANGELOG.mdüber 250 Zeichen. Sie kürzen oderchangelog-length: offindocs/ai/config.md§ Checks setzen. - Eine Quelle, die selbst ein eingerichtetes Projekt ist:
update.pyeinmal mit--source <Template-Adresse>ausführen, wie die Meldung es nennt (siehe Bevor du anfängst). - Copilot-Projekte: nach dem Update die Modelle in
.github/agents/mit/modelabgleichen, Abweichungen in die SpalteCopilotvondocs/ai/config.md§ Roles eintragen und dannpython .act/scripts/update.py --catch-up --yesausführen. - Skill-Overrides: jeder unter
docs/ai/local/skills/ist ein Befund vonact-doctor, bis du ihn mitpython .act/scripts/doctor.py --accept skill:<name>behältst oder löschst. .act-localals Link aus dem Projekt hinaus: ein Worker-Start mit einer ZeileWrite scope:oderTests:wird jetzt verweigert; einen gewöhnlichen Ordner daraus machen oderworker-write-scopeundworker-scope-overlapaufwarnsetzen.- Reasoning
noneindocs/ai/config.md§ Roles oder einer lokalen Rollen- oder Skill-Datei wird jetzt alsdefaultgelesen;act-doctornennt jede Stelle, dortdefaultschreiben. Die-high-Variante einer solchen Rolle läuft aufhigh.
Upgrade auf 2.5.0
Abschnitt betitelt „Upgrade auf 2.5.0“Von v2.4.0 aus wird act-update wie gewohnt ausgeführt, danach eine neue Sitzung gestartet.
- Zwei Migrationen laufen einmal:
005-resources-filelegtdocs/ai/local/resources.mdan und006-docs-project-readmedocs/project/README.md; keine überschreibt eine vorhandene Datei oder bringt eine gelöschte zurück. Eine bearbeitetedocs/ai/rules.mdbekommt die neue RegelR-docs-orderals Kästchenzeile; der eigene Text bleibt. - Config-Zeilen werden nicht ergänzt. Das Update fügt einer bestehenden
docs/ai/config.mdkeine Zeilen hinzu. Die neuen Schlüsseldone-entries,profile,exclude,docs-orderundown-rules-budgetgelten mit ihrem Standardwert, bis die Zeile unter ihrem Abschnitt ergänzt wird, kopiert aus.act/skeleton/config.md;/act-configändert nur vorhandene Zeilen.feedback: localist ein neuer Wert der vorhandenen Zeilefeedback(/act-config feedback local). - Erledigte Einträge werden unter Git gelöscht (
done-entriessteht dort standardmäßig aufdelete; siehe Erledigte Einträge). Das vorhandene Archiv bleibt, und der erste Sitzungsstart nennt die Zahl seiner Dateien;python .act/scripts/entries.py purge --all --planlistet es,purge --alllöscht es, wenn gewünscht. Das alte Verhalten behält, werdone-entries: keepunter § Archiv ergänzt. - Ohne
profileundexcludebleiben alle Skills, Rollen und Regeldateien wie bisher (full). docs-order:act-doctorprüft die Ordnung vondocs/project/(§ Checks, Standardwarn, nie blockierend). Gleich nach dem Update nennt er jede Datei und jeden Ordner, für die das neuedocs/project/README.mdkeine Zeile hat, und jeden Ordner mit fünf oder mehr Einträgen ohne eigeneREADME.md. Die Zeilen ergänzen (.act/scripts/move_doc.pyund der Schritt „Structure“ vonact-audit-docshelfen) oderdocs-order: offeintragen.- Eine vorhandene
docs/ai/inbox/README.mdwird nicht ersetzt; die RegelR-human-askträgt die neue Form einer Frage ohnehin, und.act/skeleton/inbox/README.mdhat den neuen Text, falls gewünscht. own-rules-budget:act-doctorwarnt (blockiert nie), wenn die Abschnitte „Own rules“ vondocs/ai/rules.mdunddocs/project/coding_rules.mdzusammen 6000 Zeichen überschreiten; der Schlüssel in § Checks hebt die Grenze an oder schaltet die Prüfung aus. Er prüft außerdem jede Einstellung mit fester Liste oder festem Format und kann einen Wert melden, den er früher übergangen hat. Ein Wert, der mit einem Backslash direkt vor dem nächsten|endet, braucht ein Leerzeichen vor dem|.workflow.js.txt: Überschreibt das Projekt das Script vonact-audit-docsunterdocs/ai/local/skills/act-audit-docs/workflow.js, ist diese Datei inworkflow.js.txtumzubenennen.- Optional: klickbare Entry-Ids werden einmal je Rechner mit
python .act/scripts/id_links_install.pyeingerichtet, und nach jedemact-updateerneut.
Upgrade auf 2.4.0
Abschnitt betitelt „Upgrade auf 2.4.0“Von v2.3.0 aus führst du act-update wie gewohnt aus und startest danach eine neue Sitzung, damit die neuen Hooks
greifen. Eine neue Migration gibt es nicht.
- Einstellungen, Rollen und Regelzeilen (Schritte 6 und 7): Das Update setzt
PYTHON_BASIC_REPL=1unterenvin.claude/settings.json, entfernt die-high-Varianten von sechs Rollen (ein Auftrag, der eine davon nannte, nennt die Rolle selbst oderbuilder-high/reviewer-high) und verschiebt in einer bearbeitetendocs/ai/rules.mddie Zeilen vonR-safe-no-secret-diff,R-safe-git-resetundR-safe-git-discardin den Block vonorchestrator/30-cost.md, Kreuze unverändert. - Der Sitzungstitel folgt dem Namen des Projekts (
session-name, Standardproject).session-name: autoüberlässt die Benennung Claude Code; einen mit/renameoderclaude -ngesetzten Titel überschreibt sie nie. - Worker mit einer Zeile
Write scope:können nicht mehr ins Temp-Verzeichnis des Systems oder in ihr Scratchpad schreiben. Ein Auftrag, der Wegwerfmaterial braucht, nennt.act-local/tmp/<task-id>-<slug>/**in seinem Scope. - Advisories sind an (siehe Advisories);
advisory-check: offindocs/ai/config.mdschaltet sie aus. act-local-tidymeldet beim ersten Lauf in einem Projekt nur (siehe oben);act-local-keepschützt deine eigenen Einträge unter.act-local/.act-version,act-export-settingsundact-load-settingsstarten nur noch, wenn du sie als Slash-Befehl tippst.archive-shortenwird nicht mehr gelesen und kann ausdocs/ai/config.mdraus. Sobald jedes Projekt auf dem Rechner aktualisiert ist, kann ein alter Ordneract-pycacheim Temp-Verzeichnis des Systems gelöscht werden.
Upgrade auf 2.3.0
Abschnitt betitelt „Upgrade auf 2.3.0“Von v2.2.0 aus führst du act-update wie gewohnt aus und startest danach eine neue Sitzung, damit die neuen Hooks und
Rollenfelder greifen. Eine neue Migration gibt es nicht.
- Der Update-Channel entscheidet, was das nächste
act-updatebringt (siehe Update-Channel). Ein Projekt ohneupdate-channelindocs/ai/config.mdfolgtreleaseund bekommt einmal einen Hinweis; mitupdate-channel: latestfolgt es weiter dem Standard-Branch. - Die Prüfung
outside-rootläuft alswarnin einem Projekt ohne ihre Zeile indocs/ai/config.md§ Checks. Ein einmaliger Hinweis beim Sitzungsstart sagt, wie du sie aufblockstellst; weitere erlaubte Orte kommen inoutside-root-allow. - Worker laden die Orchestrator-Regeln nicht mehr: Die Rollen der Vorlage bekommen
omitClaudeMd: trueund.claude/settings.jsondie Einträge fürSubagentStart(Schritt 7). Claude Code vor 2.1.271 ignoriert das Feld, Worker bekommen die Regeln dort doppelt, bis Claude Code aktualisiert ist.
Upgrade auf 2.2.0
Abschnitt betitelt „Upgrade auf 2.2.0“Von v2.1.0 aus führst du act-update wie gewohnt aus; mehr ist nicht nötig. --plan zeigt vorab, was geschieht.
- Migrationen
003und004verschieben den Kopf jedes Inbox-Eintrags (003) sowie jeder Aufgabe, jedes Backlog-Eintrags, Journal-Eintrags und archivierten Eintrags unterdocs/ai/work/(004) in ein YAML-Frontmatter zwischen zwei----Zeilen.docs/ai/work/archive/legacy/und jedeREADME.mdbleiben unverändert. Von Hand geschriebene Einträge in der alten Form funktionieren weiter. - Git 2.25 oder neuer ist für das Update nötig.
- Das Werkzeug
Artifactist aus nach dem Update.artifacts: onindocs/ai/config.mdbehält es. - Quick capture ist an: Eine Chat-Nachricht, die mit
todo:,note:oderidea:beginnt, legt ein Hook ohne Modell-Durchlauf ab.quick-capture: offindocs/ai/config.mdschaltet es aus.
Erledigte Einträge
Abschnitt betitelt „Erledigte Einträge“Der Config-Schlüssel done-entries ist abgeschafft. Eine erledigte Aufgabe, ein erledigter Backlog-Punkt oder Inbox-Eintrag wird immer von entries.py archive nach docs/ai/work/archive/ verschoben, wie es done-entries: keep tat; nichts wird dort gelöscht, und dasselbe gilt für eine Konzeptdatei, die entschieden oder gebaut ist (entries.py archive <path>). Nichts verlässt docs/, bevor es in seiner Monatsdatei steht: act-compact faltet die Einzeldateien später in Q-, T-, B-, U-<YYYY-MM>.md (Konzepte in other-<YYYY-MM>.md) mit einer Übersicht <YYYY-MM>.md, und Git hält weiter den vollen Text (siehe Archiv).
Ein Projekt, das delete hatte (der Standard unter Git), archiviert von nun an; Migration 008-done-entries-keep entfernt die Zeile done-entries, und eine zurückgebliebene Zeile wird ignoriert. Was eine ältere Version gelöscht hat, bleibt in der Git-Historie und wird nicht wiederhergestellt. entries.py purge gibt nur noch einen Hinweis aus (purge is retired) und endet mit 0, damit ein alter Aufruf nicht scheitert; die Optionen --plan und --all werden ignoriert, und ein übrig gebliebenes purge: after-commit in einer archivierten Datei bleibt, wie es ist.
Schutz vor Downgrade
Abschnitt betitelt „Schutz vor Downgrade“Ist der geholte Stand älter als der installierte, oder kennt die Quelle den installierten Commit nicht (zum Beispiel
ein lokaler Checkout mit ungepushten Commits), warnt --plan, und ein echter Lauf bricht ab, außer du gibst
--allow-downgrade an. Der übliche Ausweg ist --source <lokaler Template-Checkout>.
Deine eigenen Änderungen
Abschnitt betitelt „Deine eigenen Änderungen“.act/ wird ersetzt, bearbeite es also nie. Lege eine Projektfassung einer Regel, eines Skills oder einer Rolle
in docs/ai/local/<gleicher Pfad> ab; überschreibst du das Script workflow.js von act-audit-docs, benenne deine Datei in workflow.js.txt um (so heißt das Script des Templates jetzt, das Update entfernt das alte). Ein Update überschreibt diesen Ordner nie, ebenso wenig deine eigenen
Inhalte in docs/ai/ und docs/project/. Es frischt nur unbearbeitete erzeugte Dateien auf (etwa eine
unbearbeitete docs/ai/rules.md; eine vorhandene docs/ai/inbox/README.md wird nicht ersetzt, die Regel R-human-ask trägt die Form einer Frage), legt Befunde in der Inbox ab und führt Migrationen aus. Siehe
Schichten und Overrides.
Wenn .act/ auf anderem Weg ersetzt wurde
Abschnitt betitelt „Wenn .act/ auf anderem Weg ersetzt wurde“Nach einem einfachen git pull des Templates oder einer manuellen Kopie bemerkt ein normaler Lauf das und setzt
fort, statt „nothing to update“ zu melden. --catch-up beendet die späteren Schritte anhand des .act/ auf der
Platte ohne Abruf; es lehnt ab, wenn .act/ nicht mehr zu seiner eigenen MANIFEST.json passt.