ki-buch/HANDOFF-buch.md

Handoff: Fachbuch „Agentenbasierte KI-unterstützte Softwareentwicklung“

Meta-Arbeitsdokument (nicht Teil der Buchkapitel-Navigation).
Neue Session: diese Datei + AGENTS.md lesen, dann gewählten Slice ausführen.

Meta

Feld	Wert
Datum	2026-08-09
Projektpfad	/Volumes/SSD2TB/books/ki-agentenbasierte-softwareentwicklung
Branch	main
Fokus der letzten Session	Vollpass Lektorat (gesamtes Manuskript + Companion-Parität Kap. 10)
Status	eBook QA grün (~249 S.); Lektorat P0/P1 bis auf F.3 erledigt; große uncommitted Diffs (Manuskript + Bilder + Companion)
Nächste Session (empfohlen)	(1) Impressum-Daten (F.3) · (2) Commit der Diffs (ggf. getrennte Commits: Manuskript / Assets / Harness) · (3) Abbildung-Regen ab K3

---

Ziel (Arbeitsstand)

Fachbuch produktionsnah halten: Manuskript (Teile I–IV + Anhänge), Companion code/, Abbildungen Deep Signal, PDF eBook A4 + Print 6×9, Autoren-Harness (.grok/).

DoD — Stand

