Agentenbasierte KI-unterstützte Softwareentwicklung

Von Large Language Models zu autonomen Entwicklungsagenten – inklusive Model Context Protocol (MCP) und moderner Kontext-Engineering

Ein praxisorientiertes Fachbuch für Softwareentwicklerinnen und -entwickler, Tech-Leads und AI Engineers (Stand 2026).

Titelseite: frontmatter/titelseite.md · Cover-Datei: bilder/cover-ki-book.jpg

---

Was dieses Buch liefert

Du lernst, wie aus Sprachmodellen steuerbare Coding Agents werden – und warum Context Engineering, Agent Harness und portable Capabilities (häufig MCP) entscheidender sind als das nächste Frontier-Modell allein.

Zentrale Themen:

• Context Engineering als Disziplin (kanonisch in Kap. 3)
• Agent = Model + Harness (Kap. 4.5)
• MCP als portable Capability-Schicht – inkl. wann nicht (Kap. 4.7 / 4.7.5)
• Skills, Progressive Disclosure, Multi-Agent, Framework-Wahl ohne Lock-in
• SDLC-Integration, 90-Tage-Nutzen-Messung, Hands-on (Kap. 10), Security & Governance (Kap. 11)

---

Zielgruppe

Du bist …	Das Buch hilft dir …
Tech-Lead / Architect	Host-first vs. MCP-first, Risiken, Autonomy und Org-Rollen entscheiden
Senior IC / Platform	Harness, Server, Policies und Evals bauen
Engineering Manager	Nutzen in 90 Tagen messen statt Folien-10×
AI Engineer	Context Engineering und Tooling professionalisieren

Voraussetzungen: solides Software-Engineering (Git, APIs, Tests), Grundkenntnisse in Python (Hands-on-Code), erste Erfahrung mit Chat-LLMs. Tiefes ML-Forschungs-Know-how ist nicht nötig. Kap. 1–2 sind Auffrischung.

Empfohlene Lesepfade

Pfad	Reihenfolge
Architect (Default)	Einleitung → Kap. 3 → 4 → 5 → 6.6 → 11 → 10
Builder	Kap. 4.5–4.7 → 10 → 5.4/5.12 → 11.7
Lead / EM	ES-I–III → Kap. 7 (inkl. 7.9 Scorecard) → 11 → 13 → Anhang F
30 Min	Kap. 4.0 → 4.5 → 4.7.5 → agent.py --demo → 11.7

---

Projektstatus

Phase	Inhalt	Status
1	Setup, README, Vorwort, Einleitung, Kapitel 1–2	✅ fertig
2	Kapitel 3–4	✅ fertig
3	Kapitel 5–6	✅ fertig
4	Kapitel 7–9	✅ fertig
5	Kapitel 10 (Hands-on, besonders detailliert)	✅ fertig
6	Kapitel 11–13, Schlusswort	✅ fertig
7	Anhang A–F, Querverweise	✅ fertig

Buch inhaltlich vollständig (Frontmatter, Kap. 1–13, Schlusswort, Anhang A–F, Hands-on-Code).

Erweiterungen (integriert):

Thema	Konzept	Praxis
Agent Harness / System Prompt / Skills	4.5, 5.4, 5.11	10.12
Production Harness	5.11	11.10
Projekt-Information (AGENTS.md, Graph, Hybrid, Context-Lifecycle)	5.12	10.13

---

Inhaltsverzeichnis

Frontmatter

• Titelseite – Cover (bilder/cover-ki-book.jpg)
• Vorwort – Die neue Architektur der Softwareentwicklung
• Einleitung – Von Chatbots zu autonomen Software-Agenten

Teil I: Vom Modell zum Agenten-Problem

• Executive Summary (EM/Tech-Lead)
• Kapitel 1: Warum Agenten jetzt? – Evolution in acht Minuten ✅ (Auffrischung)
• Kapitel 2: Technische Funktionsweise von LLMs ✅ (Auffrischung; MCP-Bridge → Kap. 4)
• Kapitel 3: Fähigkeiten, Grenzen und Context Engineering ✅

