Publish-Setup: Dual-Lizenz, Impressum, CI, Lektorats- und Publish-Checklisten.

Text/Assets unter CC BY-NC-SA 4.0, Code unter MIT; Demo-Smoke-CI und
Meta-Dokumente für den Weg zur Veröffentlichung ergänzt.

.github/workflows/ci.yml

@@ -0,0 +1,49 @@
+# Smoke-CI für Hands-on-Code (Kap. 10).
+# Kompatibel mit GitHub Actions und Gitea Actions (.github/workflows).
+# PDF-Build ist bewusst nicht im Default-Job (TeX/Node zu schwer für schlanke Runner).
+
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+  workflow_dispatch:
+
+jobs:
+  demo:
+    name: Coding-Agent Demo
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: code
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+          cache-dependency-path: code/requirements.txt
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt pytest
+
+      - name: Syntax check (py_compile)
+        run: |
+          python -m py_compile \
+            01-minimal-server/server.py \
+            02-project-memory/server.py \
+            03-codebase-graph/server.py \
+            04-dev-tools/server.py \
+            05-coding-agent/agent.py \
+            05-coding-agent/local_bus.py
+
+      - name: Offline agent demo
+        run: python 05-coding-agent/agent.py --demo

LICENSE

@@ -0,0 +1,48 @@
+# Lizenzübersicht
+
+Dieses Repository verwendet eine **geteilte Lizenz** (Dual Licensing nach Bestandteil).
+
+## Manuskript, Dokumentation und visuelle Assets — CC BY-NC-SA 4.0
+
+Die folgenden Inhalte stehen unter der
+**Creative Commons Namensnennung – Nicht kommerziell – Weitergabe unter gleichen Bedingungen 4.0 International**
+(CC BY-NC-SA 4.0):
+
+- `frontmatter/`
+- `teil-01-grundlagen/`, `teil-02-agenten-mcp/`, `teil-03-praxis/`, `teil-04-zukunft/`
+- `backmatter/`
+- `anhang/`
+- `bilder/` (Cover, Konzept-Plates, STYLE/README)
+- `meta/`
+- `README.md` und sonstige Projektdokumentation im Repo-Root (soweit nicht anders gekennzeichnet)
+
+Volltext und Hinweise: [`LICENSE-TEXT`](LICENSE-TEXT)  
+Human-readable Deed: https://creativecommons.org/licenses/by-nc-sa/4.0/  
+Legal Code: https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode
+
+**Kurz:** Teilen und Bearbeiten unter Namensnennung, **nicht kommerziell**, Weitergabe unter gleicher Lizenz.
+Kommerzielle Verwertung des Textes (z. B. Verkauf als Buch) bedarf einer gesonderten Vereinbarung mit dem Rechteinhaber.
+
+## Code-Beispiele und Tooling — MIT
+
+Die folgenden Inhalte stehen unter der **MIT License**:
+
+- alles unter `code/`
+- Build- und Hilfsskripte unter `build/` (z. B. `build-pdf.sh`, `preprocess_*.py`, `header.tex`, `imprint.tex`, `metadata.yaml`)
+- CI-Workflows unter `.github/`
+
+Volltext für den Code-Baum: [`code/LICENSE`](code/LICENSE)
+
+## Copyright
+
+Copyright (c) 2026 Martin Richardt
+
+## Haftungsausschluss (Lehrcode)
+
+Die Beispiele unter `code/` sind **Lehr- und Laborcode** (Security-Stufe S0–S1).
+Keine Garantie für Produktionsreife. Nutzung auf eigene Verantwortung.
+
+## Drittmarken
+
+Produkt- und Protokollnamen (z. B. MCP, Framework- und IDE-Namen) sind Eigentum der jeweiligen Inhaber
+und dienen nur der Beschreibung. Dieses Werk ist keine offizielle Dokumentation dieser Projekte.

LICENSE-TEXT

@@ -0,0 +1,51 @@
+# Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International
+
+Copyright (c) 2026 Martin Richardt
+
+This work (manuscript, documentation, and visual assets as defined in the root
+`LICENSE` file) is licensed under the Creative Commons Attribution-NonCommercial-
+ShareAlike 4.0 International License.
+
+You are free to:
+
+- **Share** — copy and redistribute the material in any medium or format
+- **Adapt** — remix, transform, and build upon the material
+
+Under the following terms:
+
+- **Attribution** — You must give appropriate credit, provide a link to the
+  license, and indicate if changes were made.
+- **NonCommercial** — You may not use the material for commercial purposes.
+- **ShareAlike** — If you remix, transform, or build upon the material, you must
+  distribute your contributions under the same license as the original.
+- **No additional restrictions** — You may not apply legal terms or technological
+  measures that legally restrict others from doing anything the license permits.
+
+Notices:
+
+- You do not have to comply with the license for elements of the material in the
+  public domain or where your use is permitted by an applicable exception or
+  limitation.
+- No warranties are given. The license may not give you all of the permissions
+  necessary for your intended use.
+
+---
+
+**Deed (human-readable):** https://creativecommons.org/licenses/by-nc-sa/4.0/  
+**Legal Code:** https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode  
+**SPDX:** `CC-BY-NC-SA-4.0`
+
+The full legal code is incorporated by reference. In case of conflict between
+this summary and the legal code, the legal code prevails.
+
+---
+
+## Deutsche Kurzfassung (unverbindlich)
+
+**Namensnennung – Nicht-kommerziell – Weitergabe unter gleichen Bedingungen 4.0**
+
+Du darfst das Material teilen und bearbeiten, sofern du den Urheber nennst,
+das Material **nicht kommerziell** nutzt und Bearbeitungen unter derselben
+Lizenz weitergibst. Es werden keine Garantien übernommen.
+
+Maßgeblich ist der englische Legal Code der CC BY-NC-SA 4.0.

