Files
ki-buch/meta/LEKTORAT-BACKLOG.md
grok-bot 0fbbaf71d5
CI / Companion (py3.11) (push) Has been cancelled
CI / Companion (py3.12) (push) Has been cancelled
build: KDP-Print-Pipeline, Lektorat und regenerierte Dist-PDFs.
Print/KDP 6×9 Grayscale (just, QA, Assets), erweiterter Agent-Harness
und Manuskript-/Abbildungs-Stand mit frischen eBook- und Print-PDFs.
2026-08-09 10:04:12 +02:00

15 KiB
Raw Permalink Blame History

Lektorats-Backlog

Abarbeitbare Tickets für Manuskript, Code-Parität und Publish-Reife.
Stand der Analyse: 2026-07 · Manuskript ~59 000 Wörter · PDF ~310 Seiten (dist/agentenbasierte-ki-se.pdf).

Verwandt: 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) — Ausnahme P0 F.3 (Impressum-Verlagsdaten warten auf Autor)
  • 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 — nur noch Impressum-[TODO] (F.3)
  • 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 [x]
G1.2 Leitmotive vereinheitlichen: Agent = Model + Harness, Don’t blame the model, Progressive Disclosure – gleiche Schreibweise/Anführungszeichen P1 S [x]
G1.3 „Context Engineering“ vs. „Kontext-Management“ vs. „Kontext-Engineering“ – eine Primärform wählen, Alternativen nur bei Erstnennung P2 S [x]
G1.4 Du-Anrede durchgängig; kein Sie; Team-„ihr“ nur wo bewusst P2 S [x]
G1.5 Callout-Labels nur: Analogie, Pitfall, Best Practice, Praxis-Tipp, Faustregel, Leitsatz, Repo/Realwelt/Code im Repo, Was wir (noch) nicht wissen / Grenzen der Evidenz (Pipeline-Kompatibilität) P1 S [x]

G9 · Evidenz & intellektuelle Redlichkeit

Kanon: EVIDENZ-STYLE-GUIDE.md · Mapping in anhang/F-empirische-evidenz-2026.md.

ID Ticket Prio Aufwand Status
G9.1 meta/EVIDENZ-STYLE-GUIDE.md (Stufen [E1]–[E5], Kästen, Checkliste, Vorher/Nachher, eigene Evidenz) P1 M [x]
G9.2 Anhang F: Mapping F-Labels ↔ [E1]–[E5] / [E*] P1 S [x]
G9.3 Callout-Label „Was wir (noch) nicht wissen“ / „Grenzen der Evidenz“ → calloutInfo P2 S [x]
G9.4 Evidenz-Pass Kap. 3, 8, 11, 13 (Checkliste im Style Guide) P1 L [x]
G9.5 Evidenz-Pass Kap. 4–7, 10 P2 L [x]
G9.6 Referenz-Kasten + Inline-Tags als Stilmuster in Kap. 3 P1 S [x]
G9.7 Agents.md (+ ggf. PUBLISH-Checkliste): Evidenz-Guide verlinken P2 S [x]
G9.8 Agent-Harness: Betriebsmodus in AGENTS.md + .grok/skills/ (Lektorat/Evidenz/Parity/PDF) P2 S [x]

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 [x]
G2.2 „Stand 2026“-Datum konkretisieren (z. B. 2026-07) in Vorwort/Impressum/README P0 S [x]
G2.3 Kap. 6 Framework-Matrix: jede Zelle als „Orientierung, nicht Ranking“ kennzeichnen; veraltete Namen streichen P1 M [x]
G2.4 Kap. 9 IDE-/Host-Namen gegen aktuellen Markt abgleichen P1 M [x]
G2.5 Update-Policy schreiben (1 Absatz): was bei MCP-Spec-Breaking-Changes passiert P1 S [x]

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 [x]
G3.2 Kap. 8 (~1800): Multi-Agent-Fail-Cases + ein durchgängiges Mini-Szenario ergänzen oder explizit als „Kompaktkapitel“ labeln P2 M [x]
G3.3 Kap. 6: Tiefe vs. Orientierung entscheiden; bei Orientierung: Lernziele anpassen P2 M [x]
G3.4 Kap. 12–13: Spekulation vs. belastbare Trends trennen (eigene Unterüberschriften) P2 M [x]

G8 · Lesefluss-Prosa (Kompendium → gerahmte Struktur)

