Zum Inhalt springen

Einführung

Das Agentic-Coding-Template, kurz act, ist ein Satz von Dateien, den du in ein Projekt legst, damit dein KI-Coding-Assistent nach einer festen, nachprüfbaren Methode arbeitet. Es enthält Regeln, Skills, Rollen für Sub-Agenten, Hooks und Scripts. Es funktioniert in einem neuen und in einem bereits bestehenden Projekt.

  • Eine Arbeitsteilung. Du setzt Ziele und entscheidest. Der Hauptassistent, der Orchestrator, plant, prüft und committet. Er gibt abgegrenzte Aufträge an spezialisierte Worker. Siehe Rollen.
  • Ein Vorgehen mit Belegen. Eine Idee bekommt ein Konzept mit Optionen, bevor sie gebaut wird. Ein Ergebnis gilt nur als fertig, wenn ein Testlauf, ein Commit oder ein Aufruf nach außen es belegt.
  • Der Stand im Repository. Aufgaben, Backlog, Fragen, Inbox und Journal liegen in docs/ai/, sodass jede Sitzung am Board weitermachen kann. Eine Chat-Nachricht, die mit todo:, note: oder idea: beginnt, legt ein Hook ohne Modell-Durchlauf ab, und /act-config zeigt und setzt die Einstellungen in docs/ai/config.md auf dieselbe Weise.
  • Wiederkehrende Arbeit als Skills. Ein Skill ist eine schlichte SKILL.md, der jeder Assistent folgen kann, zum Beispiel act-bug, act-commit, act-release. /act <name> zeigt die Anweisungen eines Skills der Vorlage vollständig an, mit oder ohne das Präfix act- (/act version zeigt act-version); act-version, act-info (in welchem Projekt eine Sitzung arbeitet, und dessen Stand), act-export-settings und act-load-settings starten nur als eingetippter Slash-Befehl. Ein Hook beantwortet /act-info und /act-version selbst, ohne Modellrunde; /act-version gibt drei Zeilen aus, --all die vollständige Liste der Releases. Siehe die Skills-Referenz.
  • Text in deinem Format. Die Commit-Nachricht, das Changelog, die Release Notes und die README folgen einem Format, das sich je Projekt wählen oder ersetzen lässt (act-commit und act-release lesen es, act-export-settings --with-formats trägt es in ein anderes Projekt), und optionale Arbeitsmethoden wie Test-first fügen Regeln dafür hinzu, wie der Assistent arbeitet. Siehe Formats und Scope.

Für Teams und einzelne Entwickler, deren Projekt länger lebt als eine Sitzung: Arbeit wird zwischen Sitzungen oder Personen übergeben, bestehender Code wird geändert, oder ein Fehler wie ein offengelegtes Geheimnis wäre teuer.

  • Kein Framework und keine Bibliothek. Nichts davon landet in deinem Build oder zur Laufzeit.
  • Nicht kostenlos. Die Regeln werden zu Beginn jeder Sitzung geladen, mit einem Coding-Regelsatz etwa 7.000 bis 8.000 Tokens, und für jeden Sub-Agenten etwa halb so viel, weil er die Orchestrator-Regeln auslässt. Der Assistent leistet auch mehr pro Aufgabe: Tests als Beleg, ein Review, einen Journaleintrag. Für ein einmaliges Script oder einen Wegwerf-Prototyp kostet das mehr, als es bringt.
  • Keine Garantie in jedem Werkzeug. Mechanische Durchsetzung über Hooks gibt es nur in Claude Code (siehe unten).

Ein Projekt hat zwei Schichten, die sich nie vermischen.

Schicht Wo Wem sie gehört
Template .act/ Dem Template. Wird bei einem Update als Ganzes ersetzt, nie im Projekt bearbeitet.
Projekt docs/ai/ (Arbeitsstand), docs/project/ (deine Dokumentation) Dir. Ein Update überschreibt deine Inhalte nie.

Drumherum liegen die kleinen Dateien, die jedes Werkzeug liest (CLAUDE.md, AGENTS.md, .claude/, .agents/skills/), und .act-local/, das auf deinem Rechner bleibt. Eine Projektfassung einer Datei des Templates kommt nach docs/ai/local/<gleicher Pfad> und gewinnt. Details: Schichten und Overrides.

Werkzeug Liest Was es bekommt
Claude Code CLAUDE.md, .claude/ Alles: Regeln per Import, Skills per Name, Sub-Agenten-Rollen mit Modell- und Effort-Stufe, Hooks, eine Statuszeile, das Board beim Sitzungsstart.
Codex, GitHub Copilot, Cursor AGENTS.md, .agents/skills/; Copilot auch .github/agents/ Regeln und Skills als Anweisungen. Keine Hooks, also wird nichts mechanisch durchgesetzt. Mit copilot in tools bekommt Copilot zusätzlich die Rollen als Dateien unter .github/agents/; Codex und Cursor haben keine Sub-Agenten-Rollen.
Gemini CLI GEMINI.md, .agents/skills/ Die Skills. Ein Projekt hat noch keine GEMINI.md, also richte Gemini CLI in den Einstellungen auf AGENTS.md.
Jeder andere Assistent keine Sag ihm, er soll docs/ai/rules.md lesen. Jeder Skill ist eine schlichte SKILL.md.

Welche Werkzeuge im Einsatz sind, steht im Schlüssel tools in docs/ai/config.md, Standard claude-code. Jedes Projekt bekommt AGENTS.md und die Skill-Kopien unter .agents/skills/.

Python 3.9 oder neuer, nur Standardbibliothek, für die Einrichtung, die Scripts und die Hooks, dazu Git 2.25 oder neuer. Weiter mit: ein neues Projekt starten oder ein bestehendes übernehmen.