Coding Agents in der Praxis

Untertitel: Ein pragmatischer Leitfaden zum effektiven Einsatz von LLM-basierten Coding-Agents unter Berücksichtigung ihrer Limitationen

Dieses Buch ist ein Markdown-Projekt für Software-Entwickler, Tech-Leads und Engineering-Manager, die Coding-Agents zuverlässig und produktiv einsetzen wollen — ohne Hype, mit klarem Blick auf reale Grenzen.

Worum es geht

Ein Coding-Agent ist nicht „die KI, die programmieren kann“. Ein Agent ist:

LLM + Harness

Das LLM generiert Token. Der Harness gibt dem Modell Werkzeuge, mit denen es die Welt verändern (Dateien schreiben, Tests laufen lassen, committen) oder den Kontext ergänzen kann (lesen, suchen, greppen). Die Zusammenarbeit von LLM und Harness wird im Training optimiert — und in der Praxis von Kontext, Aufgaben-Schnitt und Verifizierbarkeit dominiert.

Context is King. Mehr Kontext ist nicht automatisch besser. Die Performance folgt in der Praxis oft einer U-förmigen Kurve über den Füllgrad (Heuristik): relativ gut bei moderater, signalstarker Auslastung, dann Abfall (Dumb Zone), bei sehr hoher Füllung manchmal wieder etwas besser — bei deutlich höheren Kosten. Länge, Position und Multi-Turn können denselben Abfall parallel verstärken; Context Rot meint hier den Session-Verfall (Kap. 3).

Für wen dieses Buch ist

• Entwicklerinnen und Entwickler, die Agents täglich nutzen
• Tech-Leads, die Standards und Guardrails setzen
• Engineering-Manager, die Erwartungen und Produktivität realistisch steuern

Für wen es nicht ist

• Wer „ein Prompt für alles“ sucht
• Wer Benchmark-Theater und Vendor-Marketing will
• Wer glaubt, DoD und Review seien optional, sobald ein Agent „mitdenkt“

Zentrale Thesen (Kurzform)

1. Agent = LLM + Harness
2. Context is King
3. Context-Performance ist U-förmig; große Kontexte sind teuer und oft schlechter
4. DoD muss vom Agent selbst ermittelbar und verifizierbar sein
5. Aufgaben nicht zu restriktiv: Ziel + Nebenbedingungen + Ausschlüsse
6. Komplexität minimieren; vertikale Slices
7. Sprachen/Frameworks wählen, bei denen Agents zuverlässig wartbaren Code liefern (Trainingsdaten-Präsenz als Proxy)
8. Karpathy-Skills erzwingen (Fokus)
9. Aufräumen und Konsistenz sind kritisch

Lesepfade

Schnellstart (ca. 1 Tag)

1. 01 Einführung
2. 03 Kontext ist König
3. 04 Context-Management in der Praxis
4. 05 Context Engineering: Write – Select – Compress – Isolate (optional am ersten Tag: Matrix, Sub-Agents/Model Routing, Checkliste)
5. 06 Knowledge Layer (optional am ersten Tag: Memory-Tiers + Placement)
6. 14 Effektive Aufgabenformulierung
7. Templates: task-prompt, handoff, compaction-hints — im PDF: Anhang A
8. Session-Start-Checkliste (PDF: Anhang A)

Team-Einführung

1. 01 → 02 → 03 → 04 → 05 → 06 → 07 → 08 → 09 → 10 → 11 → 12 → 13 → 15 → 16 → 17 → 18 → 19 → 20 (Kernabschluss Reife)
2. Ergänzungen: 21 wenn Repo unreif; 22 bei paralleler Agent-Arbeit (nach 5.6/5.7 und solider DoD; Readiness vor Spawn)
3. AGENTS.md-Beispiel übernehmen: templates/agents-md-beispiel.md (Monorepo: Root / Package)
4. Tägliche Checkliste im Team-Ritual verankern

Rollen (Kurz, spiegeln Kap. 1.6)