README.md

@@ -34,7 +34,7 @@ Zentrale Themen:
 | Tech-Lead / Architect | Architekturen, Risiken und Team-Rollen einzuordnen |
 | AI Engineer | Context Engineering, Tooling und Evaluierung zu professionalisieren |
 
-**Voraussetzungen:** solides Software-Engineering (Git, APIs, Tests), Grundkenntnisse in Python und/oder TypeScript, erste Erfahrung mit Chat-LLMs. Tiefes ML-Forschungs-Know-how ist **nicht** nötig.
+**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.
 
 ---
 
@@ -108,6 +108,13 @@ Zentrale Themen:
 
 - [Diagramm-Inventar (`bilder/`)](bilder/README.md)
 - [Code-Beispiele (`code/`)](code/README.md) – Hands-on Kap. 10
+- [Impressum](frontmatter/impressum.md)
+
+### Meta / Publish
+
+- [Lektorats-Backlog](meta/LEKTORAT-BACKLOG.md) – priorisierte Tickets bis Lektorat v1
+- [Publish-Checkliste](meta/PUBLISH-CHECKLISTE.md) – Lizenz, Impressum, CI, Distribution
+- [LICENSE](LICENSE) – Dual-Lizenz (Text CC BY-NC-SA 4.0 · Code MIT)
 
 ---
 
@@ -116,22 +123,22 @@ Zentrale Themen:
 ```text
 buch-agentenbasierte-ki-software/
 ├── README.md
-├── frontmatter/          # Titelseite, Vorwort, Einleitung
-├── 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/               # Cover, Diagramm-Inventar, Konzept-Plates
-│   ├── cover-ki-book.jpg # offizielle Titelseite / Cover
-│   ├── plates/           # ~20 Konzept-Illustrationen (im PDF vor Mermaid)
-│   └── STYLE.md          # visuelle Bibel
-├── code/                 # Lauffähige MCP-Server + Coding-Agent-Demo (Kap. 10)
-└── build/                # PDF-Pipeline (Pandoc) + generiertes PDF
-    ├── build-pdf.sh
-    ├── preprocess_mermaid.py
-    └── Agentenbasierte-KI-unterstuetzte-Softwareentwicklung.pdf
+├── LICENSE / LICENSE-TEXT    # Dual-Lizenz
+├── meta/                     # Lektorat & Publish-Checkliste
+├── 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/                   # Cover, Diagramm-Inventar, Konzept-Plates
+│   ├── cover-ki-book.jpg
+│   ├── plates/
+│   └── STYLE.md
+├── code/                     # MCP-Server + Coding-Agent-Demo (Kap. 10, MIT)
+├── build/                    # PDF-Pipeline (Pandoc) + generiertes PDF
+└── .github/workflows/        # CI: Demo-Smoke-Test
 ```
 
 ---
@@ -209,13 +216,14 @@ Jedes Kapitel enthält:
 
 | Bereich | Stack |
 |---------|--------|
-| Sprache | Python 3.11+, TypeScript-Skizzen wo sinnvoll |
+| Sprache | **Python 3.11+** (lauffähige Beispiele unter `code/`) |
 | MCP | FastMCP / SDK-Muster (STDIO; HTTP skizziert) |
 | Agent-Demo | Eigener Mini-Loop + LocalBus (`code/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`.
+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).
 
 ---
 
@@ -232,10 +240,17 @@ Code ist **Lehr- und Laborcode** (Security-Stufe S0–S1): Path-Checks und Deny-
 
 ## Lizenz & Hinweise
 
