ki-eit/13-checklisten-anti-patterns-schluss.md

13. Checklisten, Anti-Patterns und Schluss

Kern: Die häufigsten Fehlschläge im Enterprise-Stack mit Agents sind vorhersehbar — und mit Repo-Disziplin billiger als mit Prompt-Sammlungen.

Die Kapitel davor haben Hebel und Muster geliefert. Dieses Kapitel ist die Kurzkarte: was schiefgeht, welches Ritual trägt, und wo die Schwesterbücher die Tiefe halten. Kein neues Framework — Verdichtung.

13.1 Die teure Woche in einem Absatz

Montag: Root-Instructions auf 400 Zeilen aufgeblasen. Dienstag: Agent fährt Full-mvn verify nach jedem Tippfehler. Mittwoch: NgModule im Standalone-Repo, Review eskaliert. Donnerstag: permitAll im Merge, YOLO im Shared-Monorepo. Freitag: CI rot, lokal grün, anderes JDK — und niemand will „noch ein stärkeres Modell“, alle wollen eine Wahrheit, scoped Verify und enge Permissions.

Das ist kein Ausnahmefall. Es ist die Summe der Anti-Patterns aus Kap. 3–12. Die Tabelle darunter ist die Retro-Liste, nicht die Moralpredigt.

13.2 Top-Anti-Patterns (Stack + Agent)

Anti-Pattern	Besser	Wo im Buch
Theorie aus dem Chat, keine Commands im Repo	Verify + Runtime im Repo	Kap. 4, 9
Tote / veraltete Instructions / AGENTS.md	Commands wie CI pflegen	Kap. 4, 10
Full mvn clean install als Tight-Loop	scoped -Dtest= / --tests	Kap. 9
Agent schreibt NgModule 2018 in Standalone-Repo	Golden Path + path-instructions	Kap. 5, 10
Spring-Idiome 1:1 nach Quarkus	eigenes Idiom, kein Port-Theater	Kap. 7
Horizontaler DTO-Big-Bang	vertikaler Slice	Kap. 8
Instructions und AGENTS als 400-Zeilen-Duplikat	Root kurz, Package detailliert	Kap. 4, 10
YOLO im Shared-Monorepo	Permissions + Policy	Kap. 12
Widersprüchliche READMEs	eine Wahrheit	Kap. 4
Secrets in Beispielen / Instructions	Platzhalter	Kap. 12
CI ≠ lokale Verify-Story	Mirror inkl. Runtime-Pin	Kap. 9, 4.1
Legacy wegpompten	Strangler + Tests am Schnitt	Kap. 11
MCP „alle Server an“	Inventur, least privilege	Kap. 10
DoD nur „compiles“ / Prosa im Chat	benannte Exit-Codes + Diff-Fit	Kap. 2, 9

Lebende Listen: checklists/anti-pattern-stack.md, DoD-Checklisten, Review-Checkliste. Templates unter templates/ — Anhang A ist nur Snapshot.

13.3 Team-Ritual (minimal)

Drei Rituale tragen mehr als zehn Prompt-Bibliotheken:

Ritual	Was	Artefakt
Session-Start	Trust, Instructions, enge Permissions, Slice-Scope	checklists/session-start-angular-java.md
Slice-DoD	Tight-Loop grün, Diff zum Auftrag, kein Scope-Creep	Kap. 9; checklists/dod-*.md
Teach-back	wiederkehrende Agent-Fehler → Instructions/Skill/AGENTS.md am selben Tag, in eigener kurzer Session	Kap. 3.3; Skills Kap. 10

Optional viertens: Handoff an FE/BE- oder Themengrenze (templates/handoff-stack.md) — billiger als Freitag-Context-Schlamm (Kap. 2.1).

Das Ritual ist absichtlich klein. Was wächst, sind die Repo-Wahrheiten (Commands, Golden Paths, Invariants), nicht die Meeting-Agenda.

13.4 Lesepfade (kurz)

Pfad	Reihenfolge	Für wen
Schnellstart	1 → 2 → 4 → 9 → 10 → templates/ + Anhang C	Einzelperson, erstes Repo (Surfaces mappen)
Anderer Harness	Schnellstart + Anhang C	Copilot, Claude Code, Codex, Grok Build (weitere Surfaces analog)
Team	1 → 2 → 3 → 4 → 9 → 8 → 5/6 → 10 → 12 → 13 (+ 7 Quarkus)	Alignment, Review-Budget, Governance
Migration	2 → 8 → 11 → 9 → 12	Legacy-Hotspot, Strangler
Framework-Tiefe	5 / 6 / 7 nach 4	wenn die Reibung stilistisch/stack-spezifisch ist

13.5 Zurück zu den Schwesterbüchern

Buch	Hält	Dieses Companion hält
Coding Agents in der Praxis	Context, Compact, Handoff, DoD-Prinzipien, Multi-Agent, generische Security, Stack-Rankings	nicht erneut
Der Copilot-CLI-Harness	optional: CLI-Surfaces, Fleet, Settings, CI-Token, Permission-Produktiefe (nur Copilot)	nicht erneut
Dieses Buch	Angular + Spring Boot (+ Quarkus); Prinzipien generisch; Surfaces mappen (Anhang C)	Stack-Hebel scharf

Drei-Buch-Regel: praxis = System, copilot = optionale Copilot-Produkt-Fibel, dieses Companion = Stack-Anwendung + Surface-Mapping. Wer alles in ein Manuskript stopft, pflegt Drift an drei Fronten gleichzeitig.

13.6 Ausblick

Frameworks, Modelle und Agent-Surfaces driften. Was bleibt, wenn der Hype weiterzieht:

• eine Wahrheit für Runtime, Build, Test, Lint
• prüfbare DoD mit non-interactive Commands
• enge Slices und Review-Budget
• weich vs. hart — Instructions lenken, Permissions begrenzen
• Teach-back in Repo-Artefakte, nicht nur in Chat-Folklore

Pflegt Commands, Golden Paths und Instructions wie Code. Rankings im Theorie-Schwesterbuch (Anhang B dort) und diese Konkretisierung gemeinsam aktualisieren — Snapshot-Datum ehrlich halten (Anhang B hier: Verify-Commands).

Key Takeaways

• Anti-Patterns sind meist Setup-, Slice- und Permission-Probleme, keine „dummen Modelle“.
• Ritual: Start-Check, DoD, Teach-back — klein und verbindlich.
• Companion + praxis (+ optional copilot-harness) = System + Stack (+ optionale Copilot-Produktiefe); Surfaces mappen (Anhang C).
• Drift ist normal; Pflege von Verify und Golden Paths ist der Hebel, nicht Prompt-Hoarding.

Praktische nächste Schritte

1. Anti-Pattern-Tabelle (13.2) einmal im Team-Retro durchgehen — Top-3 markieren.
2. Session-Start- und DoD-Checklisten an eure echten Scripts hängen.
3. Templates unter templates/ als lebendige Quelle pflegen (Anhang A nur Snapshot).
4. Permissions-Policy und YOLO-Verbot in Shared Repos schriftlich machen (Kap. 12).
5. Nächsten realen Slice mit Task-Formel + benannten Commands fahren — und Teach-back am selben Tag (eigene Session).