Nachdem ein ADR, eine Spec, ein Epic, eine Story oder ein Design geschrieben oder geändert wurde
Sucht nach Schwachstellen, prüft jede Behauptung an der Quelle und fragt, wie der Plan scheitern könnte. Keine Schmeichelei.
opus · max.projectstore / Methode / 1
Eine Schleife mit einer unabhängigen Prüfung darin.
Agenten schreiben schnell Code, und sie entscheiden Geklärtes genauso schnell neu: Jede frische Sitzung beginnt leer. Die Lösung ist kein klügerer Agent, sondern Kontext sammeln → handeln → prüfen, angewandt auf das Projekt und nicht nur auf den Code.
Die Schleife
Acht Schritte. Zwei davon sind Prüfungen durch einen Agenten, der den Entwurf nicht geschrieben hat.
- 01Du sagst, was du willst. Der Agent öffnet ein Artefakt, bevor er einen Editor öffnet.
- 02Ein ADR, wenn etwas entschieden werden muss, ein Epic mit Stories für die Arbeit, eine Spec, wenn das „Wie“ nicht offensichtlich ist. Erst als Vorschau gezeigt, dann nach deinem Ja geschrieben.
- 03Ein Critic mit frischem Kontext, der am Entwurf nichts zu verlieren hat, greift ihn an. Rechne mit einem „überarbeiten“.
- 04Du gibst die Fixes frei. Das Artefakt wird als reviewt markiert und landet im Backlog.
- 05Ein Agent übernimmt eine Story. Der Planner liest, wie frühere Epics im Code gelandet sind, und sagt, wo diese Änderung hingehört.
- 06Code und Tests, nach dem Plan der Story.
- 07Ein Reviewer mit frischem Kontext prüft den Diff gegen jedes Abnahmekriterium und verlangt einen Nachweis.
- 08Fertig, mit Nachweis unter jedem Kriterium. Board, Link-Map und Code-Map werden neu aufgebaut.
Die Agenten
6 Agenten. Alle bis auf einen dürfen nur lesen.
Die Berater prüfen, planen und räumen auf, ohne etwas zu ändern. Ein einziger Clerk speichert nach deinem Ja nur das, was du freigegeben hast.
Bevor die Arbeit an einer Story beginnt (story plan)
Schaut, wo frühere Epics im Code liegen. Sagt, wo die Änderung hingehört, was sich wiederverwenden lässt, worauf zu achten ist und in welcher Reihenfolge gearbeitet wird.
opus · maxWenn der Code steht, vor dem Commit oder story close
Verlangt einen Nachweis für jedes Abnahmekriterium, auch für die der Spec. Prüft dann Korrektheit, Regressionen und Tests.
opus · maxAb und zu, vor Releases, wenn der Vault schnell wächst
Findet, was keine Regel erkennt: Research-Notizen, die einem akzeptierten ADR widersprechen, Duplikate, fehlende Links, Dateien, die ins Archiv können.
opus · maxEinmal, nach dem Binden einer bestehenden Codebasis
Findet Entscheidungen, die niemand aufgeschrieben hat: im Code, in Konfigurationsdateien und in der Git-Historie. Schlägt dafür ADRs vor, mit Nachweisen.
opus · maxNur innerhalb eines Befehlsablaufs, nur nach deinem Ja
Speichert genau das, was du freigegeben hast, nicht mehr. Baut danach das Board neu auf und führt die Prüfungen aus. Schreibt nichts Eigenes und fragt nichts.
sonnet · maxDie Standardmodelle gelten für Claude Code. In Codex ist jede Rolle ein gleichnamiger Skill, der Codex bittet, die Rolle zu starten, etwa $projectstore-critic für den Critic; er nutzt das Modell der Sitzung, solange du keines festlegst.
Die Schutzmechanismen
Mechanismen halten es zusammen, nicht Disziplin.
Keine Story, ein Stups
Ein Agent, der Code zu bearbeiten beginnt, ohne dass eine Story offen ist, wird daran erinnert, eine zu öffnen. Eine Änderung in Feature-Größe beginnt im Vault.
Was nicht reviewt ist, bleibt markiert
Ein Artefakt, das ein Review braucht, trägt review_status: pending, bis ein Critic-Durchgang eingearbeitet ist. „Noch nicht reviewt“ ist ein Zustand, den die Werkzeuge lesen können, nichts, woran sich jemand erinnern muss.
Ein Doctor ohne KI
doctor prüft die mechanische Konsistenz des Vaults deterministisch. In der CI läuft er ohne Agent und ohne Tokens.
Wo man nachschaut, generiert
graph.md hält die Links jedes Artefakts in beiden Richtungen fest; code-map.md sagt, wo der Code jedes Epics liegt. Vor einer Architekturentscheidung wird der Agent zuerst auf den ADR-Index verwiesen.
Nach /compact kommt der Vault zurück
Nach einem /compact, das du ausführst, beginnt die Sitzung in Claude Code wieder mit der Orientierung des Vaults und mit den Vault-Dateien, die das Gespräch zuvor berührt hat.
Eine zweite Sitzung wird gewarnt
Eine Sitzung, die startet, während eine andere am selben Vault arbeitet, beginnt mit einer Multi-Session-Warnung: erst suchen, bevor etwas Neues entsteht.
Fertig heißt bewiesen
Eine Story schließt mit Nachweis unter jedem Kriterium.
--- type: story epic: "CHECKOUT" title: "Gespeicherte Karten werden im Checkout aufgelistet" status: done code_refs: ["src/billing/cards/", "tests/cards.test.ts"] closed_at: "2026-07-14T16:02:11Z" --- ## Abnahmekriterien - [x] Gespeicherte Karten stehen an erster Stelle — Nachweis: tests/cards.test.ts:21 - [x] Eine abgelehnte Karte zeigt den Grund der Bank — Nachweis: tests/cards.test.ts:58 - [x] Keine Kartennummer gelangt in die Logs — Nachweis: tests/cards.test.ts:73
Der Planner hat vor dem Code gesagt, wo die Änderung hingehört, und der Plan ging mit deinem Ja in die Story; danach hat der Reviewer den Diff gegen jedes Kriterium geprüft. Jede Zeile Nachweis ist ein Test, ein ausgeführter Befehl oder eine Codezeile.
Jeder Agent kann diese Akte lesen, mit oder ohne Plugin: über die CLI, die mit JSON antwortet und keine Tokens braucht, oder über die 8 schreibgeschützten Tools des MCP-Servers.
- orientation
- search
- status
- get_artifact
- lineage
- neighbors
- code_refs
- doctor
Kleingedrucktes
Kleingedrucktes
- Die Schleife zu betreiben kostet Tokens: Die Entwürfe, der Critic und der Reviewer laufen auf dem Modell, das du ohnehin bezahlst. Das README misst es.
- Critic und Reviewer sind in Claude Code getrennte Agenten mit frischem Kontext. In Codex sind die Rollen Skills.
- ProjectStore ist geteilter Projektkontext und eine Arbeitsweise. Es ist kein Agenten-Orchestrator: Agenten zu starten ist Aufgabe deines Harness.