-- Manuskript und Beispiele: für Lern- und Projektzwecke im eigenen Team freigegeben (bei Veröffentlichung bitte Lizenz klären).
+| Bestandteil | Lizenz |
+|-------------|--------|
+| Manuskript, Anhang, `meta/`, `bilder/` | **[CC BY-NC-SA 4.0](LICENSE-TEXT)** |
+| `code/`, Build-Tooling, CI | **[MIT](code/LICENSE)** |
+
+Details und Scope: [`LICENSE`](LICENSE) · Impressum: [`frontmatter/impressum.md`](frontmatter/impressum.md)
+
 - MCP- und API-Details entwickeln sich weiter; das Buch priorisiert **stabile Architekturprinzipien** und kennzeichnet spezifikationsabhängige Details.
 - Offizielle MCP-Dokumentation: [https://modelcontextprotocol.io](https://modelcontextprotocol.io)
+- Vor Veröffentlichung: [`meta/PUBLISH-CHECKLISTE.md`](meta/PUBLISH-CHECKLISTE.md) abarbeiten.
 
 ---
 
-*Manuskriptstand: vollständig · Erweiterungen Harness + Projekt-Information · 2026*
+*Manuskriptstand: 2026-07 · vollständig · Harness + Projekt-Information · Publish-Setup*

build/build-pdf.sh

@@ -74,7 +74,7 @@ python3 "$BUILD/preprocess_callouts.py" --src-dir "$BUILD/src"
 
 # --- 2) Source list (processed copies) ---
 # Cover = Seite 1 via \maketitle in header.tex (nicht erneut aus titelseite.md).
-# Impressum: build/imprint.md als include-before (zwischen Cover und TOC).
+# Impressum: build/imprint.tex als include-before (zwischen Cover und TOC).
 SOURCES=(
   "$BUILD/src/frontmatter/vorwort.md"
   "$BUILD/src/frontmatter/einleitung.md"

build/imprint.tex

@@ -1,31 +1,50 @@
-% Kurzes Impressum nach Cover, vor Inhaltsverzeichnis
+% Impressum nach Cover, vor Inhaltsverzeichnis
 \thispagestyle{empty}
 \begin{center}
-\vspace*{2.2cm}
+\vspace*{1.8cm}
 
 {\sffamily\Large Martin Richardt\par}
 
-\vspace{1.15cm}
+\vspace{1.0cm}
 
 {\sffamily\Huge\bfseries Agentenbasierte KI-unterstützte\\[0.35em]
 Softwareentwicklung\par}
 
-\vspace{0.95cm}
+\vspace{0.85cm}
 
 {\large
 Von Large Language Models zu autonomen Entwicklungsagenten\\
 -- inklusive Model Context Protocol (MCP)\\
 und moderner Kontext-Engineering\par}
 
-\vspace{1.4cm}
+\vspace{1.15cm}
 
 {\normalsize
 Ein praxisorientiertes Fachbuch für Softwareentwicklerinnen und
--entwickler, Tech-Leads und AI Engineers (Stand 2026).\par}
+-entwickler, Tech-Leads und AI Engineers.\par}
 
-\vspace{2.2cm}
+\vspace{0.55cm}
+
+{\normalsize Manuskriptstand: 2026-07\par}
+
+\vspace{1.35cm}
+
+{\small
+\textcopyright{} 2026 Martin Richardt\par
+\vspace{0.35em}
+Text \& Abbildungen: CC BY-NC-SA 4.0 \quad\cdot\quad Code: MIT\par
+}
+
+\vspace{1.1cm}
+
+{\small\color{black!60}
+\begin{minipage}{0.88\textwidth}
+\centering
+Lehr- und Laborcode (Security-Stufe S0--S1) ohne Produktionsgarantie.
+Produktnamen Dritter dienen der Beschreibung.
+Manuskript: Markdown \cdot{} PDF-Build: Pandoc + XeLaTeX.
+\end{minipage}
+\par}
 
-{\small\color{black!55}
-Manuskript: Markdown · PDF-Build: Pandoc + XeLaTeX\par}
 \end{center}
 \clearpage

code/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Martin Richardt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

code/README.md

@@ -3,6 +3,9 @@
 Praxisnahe Skizzen zu MCP-Servern und einem Mini-Coding-Agenten.  
 **Python 3.11+**. FastMCP-APIs können je nach Version leicht abweichen – die Architektur bleibt gültig.
 
+**Lizenz:** [MIT](LICENSE) · **Getestet mit:** FastMCP 3.4.x (siehe `requirements.txt`, Stand 2026-07)  
+**CI:** Root-Workflow `.github/workflows/ci.yml` führt `agent.py --demo` aus.
+
 ## Struktur
 
 | Ordner | Inhalt |

code/requirements.txt

@@ -1,3 +1,4 @@
 # Hands-on Kapitel 10 – Python 3.11+
-fastmcp>=2.0.0
-pydantic>=2.0.0
+# Getestet mit: fastmcp 3.4.x (lokaler Dev-Stand 2026-07)
+fastmcp>=2.0.0,<4
+pydantic>=2.0.0,<3

frontmatter/impressum.md

@@ -0,0 +1,62 @@
+# Impressum & Rechtliches
+
+**Titel:** Agentenbasierte KI-unterstützte Softwareentwicklung  
+**Untertitel:** Von Large Language Models zu autonomen Entwicklungsagenten – inklusive Model Context Protocol (MCP) und moderner Kontext-Engineering  
+
+**Autor:** Martin Richardt  
+**Manuskriptstand:** 2026-07  
+
+---
+
+## Copyright
+
+© 2026 Martin Richardt. Alle Rechte vorbehalten, soweit nicht durch die unten genannten Lizenzen freigegeben.
+
+---
+
+## Lizenzen
+
+| Bestandteil | Lizenz | Details |
+|-------------|--------|---------|
+| Manuskript, Anhang, `meta/`, `bilder/` | **CC BY-NC-SA 4.0** | [`LICENSE-TEXT`](../LICENSE-TEXT) |
+| Code unter `code/`, Build-Tooling, CI | **MIT** | [`code/LICENSE`](../code/LICENSE) |
+
+Gesamtüberblick: [`LICENSE`](../LICENSE)
+
+---
+
+## Haftungsausschluss
+
+- Die Code-Beispiele sind **Lehr- und Laborcode** (Security-Stufe S0–S1): Path-Checks und Deny-Listen ja, kein Production-Sandboxing.
+- Keine Gewähr für Vollständigkeit, Aktualität von APIs/Frameworks oder Eignung für den produktiven Einsatz.
+- Produkt- und Protokollnamen Dritter dienen der Beschreibung; dieses Werk ist keine offizielle Dokumentation dieser Produkte.
+
+---
+
+## PDF-Build
+
+Manuskript: Markdown · PDF: Pandoc + XeLaTeX · Diagramme: Mermaid  
+Pipeline: `build/build-pdf.sh`
+
+---
+
+## Angaben für öffentliche Website / Verlag *(Platzhalter)*
+
+> Nur ausfüllen, wenn das Werk öffentlich im Web angeboten wird oder ein Verlag/Self-Pub es verlangt.
+> Interne Team-Nutzung benötigt diese Felder typischerweise nicht.
+
+| Feld | Wert |
+|------|------|
+| Anbieter / Verlag | `[TODO]` |
+| Anschrift | `[TODO]` |
+| Kontakt (E-Mail) | `[TODO]` |
+| Verantwortlich i. S. d. Presserechts | `[TODO]` |
+| ISBN | `[TODO — optional Self-Pub]` |
+| Erscheinungsort / -jahr | `[TODO]` |
+
+---
+
+## Verweise
+
+- Lektorats-Backlog: [`meta/LEKTORAT-BACKLOG.md`](../meta/LEKTORAT-BACKLOG.md)
+- Publish-Checkliste: [`meta/PUBLISH-CHECKLISTE.md`](../meta/PUBLISH-CHECKLISTE.md)

meta/LEKTORAT-BACKLOG.md

@@ -0,0 +1,183 @@
+# Lektorats-Backlog
+
+Abarbeitbare Tickets für Manuskript, Code-Parität und Publish-Reife.  
+Stand der Analyse: **2026-07** · Manuskript ~48 000 Wörter · PDF ~276 Seiten.
+
+Verwandt: [`PUBLISH-CHECKLISTE.md`](PUBLISH-CHECKLISTE.md)
+
+---
+
+## Legende
+
+| Prio | Bedeutung |
+|------|-----------|
+| **P0** | Blocker vor öffentlicher Veröffentlichung |
+| **P1** | Soll vor Version 1.0 erledigt sein |
+| **P2** | Qualität / Lesefluss |
+| **P3** | Nice-to-have / spätere Auflage |
+
+| Aufwand | Richtwert |
+|---------|-----------|
+| **S** | < 1 h |
+| **M** | 1–4 h |
+| **L** | > 4 h / mehrtägig |
+
+Status: `[ ]` offen · `[~]` in Arbeit · `[x]` erledigt
+
+---
+
+## Definition of Done – Lektorat v1
+
+- [ ] Alle **P0**- und **P1**-Tickets erledigt oder bewusst verworfen (mit Begründung)
+- [ ] Ein voller Lesepass (oder Vier-Augen) auf Kap. 4, 5, 10, 11
+- [ ] `python 05-coding-agent/agent.py --demo` grün; Kap. 10 stimmt mit Demo überein
+- [ ] Terminologie-Glossar (Anhang A) deckt neue Leitmotive ab (Harness, Progressive Disclosure, AGENTS.md)
+- [ ] Keine „WIP“-/Platzhalter-Formulierungen im Manuskript
+- [ ] Publish-Checkliste Abschnitte 1–5 grün (siehe `PUBLISH-CHECKLISTE.md`)
+
+---
+
+## Globale Tracks
+
+### G1 · Terminologie & Konsistenz
+
+| ID | Ticket | Prio | Aufwand | Status |
+|----|--------|------|---------|--------|
+| G1.1 | MCP-Terms (Host/Client/Server, Tools/Resources/Prompts) einmal pro Kapitel prüfen: erstes Vorkommen erklärt? | P1 | M | [ ] |
+| G1.2 | Leitmotive vereinheitlichen: *Agent = Model + Harness*, *Don’t blame the model*, *Progressive Disclosure* – gleiche Schreibweise/Anführungszeichen | P1 | S | [ ] |
+| G1.3 | „Context Engineering“ vs. „Kontext-Management“ vs. „Kontext-Engineering“ – eine Primärform wählen, Alternativen nur bei Erstnennung | P2 | S | [ ] |
+| G1.4 | Du-Anrede durchgängig; kein Sie; Team-„ihr“ nur wo bewusst | P2 | S | [ ] |
+| G1.5 | Callout-Labels nur: Analogie, Pitfall, Best Practice, Praxis-Tipp, Faustregel, Leitsatz, Repo/Realwelt/Code im Repo (Pipeline-Kompatibilität) | P1 | S | [ ] |
+
+### G2 · Quellen & Aktualität
+
+| ID | Ticket | Prio | Aufwand | Status |
+|----|--------|------|---------|--------|
+| G2.1 | Quellenminimum: Transformer-Paper, MCP-Spec-URL, 3–5 zentrale Framework-/IDE-Quellen in Anhang D oder Fußnoten | P0 | M | [ ] |
+| G2.2 | „Stand 2026“-Datum konkretisieren (z. B. 2026-07) in Vorwort/Impressum/README | P0 | S | [ ] |
+| G2.3 | Kap. 6 Framework-Matrix: jede Zelle als „Orientierung, nicht Ranking“ kennzeichnen; veraltete Namen streichen | P1 | M | [ ] |
+| G2.4 | Kap. 9 IDE-/Host-Namen gegen aktuellen Markt abgleichen | P1 | M | [ ] |
+| G2.5 | Update-Policy schreiben (1 Absatz): was bei MCP-Spec-Breaking-Changes passiert | P1 | S | [ ] |
+
+### G3 · Kapitelbalance
+
+| ID | Ticket | Prio | Aufwand | Status |
+|----|--------|------|---------|--------|
+| G3.1 | **Kap. 5** (~6500 Wörter): Wiederholungen Memory/AGENTS.md/Hybrid straffen; Verweis auf 10.13 statt Doppelung | P1 | L | [ ] |
+| G3.2 | **Kap. 8** (~1800): Multi-Agent-Fail-Cases + ein durchgängiges Mini-Szenario ergänzen *oder* explizit als „Kompaktkapitel“ labeln | P2 | M | [ ] |
+| G3.3 | **Kap. 6**: Tiefe vs. Orientierung entscheiden; bei Orientierung: Lernziele anpassen | P2 | M | [ ] |
+| G3.4 | **Kap. 12–13**: Spekulation vs. belastbare Trends trennen (eigene Unterüberschriften) | P2 | M | [ ] |
+
+### G4 · Typografie & Stil (Manuskript-Pass)
+
+| ID | Ticket | Prio | Aufwand | Status |
+|----|--------|------|---------|--------|
+| G4.1 | Einheitliche Anführungszeichen deutsch („…“) vs. Code/ASCII | P2 | M | [ ] |
+| G4.2 | Geschützte Leerzeichen vor Einheiten/% wo sinnvoll; Gedankenstrich – vs. Bindestrich | P3 | M | [ ] |
+| G4.3 | Doppelte Leerzeichen, trailing whitespace, inkonsistente `---` | P2 | S | [ ] |
+| G4.4 | Codeblöcke: Sprache getaggt (`python`, `yaml`, `mermaid`, `text`) | P2 | S | [ ] |
+| G4.5 | PDF-Spotcheck: Callouts, Plates, Mermaid, lange Codezeilen (Umbuch) | P1 | M | [ ] |
+
+### G5 · Code ↔ Text-Parität
+
+| ID | Ticket | Prio | Aufwand | Status |
+|----|--------|------|---------|--------|
+| G5.1 | README: TypeScript-Versprechen an Realität anpassen (Python only) *oder* 1 TS-Skizze ergänzen | P0 | S | [ ] |
+| G5.2 | Kap. 10: Tool-Namen, Pfade, Demo-Schritte vs. `code/05-coding-agent` abgleichen | P0 | M | [ ] |
+| G5.3 | FastMCP: „getestet mit Version X“ in `code/README.md` und Kap. 10 Security/Setup | P1 | S | [ ] |
+| G5.4 | LocalBus vs. echtes STDIO-MCP: im Kap. 10 und `agent.py`-Docstring prominent (ein Satz reicht) | P1 | S | [ ] |
+| G5.5 | requirements pinnen / oberen Major-Cap setzen; CI hält Demo grün | P0 | S | [ ] |
+
+### G6 · Visuals
+
+| ID | Ticket | Prio | Aufwand | Status |
+|----|--------|------|---------|--------|
+| G6.1 | Alle Plate-Referenzen im Text existieren unter `bilder/plates/` | P1 | S | [ ] |
+| G6.2 | Plate-Beschriftungen vs. Kapitelterminologie (Harness, MCP Host) | P2 | M | [ ] |
+| G6.3 | Mermaid: zu breite Diagramme im PDF (Spotcheck Kap. 5, 10) | P2 | M | [ ] |
+| G6.4 | Cover: Print-DPI/Farbraum nur bei Print-Auflage (Self-Pub) | P3 | M | [ ] |
+
+---
+
+## Kapitelweise Tickets
+
+### Frontmatter
+
+| ID | Ticket | Prio | Aufwand | Status |
+|----|--------|------|---------|--------|
+| F.1 | Vorwort: Versprechen (was das Buch *nicht* ist) mit Kap. 6/12 abgleichen | P2 | S | [ ] |
+| F.2 | Einleitung: Evolutionsstufen-Tabelle mit Kap. 1/4 konsistent | P2 | S | [ ] |
+| F.3 | Impressum-Felder für öffentliche Website/Verlag ausfüllen (`frontmatter/impressum.md`) | P0 | S | [ ] |
+
+### Teil I – Grundlagen
+
+| ID | Kapitel | Ticket | Prio | Aufwand | Status |
+|----|---------|--------|------|---------|--------|
+| T1.1 | Kap. 1 | Timeline 2024–2026: MCP-Einführung nicht überzeichnen; Quelle/Jahr prüfen | P1 | S | [ ] |
+| T1.2 | Kap. 2 | „Technische Funktionsweise“: Länge ok, aber 1–2 Absätze zu Sampling/Limits mit Agenten-Bezug verknüpfen (Bridge zu Kap. 3) | P3 | S | [ ] |
+| T1.3 | Kap. 3 | Context Engineering als Disziplin: Definition einmal „kanonisch“, später nur verweisen | P1 | S | [ ] |
+| T1.4 | Kap. 1–3 | Übungen: Zeitbedarf grob angeben (optional) | P3 | S | [ ] |
+
+### Teil II – Agenten & MCP
+
+| ID | Kapitel | Ticket | Prio | Aufwand | Status |
+|----|---------|--------|------|---------|--------|
+| T2.1 | Kap. 4 | Harness-Abschnitt (4.5) vs. Kap. 5.11: Querverweise, minimale Doppelung | P1 | M | [ ] |
+| T2.2 | Kap. 4 | USB-C-Analogie nicht inflationär; 1× prägnant + Verweis | P2 | S | [ ] |
+| T2.3 | Kap. 5 | **Straffungs-Kandidaten:** 5.12 vs. 10.13 – Theorie hier, Praxis dort; Tabellen deduplizieren | P1 | L | [ ] |
+| T2.4 | Kap. 5 | Failure Modes (Kontext-Drift, Tool-Kollision) mit Kap. 11 Threat Model verlinken | P2 | S | [ ] |
+| T2.5 | Kap. 6 | Code-Snippets als „illustrativ, API-Namen je Version“ – einheitlicher Disclaimer pro Listing | P1 | S | [ ] |
+| T2.6 | Kap. 6 | mcp-agent / CrewAI / LangGraph: je 1 Satz „wann wählen“ behalten, Feature-Listen kürzen | P2 | M | [ ] |
+
+### Teil III – Praxis
+
+| ID | Kapitel | Ticket | Prio | Aufwand | Status |
+|----|---------|--------|------|---------|--------|
+| T3.1 | Kap. 7 | Autonomy-Levels L0–L3 mit Kap. 11 Error Budgets abgleichen | P1 | S | [ ] |
+| T3.2 | Kap. 8 | Ein End-to-End-Szenario (Issue → PR) skizzieren, Rollen an MCP-Server koppeln | P2 | M | [ ] |
+| T3.3 | Kap. 9 | Host-Config-Beispiel vs. `code/host-config.example.json` paritätisch | P1 | S | [ ] |
+| T3.4 | Kap. 10 | Setup-Pfad exakt wie `code/README.md` (venv, pytest, `--demo`) | P0 | S | [ ] |
+| T3.5 | Kap. 10 | Skills 10.12 + KB 10.13: Checkliste „Done wenn Demo-Trace X enthält“ | P1 | S | [ ] |
+| T3.6 | Kap. 10 | Security 10.7.5: S0–S1 klar; kein Production-Claim | P0 | S | [ ] |
+| T3.7 | Kap. 11 | Production Harness 11.10 mit 5.11/4.5 Querverweis-Matrix | P1 | S | [ ] |
+| T3.8 | Kap. 11 | Policy-YAML-Beispiele: „illustrativ“ + kein Copy-Paste-in-Prod ohne Review | P1 | S | [ ] |
+
+### Teil IV – Zukunft
+
+| ID | Kapitel | Ticket | Prio | Aufwand | Status |
+|----|---------|--------|------|---------|--------|
+| T4.1 | Kap. 12 | Spekulative Abschnitte als solche markieren; 2–3 belastbare Trends priorisieren | P2 | M | [ ] |
+| T4.2 | Kap. 13 | Rollen (Agent Platform Eng, …) mit Kap. 7/8 Skills-Tabelle harmonisieren | P2 | S | [ ] |
+| T4.3 | Schlusswort | Call-to-Action: nächster konkreter Schritt (Demo starten) belassen | P3 | S | [ ] |
+
+### Anhang
+
+| ID | Ticket | Prio | Aufwand | Status |
+|----|--------|------|---------|--------|
+| A.1 | Glossar A: neue Begriffe aus Harness/KB-Erweiterung (Skill Catalog, Recovery Pack, CA-MCP) vollständig? | P1 | M | [ ] |
+| A.2 | Anhang B: Server-Liste mit „Stand“ und „Community vs. offiziell“ | P2 | M | [ ] |
+| A.3 | Anhang C: Benchmarks – keine überzogenen Performance-Claims ohne Quelle | P1 | S | [ ] |
+| A.4 | Anhang D: MCP-Docs + License-Links + dieses Meta-Verzeichnis | P1 | S | [ ] |
+| A.5 | Anhang E: Stichwortverzeichnis nach großen Kap.-Edits neu ziehen (manuell) | P2 | L | [ ] |
+
+---
+
+## Empfohlene Abarbeitungsreihenfolge
+
+1. **P0-Batch (Publish-Blocker):** F.3, G2.1–G2.2, G5.1–G5.2, G5.5, T3.4, T3.6  
+2. **P1-Kernlektüre:** Kap. 4 → 5 (straffen) → 10 → 11 + G1 Terminologie  
+3. **P1-Ökosystem:** Kap. 6, 9, G2.3–G2.4  
+4. **P2-Balance & Stil:** G3, G4, Kap. 8/12/13  
+5. **P3:** Print-Assets, Feinschliff Typografie  
+
+---
+
+## Notizen aus Projektbewertung (Kontext)
+
+- Stärken beibehalten: Leitmotive, Hands-on-Demo, Kap. 11 Governance, PDF-Pipeline.  
+- Nicht über-lektorieren: Lehrcode darf skizzenhaft bleiben, solange Security-Ehrlichkeit bleibt.  
+- CC-BY-NC-SA: bei Verlagsvertrag NC-Kompatibilität prüfen (separate Rechte möglich).  
+
+---
+
+*Dieses Backlog ist ein Arbeitsdokument und unterliegt derselben Textlizenz wie das Manuskript (siehe Root-`LICENSE`).*

meta/PUBLISH-CHECKLISTE.md

@@ -0,0 +1,197 @@
+# Publish-Checkliste
+
+Gate-Liste bis zur internen oder öffentlichen Veröffentlichung.  
+Lizenz-Default: **Text/Assets CC BY-NC-SA 4.0** · **Code MIT** · Stand-Feld: **2026-07**.
+
+Verwandt: [`LEKTORAT-BACKLOG.md`](LEKTORAT-BACKLOG.md) · [`../frontmatter/impressum.md`](../frontmatter/impressum.md)
+
+---
+
+## 0 · Release-Typ wählen
+
+- [ ] **Intern / Team only** (Private Git, keine öffentliche Website)
+- [ ] **Öffentliches Repo** (README + LICENSE sichtbar)
+- [ ] **Self-Publishing PDF/Print**
+- [ ] **Verlag** (zusätzliche Rechtevergabe nötig – NC beachten)
+
+Je Typ unterschiedliche Pflichtfelder in Abschnitt 2 und 8.
+
+---
+
+## 1 · Recht & Lizenz
+
+- [x] Dual-Lizenz dokumentiert: Root-[`LICENSE`](../LICENSE), [`LICENSE-TEXT`](../LICENSE-TEXT), [`code/LICENSE`](../code/LICENSE)
+- [x] README-Lizenzabschnitt verweist auf Split (kein „bitte später klären“)
+- [ ] **Cover & Plates:** alle unter `bilder/` sind eigene Werke / freigegebene Generierung (keine fremden Stock-Assets ohne Lizenz)
+- [ ] **Drittmarken:** MCP, Produkt- und Firmennamen nur beschreibend; kein Irreführen als offizielle Doku
+- [ ] **Zitate & Abbildungen Dritter:** falls später ergänzt – Rechte geklärt
+- [ ] **Verlagsweg:** NC-Klausel geprüft; ggf. separate kommerzielle Lizenz für Text verhandelbar
+- [ ] Keine Secrets, API-Keys, personenbezogene Daten im Repo
+
+**Hinweis CC BY-NC-SA 4.0:** nicht-kommerzielle Nutzung, Namensnennung, ShareAlike. Kommerzielle Buchvermarktung des *Textes* erfordert andere Rechte vom Rechteinhaber.
+
+**Hinweis MIT (Code):** freie Nutzung inkl. kommerziell; Copyright-Hinweis und Lizenztext beibehalten.
+
+---
+
+## 2 · Impressum & Metadaten
+
+- [x] PDF-Impressum: [`build/imprint.tex`](../build/imprint.tex) (Copyright, Lizenzkurz, Stand)
+- [x] Editor-Impressum: [`frontmatter/impressum.md`](../frontmatter/impressum.md)
+- [ ] Platzhalter in `impressum.md` für öffentliche Website ausfüllen:
+  - [ ] Kontakt / E-Mail
+  - [ ] Anschrift (falls TMG/DDG-pflichtig)
+  - [ ] Verantwortliche Person
+- [ ] Optional Self-Pub: ISBN, Verlag, Erscheinungsort
+- [ ] `build/metadata.yaml`: Titel, Autor, `lang: de-DE` aktuell
+- [ ] Manuskriptstand-Datum in README-Footer und Impressum identisch (z. B. 2026-07)
+
+---
+
+## 3 · Inhaltliche Gates
+
+- [ ] Lektorat **P0 + P1** aus [`LEKTORAT-BACKLOG.md`](LEKTORAT-BACKLOG.md) erledigt oder verworfen
+- [ ] Keine Platzhalter (`TODO`, `TBD`, `lorem`) im Manuskript (außer bewusste Impressum-TODOs vor Website-Go-Live)
+- [ ] Lernziele + Key Takeaways in Kap. 1–13 vorhanden
+- [ ] Lesepfade im README getestet (Links gültig)
+- [ ] Anhang A–E vorhanden und aus Schlusswort/README verlinkt
+- [ ] Quellenminimum (Backlog G2.1) erfüllt
+
+---
+
+## 4 · Code-Gates
+
+```bash
+cd buch-agentenbasierte-ki-software/code
+python -m venv .venv && source .venv/bin/activate
+pip install -r requirements.txt pytest
+python -m py_compile \
+  01-minimal-server/server.py \
+  02-project-memory/server.py \
+  03-codebase-graph/server.py \
+  04-dev-tools/server.py \
+  05-coding-agent/agent.py \
+  05-coding-agent/local_bus.py
+python 05-coding-agent/agent.py --demo
+```
+
+- [ ] Demo endet mit `tests_ok: true` / Success-Trace
+- [ ] `code/README.md`: Setup, Security S0–S1, getestete FastMCP-Version
+- [ ] Kein generisches Shell-Tool in den Beispielen
+- [ ] `host-config.example.json` ohne echte Secrets
+- [ ] `requirements.txt` mit oberem Versions-Cap
+
+---
+
+## 5 · PDF-Gates
+
+```bash
+cd buch-agentenbasierte-ki-software
+./build/build-pdf.sh
+# schnellere Iteration:
+SKIP_MERMAID=1 ./build/build-pdf.sh
+```
+
+- [ ] Build exit 0; PDF unter `build/Agentenbasierte-KI-unterstuetzte-Softwareentwicklung.pdf`
+- [ ] Seite 1 = Cover
+- [ ] Impressum nach Cover, vor TOC: ©, Lizenzkurz, Stand
+- [ ] TOC navigierbar; Kapitel 1–13 + Anhang
+- [ ] Spotcheck Callouts (Farbe/Label), Plates, Mermaid-PNGs
+- [ ] Keine massiven Overfull-Boxen auf Stichproben-Seiten
+- [ ] Voraussetzungen dokumentiert: Pandoc, XeLaTeX, npx/mmdc
+
+---
+
+## 6 · CI
+
+- [x] Workflow vorhanden: [`.github/workflows/ci.yml`](../.github/workflows/ci.yml)
+- [ ] **Gitea Actions** (oder GitHub Actions) im Repo aktiviert
+- [ ] Runner verfügbar; Workflow auf `main` grün
+- [ ] PR-Policy: Demo-Job required (optional branch protection)
+- [ ] PDF-Build bleibt **manuell** (zu schwer für Default-Runner) – bewusst
+
+Remote-Hinweis: `origin` zeigt auf Gitea (`http://10.27.27.139:3000/...`). Workflow-Syntax ist Actions-kompatibel; unter Gitea ggf. Actions im Admin aktivieren.
+
+---
+
+## 7 · Repo-Hygiene
+
+- [ ] `.gitignore`: `.venv/`, `__pycache__/`, `build/src/`, `build/mermaid/`, Previews
+- [ ] Keine lokalen Secrets / `.env` committed
+- [ ] **PDF-Policy entschieden:**
+  - [ ] Variante A: fertiges PDF im Repo committen (Status quo, ~9 MB)  
+  - [ ] Variante B: PDF nur als Release-Artifact / CI-Upload
+- [ ] `build/_preview/`, `_debug.*` nicht committen
+- [ ] Große Binaries (Plates) ok; keine unnötigen Duplikate
+
+---
+
+## 8 · Distribution
+
+### Intern
+
+- [ ] Zugang nur für Zielgruppe; README erklärt Setup
+- [ ] Lizenz trotzdem gesetzt (Klarheit bei Weitergabe)
+
+### Öffentliches Repo
+
+- [ ] LICENSE-Dateien im Root sichtbar
+- [ ] README: Zielgruppe, Lesepfade, Code-Demo, Lizenz, Stand
+- [ ] Security-Hinweis Lehrcode prominent
+- [ ] Kontakt / Issues-Policy (optional)
+
+### Self-Pub / Print
+
+- [ ] Cover Druckdaten (DPI, Beschnitt)
+- [ ] ISBN / Impressum vollständig
+- [ ] PDF/X oder Druckerei-Anforderungen
+- [ ] Preis / Vertriebskanal
+
+### Verlag
+
+- [ ] Manuskript-Export (ggf. DOCX) und Stilvorgaben
+- [ ] Rechte: NC vs. Verlagsvertrag geklärt
+- [ ] Abbildungen: Quelldateien / Rechte
+
+---
+
+## 9 · Post-Release / Wartung
+
+- [ ] Stand-Datum bei inhaltlichen MCP-/Framework-Updates anheben
+- [ ] Changelog (kurz) in README oder `meta/CHANGELOG.md` führen
+- [ ] CI hält Demo grün bei Dependency-Bumps
+- [ ] Halbjährlicher Review: Kap. 6, 9, Anhang B/D
+- [ ] Bei Breaking MCP-Spec: Kap. 4/10 + Code-Skizzen priorisieren
+
+---
+
+## Schnell-Gate „darf raus?“
+
+| Gate | Intern | Öffentlich | Print/Verlag |
+|------|--------|------------|--------------|
+| LICENSE Split | empfohlen | **pflicht** | **pflicht** |
+| Impressum © + Stand | ja | ja | vollständig |
+| Demo CI grün | ja | **pflicht** | ja |
+| Lektorat P0 | ja | **pflicht** | **pflicht** |
+| Lektorat P1 | teilweise | **pflicht** | **pflicht** |
+| Quellenminimum | neat | **pflicht** | **pflicht** |
+| PDF Spotcheck | neat | empfohlen | **pflicht** |
+
+---
+
+## Erledigt in diesem Setup (Repo-Stand)
+
+| Item | Status |
+|------|--------|
+| `meta/LEKTORAT-BACKLOG.md` | angelegt |
+| `meta/PUBLISH-CHECKLISTE.md` | angelegt |
+| Dual-Lizenz Dateien | angelegt |
+| Impressum md + tex | erweitert |
+| CI Demo-Workflow | angelegt |
+| README Lizenz + Meta-Links | aktualisiert |
+
+Offene Checkboxen oben sind **menschliche** bzw. **Release-**Schritte – nicht alles ist automatisierbar.
+
+---
+
+*Arbeitsdokument · Textlizenz siehe Root-`LICENSE`.*