Baue ein Feature als eine Abfolge von Gates. Jeder Schritt produziert ein kleines Artefakt und stoppt dann an einem Gate, das du – der Mensch – freigibst, bevor der nächste Schritt beginnt. Der Agent öffnet niemals selbst ein Gate. Ein Agent, der seine eigenen Schritte zertifiziert, reduziert die gesamte Methode wieder auf gewöhnliche Slop-Generierung; die Gates sind die Methode.
Die Planung ist erst abgeschlossen, wenn die Implementierung mechanisch geworden ist – das Feature nur aus den Artefakten heraus erstellbar ist, ohne irgendwo anders hinzugehen. Wenn das nicht möglich ist, war ein früheres Artefakt falsch: Gehe zurück und korrigiere es, bevor du weitermachst.
So wird es ausgeführt
Ein Schritt pro Runde. Produziere das Artefakt des Schritts, präsentiere es und stoppe am Gate. Beginne nicht mit dem nächsten Schritt, bis du ein explizites weiter hörst. Wenn du es nicht gehört hast, befindest du dich noch im aktuellen Schritt.
Verdient dies die Gates?
Triage vor dem Start – die Methode ist auf mittlere, strukturelle Änderungen abgestimmt:
- Überspringe es – eine einzeilige Korrektur, eine mechanische Bearbeitung, eine Dokumentationsanpassung. Sage das und stoppe; die Gates werden ihre Kosten nicht rechtfertigen.
- Zerlege es zuerst – ein Meilenstein, ein Epic oder ein vages Ziel. Die Methode passt zu einer mittleren strukturellen Änderung, nicht zu einem Arbeitsprogramm. Teile es auf und wende die Methode auf ein einzelnes Kind an. Recherche, bei der das Design die Lieferung ist, qualifiziert nicht – man kann nicht mechanisch planen, was man noch entdeckt.
- Führe es aus – ein falsches Design wäre teuer, aber die Änderung ist klein genug, dass die Gates es nicht ersticken.
Lege den Artefakt-Speicherort fest
Entscheide vor Schritt 0, wo die Schritt-Artefakte in diesem Repository leben (z. B. docs/handoffs/<feature>/) und benenne es – unbenannt improvisieren sie ihren eigenen Speicherort. Binde deinen Tracker an das Wort des Prüfers: Ein Schritt ist abgeschlossen, wenn der Mensch sein Gate freigibt, niemals wenn das Artefakt bloß erscheint.
Die Schritte
- 0 – Recherche & Planung. Lese den Code und die Randbedingungen. Produziere: Umfang, Modulplatzierung, Teststrategie, die offenen Fragen für den Menschen und die Stil-Frage – passt der Artefakt-Stil zum Hausstil? Falsche Designs sterben hier am günstigsten. Gate.
- 1 – Datenstrukturen. Die Typen und sonst nichts. Gate.
- 2 – Schnittstellen. Signaturen und sonst nichts – eine reine Funktion pro Verhaltenseinheit, wo es die Domäne erlaubt. Jeder Parameter, der ein Laufzeit-Handle ist – eine Live-Ressource, die die Signatur empfängt statt konstruiert – muss benennen, wer die echte Instanz in der echten Umgebung baut, oder er wird als offene Nahtstelle markiert: Eine injizierte Abhängigkeit wirkt sauber, gerade weil sie diese Frage verschiebt, also erreicht keine nicht bereitgestellte Abhängigkeit unmarkiert einen späteren Schritt. Gate.
- 3 – To-dos. Platziere einen wörtlichen Marker (einen
TODO-Kommentar) im Quellcode an jeder Stelle, an der sich Code ändern wird – aufgezählt, nicht beschrieben. Eine Liste in einem Planungsdokument erfüllt diesen Schritt nicht: Die Marker leben im Code, damit Schritt 4 direkt auf ihnen implementieren kann, und ihre Abwesenheit ist grep-bar. Jede Stelle, oder der Schritt ist nicht erledigt. Gate. - 4 – Recon: Mocken, Ausführen, Zurücksetzen, Berichten. Implementiere auf Basis der To-dos, führe gegen echte Daten aus, dann setze alles zurück und behalte nur einen Bericht darüber, wo der Plan gescheitert ist. Die Ausgabe sind Informationen, kein Code, und der Bericht erhält dasselbe Gate wie jedes Artefakt. Prüfe die Technik, nicht nur das Design: Trage den tatsächlichen Mechanismus des Mocks in den Bericht ein – ein Plan kann eine plausible, aber falsche Technik benennen, die trotzdem zu den Schnittstellen passt, also zeigt erst ein echter Versuch den Mechanismus, der am einfachsten und richtig ist. Führe den gesamten Pfad aus, nicht einen Korb von Sonden: Starte den echten Lauf am wahren Eingang und verwende die echte Komponente an jedem Schritt – eine manuell gelieferte Zwischenstufe ist kein Shortcut, sondern eine rote Flagge, die eine ungeprüfte Nahtstelle markiert, und ein gezielter Satz Sonden kann nur die Risiken widerlegen, die du zu nennen wusstest, während ein End-to-End-Lauf nicht um Erlaubnis von deinen Annahmen bittet. Ein Teil, das wie besehen in einer neuen Laufzeit oder einem neuen Kontext wiederverwendet wird, ist ein Recon-Ziel, keine Selbstverständlichkeit – „unverändert“ gilt nur in der Umgebung, für die es gebaut wurde. Recon läuft auf echten Daten und echten Datenlecks: Der Bericht enthält Aggregate und Struktur, niemals Identitäten oder echten Inhalt. Gate.
- 5 – Invarianten. Du formulierst sie; der Agent verdrahtet und erzwingt sie nur – die Autorenschaft kann nicht delegiert werden, denn eine Invariante ist ein vorab vereinbarter Richterspruch für einen zukünftigen Streit. Gib der Durchsetzung denselben adversariellen Pass wie den Regeln, die sie überwacht: Eine Prüfung, die falsch-positiv werden kann, untergräbt das Gesetz, das sie durchsetzt. Gate.
- 6 – Implementieren. Mechanisch, wenn die früheren Schritte ihre Arbeit getan haben – Tippen, nicht Entscheiden. Ein Designentscheid, der hier auftaucht, ist ein Fehler in einem früheren Artefakt: Stoppe und gehe zurück. Bevor du implementierst, lege dem Menschen die Kalt/Warm-Gabelung als erforderliche Gate-Entscheidung vor – nimm sie niemals an: Kalt übergibt Schritt 6 an einen frischen Kontext (eine neue Sitzung oder einen Subagenten), der nur die Schritt-Artefakte + Invarianten-Prüfungen mitnimmt, sodass die Artefakte allein den Build treiben und die Methode selbst validiert wird; Warm implementiert im aktuellen Kontext, in Ordnung wenn du nur ausliefern willst. Abgeschlossen, wenn die Invarianten aus Schritt 5 gelten. Gate.
- 7 – Fertig-Zustand auf Live-Daten. Liefere nur aus, wenn alle drei gelten: Die Invarianten gelten in der Produktion, das Feature tut etwas Reales, was kein vorhandenes Tool konnte, und es existiert ein begleitendes Artefakt (ein Runbook oder eine Ship-Checkliste, die an diesem Gate gelesen wird). Fixtures kodieren deine Vorstellungskraft; Live-Daten kodieren die Realität. Gate.
Liefergegenstände
Übergebe jedem Gate etwas Überprüfbares – einen Diff, ein grep, eine Datei – keine Prosa, die die Arbeit nur beschreibt; ein verifizierbares Artefakt macht seine eigene Abwesenheit offensichtlich. Die Form des Artefakts unterscheidet sich je nach Schritt, also setze nicht jeden Schritt standardmäßig auf ein Planungsdokument:
0 ein Plan · 1 die Typen · 2 die Signaturen · 3 TODO-Marker im Quellcode (grep-bar) · 4 ein Bericht, Code zurückgesetzt · 5 die Invariante + ihre Prüfung im Code · 6 die Implementierung · 7 Live-Verhalten + ein Runbook.
Ein Schritt, dessen Artefakt im Code lebt (3, 4, 6), wird nicht durch ein Dokument darüber erfüllt. Wenn du nicht auf das Artefakt zeigen und es prüfen kannst, ist der Schritt nicht erledigt.
Fehlermodi
- Abstempel-Gate – ein Gate, das ohne Aufmerksamkeit geprüft wird, vermittelt das Gefühl von Eigenverantwortung ohne Substanz. Die Gatedichte sollte der Irreversibilität folgen: Klappe Gates über billige, wiederholbare Artefakte zusammen, aber klappe niemals Recherche (0), Recon (4) oder den Fertig-Zustand (7) zusammen.
- Zum Diff hetzen – zu Schritt 6 eilen, während ein früherer Schritt noch offen ist. Einen späteren Schritt zu sehen ist keine Erlaubnis, ihn zu beginnen; jeder Schritt produziert nur sein eigenes Artefakt.
- Selbstzertifizieren – der Agent erklärt ein Gate für geöffnet. Nur der Mensch öffnet ein Gate.
- Der ausgelieferten Hälfte vertrauen – ein Teil wiederverwenden, das bereits existiert und seine eigenen Tests bestanden hat, in einer neuen Laufzeit oder einem neuen Kontext, ohne die Verbindungsstelle erneut zu prüfen. „Funktioniert bereits“ war woanders wahr; die Nahtstelle, an der du es anfügst, ist brandneu und gehört keiner Seite, also genau dort versteckt sich die ungeprüfte Lücke.