• Autoren-Harness: Rules, Commands, Skills (humanizer, kapitel-review, abbildung, pdf-print, …)
• AGENTS.md + dieses Handoff
• Print-Pipeline: prepare_print_assets.py, pdf/print/*, justfile, check_pdf --mode print
• Print-Smoke (früher): just pdf-print + qa-print — 351 S., 6×9, gray, Fonts OK
• Abbildung-Regen Backup: _staging/pics/backup-2026-08-09/
• Abbildung-Regen Phase Cover + L1: Cover + alle 20 plate-*.jpg
• Abbildung-Regen L2 Kap. 1–2: K1-01…03, K2-01…05
• Lektorat-Vollpass 2026-08-09 (Callouts kanonisch, Kap. 1–13, Anhänge, Tickets P0/P1)
• Companion-Parität Kap. 10: Setup=README, LocalBus≠STDIO, S0–S1 Labor, Tool-Namen, Trace-DoD
• Companion Tests: pytest tests -q grün; agent.py --demo engineered + baseline exit 0
• eBook nach Lektorat: SKIP_MERMAID=1 just pdf + just qa → dist/agentenbasierte-ki-se.pdf ~249 S., OK
• P0 F.3 Impressum-Verlags-/Website-Felder (Autor liefert Daten)
• Uncommitted Diffs reviewen und committen (kein Auto-Commit ohne Auftrag)
• Abbildung-Regen Rest: K3–K13, C-01, F-01, t-01…04, assets/parts/teil-0N.jpg
• G4 Typografie (Anführungszeichen, Whitespace) optional P2/P3
• Print-PDF nach großen Manuskript-/Asset-Änderungen ggf. neu bauen

---

Lektorat 2026-08-09 (Ergebnis)

Backlog: meta/LEKTORAT-BACKLOG.md
Regeln: .grok/rules/schreibkonventionen.md · Skill lektorat-pass

Erledigt (Kern)

Track / Ticket	Inhalt
Welle 0	Nicht-kanonische Callouts → Kanon; Plate-Pfade OK (G6.1); README Python-first (G5.1)
Kap. 1–3	MCP-Timeline präziser; Sampling-Bridge; TS-Snippet → Python
Kap. 4–5	USB-C 1×; Harness 4.5↔5.11; Memory/Hybrid vs. 10.13; Failure Modes → Kap. 11 (T2.1–T2.4, G3.1)
Kap. 6–9	Orientierung≠Ranking; Snippet-Disclaimer; L0–L3↔Kap. 11; E2E Issue→PR; host-config-Parität
Kap. 10–11	T3.4–T3.8, G5.2, G5.4; Policy illustrativ; Production-Harness-Xref
Teil IV + Anhänge	Spekulation gelabelt; Glossar A.1; B Stand/Herkunft; D Spec-Links; F Typo
G1, R1.12, G4.5	Terminologie/Mantras/PDF-QA nach Build

Bewusst offen

ID	Was	Blocker
F.3	frontmatter/impressum.md Felder [TODO]	Autor: Anbieter/Verlag, Anschrift, E-Mail, Verantwortliche:r, ISBN (opt.), Ort/Jahr
G4.1–G4.4	Typografie-Feinschliff	optional
G8.7	Stil-Faustregeln in Autorennotiz	P3
A.5	Stichwortverzeichnis neu ziehen	nur nach großen Umbenennungen

Companion-Änderungen (Parität)

Datei	Änderung
code/examples/05-coding-agent/agent.py	Docstring LocalBus vs. STDIO
code/examples/05-coding-agent/skills/fix-from-issue/skill.md	nur existierende Tools (write_file, kein apply_patch)

Manuskript-Diffs (uncommitted, Auszug)

Geändert u. a.: frontmatter/*, teil-01…04/**, backmatter/, anhang/A–D,F, README.md, meta/LEKTORAT-BACKLOG.md, Kap. 10/11 stark, plus Abbildung-Regen-Assets (Cover, plates, k1/k2) und Harness-Dateien aus früheren Sessions.

Nicht handpatchen: build/src/, build/book.md.

---

Abbildung-Regen (Detail, fortsetzbar)

Log (Source of Truth PASS/FAIL): meta/ABBILDUNG-REGEN-LOG.md
Katalog/Specs: bilder/ABBILDUNGEN.md
Prompts-Basis: bilder/gemini-prompts/
Skill: .grok/skills/abbildung/SKILL.md (+ global imagine)

Entscheidungen (User, final)

Punkt	Wert
Umfang	Komplett-Korpus
Werkzeug	Alles Imagine (image_gen / image_edit) — kein SVG-Default
Paratexte	Cover + Teil-Trenner (figures/t-* und assets/parts/)
Manuskript	Assets only während Regen — keine Kapitel-Edits, Pfade bleiben

Erledigt (kanonische Pfade überschrieben)

Gruppe	Anzahl	Pfade
Cover	1	bilder/cover-ki-book.jpg (Upscale ~1600×2400)
L1-Plates	20	bilder/plates/plate-*.jpg (Upscale 2560×1440)
L2 Kap. 1	3	k1-01 … k1-03
L2 Kap. 2	5	k2-01 … k2-05
Summe neu	29	+ Backup separat

Offen (nächste Batches)

Batch	IDs / Pfade	Count (ca.)
1	K3-01…03	3
2	K4-01…08	8
3	K5-01…10	10
4	K6-01…06	6
5	K7-01…04	4
6	K8-01…07	7
7	K9-01…04	4
8	K10-01…07	7
9	K11-01…04	4
10	K12-01…03, K13-01…02	5
11	C-01, F-01	2
12	figures/t-01…04 + assets/parts/teil-01…04	8
	Summe offen	~68

Workflow (pro Asset)

1. Spec: ABBILDUNGEN.md + gemini-prompts/<id>.md
2. Prompt: Deep Signal · max ~6 Primär-Labels · 16:9 (Cover 2:3)
3. image_gen → multimodal QA (read_file) → ggf. image_edit · max 5
4. cp → kanonischer Pfad
5. sips -z 1440 2560 <jpg>   # Body/Plate; Cover: sips -z 2400 1600
6. Eintrag in meta/ABBILDUNG-REGEN-LOG.md

Betriebsregeln

• Rate-Limit: max. 3–4 image_gen parallel; Pause 10–25 s
• Stil: L1 Navy #0A1628 / Electric #2F6BFF / Cyan #00D4FF / Amber #D4A84B; L2 BG #F7F9FC
• QA-Härte: „schön aber falsch“ = FAIL; Meta-Banner, Hex-Codes, Vendor-Logos, Robots vermeiden
• Native Imagine oft 1280×720 → immer Upscale
• Während Regen: kein Manuskript, kein Commit ohne Auftrag, kein build/-Handpatch

Bekannte PASS*-Reste (nicht blockierend)

• Meta-Titel „L1 Deep Signal…“ / „L2 Signal Light Landscape…“ in vielen Plates
• K1-03: Fake-UI-Screenshots; K2-04: Vendor-Namen FAISS/Pinecone
• Einzelne Mikro-Garble (Details im Log)

---

Autoren-Harness

Skill	Command	Rolle
lektorat-pass	/lektorat	Ton, Callouts, Mantras, Diffs
kapitel-review	/review	Kritische Gegenlese
humanizer	/humanizer	KI-Stil → Vorschläge
evidenz-tag	/evidenz	[E*]-Stufen
companion-parity	/companion	Kap. 10 ↔ code/
pdf-build-qa	/pdf	eBook A4
pdf-print	/pdf-print	KDP 6×9
abbildung	/abbildung	Imagine + QA-Loop
mantra-xref	/mantra	Doppelungen
figure-consistency	—	Pfade/Katalog
—	/status	Repo-Überblick

Rules: .grok/rules/bau-pipeline.md, .grok/rules/schreibkonventionen.md.

---

Artefakte (kanonisch)

Pfad	Hinweis
dist/agentenbasierte-ki-se.pdf	eBook A4 · ~249 S. · QA 2026-08-09 grün
dist/agentenbasierte-ki-se-print.pdf	Print 6×9 (älterer Smoke 351 S.; nach Bedarf neu)
bilder/figures/, bilder/plates/, bilder/cover-*.jpg	Inline / Cover
assets/parts/teil-0N.jpg	PDF-Part-Pages (noch nicht regeneriert)
meta/ABBILDUNG-REGEN-LOG.md	Regen-Fortschritt
meta/LEKTORAT-BACKLOG.md	Ticket-Status (F.3 offen)
_staging/pics/backup-2026-08-09/	Pre-Regen-Backup
code/	Companion Kap. 10

---

Bewusst offen (Priorität)

#	Slice	DoD (kurz)
1	F.3 Impressum	Verlags-/Website-Felder ohne [TODO]
2	Commit	Diffs reviewen; ggf. split: Manuskript · Companion · Assets · Harness
3	Abbildung-Regen Rest	ab K3-01; Log grün/PASS*
4	Print neu bauen	just all-print nach Asset-/Text-Freeze
5	G4 Typografie	optional P2
6	KDP-Außenumschlag	out of scope (Bleed/Spine)

---

Einstiegs-Prompts (kopierbar)

A — Impressum + Commit (empfohlen als Nächstes)

Projekt: ki-agentenbasierte-softwareentwicklung (main).
Lies AGENTS.md + HANDOFF-buch.md + meta/LEKTORAT-BACKLOG.md.

Stand: Vollpass Lektorat 2026-08-09 erledigt; eBook QA ~249 S. grün;
Companion Demo grün; offen P0 F.3 Impressum + uncommitted Diffs.

Aufgabe:
1) Wenn User Verlagsdaten liefert → frontmatter/impressum.md ausfüllen, F.3 [x].
2) Diffs reviewen und auf expliziten Auftrag committen (keine Secrets, split sinnvoll).
Constraints: nie build/src/; Evidenz nicht erfinden; Commit nur mit User-OK.

B — Abbildung-Regen ab K3

Projekt: ki-agentenbasierte-softwareentwicklung (main).
Lies AGENTS.md + HANDOFF-buch.md + meta/ABBILDUNG-REGEN-LOG.md.
Skill: abbildung (+ imagine). Modus: Alles Imagine, Assets only.

Erledigt: Cover, P01–P20, K1-01…03, K2-01…05.
  Upscale: Body/Plate 2560×1440, Cover ~1600×2400.
  Backup: _staging/pics/backup-2026-08-09/

Nächste Aufgabe: L2 ab K3-01 (Batches 3–4), dann K4…K13, C-01, F-01,
  danach figures/t-01…04 und assets/parts/teil-01…04.
  Spec: bilder/ABBILDUNGEN.md + bilder/gemini-prompts/.
  Pro Asset: image_gen → multimodal QA (max 5) → kanonischer Pfad → sips → Log.
  Rate-Limit: max 3–4 parallel, Pause 10–25s. Manuskript nicht anfassen. Commit nur auf Auftrag.

C — Print-QA nach Freeze

Projekt: ki-agentenbasierte-softwareentwicklung (main).
Lies AGENTS.md + HANDOFF-buch.md + pdf/print/QA-NOTES.md.
Skill: pdf-print. just pdf-print && just qa-print.
Fixes nur in Quellen / print-pipeline, nie build/src.