Ziel: dichte Tabellen/Listen mit erklärendem Fließtext rahmen, ohne skimmbare Struktur aufzulösen. Stilreferenz: Einleitung + Kap. 8.

ID Ticket Prio Aufwand Status
G8.1 Kap. 3.7: sieben Hebel, Patterns, MCP-Arbeitsteilung rahmen P1 M [x]
G8.2 Kap. 4.5: Harness-Schichten + Landschaft Lesart P1 M [x]
G8.3 Kap. 5.4 / 5.6–5.8 / 5.10–5.11: Skills, CA-MCP, Multi-Agent, Harness Eng. P1 L [x]
G8.4 Kap. 7.8: Context Engineering im SDLC Einstieg + Packs P1 M [x]
G8.5 Kap. 11.10 (+ 11.2/11.3): Production Harness, Autonomy Ladder, Risikorahmen P1 M [x]
G8.6 Kap. 6 / 4.7.1 / 10.8: optionale Feinschliffe (P2) P2 M [x]
G8.7 Stil-Faustregeln (40–60 % Fließtext vs. Struktur) in Autorennotiz/README verlinken P3 S [ ]
G8.8 Thematische Einordnungen: Kap. 1–13 (120–220 Wörter vor Lernzielen) + priorisierte Unterkapitel 3.7, 4.5, 4.7, 5.4, 5.8, 5.9, 5.11, 7.8, 10.7, 10.12, 10.13, 11.7, 11.10 (40–90 Wörter); Marker <!-- thematische-einordnung --> P1 M [x]
G8.9 Erklärende Kapitel-Prosa: Kap. 1–13 Einstiege problemorientiert (~180–280 Wörter: Problem → These → Leitfrage → Brücke); Abschnitts-Leads vor Tabellen in Kap. 6/12/13 + 1.2, 4.4, 9.2 P1 M [x]

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 [x]

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 [x]
G5.2 Kap. 10: Tool-Namen, Pfade, Demo-Schritte vs. code/05-coding-agent abgleichen P0 M [x]
G5.3 FastMCP: „getestet mit Version X“ in code/README.md und Kap. 10 Security/Setup P1 S [x]
G5.4 LocalBus vs. echtes STDIO-MCP: im Kap. 10 und agent.py-Docstring prominent (ein Satz reicht) P1 S [x]
G5.5 requirements pinnen / oberen Major-Cap setzen; CI hält Demo grün P0 S [x]

G6 · Visuals

ID Ticket Prio Aufwand Status
G6.1 Alle Plate-Referenzen im Text existieren unter bilder/plates/ P1 S [x]
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 [x]
F.2 Einleitung: Evolutionsstufen-Tabelle mit Kap. 1/4 konsistent P2 S [x]
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 [x]
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 [x]
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 [x]
T2.2 Kap. 4 USB-C-Analogie nicht inflationär; 1× prägnant + Verweis P2 S [x]
T2.3 Kap. 5 Straffungs-Kandidaten: 5.12 vs. 10.13 – Theorie hier, Praxis dort; Tabellen deduplizieren P1 L [x]
T2.4 Kap. 5 Failure Modes (Kontext-Drift, Tool-Kollision) mit Kap. 11 Threat Model verlinken P2 S [x]
T2.5 Kap. 6 Code-Snippets als „illustrativ, API-Namen je Version“ – einheitlicher Disclaimer pro Listing P1 S [x]
T2.6 Kap. 6 mcp-agent / CrewAI / LangGraph: je 1 Satz „wann wählen“ behalten, Feature-Listen kürzen P2 M [x]

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 [x]
T3.2 Kap. 8 Ein End-to-End-Szenario (Issue → PR) skizzieren, Rollen an MCP-Server koppeln P2 M [x]
T3.3 Kap. 9 Host-Config-Beispiel vs. code/host-config.example.json paritätisch P1 S [x]
T3.4 Kap. 10 Setup-Pfad exakt wie code/README.md (venv, pytest, --demo) P0 S [x]
T3.5 Kap. 10 Skills 10.12 + KB 10.13: Checkliste „Done wenn Demo-Trace X enthält“ P1 S [x]
T3.6 Kap. 10 Security 10.7.5: S0–S1 klar; kein Production-Claim P0 S [x]
T3.7 Kap. 11 Production Harness 11.10 mit 5.11/4.5 Querverweis-Matrix P1 S [x]
T3.8 Kap. 11 Policy-YAML-Beispiele: „illustrativ“ + kein Copy-Paste-in-Prod ohne Review P1 S [x]

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 [x]
T4.2 Kap. 13 Rollen (Agent Platform Eng, …) mit Kap. 7/8 Skills-Tabelle harmonisieren P2 S [x]
T4.3 Schlusswort Call-to-Action: nächster konkreter Schritt (Demo starten) belassen P3 S [x]

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 [x]
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 [x]
A.4 Empirie-Inserts: Kap. 3/5/6.5/8.6/10/11/13 + Anhang F vernetzt; PDF-Build listet F P1 M [x]
A.4 Anhang D: MCP-Docs + License-Links + dieses Meta-Verzeichnis P1 S [x]
A.5 Anhang E: Stichwortverzeichnis nach großen Kap.-Edits neu ziehen (manuell) P2 L [ ]

