Kartografische Aufnahme · Blatt 1 von 1

Das Coding-Harness

Wimmelbild einer agentischen Umsetzungs-Schleife
Nach einer Handskizze
Maßstab: 1 Ring ≈ 1 Verantwortungsebene
Legende unten · Elemente anfassbar
Zeiger über ein Element halten, um seine Beschreibung zu lesen
DAS REPO
HIER ENTSTEHT DAS PRODUKT
SPEC
M1
M2
M3
DONE-NOTIZEN
REQUEST
FEATURE · BUG · HOTFIX · PATCH
ARCH
BRAIN
SPAWN →
IMPL
WORKER
EDIT CODE ⇢
feat/branch · WORKTREE
COMMITS ×n
EXE
mvn install
mvn spotless:apply
mvn test · tslint
jacoco coverage
FORMATTER · LINTER
STATIC CODE
UNIT TEST
SMOKE TEST (small)
o.k. ✓ not ok ✗
→ git commit
→ checkpoint
→ M1 ≤ SPEC
REVIEW
GIT DIFF TOOLING
ENTSCHEIDUNG
abnehmen zurück
FIX / PATCH
SELF · SUB-AGENT
↻ REPEAT
+ PROMPT FROM ARCH
W/ CONTEXT
← BACK OVERWATCH
SCREENSHOTS
& VIDEOS
HUMAN FEEDBACK
ABNAHME DURCH DEN MENSCHEN
M1
M2
M3
FULL-SUITE BUILD
DOCKER IT-TEST
TS-LINTER
FORMATTER
RUN BUILD
COVERAGE
CHECK
CHECK 2
CHECK
KERN
1 ZYKLUS = 1 MEILENSTEIN
Legende · Zonen
Der Kern — das Repo. Das Loch in der Mitte. Hier entsteht das eigentliche Produkt; niemand wohnt darin.
Erster innerer Kreis — ARCH. SPEC, Meilenstein-Checkboxen, DONE-Notizen, Review, Entscheidung.
Worker-Ring. IMPL, feat/branch, edit Code, Commits, Fix/Patch, Repeat — die Zone, in der gearbeitet wird.
Executor-Saum. EXE-Agents und die Gates auf der Außenhaut: Build, Lint, Formatter, Docker-IT, Coverage.
Human Gate. Screenshots, Videos, Abnahme durch den Menschen — der einzige Punkt außerhalb der Hülle.
Legende · Linien
Hauptumlauf im Uhrzeigersinn: Auftrag → Umsetzung → Prüfung → Commit.
Rückkanäle: Overwatch, Fix/Patch, Repeat.
Ein- und Ausgang: Request hinein, Belege hinaus.
›››
Prüfdruck von außen nach innen.
Der Lauf in zehn Schritten
  1. Ein Request trifft ein: Feature, Bug, Hotfix oder Patch.
  2. ARCH definiert in einer der ersten Phasen die SPEC — mit Meilenstein-Checkboxen M1, M2, M3.
  3. Frei nach SubAgent-TDD-Ansatz beauftragt ARCH einen WORKER mit dem ersten Teil.
  4. Der Worker arbeitet auf einem dedizierten feature/branch im eigenen Worktree und commitet dort.
  5. Der Worker spawnt EXECUTOR-Agents im äußeren Ring. Die feuern Commands ab — mvn install, mvn spotless:apply, mvn test, tslint, jacoco coverage — und spielen den Output 1:1 zurück.
  6. Irgendwann ist der Worker fertig: Code-Richtlinien, TS-Lint, Unit-Tests, Spotless und der kleine Smoke-Test halten. M1 ist umgesetzt.
  7. ARCH erhält die Commits und führt ein Review über git-diff-Tooling durch.
  8. Sagt ARCH okay, wird M1 abgesegnet und in die DONE-Notizen direkt neben den SPEC-Checkboxen eingetragen.
  9. Sagt ARCH nicht okay — static-code-guard rot, Tests oder E2E fehlgeschlagen, oder der Meilenstein wurde gar nicht umgesetzt — läuft ein Fix-Agent eine Extra-Runde. Der Prozess wiederholt sich ab Schritt 6/7, bis ARCH wieder entscheiden kann.
  10. Zu jedem erreichten Meilenstein existieren Screenshots und Videos. Die muss der Mensch abnehmen: nach jedem Meilenstein oder einmalig zum Schluss.
Lesart der Karte

Die Skizze ist kein Flussdiagramm, sondern ein Druckbehälter. Außen die harte Haut aus Checks, innen das Loch, in dem das Produkt wächst. Alle Pfeile auf der Hülle zeigen nach innen: das Harness prüft, der Kern produziert.

Die Rollen sind strikt nach Ring getrennt. ARCH entscheidet und schreibt nie Code. Der Worker schreibt Code und entscheidet nie. Der Executor führt aus und denkt nicht — er spielt Output 1:1 zurück. Diese Trennung ist der eigentliche Trick der Zeichnung.

Der Umlauf ist nicht als Linie, sondern als Kreis gezeichnet, weil er mehrfach läuft: einmal pro Meilenstein, plus je eine Extra-Runde pro Ablehnung. Leichte Gänge — Formatter, Linter, Smoke — laufen in jedem Zyklus mit; die schweren — Full-Suite Build, Docker-IT-Test — nur am Ende.

Der Mensch steht bewusst außerhalb der Hülle. Er greift nicht in die Schleife ein, sondern nimmt ab — auf Basis von Screenshots und Videos, die die Maschine selbst angefertigt hat.

Nicht in der Skizze entschieden
Ob der Mensch nach jedem Meilenstein oder einmal am Schluss abnimmt, lässt die Zeichnung offen — auf der Karte sind beide Wege als ein Gate außerhalb der Hülle gezeichnet.