ki-praxis/00-inhaltsverzeichnis.md

Inhaltsverzeichnis

Coding Agents in der Praxis
Ein pragmatischer Leitfaden zum effektiven Einsatz von LLM-basierten Coding-Agents unter Berücksichtigung ihrer Limitationen

README · Begleit-Service (Material, Errata)

Kapitel

1. Einführung
   Wo Agents helfen und wo sie scheitern; neun Thesen.

2. Anatomie des Coding-Agents
   LLM + Harness: Tools, Loop, Permissions; wann eigenen Harness bauen.

3. Kontext ist König
   Window, U-Kurve, Dumb Zone, Lost-in-the-Middle, empirische Einordnung, Kosten.

4. Context-Management in der Praxis
   Session, Compact + Hints, Handoff, Agent-Selbsthilfe.

5. Context Engineering in der Praxis: Write – Select – Compress – Isolate
   Lifecycle: leichte Tools, Masking, Caching, Sub-Agents, Routing.

6. Knowledge Layer – Wissen für Agents verwalten
   Memory-Tiers, Progressive Disclosure, Write-Back, Freshness.

7. Workflow: Explore → Plan → Execute → Verify → Commit
   Ablauf, der Agents steuerbar und reviewbar macht.

8. Vertikale Slices und Komplexität
   Warum große horizontale Tasks scheitern; schlanke End-to-End-Schnitte.

9. Projekt-Struktur: Monorepos als Vorteil für Coding-Agents
   Context-Wände, scoped Loops, Polyrepo+Codegen; Boundaries.

10. Definition of Done und autonome Loops
    DoD, Orakel-Schichten, wann Autonomie-Loops greifen.

11. Alignment des Verständnisses
    Gemeinsames Modell vor dem Orakel: Teach-back, Gates, Spec-Haltung.

12. Aufräumen und Konsistenz
    Obsolete Dateien, widersprüchliche Regeln, Context-Reste.

13. Karpathy-Skills und Fokus
    Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution — und wie man sie erzwingt.

14. Effektive Aufgabenformulierung
    Ziel + Nebenbedingungen + Ausschlüsse + DoD.

15. Praktisches Setup und Tooling
    AGENTS.md, weich vs. hart, Jobs→Surfaces, Harness-Hebel, Stack, DevX, Sicherheit.

16. Agent Skills: Wiederverwendbare Expertise für zuverlässige Coding-Agents
    Portable SKILL.md-Pakete; Prompt vs. Tool vs. Skill.

17. MCP-Server: Der standardisierte Zugang der Agents zur Außenwelt
    Model Context Protocol; Skills vs. MCP; Context und Sicherheit.

18. Security für Coding-Agents: Secrets, Isolation und Enterprise-Risiken
    Secrets/Vault, Isolation, Enterprise, Source-Schutz, Injection/Supply-Chain.

19. Anti-Patterns, Checklisten und Templates
    Korrektiv zu Kap. 3–18; Katalog, Top-10, Werkbank-Index.

20. Schluss und Ausblick
    Kernabschluss: Rekapitulation, Team-Reife, Ausblick. Kap. 21–22 ergänzen.

21. Low-Maturity, Legacy & Greenfield – Agents in unreifen und chaotischen Codebases
    Ergänzung: unreife Codebases — Slice 0, Hygiene-First, Greenfield ab Tag 1.

22. Multi-Agent-Orchestrierung in der Praxis – Koordination, Isolation und Grenzen
    Ergänzung: wann Multi-Agent lohnt; Isolation, Verträge, Observability.

Anhang A. Kern-Templates und Checklisten
PDF-Snapshot: sechs Kerne plus DoD-Bibliothek (A.7) und Reife-Assessment (A.8); Quellen unter templates/ und checklists/.

Anhang B. Stack-Orientierung für agentisches Coding
Sprachen/Frameworks nach Anwendungsfall (These 7); Snapshot im Buch-Repo.

Templates und Checklisten

Lebend im Repo und Begleit-Service; PDF-Kerne in Anhang A.

• handoff-template.md — Session-Übergabe
• progress-template.md — Fortschrittslog
• compaction-hints.md — Compact-Hints
• task-prompt-template.md — Aufgabenformulierung
• agents-md-beispiel.md — Projektregeln
• agents-md-monorepo-root.md / package — Monorepo-AGENTS
• cursorignore-monorepo-beispiel.md — Ignore-Patterns
• dod-bibliothek.md — DoD-Kopiervorlagen (A.7)
• session-start-checkliste.md — vor dem ersten Prompt
• taegliche-agent-checkliste.md — Tageshygiene
• anti-pattern-vermeidung.md — pro Task / PR
• review-agent-diff.md — Agent-PR lesen
• monorepo-entscheidung.md — Mono/Poly/Hybrid
• reife-assessment.md — Team-Reife 0–2 (A.8)
• security-kurzcheckliste.md — Security-Kurzcheck (Kap. 18)

---

Einstieg: Begleit-Service → Kapitel 1 · Kerne: Anhang A