G7 · Publish-Härte 2026-07 (Umsetzungsplan WP1–WP12)

ID Ticket Prio Aufwand Status
G7.1 Companion: Pins, pyproject, tests, CI, COMPATIBILITY, Platzhalter weg P0 L [x]
G7.2 Stabilitäts-Matrix in Code/Config-Kapiteln P1 M [x]
G7.3 MCP Spec 2025-11-25 kanonisch + Deep-Links P0 M [x]
G7.4 Kap. 4.7.5 Wann MCP nicht P1 S [x]
G7.5 Evidenz + Anhang C.12 Baseline TRACE-DEMO-1 P1 M [x]
G7.6 Kap. 11 Threat-Template, Policy-as-Code, Audit, DSGVO, Team-Checkliste P1 L [x]
G7.7 Executive Summaries pro Teil + PDF-Pipeline P1 M [x]
G7.8 Context Trace-Faden + 30-Min-Lesepfad P1 M [x]
G7.9 Übungs-DoD (Kernkapitel) P1 M [x]
G7.10 Pitfall-Tabellen 4 Spalten P2 M [x]
G7.11 Glossar Skill/Prompt/AGENTS.md + EN P1 S [x]
G7.12 Kap. 12 Frühindikatoren P2 S [x]

Empfohlene Abarbeitungsreihenfolge

  1. P0-Batch: G2.1–G2.2, G5.1–G5.2, G5.5, T3.4, T3.6 · erledigt · offen nur F.3 (Verlagsdaten User)
  2. P1-Kernlektüre: Kap. 4 → 5 → 10 → 11 + G1 · Vollpass 2026-08-09 erledigt
  3. P1-Ökosystem: Kap. 6, 9, G2.3–G2.4 · erledigt
  4. P1-Lesefluss / G8: erledigt
  5. P2-Balance & Stil: G3 weitgehend erledigt; G4 Typografie noch offen
  6. P3: Print-Assets, Feinschliff Typografie · nächster Rest: F.3 + G4.x + G4.5 PDF-Spotcheck

Restructure-Welle R1 (2026-07) – Einstieg + Entscheidungen

Ziel: schneller zum Kern, MCP-Doppelung weg, schärfere Trade-offs.
Kanon: meta/MANTRA-KANON.md.

ID Ticket Prio Aufwand Status
R1.1 Vorwort + Einleitung neu (Zielgruppe, Entscheidungsliste, Lesepfade) P1 M [x]
R1.2 Kap. 1 straffen (API-Evolution, Auffrischung) P1 M [x]
R1.3 Kap. 2.6.2 MCP-Deep-Dive → Bridge; Deep-Dive nur 4.7 P1 L [x]
R1.4 Kap. 4.0 Architektur-Entscheidungslandkarte P1 M [x]
R1.5 Kap. 4.7.5 schärfere „Wann MCP nicht“-Tabelle P1 S [x]
R1.6 Kap. 7.9 90-Tage-Scorecard P1 M [x]
R1.7 ES-I–III + README Lesepfade P1 S [x]
R1.8 Kap. 5 Dedup vs. 10.13 (−15–20 %) P1 L [x]
R1.9 Kap. 6 Feature-Listen kürzen; Entscheidung schärfen (neu 6.3–6.6) P1 M [x]
R1.10 Kap. 12 spekulationsarm; Rollen → 13 P2 M [x]
R1.11 Kap. 13 Geschäftsmodelle tabellarisch + Scorecard-Anbindung P2 M [x]
R1.12 Mantra-Pass R1–R4 über Kap. 3–5, 7–8 P2 M [x]
R1.13 PDF-Build + Spotcheck nach R1 P1 M [x]
R1.14 Querverweise 6.5→6.5, 6.6→6.6 global P1 S [x]

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).