Kartografische Aufnahme · Blatt 3 · ausgebaute Fassung

Vier Ringe, ein Repo, eine Git-Bahn

Dein Konzept, ergänzt um das, was ein Harness im Betrieb zusätzlich braucht
+ markiert meine Ergänzung
ohne Markierung = aus deiner Skizze
Blatt 1 und 2 bleiben erhalten
Zeiger über ein Element halten, um seine Beschreibung zu lesen
DAS REPO
main · geschützt
ARCH
SPEC
+ AKZEPTANZ
M1
M2
M3
DONE-NOTIZEN
W1
W2
W3
①②
mvn install
mvn spotless:apply
mvn test
tslint
jacoco coverage
docker it-test
smoke test (small)
+ SANDBOX
kein Netz
+ BUDGET
& Limits
+ AUDIT-LOG
Run-Protokoll
+ ARTEFAKTE
Speicher
I
ARCH
II
WORKER
III
EXECUTOR
IV
PLATTFORM
REQUEST
FEATURE · BUG · HOTFIX · PATCH → ARCH
+ Kontext-Paket je Auftrag
· SPEC-Ausschnitt Mn + Akzeptanzkriterien
· Repo-Karte: wo liegt was
· Code-Richtlinien des Projekts
· Testfälle zuerst (SubAgent-TDD)
· bei Wiederholung: git diff + Fehler-Log
+ Budget · Abbruch · Eskalation
· Token-Budget und Timeout je Worker-Run
· max. 3 Fix-Runden je Meilenstein
· danach Abbruch statt Endlosschleife
Dann zwei Wege: ARCH schneidet Mn kleiner — oder der Mensch entscheidet.
HUMAN GATE
Screenshots und Videos gehen an den Menschen. + drei Antworten: annehmen · nachbessern · ablehnen.
ARCH sagt nicht okay, weil
a · static-code-guard ist rot
b · Tests oder E2E-Tests schlagen fehl
c · Meilenstein nicht umgesetzt (selten)
Git-Bahn
main
+ PROTECTED · kein Force-Push
git checkout -b feature/M1 · worktree
COMMITS c1 · c2 · c3 · c4 → feature/M1
+ CI auf dem Branch
ARCH REVIEW · git diff
MERGE
+ squash · ein Commit je M
+ tag M1 · revert möglich
→ feature/M2
+ rebase bei Konflikt
Ringschlüssel
Kern · Das Repo. Geschützte main. Nichts landet hier ohne Merge.
Ring I · ARCH. SPEC, Meilensteine, DONE-Notizen, Review, Entscheidung.
Ring II · WORKER. Schreibt Code auf einem eigenen Feature-Branch und commitet dort.
Ring III · EXECUTOR. Führt einzelne Commands aus, gibt Output unverändert nach innen.
+ Ring IV · PLATTFORM. Sandbox, Budget, Audit-Log, Artefakt-Speicher. Trägt den Lauf, nimmt an ihm nicht teil.
Linien
Auftrag nach außen: ARCH → Worker → Executor.
Ergebnis nach innen: Output 1:1, Commits, Status.
① back ② overwork — zurück und überarbeiten.
Ein- und Ausgang durch die Plattform-Schale.
Was ich ergänzt habe und warum
Ring IV, die Plattform-Schale. Sandbox, Budget, Audit-Log und Artefakt-Speicher gehören nicht in den Ablauf, sondern darunter. In der Skizze fehlen sie, im Betrieb entscheiden sie, ob ein Lauf überhaupt erlaubt und nachvollziehbar ist.
Das Kontext-Paket. Ein Auftrag ist erst reproduzierbar, wenn festgelegt ist, was der Worker mitbekommt: SPEC-Ausschnitt, Akzeptanzkriterien, Repo-Karte, Richtlinien, bei Wiederholung der Diff und das Fehler-Log.
Abbruch und Eskalation. Der Fix-Zyklus in deiner Skizze hat kein Ende. Drei Runden je Meilenstein, dann Abbruch — und eine Entscheidung durch ARCH oder Mensch.
Akzeptanzkriterien je Meilenstein. „M1 ≤ SPEC" braucht einen prüfbaren Maßstab, sonst ist das Review Geschmackssache.
Git-Hygiene. Protected main, CI auf dem Branch, Squash je Meilenstein, Tag und Revert-Weg. Damit bleibt die Historie lesbar, obwohl ein Agent sie erzeugt hat.
Der Lauf, vollständig
  1. Request trifft ein und geht an ARCH.
  2. ARCH schreibt die SPEC: Meilensteine mit Akzeptanzkriterien.
  3. ARCH schneidet Mn heraus und packt das Kontext-Paket.
  4. Ein Worker erhält den Auftrag, öffnet feature/Mn im eigenen Worktree.
  5. Testfälle zuerst, dann Implementierung.
  6. Der Worker spawnt Executor-Agents; die feuern Commands ab und geben Output 1:1 zurück.
  7. Grün in Lint, Format, Unit und Smoke: der Worker commitet und meldet fertig.
  8. CI läuft auf dem Branch, Artefakte werden abgelegt.
  9. ARCH reviewt per git diff gegen die Akzeptanzkriterien.
  10. Nicht okay: ① back ② overwork — Fix-Runde, maximal drei, dann Abbruch und Eskalation.
  11. Okay: Eintrag in die DONE-Notizen, Squash-Merge, Tag.
  12. Der Mensch nimmt ab: annehmen, nachbessern oder ablehnen — je Meilenstein oder einmalig am Schluss.
Blatt 3 · ausgebaute Fassung des Konzepts