Rolle	Kapitel-Kern
Praktiker	1, 3–4, 14 (+ optional 5–6)
Tech-Lead	5–12, 14–15, 18 (+ 21 bei Chaos)
Manager	1, 3, 10, 18–20 (+ optional 7, 21)
Legacy / Low-Maturity	8, 10, 12, 21

Nach Situation

Engpass der laufenden Woche, nicht das Inhaltsverzeichnis von vorn. Spiegel von Kap. 1.6. Vollere Matrix: Kap. 19.10.

Situation	Zuerst
Agent wiederholt sich, Context läuft voll	3, 4, 10
Neues Feature / dünner Slice	7, 8, 14
Grün, aber falsch / Loop ohne Stopp	10, 11
Legacy- oder Chaos-Repo	8, 10, 12, 21
Secrets, Isolation, Supply-Chain	18
Mehrere Agents parallel	22 (nach 5.6/5.7 und solider DoD)

Fester Stack (Angular / Spring / Quarkus)

Prinzipien, Context und DoD bleiben in diesem Buch. Stack-Patterns und These 7 invers: Agents mit Angular, Spring Boot & Quarkus.

Deep Dive Context

1. 03 → 04 → 05 → 06 → 09 → 11 → 12
2. Alle Hints in templates/compaction-hints.md
3. Eigene Session-Grenzen, Compact-Schwellen, Knowledge-Tiers und Token-Hebel (Kap. 5–6) festlegen und messen

Legacy / Greenfield / Low-Maturity

1. 01 Einführung (Thesen)
2. 08 Vertikale Slices · 10 DoD · 12 Aufräumen
3. 21 Low-Maturity, Legacy & Greenfield
4. Templates: AGENTS.md, Handoff, Task-Prompt — PDF: Anhang A

Struktur

Pfad	Inhalt
manuskript/	kapitel-01-*.md … kapitel-22-*.md plus Anhänge A/B — Quelle für alle Ausgaben
00-inhaltsverzeichnis.md	Navigation, nicht im PDF
research/	Quellen-Inventar, Abbildungs-Katalog und -Specs
audits/	Prüfprotokolle und Vollprüfungen
templates/, checklists/	lebende Leser-Vorlagen; Anhang A ist der PDF-Snapshot
docs/kb/	Autoren-Knowledgebase (erste Informationsquelle nach den Rules)
pdf/, scripts/, justfile	Satz (A4, Print, EPUB), Assembler und QA
assets/	Cover und Kanon-Figuren
build/, dist/	generiert; nie von Hand bearbeiten

Templates und Checklisten

Hybrid: Im PDF liefert Anhang A die stabilen Kernvorlagen. Lebende Quellen liegen unter templates/ und checklists/. Vollständige und laufend aktualisierte Pakete (ZIPs mit MANIFEST) im Begleit-Service.

Begleit-Service: https://books.maatini.space/projects/coding-agents-praxis/ — Stand & Drift, Errata, Material, Schnelle Hilfe, Feedback.

Templates

• handoff-template.md (Anhang A)
• progress-template.md
• compaction-hints.md (Anhang A, Kern)
• task-prompt-template.md (Anhang A)
• agents-md-beispiel.md (Anhang A)
• agents-md-monorepo-root.md
• agents-md-monorepo-package.md
• cursorignore-monorepo-beispiel.md
• dod-bibliothek.md (Anhang A)

Checklisten

• session-start-checkliste.md (Anhang A)
• taegliche-agent-checkliste.md
• anti-pattern-vermeidung.md (Anhang A)
• review-agent-diff.md
• monorepo-entscheidung.md
• reife-assessment.md (Anhang A)
• security-kurzcheckliste.md

Stil dieses Projekts

• Pragmatisch, ehrlich, lösungsorientiert
• Viele Templates, Checklisten, Anti-Patterns, Do-this / Avoid-that
• Kapitel enden mit Key Takeaways und Praktische nächste Schritte
• Tool- und vendor-agnostisch; Produkte nur als gleichrangige Beispiele (Claude Code, Cursor, Codex, Aider, Grok Build u. a.)

Autoren-Knowledgebase (Meta)

