Neues Projekt
Das Template holen
Abschnitt betitelt „Das Template holen“Klone das Template-Repository oder nutze auf GitHub Use this template, und öffne den Ordner dann in deinem Assistenten: Claude Code, Codex, GitHub Copilot, Cursor oder Gemini CLI. Du brauchst Python 3.9 oder neuer und Git 2.25 oder neuer; der Assistent prüft Python und erklärt die Installation, falls es fehlt.
Mit dem Assistenten: act-setup
Abschnitt betitelt „Mit dem Assistenten: act-setup“Was auch immer deine erste Nachricht ist, der Assistent startet den Skill act-setup. Er prüft, ob Python
vorhanden ist, fragt, wohin das Projekt kommt, zeigt den Plan und führt ihn aus. Zum Beispiel:
startErstelle hier im Verzeichnis ein neues Projekt.Erstelle ein neues Projekt in ../shop-api.Übernimm mein bestehendes Projekt in ~/dev/shop — es hat schon eine CLAUDE.md und eigene Doku.Jede Sprache funktioniert. Mit copilot in tools zeigt act-setup außerdem eine kurze Tabelle Rolle und Modell,
gelesen aus .github/agents/; gleiche sie in Copilot mit /model ab, trage eine Abweichung in die Spalte Copilot
von docs/ai/config.md § Roles ein (fehlt die Spalte im Tabellenkopf, ergänze sie) und führe dann
python .act/scripts/update.py --catch-up --yes aus. Es gibt drei Wege:
- Genau hier. Der Klon wird zum Projekt. Der Remote
originwird entfernt, wenn er auf das Template-Repository zeigt, und das Projekt startet auf einem frischenmainohne die Historie des Templates. Spätere Updates des Templates kommen nur überact-update. - Woanders. Ein leerer oder fehlender Ordner wird direkt mit
--targeteingerichtet. Der Ordner muss außerhalb des Projekts liegen, von dem aus gestartet wird (nicht das Projekt selbst, nicht ein Ordner darin, auch nicht über Symlink oder Junction);init.pyverweigert das und legt nichts an. - Ein bestehendes Projekt. Ein Ordner, der schon ein Projekt enthält — eigene Doku, eine
CLAUDE.md, ein älteres KI-Setup —, wird mitact-adoptübernommen. Der Assistent sichtet jede Quelle für Doku und KI-Werkzeuge, schlägt je Quelle eine Aktion vor, wartet, bis du die Tabelle einmal freigibst, und zieht das Material dann auf einem Branchact-adoptum, ohne es zu committen. Die Schritte stehen unter Bestehendes Projekt.
Läuft das Template in einem Projekt schon, startet /act-adopt dort das nächste Projekt oder übernimmt von dort aus ein
anderes und kann dessen eigene Skills, Regeln, Ausnahmen, Overrides, Topics und Agents mitnehmen (--carry); siehe
Bestehendes Projekt. Danach schlägt der
Assistent act-update im neuen Projekt vor, denn es hat das .act/ des Projekts bekommen, aus dem es kam. Seine Template-Quelle stammt nur dann aus der Lock-Datei jenes Projekts, wenn sie eine Remote-Adresse ist;
sonst gilt die veröffentlichte Template-Adresse.
Vor dem Lauf fragt der Assistent einmal, ob eine Arbeitsmethode an sein soll (test-first, spec-first,
simple-changes; Standard keine), und gibt die Antwort als --methods weiter. Die Zeile methods in docs/ai/config.md
§ Scope ändert sie jederzeit.
Der Assistent führt die Befehle selbst aus. Er hat kein Terminal, in dem er dir Fragen stellen könnte, also
übernimmt init.py die Standardwerte und schreibt jeden offenen Punkt (Name, Owner, Stack, Werkzeuge) in die
Inbox. Du gehst diese Notiz mit dem Assistenten durch, und die Antworten kommen in docs/ai/config.md. Ohne Antwort steht feedback auf confirm: Jede Nachricht an den
Template-Autor wird gezeigt und erst nach deinem Ja gesendet. off ist mit einer Änderung in docs/ai/config.md gesetzt, ebenso local: Es wird nie etwas gesendet, Funde werden zu Backlog-Einträgen im Projekt. /act-config feedback local setzt es ohne Modell-Durchlauf; /act-config allein listet alle Einstellungen.
Von Hand: init.py
Abschnitt betitelt „Von Hand: init.py“Die Einrichtung braucht keine KI. In einem Terminal fragt init.py nach Name, Owner, Stack, Lint- und
Testbefehlen, Werkzeugen und Sprachen:
python .act/scripts/init.py --plan # show what would happen, change nothingpython .act/scripts/init.py # turn this clone into the projectpython .act/scripts/init.py --target ../my-project # set up a new, empty folder insteadpython .act/scripts/init.py --non-interactive # no questions: defaults, open points to the inboxNützliche Optionen: --language-docs <code> (Sprache von docs/, Standard en), --language-chat <code|auto>,
--update-channel <release|latest> (was act-update verfolgt, siehe Update; init fragt, wenn du es weglässt), --methods <Namen|none> (Arbeitsmethoden, die an sein sollen; init fragt, wenn du es weglässt), --carry <Liste> (mit --target, aus einem Projekt gestartet: was von dort mitkommt: skills, rules, exceptions, overrides, topics, agents; Standard alles), --no-commit. Alle Optionen stehen in der Scripts-Referenz.
Bei einem bestehenden Projekt überschreibt init.py --target <dir> nie eine Datei. Es ergänzt .act/ und alles,
was fehlt, hängt seine eigenen Blöcke an .gitignore/.gitattributes an, führt seine Hook-Einträge in
.claude/settings.json zusammen und lässt jede andere Datei genau so, wie sie ist — auch eine vorhandene
CLAUDE.md, der dann noch der Import der Regeln fehlt. Was aus der eigenen Doku und den KI-Dateien des Projekts
werden soll, ist eine Einzelfallentscheidung je Datei, und die braucht einen Assistenten:
act-adopt.
Was init tut
Abschnitt betitelt „Was init tut“Zehn feste Schritte, jeder ausgegeben als [n/10]:
- Sammelt die Einstellungen: Name, Owner, Sprachen, Stack, Befehle, Werkzeuge, Modus, Feedback, Update-Channel (
releaseoderlatest, geschrieben nachdocs/ai/config.md§ Update), Arbeitsmethoden (methods, Standardnone) und das Scope-Profil (profilein § Scope:fullfür ein Web-Projekt, sonststandard, aus dem Stack bestimmt;--scopesetzt es). Es weist darauf hin, wenn der Klon schon über dem neuesten Release liegt. - Klärt Git: im Klon entfernt es
originund bautmainneu auf; mit--targetführt es bei Bedarfgit initaus. - Prüft deine Git-Identität.
- Schreibt deine Workspace-Identität (auch wenn
.act-local/identity.jsonexistiert, aberidentityfehlt) und den lokalen Import-Ordner.act-local/import/. - Dünnt die Brücken auf die gewählten Werkzeuge aus.
- Schreibt das Gerüst:
docs/ai/(config.md,rules.md,concept/, Inbox, Arbeitsordner),docs/project/coding_rules.md,docs/project/glossary.md,docs/project/README.md(der Index der Projektdoku, eine Zeile je Datei),docs/ai/local/resources.md,docs/README.md, die Brückendateien, Skill-Kopien und die Hook-Einträge in.claude/settings.json(mit"enableArtifact": false, außer beiartifacts: on, undPYTHON_BASIC_REPL=1unterenv, damit unter Windows ein leeres Heredoc in einem Bash-Aufruf unter Python 3.13 und neuer nicht hängt). Skill-Kopien und Rollen-Brücken, dieprofileoderexcludeindocs/ai/config.md§ Scope auslassen, werden nicht geschrieben. - Hängt Blöcke des Templates an
.gitattributesund.gitignorean und hält.act-local/aus den Indizes der IDEs heraus (excludeFolderin.idea/*.iml,files.watcherExcludein.vscode/settings.json, wo.vscode/existiert). - Nur im Klon: legt die eigenen Dateien des Templates still: README (die neue folgt dem Layout
readme-formataus Formats, standardmäßigstandard),CHANGELOG.mdund die Community-Dateien unter.github/(Beitragshinweise, Sicherheit, Verhaltenskodex, Barrierefreiheit, Vorlagen für Issues und Pull Requests), und fragt, ob seine LICENSE bleibt. Im Klon wie mit--targetlegt es dann das eigeneCHANGELOG.mddes Projekts mit einem leeren Abschnitt## [Unreleased]an, außerchangelogin § Formats steht aufrelease-notes-onlyoderoffoder das Projekt führt schon ein Changelog unter anderem Namen; eine vorhandene Datei wird nie überschrieben. - Schreibt
.act-lock.json(die festgehaltene Quelle und Version des Templates) und.act/MANIFEST.json. - Macht den ersten Commit. Er nimmt nur die Pfade mit, die dieser Lauf geschrieben hat; anderes, das im Ziel schon gestaged ist, bleibt gestaged und wird in der Ausgabe genannt. Ein Pfad, den die
.gitignoredes Ziels ignoriert (eine Allowlist wie*,!docs/), bleibt aus dem Commit heraus, der ihn nennt; eine ignorierteCHANGELOG.mdwird nicht angelegt.
init.py überschreibt nie eine Datei, die das Projekt schon hat. Eine Frage ohne Eingabe nimmt ihren angezeigten Standardwert. Eine language-docs außer Englisch lässt das
Gerüst auf Englisch. act-setup übersetzt es im selben Lauf; nach einem einfachen init.py bittet eine Inbox-Notiz den
Assistenten, es einmal zu übersetzen;
gängige englische Fachbegriffe (Skill, Inbox, Hook, Branch …) bleiben stehen, vor allem in Überschriften.
Deine erste Sitzung
Abschnitt betitelt „Deine erste Sitzung“Öffne das Projekt in deinem Assistenten und sag weiter. Der Assistent liest das Board und die Inbox. Fang
mit den init-Notizen in docs/ai/inbox/ an, und probiere dann eine Idee (Idee: die Bestellungen als CSV exportieren),
einen Fehler (Bug: Login scheitert an einem Umlaut) oder Welche Skills gibt es?. Die Einstellungen stehen in docs/ai/config.md.