Teil II: Agent Harness, MCP und portable Capabilities

• Executive Summary (EM/Tech-Lead)
• Kapitel 4: Einführung in KI-Agenten und MCP ✅ (4.0 Entscheidungslandkarte, Harness, 4.7.5 Wann MCP nicht, 4.8 Spec 2026-07-28)
• Kapitel 5: Fortgeschrittene Agenten-Architekturen & Kontext-Management ✅ (Skills, Harness Engineering, 5.12 Projekt-Information)
• Kapitel 6: Frameworks und Runtimes wählen (2026) ✅

Teil III: Produktion – SDLC, Hands-on, Risiken

• Executive Summary (EM/Tech-Lead)
• Kapitel 7: Agenten im Software Development Life Cycle ✅ (inkl. 7.9 90-Tage-Scorecard)
• Kapitel 8: Multi-Agenten-Teams für komplette Softwareprojekte ✅
• Kapitel 9: Integration in moderne Entwickler-Tools und Workflows ✅
• Kapitel 10: Hands-on – Coding Agent mit MCP bauen ✅ Schwerpunkt (Companion code/, TRACE-DEMO-1)
• Kapitel 11: Risiken, Herausforderungen und verantwortungsvoller Einsatz ✅ (Threat-Template, Audit, Team-Readiness)

Teil IV: Strategie und Organisation

• Executive Summary (EM/Tech-Lead)
• Kapitel 12: Die Zukunft der agentenbasierten Softwareentwicklung ✅ (Frühindikatoren)
• Kapitel 13: Auswirkungen auf die Softwarebranche ✅
• Schlusswort ✅

Anhang

• A Glossar (inkl. MCP-Begriffe) ✅
• B Übersicht wichtiger MCP-Server für Softwareentwicklung (2026) ✅
• C Benchmarks und Evaluierungsansätze ✅
• D Weiterführende Ressourcen & offizielle MCP-Dokumentation ✅
• E Stichwortverzeichnis ✅
• F Empirische Evidenz 2026 (Feldstudien, Benchmarks, Evidenz-Matrix) ✅

Ergänzungen

• Diagramm-Inventar (bilder/)
• Visuelle Bibel / Diagram Style Guide – Deep Signal L1/L2
• Code-Beispiele (code/) – Hands-on Kap. 10
• Impressum

Meta / Publish

• Design System Deep Signal – Typografie, Layout, Farben, Pipeline
• Lektorats-Backlog – priorisierte Tickets bis Lektorat v1
• Publish-Checkliste – Lizenz, Impressum, CI, Distribution
• LICENSE – Dual-Lizenz (Text CC BY-NC-SA 4.0 · Code MIT)

---

Repository-Struktur

Für Agents: Einstieg, Edit-Grenzen und Betriebsmodus in AGENTS.md.
Task-Skills (Lektorat, Evidenz, Companion, PDF, …): .grok/skills/.

ki-buch/
├── AGENTS.md                 # Agent-Map + Betriebsmodus (SoT vs. generiert)
├── .grok/skills/             # Projekt-Skills (lektorat-pass, evidenz-tag, …)
├── README.md
├── LICENSE / LICENSE-TEXT    # Dual-Lizenz
├── meta/                     # Lektorat, Design, Publish, Evidenz-Guide
├── frontmatter/              # Titelseite, Vorwort, Einleitung, Impressum
├── teil-01-grundlagen/       # Kapitel 1–3
├── teil-02-agenten-mcp/      # Kapitel 4–6
├── teil-03-praxis/           # Kapitel 7–11
├── teil-04-zukunft/          # Kapitel 12–13
├── backmatter/               # Schlusswort
├── anhang/                   # Glossar, Ressourcen, …
├── bilder/                   # Kanon: Cover, figures/, plates/, STYLE
├── assets/parts/             # Teil-Trenner (PDF Part-Pages)
├── code/                     # Companion Kap. 10 (MIT) + code/AGENTS.md
├── justfile                  # just pdf / qa / clean
├── pdf/                      # Live-Pipeline: templates, styles, Lua-Filter
├── scripts/                  # assemble_book.py, check_pdf.py
├── build/                    # Preprocess-Scripts/Fonts + regenerierter Cache
├── dist/                     # Kanonische PDF-Ausgabe
├── _staging/                 # Import-Staging (gitignored, z. B. pics/)
└── .github/workflows/        # CI: Companion-Smoke

