Workflows

Sechs Arbeitsweisen von der Installation bis zum Vorhaben. Regeln, Skill-Trigger und Hooks leiten die Aufgabe; jeder Weg endet in einer Prüfung. Direkte Arbeit ist der Standard; eine Spec verdient sich über Größe — mehr als 5 Schritte oder mehr als 6 Dateien über 2+ Subsysteme —, eine größere Übergabe, eine offene Entscheidung oder deinen Wunsch.

Autopilot behandelt getippte und transkribierte Wünsche gleich, erklärt Direktarbeit, Delegate oder Wave und nennt Harness, Anbieter, Modell und nächsten Schritt. Mehr unter Smart Routing.

Onboarding

Einmal pro Maschine und Projekt: devkit install → devkit sync → devkit init → /index.

Schritt	Ergebnis
devkit install	Verdrahtet den Session-Hook und führt den ersten Sync aus.
devkit sync	Lädt und prüft das Release, verlinkt Skills, Agents, Rules und Hooks, installiert die nötigen Tools.
devkit init	Richtet den Projekt-Checkout ein: Agent-State-Caches in .gitignore, Code-Graph, angelegtes .agents/context/; ein älteres Setup wird aktualisiert.
/index	Wendet nach einem Ja an, was devkit init offen hat, hält dann .agents/context/ auf das beschränkt, was nicht im Code steht, und korrigiert darin veraltete Angaben, kaputte Pfade und zu lange Decision-Einträge. Nach jedem devkit-Update ausführen; Ergebnis fürs Team committen.

devkit status und devkit doctor bestätigen das Setup. Neues Projekt: /vision legt den Nordstern in .agents/context/VISION.md fest; /spec, /brainstorm und /challenge prüfen dagegen.

Tagesarbeit

Für Arbeit unter den Spec-Schwellen, ohne offene Anforderung oder ausdrücklichen Planwunsch: beschreiben → bearbeiten → /test → /review → /commit. Der Agent startet /test nach einer zusammenhängenden Änderung und /review --quick bei mehreren Quelldateien oder riskanten Pfaden. Du startest /commit; Risiko allein verlangt keine Spec.

Skill	Was passiert
/test	Führt die gezielten Tests aus; die volle Suite nur auf Anfrage, bei hohem Risiko oder geänderter geteilter Test-Infrastruktur.
/review	Unabhängiges, nur lesendes Review des aktuellen Diffs; nennt /spec und stoppt, wenn der Diff einen Vertrag braucht.
/commit	Staged nur die Dateien dieser Session; ein gitleaks-Fund oder ein gestagter Agent-State-Pfad bricht ab.
/release	CHANGELOG ergänzen, Version heben, Tag pushen, GitHub-Release anlegen.

Feature

Für mehr als 5 Schritte oder mehr als 6 Dateien über 2+ Teilsysteme, eine größere Übergabe an eine andere Session, eine offene Entscheidung, die du zuerst treffen musst, oder einen schriftlichen Plan: /spec → /spec-work → /commit → PR. Kleines für später wird ein Todo für /todo, keine Spec. Specs und Todos erklärt beides.

Schritt	Du	Der Agent
/spec	Beschreibst das Ergebnis und korrigierst die Zusammenfassung. Der Start von /spec-work ist die Freigabe. Sie nennt den Pfad und endet mit /clear, dann /spec-work <ID> für eine frische Session.	Schreibt Ziel, Schritte, Dateien und Prüfungen. Riskante oder systemübergreifende Arbeit bekommt einen volleren Plan mit Modell-Review.
/spec-work	Beantwortest Entscheidungsfragen.	Ein frischer Agent setzt die Schritte um und prüft sie; danach übergibt die Hauptsession an einen unabhängigen Reviewer.
Außerhalb des Plans	Liest den erweiterten Plan.	/spec-update öffnet betroffene Schritte und Abhängigkeiten. Nach completed sind Nachkorrekturen Inline-Arbeit.
Unterbrochen	Sagst wieder /spec-work <ID>.	Macht beim ersten offenen Schritt weiter.

Vorhaben

Für Arbeit, die zu groß für eine Spec ist — mindestens drei Specs, ein externer Anbieter oder eine Änderung über Systemgrenzen — planst du einen Slice, schließt ihn ab und planst dann den nächsten: /brainstorm → /spec → /spec-work → nächster Slice.

Skill	Wann
/brainstorm	Die Richtung ist offen. Endet mit dem nächsten kleinen Slice oder einem lebenden Plan, Zeile für Zeile.
/challenge	Du willst zuerst die Gegenargumente hören.
/wave	Mehrere Slices sind freigegeben und berühren verschiedene Dateien: läuft sie parallel in eigenen Worktrees, jeder mit eigenem Review.
/workspace	Die Arbeit verteilt sich auf Geschwister-Repositories unter einem Ordner: eine Spec pro Repository, in Reihenfolge.
/delegate	Ein abgegrenztes Review, eine Recherche oder Umsetzung profitiert von einem anderen Modell. Umsetzungen kommen automatisch zurück; ein Restpfad bleibt im Worktree, devkit worktree-gc --apply räumt gemergte weg.

Wissen und Kontext

Laufend, damit keine Session das Projekt neu lernt.

Bedarf	Aktion
Gotcha, Konvention oder Entscheidung	/capture schreibt es nach .agents/context/; kritische Gotchas bekommen einen Prompt-Trigger.
Verwandtes Repo (Backend, Boilerplate, Contract-Partner)	/capture als Related → .agents/context/RELATED.md; ein Prompt-Hinweis erinnert daran.
Offene Arbeit	Agent bietet ein Todo an, ab ~30 Tool-Calls legt er es an; /todo arbeitet es ab.
Frage zur Vergangenheit	Memory-Recall, dann memsearch, falls installiert.
Verdacht auf Drift	devkit context-drift-check meldet kaputte Verweise.

Wartung

Nichts zu tun: Jeder Session-Start aktiviert ein Update, das im Hintergrund geprüft wurde. devkit sync aktualisiert sofort, devkit doctor diagnostiziert, devkit rollback geht zurück — mehr unter So funktioniert es und Troubleshooting.