Für Agents und Menschen, die am Buch arbeiten (nicht Lesepfad, nicht im PDF): hierarchische Knowledgebase unter docs/kb/ — erste Informationsquelle nach always-on Rules. Progressive Disclosure (Index → Domain → Card → Source of Truth). Einstieg: docs/kb/INDEX.md, Protokoll: docs/kb/PROTOCOL.md. Session-Stand bleibt in HANDOFF-buch.md; Rules in AGENTS.md. Alter Pfad knowledge/ ist Redirect.

PDF bauen (optional)

Kapitel 01–22 plus Anhang A und Anhang B werden assembliert und mit Pandoc/LuaLaTeX gesetzt. Markdown-Navigation (00) und Meta-Dateien gehören nicht zum PDF-Body. Die lebenden Vorlagen bleiben unter templates/ und checklists/; im PDF steckt ein knapper Snapshot der Kerne plus A.7/A.8 (Anhang A) sowie die Stack-Orientierung (Anhang B, Snapshot).

Voraussetzungen: just, pandoc, TeX Live (LuaLaTeX, KOMA-Script scrbook), Fonts laut Template (Charter, DejaVu).

just pdf        # → dist/coding-agents-praxis.pdf
just qa         # Post-Build-Checks
just assemble   # nur build/book.md
just clean      # generierte Artefakte

Draft/Plain: just pdf-draft, just pdf-plain. Details: .grok/skills/pdf-bauen/references/pipeline.md, Skill pdf-bauen, Command /pdf.

EPUB bauen (optional)

Dieselbe Assemblierung, eigener Bild-Stage und eigenes CSS. Das Impressum wird aus pdf/front/impressum.tex gespiegelt; „Über den Autor“ kommt aus pdf/back/ueber-den-autor.tex.

just epub       # → dist/coding-agents-praxis.epub
just qa-epub    # Struktur-QA des EPUB

Voraussetzung zusätzlich: Python-Paket Pillow (Bilder werden für Kindle verkleinert). Details: .grok/rules/bau-pipeline.md, pdf/epub/, scripts/prepare_epub.py. Print/KDP: just pdf-print, just qa-print.

Autoren-Harness (für Agents am Buch)

Regeln und Skills steuern die Arbeit am Manuskript — nicht den Inhalt für Leser unter templates/ / checklists/.

Pfad	Rolle
AGENTS.md	Projektregeln (always-on, schlank)
.grok/rules/schreibkonventionen.md	Ton, Terminologie, Abschlüsse (always-on)
.grok/config.toml	Permission-deny, Superpowers in diesem Repo aus
.grok/skills/pdf-bauen/references/pipeline.md	PDF-Build, Callouts, QA (nur bei Build-Task)
.grok/rules/bau-pipeline.md	Build-Kette, Invarianten, Smoke-Test
.grok/rules/subagenten.md, sachlogik.md	Sub-Agenten, Zuschreibungsprüfung
.grok/skills/lektorat/	Lektorats-Checkpoints
.grok/skills/kapitel-review/	Argumentations-/Lesefluss-Gegenlese
.grok/skills/humanizer/	KI-Stil → menschlichere Stimme (Report only)
.grok/skills/pdf-bauen/	PDF/EPUB bauen und QA
.grok/skills/pdf-print/	KDP-Interior 6×9
.grok/skills/faktencheck/, lesepass/, sachlogik/	Querschnittsprüfungen
.grok/scripts/	seiten.py, manuskript_check.py, _repo.py
.grok/commands/	Aliase: /review, /pdf, /buch-status, /faktencheck, /lesepass, /sachlogik

Meta-Handoff zwischen Sessions: HANDOFF-buch.md.

Wie dieses Buch entstanden ist

Nach dem gleichen Workflow, den es lehrt: Explore → Plan → Execute → Verify → Commit, in vertikalen Slices, mit Handoff bei langem Context.

Lizenz / Nutzung

Internes Fachbuch-Manuskript im Markdown-Format. Anpassen, forken, Templates in eure Repos übernehmen — und veraltete Kopien pflegen (siehe Kapitel 12).