---

So liest und renderst du das Buch

1. Im Editor: Öffne die Markdown-Dateien in VS Code, Cursor oder einer vergleichbaren IDE mit Markdown-Vorschau.

2. Mermaid-Diagramme: Werden von GitHub, vielen IDEs und Mermaid Live Editor gerendert. Alle Diagramme sind als ```mermaid Codeblöcke eingebettet; Inventar unter bilder/README.md.

3. Hands-on-Code: code/README.md – Offline-Demo: python examples/05-coding-agent/agent.py --demo.

4. PDF bauen (Just + Pandoc + LuaLaTeX, Pipeline wie ki-hinterm-vorhang):

   just pdf              # voller Build → dist/agentenbasierte-ki-se.pdf
   just pdf-sample       # schnelle Vorschau (Vorwort + Einl. + Kap. 1)
   just pdf-draft        # Draft ohne Mermaid-Neu-Render
   just qa               # Post-Build-Checks
   just clean            # dist/ + build/book.md
   

   Voraussetzungen: just, Pandoc, LuaLaTeX (MacTeX/TeX Live), Python 3, optional Node/npx (@mermaid-js/mermaid-cli).
   Ausgabe: dist/agentenbasierte-ki-se.pdf.
   Ohne Diagramm-Neu-Render: SKIP_MERMAID=1 just pdf.
   Layout: A4, Cover als Seite 1, Deep-Signal-Farben, Charter/DejaVu, Part-Pages, Lua-Filter-Callouts, Mermaid als PNG, umbrechender Code.

   Callout-Farben (automatisch aus > **Label:** …):

   Label im Manuskript	Farbe	Bedeutung
   Analogie	Teal	Verständnis-Brücke
   Pitfall	Rot	Warnung
   Best Practice / Praxis-Tipp	Grün	Empfehlung
   Faustregel / Leitsatz	Indigo	Merkformel
   Repo / Realwelt / Code im Repo	Schiefer	Praxis-Pointer
   sonstige Quotes	Navy	Definition / Zitat

   Kapitelüberschriften in Navy; Fließtext bleibt schwarz. Pipeline: preprocess_callouts.py → LaTeX-tcolorbox in header.tex.

---

Konventionen im Manuskript

Jedes Kapitel enthält:

• Lernziele am Anfang
• Erklärungen mit Analogien und Beispielen (Stand 2026)
• Code (Companion: Python; TypeScript nur als externe SDK-/Host-Referenz, nicht als zweiter Companion-Stack)
• Mermaid-Diagramme (Architekturen, Flows)
• Best Practices und Pitfalls
• Key Takeaways am Ende

Anrede: durchgängig Du (Praktiker-Ton).
Fachbegriffe: englische Termini (Host, Client, Tool Discovery, Context Window …) beim ersten Vorkommen erklärt, danach konsistent verwendet.

MCP-Terminologie (Kurzreferenz)

Begriff	Bedeutung
MCP Host	AI-Anwendung (z. B. Claude Code, Cursor, eigener Agent)
MCP Client	Verbindungs-Komponente im Host (1:1 zu einem Server)
MCP Server	Prozess, der Tools, Resources und/oder Prompts bereitstellt
Tools	Ausführbare Aktionen (model-controlled)
Resources	Lesbare Kontextdaten (application-controlled)
Prompts	Wiederverwendbare Vorlagen/Workflows (user-controlled)

Zentrale Leitmotive (Kurz)

Leitmotiv	Wo vertieft
Agent = Model + Harness	4.5, 5.11, 11.10
Don’t blame the model	5.11, 11.10
Progressive Disclosure	5.4, 5.12, 10.12–10.13
MCP als portable Welt-Schnittstelle	2.6, 4.7, 9–10
Projekt-Information hybrid	5.12, 10.13

---

Tech-Stack der Codebeispiele

Bereich	Stack
Sprache	Python 3.11+ (lauffähige Beispiele unter code/)
MCP	FastMCP / SDK-Muster (STDIO; HTTP skizziert)
Agent-Demo	Eigener Mini-Loop + LocalBus (code/examples/05-coding-agent)
Frameworks (Kontext Kap. 6)	LangGraph, CrewAI, mcp-agent u. a. (narrativ)
Transport	STDIO (lokal), Streamable HTTP (remote)

Code ist Lehr- und Laborcode (Security-Stufe S0–S1): Path-Checks und Deny-Listen ja, kein Production-Sandboxing. Details: Kap. 10.7.5 und code/README.md.
Getestet u. a. mit FastMCP 3.4.x (siehe code/requirements.txt). CI: .github/workflows/ci.yml (Offline-Demo).

---

Lesepfade (Empfehlung)

Ziel	Reihenfolge	30-Min-Kern
Hands-on Lab (Companion first-class)	10.0 → 10.10 L0–L3 → 10.8 Compare → 10.11	Demo · TRACE-DEMO-1 · Policy-Deny · Keep/Throw
Schnellverständnis MCP + Agenten	Vorwort → Einl. → 2.6 → 4 → 10.0 (Demo)	Vorwort-Matrix · 2.6 · 4.7 · 5-Min-Demo
Context Engineering & Projekt-KB	3.7 → 5.8–5.12 → 10.8 Compare, 10.13	3.7 · TRACE-DEMO-1 vs. Baseline · C.12
Harness & Produktion	4.5 → 5.11 → 10.12 + 10.10 L3 → 11	Hooks · HITL · 11.7 Trust
Organisation & Zukunft	7–9, 12–13	Exec Summary Teil III/IV · 12.8 Indikatoren
Nur 30 Minuten (Entscheider)	Exec Summaries I–IV → 10.0 Demo → 11.7.0 Threat-Template	die vier 00-executive-summary.md + Companion

---

Lizenz & Hinweise

Bestandteil	Lizenz
Manuskript, Anhang, meta/, bilder/	CC BY-NC-SA 4.0
code/, Build-Tooling, CI	MIT

Details und Scope: LICENSE · Impressum: frontmatter/impressum.md

• MCP- und API-Details entwickeln sich weiter; das Buch ist ein Architektur- und Musterbuch. Es priorisiert stabile Prinzipien (Host–Client–Server, Tools/Resources/Prompts, Context Engineering, Harness) und kennzeichnet konkrete SDK-/Host-Beispiele als Beispielimplementierung (Stand Juli 2026).
• Haltbarkeit: stabil (Protokoll/Architektur) · mittelstabil (methodische Muster) · volatil (SDK/Host) – siehe Anhang D und Vorwort.
• Companion (lauffähiger Code, CI, Host-Matrix): code/ · Tags book-2026-07 / latest · code/COMPATIBILITY.md
• Offizielle MCP-Spec (Buch-Pin): 2025-11-25 · Docs: modelcontextprotocol.io
• Spec-Revision 2026-07-28 (stateless): gezielt in Kap. 4.8; Companion bleibt auf 2025-11-25 (code/COMPATIBILITY.md)
• Vor Veröffentlichung: meta/PUBLISH-CHECKLISTE.md abarbeiten.

---

Manuskriptstand: 2026-07 · vollständig · Harness + Projekt-Information · Publish-Setup