Vorarbeiter-Landing-Pipeline
Multi-Vorarbeiter-Pipeline für die Auslieferung eines Plans oder eines BACKLOG-Bündels: Erkundung → Planüberprüfung → Implementierungs-Vorarbeiter → Landing-Vorarbeiter → Tiefe-0-Verifikation zwischen jeder Stufe → Abschluss-Vorarbeiter. Tiefe-0 bleibt die einzige Autorität, die einen Anspruch akzeptiert; jeder Ausgabe eines Vorarbeiters ist ein Beweis, niemals ein Urteil.
0. Vorarbeit (bevor ein Vorarbeiter existiert)
- Erkunde jede Plattform-Tatsache, von der der Plan abhängt, die du in dieser Sitzung nicht per URL oder durch Ausführen des eigentlichen Tools überprüft hast (siehe Projekt CLAUDE.md „Don't“ §). Eine nicht überprüfte Tatsache ist ein Spike-Kandidat, keine Tatsache – setze sie entweder als solchen in den Plan oder erkunde sie zuerst.
- Schreibe den Plan und führe ihn dann durch die Planüberprüfungsschleife (
autopilot:hetero-review→dispatch-plan-review), nicht durch das eigene Urteil dieser Fähigkeit:- Eingefrorene Bewertungsmatrix pro Generation; ein Vorsitzwechsel benötigt die Zustimmung des Betreibers, nicht die Initiative eines Vorarbeiters.
- G1-Entscheidungen sind bindend – jeder akzeptierte Punkt ist wortwörtlich im Gültigkeitsbereich der Globalen Einschränkungen des Implementierungsauftrags.
- Maximal G2. Wenn ein Bewertungspunkt bei G1 abgelehnt wird, ersetze ihn durch eine neue logische ID und ein neues Ticket, anstatt die alte wiederzubeleben.
- Führe die Einfrierprüfung durch, bevor du den Plan als umsetzbar behandelst.
- Eine begrenzte Reparatur nach dem Einfrieren ist für Mängel erlaubt, die die Einfrierprüfung selbst aufdeckt – keine Wiedereröffnung bereits entschiedener Bewertungspunkte.
1. Implementierungs-Vorarbeiter
Entsende einen Hintergrund-Sonnet-Vorarbeiter (Engine: sonnet Header – dispatch-model-guard verweigert eine Sendung ohne diesen) aus templates/implement-brief.md. Urteil für den Auftrag:
- Ein Klon, niemals das Haupt-Repository. Der Klon trägt einen Schatten-Commit („PARALLEL-RUN LOCAL ONLY — mission_convergence enforcement_mode shadow, never land“), damit
dispatch-hetero.shnicht unter Mission-Durchsetzung ablehnt. Setze den Schatten-Commit in den Auftrag selbst, beim Setup, verfasst von Tiefe-0 – sende ihn niemals als Folgenachricht an den Vorarbeiter. Eine Folgenachricht ist keine Autorisierung; ein abgelehnter oder falsch angewendeter Schatten-Commit ist die Ursache von Welle-1b-Kosten. - Gestapelte Reihen: Die Handbasis jeder Reihe = der akzeptierte Kopf der vorherigen Reihe (sein Reparaturkopf, falls repariert). Ein Hand-Commit pro Reihe, zuerst ROT, Testen führt die eigene Suite der Reihe plus JEDE KONSUMENTEN-Suite des berührten Vertrags aus – nicht nur die Bündel-Suite.
- Überprüfung pro Reihe findet hier statt, aber behandle sie als notwendig und nicht ausreichend – siehe §2s kombinierte Überprüfung.
- Schienenfehler (Kontingent, 402, Bereitschaft, „Dieses Modell kann nicht verwendet werden“) sind
RAIL-FAIL, kein Grund für den Vorarbeiter, selbst Code zu schreiben.
1b. Form vor dem Versand abschätzen (2026-10-02/03)
- Unabhängige Reihen laufen parallel, nicht gestapelt: eine Sonnet-Hand pro Reihe in einem eigenen Arbeitsverzeichnis eines Klons, aus
templates/hand-brief-common.md. Stapele nur echte Abhängigkeiten. Sieben parallele S-Reihen landeten in ~1 h; ein gestapeltes Billig-Hand-Bündel derselben Größe dauerte ~3 h. - Handwahl: Reihen, die groß sind oder Signale/Fallen/Sandboxing berühren, erhalten eine Sonnet-Hand (
Agent, Modell sonnet), keine Billig-Schienen-Hand – 6/7 Billig-Hand-Reihen benötigten eine Reparaturrunde. - Überspringe niemals die Überprüfung pro Reihe, um Zeit zu sparen: v2.36.108 übersprang sie und drei Probleme tauchten erst in der kombinierten Überprüfung auf, jede kostete eine Landungsrunde.
- Verbraucher-Sweep inkl. L1 ist Teil des Verify jeder Hand (die Vorlage erklärt wie); eine Hand, die nur ihre Bash-Suite ausführt, verschiebt den Fehler zum Landungstor.
- Teile dem Betreiber die geschätzte Wandzeit beim Versand mit.
2. Landing-Vorarbeiter
Neuer Auftrag aus templates/land-brief.md, der erst gesendet wird, nachdem Tiefe-0 jede Implementierungs-Vorarbeiter-Reihe anhand von Git-Beweisen (Diff, keine Selbstauskunft) akzeptiert hat. Urteil für den Auftrag:
- Ein frischer Klon von
origin/develop, nicht der Implementierungs-Klon. Setzegit config core.hooksPath .githooksin der allerersten Setup-Zeile – ein Landing-Klon ohne dies sendet ohne den Pre-Push-QC-Gate aus (v2.36.99 hat auf diese Weise einen wörtlichen<id>-Trailer ausgeliefert). - Kirschenpflücke nur Hand-Commits. Niemals den Schatten-Commit; grep
enforcement_modezeigt nach jedem Pflücken immer nochenforce. - Die gesamte Suite, kein eingeschränkter Ausschnitt – eine Änderung, die einen weit verbreiteten Vertrag berührt, benötigt die volle
hooks/tests/run.sh. Führe jedes rote Solo erneut aus; alles, was noch rot ist, wird in einem Wegwerf-Arbeitsverzeichnis mitorigin/developverglichen, um bereits vorhandenes Rot von durch den Branch eingeführtem Rot zu trennen. - EINE kombinierte Überprüfung über
origin/develop..HEAD, niemals eine Wiederholung der Überprüfungen pro Reihe. Eine kombinierte Überprüfung hat auf dieser genauen Pipeline erfasst, was die Überprüfung pro Reihe übersehen hat (Multiplexer-Allow-Bypass und fünf Erkenntnisse in einer Runde – siehe Gelernte Regeln). STOPPE bei jedem 🔴/🟠 in diesem Urteil; beurteile sie nicht selbst weg. - Veröffentliche nur, wenn die Tore grün sind und das Urteil SHIP-AS-IS lautet: Versionssprung, BACKLOG/CHANGELOG/INDEX,
preflight-release.sh. - Trailer werden aus der echten Überprüfungs-ID des Überprüfungsmanifests (dem JSON, das die kombinierte Überprüfung tatsächlich produziert hat) ausgefüllt, niemals als wörtlicher Platzhalter-String belassen. Push, dann bestätige mit
git ls-remote origin develop.
3. Pflichten von Tiefe-0 zwischen den Stufen
- Leite jeden widerlegten Befund selbst neu ab. ADR-0001 (Verifikation über Behauptung): Die Aussage eines Vorarbeiters „dieser Befund ist ein falsch Positives“ ist eine Behauptung, keine Tatsache, bis du ihn aus demselben Diff neu ableitest.
- Überprüfe jeden Push unabhängig:
git ls-remotestimmt mit dem gemeldeten SHA überein, der Trailer enthält eine echte Überprüfungs-ID (nicht<id>), die Governance liest immer nochenforce, und kein Schatten-Commit gelandet ist. - Geparkte Vorarbeiter wecken sich nicht selbst. Verwende einen Hintergrund-Totmann-Timer (
sleep <n>; echo WAKE-<tag>) zusammen mit dem Versand, plus eine Git-Status-Prüfung beim Aufwachen, plusSendMessage, um einen Vorarbeiter zu stoßen, der hätte Bericht erstatten sollen und es nicht getan hat.
4. Abschluss-Vorarbeiter
Aus templates/closeout-brief.md, im echten Repository (kein Klon – „hier läuft nichts anderes“). Dieser Schritt wird niemals übersprungen, selbst für ein kleines Bündel:
- Bereichsbezogene Dokumentsynchronisation genau über den Diff-Bereich, der ausgeliefert wurde – behebe nur echte Abweichungen.
- Eine BACKLOG-Zeile für alles, was während der Pipeline entdeckt wurde und nicht im Rahmen war, um es jetzt zu beheben (z. B. ein vermuteter, aber nicht bestätigter Kontaminationsvorfall).
- Ein Beweisverzeichnis unter
docs/plans/evidence/<date>-<slug>/, das jeden Auftrag, jeden BERICHT, jedes Überprüfungs-JSON sowie eine kurze README mit den Erkundungen und den kombinierten Überprüfungsfängen enthält. - HANDOFF-Aktualisierung im bestehenden Stil (zh-TW-Konventionen gelten – siehe Projekt CLAUDE.md).
- Ein Commit, auf die gleiche Weise abgesichert wie ein Landing-Commit, wenn er einen QC-geschützten Pfad berührt.
Reparatur (wenn Landing-Tore nur auf dem Release-Branch rot werden)
Verwende templates/repair-brief.md, wenn der Gate-Lauf des Landing-Vorarbeiters Suiten auf dem Release-Branch rot, aber auf origin/develop grün findet. Führe zuerst eine Bisektion pro Cluster durch – vertraue der Bisektion mehr als der verdächtigen Vermutung. Eine Reparatur-Hand pro Cluster, auf einem neu erstellten Schatten-Branch (niemals dem Release-Branch selbst), überprüft auf die gleiche Weise wie eine Hand des Implementierungs-Vorarbeiters. Höchstens eine Reparaturrunde pro Cluster; alles, was danach noch rot ist, ist FAIL, gemeldet, nicht durch den Vorarbeiter selbst repariert.
Regeln – kanonisch woanders (hier nicht duplizieren)
Diese Fähigkeit ist die Checkliste und die Vorlagen (templates/*.md). Die Regeln und ihre Quellenereignisse leben in:
skills/l5/references/hetero-impl-loop.md§ „Sonnet-Vorarbeiter als Agent-Subagenten“: der Schatten-Commit gehört in den Auftrag, ein Landing-Klon setztcore.hooksPath, die Trailer-ID stammt aus dem Manifest, und der Landing-Vorarbeiter stoppt bei 🔴/🟠.references/evidence-discipline.md§42–§44: Die Existenz eines Beratungskanals ist kein Beweis dafür, dass eine Nachricht ankommt; eine Überprüfung pro Reihe kann die kombinierte Überprüfung nicht ersetzen; ein Diff im echten Store ist kein Beweis für Testverschmutzung.- Tool-Guard-Fallen: Die Exec-Boundary blockiert destruktiv geformte Wörter selbst innerhalb von Heredoc-Text, schreibe daher Skripte zuerst in eine Datei;
pgrep -f/pkill -ferkennen sich selbst. Diese sind im Gedächtnis des Betreibers, nicht im Repository.
Wenn eine neue Regel gelernt wird, füge sie zu diesen Dateien hinzu, nicht hier.