Anti-Pattern-Vermeidungs-Checkliste

Kurzes Gegenmittel zu den häufigsten Coding-Agent-Fallen.
Details und Begründung: Kapitel 19.

Täglich (5–10 Minuten)

Offene Handoffs/Progress überfliegen; erledigte als erledigt markieren oder archivieren (kein Zombie-Handoff)
AGENTS.md / Skills: bekannte Widersprüche? Tote Anweisungen?
Gestern Accept-without-read, Rework oder Endlos-Session? → eine konkrete Korrektur (Slice kleiner, DoD schärfer, Session-Grenze)
Token-/Zeitfresser der letzten Session: Yield (grüner Slice / reviewbarer Diff) oder nur Spend?

Ziel in 1–3 Sätzen (Outcome, nicht nur Aktivität)
Nebenbedingungen + Ausschlüsse explizit
DoD mit ausführbaren Commands (nicht nur „sieht gut aus“)
Jede DoD-Zeile ist Command oder explizit Human-Gate — nicht als Loop-Orakel mischen (Kap. 19.4 Soft-DoD)
Harness-Permissions gesetzt — weiche Rules allein sind keine Grenze (Kap. 15.1)
Slice klein genug, dass ein Mensch den Diff in einem Zug reviewen kann
Context: nur nötige Dateien/Pfade; keine CI-Log-Dumps
Stop-Regel: z. B. max. 3 Fix-Iterationen ohne DoD-Fortschritt → Handoff + Stop (optional: einmal Modell-Tier eskalieren, dann User)
Bei Sub-Agents: Scope + DoD + Hand-back; Default-Modell nicht „immer Max“
Bei parallelen Writern: Ownership/Write-Scopes + Integrations-DoD vor Spawn (Kap. 22)
Bei Auth/Netzwerk/User-Input: Sicherheits-Nebenbedingungen im Prompt; Kurzcheckliste: checklists/security-kurzcheckliste.md
Deny-Read auf Secret-Pfade (.env, Key-Files, ~/.ssh) — Isolation ohne Deny ist Theater, sobald der Mount die Datei zeigt (Kap. 18.2)
Supply-Chain: Skills und MCP inventarisiert, Review vor Enable, Pin, Owner, Read≠Write (Kap. 18.9)
Creation und tiefes Debugging nicht in derselben endlos wachsenden Session mischen

Explore/Plan kurz, bevor großer Write-Strom startet (kein Execute-first, kein Plan-Theater; Skills nicht als Repo-Dump)
Surgical Changes — kein Drive-by-Refactor ohne Auftrag
Bei Widersprüchen des Agents zu Turn-1-Nebenbedingungen: Compact oder neue Session
Agent behauptet „Done“? → Commands selbst oder im Harness verifizieren

Diff gelesen (kein Accept-and-Forget; nicht nur Agent-Zusammenfassung)
Jede Datei gehört zum Auftrag / Slice
Öffentliche API / Schema / Migration: Intent korrekt?
DoD-Checks nachvollziehbar grün (lokal oder CI); Human-Gates nicht als Agent-Grün zählen
Keine Secrets, keine Placeholder-Credentials mit echten Mustern
AuthN/AuthZ und Validierung bei schreibenden/sensiblen Pfaden bedacht
Tests: echte Asserts / würden bei Feature-Bruch failen?
Almost-right-Stellen benannt: fixen oder bewusst out-of-scope — nicht still mergen
Kein Merge nur weil „es kompiliert und läuft“

Signal	Typische Anti-Patterns	Aktion
Grün	Klarer Slice, Diff lesbar, DoD grün, Review gemacht	Mergen / nächster Slice
Gelb	Wiederholte Korrekturen, wachsender Context, Almost-right	Compact/Handoff; Scope schärfen; zweiten Pass nur für Lücken
Rot	Accept-All-Gewohnheit, Loop ohne Fortschritt, Secrets/Security unklar, Agent widerspricht sich	Stop → frische Session → Auftrag und DoD neu; bei Security kein Merge