ki-agent/design/lektorat-2026-07-24.md

Lektorat — Secure Coding Agents with Flue

Datum: 2026-07-24
Scope: Gesamtes Manuskript (Prolog, Kap. 1–11, Epilog, Backmatter)
Methode: Checkpoints Ton, Terminologie, Wiederholung, Verständlichkeit, Querverweise (angelehnt an Lektorats-Skill des Schwesterprojekts)

Ergebnis

Erste Lektoratsrunde durchgeführt und eingearbeitet. PDF neu gebaut.

P0 — behoben

Fund	Maßnahme
Kap. 4 Zusammenfassung: unklare Formulierung „skaliert Nutzen ohne Risiko … mitzuskalieren“	Neu formuliert (Nutzen skalieren, ohne Datenrisiko proportional mitwachsen zu lassen)
Gemischte Terminologie Allow-Listen / Deny-Listen / Allowlist	Vereinheitlicht auf Allowlist(s) / Denylist(s) (wie Glossar)
Kap. 9 „Entscheidung-Metadaten“	→ Entscheidungs-Metadaten

P1 — behoben

Fund	Maßnahme
Doppelte Schlussformel „wenig unnötiges Wissen, wenig unnötige Macht“ (Kap. 7 + 8)	Kap. 7 und 8 differenziert; Epilog behält die drei Leitsätze
„Enterprise-ready heißt“ als Schluss in Kap. 1, 10, 11	Kap. 10 und 11 variiert
„Theaterkulisse“ / „Theater“ für schwache Sandbox	Kap. 1 entschärft; Kap. 7 behält „Theater“ einmal
Kap. 2 Schluss leicht lehrbuchhaft	Gestrafft, Mapping betont
„Default-deny“ vs. „Deny by default“ (Kap. 7)	Prosa auf Deny by default
Kap. 7 „ephemeral workspace“ mitten im DE-Text	→ ephemerer Workspace
Kap. 6/Epilog/Prolog: kleinere Stilglättungen	eingearbeitet

P2 — bewusst belassen oder später

Fund	Entscheidung
Wiederkehrende Brücken „Kapitel X hat … Dieses Kapitel …“	Gewollt für lineare Leser; nicht streichen
„System-Prompt ist keine Policy“ an mehreren Stellen	Kernbotschaft; an Ersteinführung (Kap. 1/2) und Vertiefung (Kap. 8) ok
Checklisten am Kapitelende ähnlich aufgebaut	Konvention des Buchs
Literatur: Arbeitsbibliografie, nicht alle DOI	im Text so deklariert; Vertiefung bei Bedarf
Part-Pages ohne Grafik	Infrastruktur, kein Lektoratstext
Kein zweites Augenpaar / Fachreview Security	empfohlen als nächster Schritt

Terminologie (kanonisch nach Runde 1)

Begriff	Form
Positiv-/Negativlisten	Allowlist / Denylist
Policy-Default	Deny by default
Steuerungsschicht	Harness / Agent-Harness
Modellzugang	Model Gateway / Gateway
Risikoklassen Tools	R0–R4
Aufbewahrung Logs	Retention-Tier T0–T3
Buchtitel EN	Secure Coding Agents with Flue

Querverweise

Stichprobe der Kapitelverweise (2→3→4→…→11, Prolog-Lesepfade, Epilog-Schichtentabelle): stimmig. Keine offensichtlichen „siehe Kapitel N“-Fehler gefunden.

Ton

• Nüchtern, enterprise/security, wenig Hype — ok
• Keine AGI-Prophezeiungen — ok
• Wiederkehrende Metapher „Vertrauensgrenze / Kontrolle als Produkt“ — kohärent

Statistik (Runde 1)

Kategorie	Geschätzt vor Fix	Nach Fix
P0 Sprache/Klarheit	1	0 offen
P0 Terminologie	1 Cluster	vereinheitlicht
P1 Redundanz Schlussformeln	3	entschärft
P2 strukturelle Wiederholung	bewusst	belassen

Runde 2 — Satz/Layout (2026-07-24, eingearbeitet)

Fund	Maßnahme
Doppelnummerierung 2 1 Warum…	secnumdepth=-2 (Nummern nur aus H1)
Contents / List of Figures / Figure	DE: Inhaltsverzeichnis, Abbildungsverzeichnis, Abbildung
pdflang=en	pdflang aus lang (de-DE)
Box „(continued)“	„(Fortsetzung)“
Impressum EN-Platzhalter	deutsches Impressum + HaftungsHinweis
Kolophon „Fachbuch-Skizze“	„Fachbuch (1. Auflage)“
Default-deny / Risikoklasse	Deny by default / Risk-Klasse
TOC zu tief (9 S.)	toc-depth=0 → 1 Seite, nur Kapitel
Glossar gedrängt	description-List mit nextline + Abstand
Exposé 73 S.	aktualisiert (~150 S., Anhangsanteil)
policy_version vs. Policy-Version	Glossar-Regel
PDF-Engine	latexmk + lualatex (stabile TOC-Läufe)
LoF leer nach Counter-Fix	lof: false bis stabil reaktiviert

Empfohlene Runde 3 (nicht in diesem Durchlauf)

1. Kapitelweise Lautlesen (Prolog + Kap. 4–6 priorisieren)
2. Fachreview: DLP-Schwellen, Sandbox-Stufen, DSGVO/AI-Act-Formulierungen mit Legal
3. Diagramm-Labels DE oder dokumentierte EN-Policy; Playbook-Figure vereinfachen
4. Klappentext aus Prolog + Epilog-Leitsätzen ableiten
5. Optional: Anhang E kürzen / Verfallsdatum