BP: AP8 schmal AE-61 (19.9 und S-11)
- 19.9 13→7 Plattform-Zeilen; S-11-Embed aus 6.3 (K-09 bleibt) - 16.7 und 20.5 unberührt; Freeze 5.5–5.7 unberührt - Wörter 58 529→58 389 (−140); AP3-Rest 214 - Ziel ≥ 85 als Untergrenze der AP7-Messung (81,3) - Bericht audits/behebungsplan-ap8-2026-11-07.md
This commit is contained in:
grok-bot committed
1 parent
59be99ffd9
commit
6db563889f
6 files changed
+136
-22
No files matched your search
@@ -0,0 +1,127 @@
|
||||
# Behebungsplan AP8 — Redundanz schmal + Untergrenze
|
||||
|
||||
## 1. Kopf
|
||||
|
||||
| Feld | Wert |
|
||||
|------|------|
|
||||
| Datum | 2026-11-07 |
|
||||
| Modell | Hauptsitzung wie eingestellt |
|
||||
| Basis-SHA | `2a5d21d` (`main`, AE-60 A); Arbeitsbaum trug bereits uncommittetes AP4–AP7 |
|
||||
| Branch | `main`, **nicht committet**, nicht gepusht; `origin/main` = `22ddedc` (9 Commits voraus) |
|
||||
| Plandatei | `audits/behebungsplan-2026-11-02.md` § 14 AE-61; Auftrag nach AP7 |
|
||||
| Status | **AP8 schmal abgeschlossen**; Ziel ≥ 85 als **Untergrenze der Messung** (AP7-Mittel 81,3). Ampel **GELB** (Dist stale, AP4–AP8 uncommittet) |
|
||||
|
||||
## 2. Auftrag und DoD
|
||||
|
||||
Nach AP7 (Chat 2026-11-07): AP8 nur an den zwei bestätigten Doppelungen;
|
||||
Ziel ≥ 85 als Untergrenze der AP7-Messung akzeptieren.
|
||||
|
||||
- 19.9 von 13 auf 7 Plattform-Zeilen.
|
||||
- In 6.3 eine der zwei Funnel-Abbildungen streichen: **S-11** raus, **K-09** bleibt.
|
||||
- 16.7 `session-handoff`-Skill und 20.5-Schluss unberührt.
|
||||
- Abhängige Zeiger mitziehen (22.9; 19.9-Brücke).
|
||||
- Freeze 5.5–5.7 / 17.5–17.6 / 18.1–18.4 / 9.2–9.6 / 22.2–22.5 / 4.3/4.4 unberührt.
|
||||
- S-11-Asset und Prompt bleiben; kein Löschen unter `assets/`.
|
||||
|
||||
**Nicht:** voller Vier-Stellen-Schnitt, 16.7, 20.5, BP-07, Builds,
|
||||
`_print_pages`, Cover, Pipeline, ISBN, Merge, Push, Commit.
|
||||
|
||||
## 3. Tight-Loop
|
||||
|
||||
```text
|
||||
just markdownlint → 0 error(s), 70 Dateien
|
||||
just link-check → check_md_links: 142 file(s) ok
|
||||
python3 .grok/scripts/manuskript_check.py → Harte Verstöße: 0
|
||||
```
|
||||
|
||||
Kap. 06 Bilder 8/8 → **7/7** (S-11-Embed entfallen, Datei bleibt). Dist nicht
|
||||
neu gebaut: kein PDF-, Print- oder EPUB-Auftrag. Figure-Count im Satz wird
|
||||
beim nächsten Build 40→39; Messung dann.
|
||||
|
||||
## 4. Datei-Abgleich gegen den Auftrag
|
||||
|
||||
AP8-Hunks (neben dem bereits dirtyen AP4–AP7-Baum):
|
||||
|
||||
| Datei | Änderung |
|
||||
|-------|----------|
|
||||
| `manuskript/kapitel-19-*.md` | 19.9 13→7 Zeilen; Brücke auf 5.6/5.7/6/18 |
|
||||
| `manuskript/kapitel-06-*.md` | S-11-Embed entfernt; K-09 bleibt |
|
||||
| `manuskript/kapitel-22-*.md` | 22.9-Zeiger an die 7 Zeilen; Spawn/Always-Max/Isolation benannt |
|
||||
| `research/abbildungen.md` | S-11-Status: Asset da, nicht eingebettet |
|
||||
| `docs/kb/06-modelle/kanon-ort-reprise.md` | S-11 nicht mehr Primär-Embed |
|
||||
| `docs/kb/00-projekt/entscheidungslog.md` | AE-61 |
|
||||
| `audits/behebungsplan-2026-11-02.md` | § 14 AE-61 |
|
||||
| `audits/behebungsplan-ap8-2026-11-07.md` | dieser Bericht |
|
||||
| `HANDOFF-buch.md` | Meta / Slice / Offen |
|
||||
|
||||
Freeze-Dateien ohne Hunk in den Freeze-Zeilen. 5.7 Zeile 193 („Always-Max,
|
||||
Spawn ohne Vertrag: 5.8 und Kap. 19“) liegt in **5.5–5.7** und bleibt.
|
||||
|
||||
## 5. Wortbilanzen
|
||||
|
||||
`wc -w`, Vergleich AP7:
|
||||
|
||||
| Kap. | AP7 | heute | Δ |
|
||||
|------|----:|------:|--:|
|
||||
| 06 | 2 501 | 2 489 | −12 |
|
||||
| 19 | 3 399 | 3 284 | −115 |
|
||||
| 22 | 3 330 | 3 339 | +9 |
|
||||
| **Summe 01–24** | **58 529** | **58 389** | **−140** |
|
||||
|
||||
**AP3-Band, aktuelle Messung** (Teilbänder wie AP7; Kap. 22 Freeze 2 121):
|
||||
|
||||
| Bereich | Rest AP2 | Rest heute | Δ | Band | Status |
|
||||
|---------|---------:|-----------:|---:|------|--------|
|
||||
| Kap. 4–6 | 5 797 | 5 230 | −567 (−9,8 %) | −578…−867 | 11 Wörter über der Oberkante |
|
||||
| Kap. 19/21/22 | 7 895 | 7 151 | −744 (−9,4 %) | −947…−1 421 | 203 unter dem Band |
|
||||
| Gesamt | 13 692 | 12 381 | −1 311 (−9,6 %) | −1 525…−2 288 | **214 unter dem Band** |
|
||||
|
||||
AE-60 A bleibt: kein zweiter Band-Schnitt. Die 214 sind Rest, kein Auftrag.
|
||||
|
||||
## 6. Was 19.9 behält und abgibt
|
||||
|
||||
**Sieben Plattform-Zeilen:** Multi-Agent zu früh · God Agent · Tool-Sprawl ·
|
||||
Hardcoded Logic · Keine Observability · Deployen ohne Evaluation ·
|
||||
Output-only Guardrails.
|
||||
|
||||
**Sechs Kanon-Zeilen → Brücke:** Always-Max (5.7) · Spawn ohne DoD/Hand-back
|
||||
(5.6) · Memory-Architektur (Kap. 6) · Blind-Index/Write-Back (6.7/6.9) ·
|
||||
Ungoverned Write-Access (Kap. 18) · Context Drift (Kap. 3/4).
|
||||
|
||||
19.10, 19.12, Takeaways und Templates zeigen nicht auf die gestrichenen
|
||||
Namen. 5.8-Link „19.9 (Plattform)“ bleibt gültig.
|
||||
|
||||
## 7. Freeze-Integrität
|
||||
|
||||
| Freeze | AP8 |
|
||||
|--------|-----|
|
||||
| 17.5–17.6 | kein Hunk |
|
||||
| 18.1–18.4 | kein Hunk |
|
||||
| 9.2–9.6 | kein Hunk |
|
||||
| 22.2–22.5 | kein Hunk (Hunk nur 22.9) |
|
||||
| 5.5–5.7 | kein Hunk; Zeile 193 gemeldet |
|
||||
| 4.3-Diff / 4.4-Gabel | kein Hunk |
|
||||
| K3 in 18.4 | kein Hunk |
|
||||
|
||||
## 8. Zielbewertung
|
||||
|
||||
AP7-Mittel 81,3 gegen ≥ 85 bleibt die Messung. Der schmale Schnitt ändert
|
||||
Redundanz an zwei Stellen; er holt das Mittel nicht auf 85. Die drei Prüfer
|
||||
lasen 24 Kapitel in einem Durchgang — die Noten sind eine **Untergrenze**.
|
||||
Auftrag: diese Untergrenze akzeptieren, nicht nachschneiden.
|
||||
|
||||
## 9. Geänderte Dateien (dieser Slice)
|
||||
|
||||
Siehe § 4. S-11-JPEG, SVG und Prompt unangetastet. AP4–AP7 bleiben
|
||||
uncommittet.
|
||||
|
||||
## 10. Nicht angefasst
|
||||
|
||||
16.7, 20.5, 20:88, `templates/`, `checklists/`, `pdf/`, `scripts/`,
|
||||
`justfile`, `assets/` (kein Löschen), Dist, `_print_pages`, ISBN,
|
||||
Thesen-Wortlaut. Kein Build, kein Merge, kein Push, kein Commit.
|
||||
|
||||
## 11. Nächster Schritt
|
||||
|
||||
**BP-07** (Builds, `_print_pages`, Außenumschlag) und AP4–AP8-Commit —
|
||||
jeweils nur mit Auftrag. Companion-Paket nach Auftrag neu packen.
|
||||
@@ -43,7 +43,7 @@ Jedes Kernkonzept hat **einen** Erstlehr-Ort (volle Erklärung). Andere Kapitel
|
||||
| Select / RAG-Policy | **5.5** | KB-Policy **6.4** — kein zweites Select-Tableau |
|
||||
| Sub-Agents / Model Routing | **5.6 / 5.7** | Orchestrierung **22** |
|
||||
| Hand-back | Minimal **5.6** | Vertrag/Isolation **22** |
|
||||
| Knowledge Layer, Tiers, PD | **6** (K-08–K-11, S-11) | diese Autoren-KB ist Beispiel, kein zweites Kapitel |
|
||||
| Knowledge Layer, Tiers, PD | **6** (K-08–K-11) | diese Autoren-KB ist Beispiel, kein zweites Kapitel; S-11 nicht eingebettet (AP8, Doppelung K-09) |
|
||||
| EPEVC / K-05 | Embed **nur Kap. 7** | Kap. 1.7 Text + Link |
|
||||
| DoD / Orakel / Tight·Slice·Heavy | **10** (K-07) | Alignment **11** kommt *davor* im Kopf, nicht als zweites Orakel; CI-Mirror in **10.6** |
|
||||
| Weich vs. hart | **15.1** | Reprise **18.6**; Surfaces **15.4** — kein zweites Tableau |
|
||||
@@ -67,7 +67,7 @@ Jedes Kernkonzept hat **einen** Erstlehr-Ort (volle Erklärung). Andere Kapitel
|
||||
| K-05 | Kap. **7** |
|
||||
| S-08 | Kap. **6.5** |
|
||||
| S-10 | Kap. **3** |
|
||||
| S-11 | Kap. **6.3** |
|
||||
| S-11 | nicht eingebettet (AP8, Doppelung K-09) |
|
||||
| S-12 | Kap. **8** |
|
||||
| S-05 | Kap. **11.4** |
|
||||
| S-13 | Kap. **12.10** |
|
||||
|
||||
@@ -63,8 +63,6 @@ Working soll **klein und scharf** bleiben. Die unteren Tiers existieren, damit d
|
||||
|
||||
{width=90%}
|
||||
|
||||
{width=90%}
|
||||
|
||||
Skills sind die klarste Produktform (Kap. 16): oft nur `name` + `description` in der Discovery; voller `SKILL.md`-Body bei Activation; `references/` und Scripts erst bei Execution. Dasselbe Muster gilt **außerhalb** von Skills.
|
||||
|
||||
### Vier Muster, die im Coding-Alltag tragen
|
||||
|
||||
@@ -90,7 +90,7 @@ Agents optimieren auf „hilfreich wirken“. Vage Inputs und Riesenaufträge be
|
||||
|
||||
### Deep-Dive: Vague Prompting vs. Step-Diktat
|
||||
|
||||
Beide Extreme sind schädlich. „Mach Auth irgendwie besser“ ist zu vage; „ändere Zeile 40, dann 88, nenne die Variable genau X, baue keinen Util“ ist zu eng — der Agent produziert unidiomatischen Code. Die Mitte ist Outcome-Steuerung: Ziel klar, Weg offen, Grenzen hart. Das vollständige Beispiel mit Ziel, Nebenbedingungen, Ausschlüssen und DoD: [Kap. 14.6, Beispiel B](kapitel-14-effektive-aufgabenformulierung.md).
|
||||
Beide Extreme sind schädlich. „Mach Auth irgendwie besser“ ist zu vage. „Ändere Zeile 40, dann 88, nenne die Variable genau X, baue keinen Util“ ist zu eng. Der Agent produziert unidiomatischen Code. Die Mitte ist Outcome-Steuerung: Ziel klar, Weg offen, Grenzen hart. Das vollständige Beispiel mit Ziel, Nebenbedingungen, Ausschlüssen und DoD: [Kap. 14.6, Beispiel B](kapitel-14-effektive-aufgabenformulierung.md).
|
||||
|
||||
### Deep-Dive: Endless Chat + Debug-in-Creation
|
||||
|
||||
@@ -176,12 +176,7 @@ Rules und Skills sind *dauerhafter* Context. Ein Widerspruch dort steuert nicht
|
||||
| **Conflicting instructions** | Chat vs. `AGENTS.md` vs. CI vs. README | Eine kanonische Quelle; Rest verlinkt |
|
||||
| **Init-Fossilization** | Einmaliger Bootstrap-Prompt lebt monatelang | Init schlank halten; Projektrealität in gepflegten Files |
|
||||
|
||||
**Compact-Hint (Do this):**
|
||||
|
||||
```text
|
||||
/compact Behalte: aktuelles Ziel, DoD, Nebenbedingungen, geänderte Pfade,
|
||||
offene Risiken, nächster Slice. Verwirf: rohe Tool-Logs, verworfene Ansätze.
|
||||
```
|
||||
**Compact-Hint (Do this):** Ein Erhaltungskriterium, nicht „kürzer“. Kopiervorlagen: [A.2](kapitel-23-anhang-a-kern-templates.md).
|
||||
|
||||
---
|
||||
|
||||
@@ -261,32 +256,26 @@ Wer eigene Agents oder Multi-Agent-Pipelines baut, wiederholt dieselben Fehler
|
||||
| Anti-Pattern | Problem | Do this instead |
|
||||
|--------------|---------|-----------------|
|
||||
| **Multi-Agent-Architektur zu früh** | N-facher Context, N-fache Drift, Debug-Hölle | Ein Agent + klare Tools, bis der Single-Path stabil ist; Readiness: [Kap. 22](kapitel-22-multi-agent-orchestrierung.md) |
|
||||
| **Always-Max-Model** | Hohe Kosten/Latenz, wenig Qualitätsgewinn | Default Fast/Balanced + Escalate ([Kap. 5.7](kapitel-05-context-engineering-write-select-compress-isolate.md)) |
|
||||
| **Spawn ohne DoD/Hand-back** | Parent ertrinkt in Prosa; verteilter Rot | Enger Scope, DoD, Rückgabeformat pro Sub ([Kap. 5.6](kapitel-05-context-engineering-write-select-compress-isolate.md); Orchestrierung: [Kap. 22](kapitel-22-multi-agent-orchestrierung.md)) |
|
||||
| **God Agent** | Ein Prompt kann alles — und nichts zuverlässig | Schmale Rollen, enge Tool-Oberflächen |
|
||||
| **Tool-Sprawl** | 40 Tools, Modell wählt falsch | Minimale Tool-Menge; klare Beschreibungen; Gruppierung |
|
||||
| **Hardcoded Logic statt konfigurierbarer Komponenten** | Jede Richtlinien-Änderung = Deploy/Prompt-Edit | Richtlinien, Allowlists, Model-Routing konfigurierbar |
|
||||
| **Keine Memory-Architektur** | Nur Chat-Buffer | Explizit Tiers: Working / Episodic (Handoff) / Semantic / Procedural ([Kap. 6](kapitel-06-knowledge-layer-wissen-fuer-agents.md)) |
|
||||
| **Blind-Index / ungeprüfter Write-Back** | Alles indexieren oder Agent schreibt kanonische Docs ungeprüft | Kataloge: [Kap. 6.7](kapitel-06-knowledge-layer-wissen-fuer-agents.md) (Write-Back) und [6.9](kapitel-06-knowledge-layer-wissen-fuer-agents.md) (Index) |
|
||||
| **Keine Observability** | Keine Traces, keine Token-/Tool-Metriken | Log Prompts (redacted), Tool-Calls, Failures, Latency |
|
||||
| **Ungoverned Write-Access** | Agent schreibt Prod/Main ohne Gate | Sandbox, Branch-only, Approval für risky tools |
|
||||
| **Context Drift in langen Tasks** | Spec von Turn 1 vs. Turn 40 | Re-state goal; Checkpoints; Sub-Tasks mit frischem Context |
|
||||
| **Deployen ohne Evaluation gegen Edge Cases** | Demo-Set ≠ Produktion | Feste Eval-Suite (golden + adversarial) vor Release |
|
||||
| **Output-only Guardrails** | Nur Regex auf die Antwort | Guardrails an Tools, Permissions, Inputs *und* Outputs |
|
||||
|
||||
**Brücke zum Buch:** Alles aus Kap. 3–10 gilt *innerhalb* eurer Agent-Plattform verdoppelt — Context, DoD (Evals), Slices, Permissions.
|
||||
**Brücke zum Buch:** Context, DoD, Memory und Permissions gelten *innerhalb* der Plattform verdoppelt — Spawn/Hand-back [Kap. 5.6](kapitel-05-context-engineering-write-select-compress-isolate.md), Routing [5.7](kapitel-05-context-engineering-write-select-compress-isolate.md), Tiers/Write-Back [Kap. 6](kapitel-06-knowledge-layer-wissen-fuer-agents.md), Isolation [Kap. 18](kapitel-18-security-fuer-coding-agents.md).
|
||||
|
||||
---
|
||||
|
||||
## 19.10 Gegenmittel: Positive Praktiken → Anti-Patterns
|
||||
|
||||
Im Retro sitzt das Team vor „der Agent war schlecht“. Meist fehlt nicht ein Modell-Upgrade — es fehlt die Praxis, die den Fail *hätte* killen können. Vier Hebel decken fast alles ab: Context aktiv managen ([Kap. 3](kapitel-03-kontext-ist-koenig.md), [4](kapitel-04-context-management-in-der-praxis.md)), DoD als Command oder Human-Gate ([Kap. 10](kapitel-10-definition-of-done-und-autonome-loops.md)), vertikale Slices ([Kap. 8](kapitel-08-vertikale-slices-und-komplexitaet.md)) und Diff-Review (19.4). Auf Plattform-Ebene kommen Knowledge Layer ([Kap. 6](kapitel-06-knowledge-layer-wissen-fuer-agents.md)), Permissions ([Kap. 15](kapitel-15-praktisches-setup-und-tooling.md), [18](kapitel-18-security-fuer-coding-agents.md)) und Orchestrierung erst nach stabilem Single-Path ([Kap. 22](kapitel-22-multi-agent-orchestrierung.md)) dazu. Welche Praxis welche Fehlerklasse trifft, sagt die Spalte „Do this instead“ in den Tabellen oben.
|
||||
Im Retro sitzt das Team vor „der Agent war schlecht“. Meist fehlt nicht ein Modell-Upgrade — es fehlt die Praxis, die den Fail *hätte* killen können. Die vier Hebel sind Context ([Kap. 3](kapitel-03-kontext-ist-koenig.md), [4](kapitel-04-context-management-in-der-praxis.md)) und DoD als Command oder Human-Gate ([Kap. 10](kapitel-10-definition-of-done-und-autonome-loops.md)). Dazu kommen vertikale Slices ([Kap. 8](kapitel-08-vertikale-slices-und-komplexitaet.md)) und Diff-Review (19.4). Auf Plattform-Ebene kommen Knowledge Layer ([Kap. 6](kapitel-06-knowledge-layer-wissen-fuer-agents.md)) und Permissions ([Kap. 15](kapitel-15-praktisches-setup-und-tooling.md), [18](kapitel-18-security-fuer-coding-agents.md)) dazu. Orchestrierung erst nach stabilem Single-Path ([Kap. 22](kapitel-22-multi-agent-orchestrierung.md)). Welche Praxis welche Fehlerklasse trifft, sagt die Spalte „Do this instead“ in den Tabellen oben.
|
||||
|
||||
---
|
||||
|
||||
## 19.11 Wo die Bausteine liegen
|
||||
|
||||
Pfade und Wann stehen in 19.1; welches Gegenmittel welche Fehlerklasse trifft, sagt die Spalte „Do this instead“ in den Tabellen oben. Werkbank-Ziele — Anhang A.6/A.7, die Stop-Regel aus 10.8, die Isolationsstufen aus 18.8/18.9 — stehen dort und in ihren Kapiteln.
|
||||
Pfade und Wann stehen in 19.1. Werkbank: [A.6](kapitel-23-anhang-a-kern-templates.md)/[A.7](kapitel-23-anhang-a-kern-templates.md). Stop-Regel: [10.8](kapitel-10-definition-of-done-und-autonome-loops.md). Isolation und Supply-Chain: [18.8](kapitel-18-security-fuer-coding-agents.md)/[18.9](kapitel-18-security-fuer-coding-agents.md).
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -420,7 +420,7 @@ Sprint-Review: drei Strong-Workers auf demselben Epic, kein Ownership, Parent al
|
||||
| „Noch ein Agent“ bei Stuck | Spawn-Spam | Stop, Diagnose, Scope oder Tier |
|
||||
| Multi-Agent in Low-Maturity | Drift × N | Slice 0 / Hygiene zuerst (Kap. 21) |
|
||||
|
||||
Weitere Plattform-Fallen (Spawn ohne Hand-back, Always-Max, Observability, Permissions): [Kapitel 19.9](kapitel-19-checklisten-templates-und-anti-patterns.md).
|
||||
Weitere Plattform-Fallen (God Agent, Tool-Sprawl, Observability, Output-only Guardrails): [Kapitel 19.9](kapitel-19-checklisten-templates-und-anti-patterns.md). Spawn ohne Hand-back: 5.6; Always-Max: 5.7; Isolation: [Kap. 18](kapitel-18-security-fuer-coding-agents.md).
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -141,7 +141,7 @@ Neue Companion-Figuren zu bestehenden Kerndiagrammen. **Prompts fertig**; Assets
|
||||
| ID | Titel | Kapitel | Asset (Ziel) | Prompt | Status |
|
||||
|----|-------|---------|--------------|--------|--------|
|
||||
| S-10 | Context-Rot Session Timeline | 03 · Zone B | `S-10-context-rot-session-timeline.jpg` | `prompts/gemini/should/S-10-context-rot-session-timeline.txt` | Eingebettet (SVG→JPEG 2026-08-23, Karten statt Szenen) |
|
||||
| S-11 | Progressive Disclosure Funnel | 06 · §6.3 | `S-11-progressive-disclosure-funnel.jpg` | `prompts/gemini/should/S-11-progressive-disclosure-funnel.txt` | Eingebettet (SVG→JPEG 2026-08-15, kein Badge-Source) |
|
||||
| S-11 | Progressive Disclosure Funnel | 06 · §6.3 | `S-11-progressive-disclosure-funnel.jpg` | `prompts/gemini/should/S-11-progressive-disclosure-funnel.txt` | Asset da, nicht eingebettet (AP8 2026-11-07: Doppelung zu K-09; JPEG bleibt) |
|
||||
| S-12 | Complexity Budget Gauge | 08 · §8.3 (Kanon; 14 nur Text) | `S-12-complexity-budget-gauge.jpg` | `prompts/gemini/should/S-12-complexity-budget-gauge.txt` | Eingebettet (SVG-first 2026-08-12; keine %-Skala) |
|
||||
| S-13 | Broken Windows Cascade | 12 · §12.10 | `S-13-broken-windows-cascade.jpg` | `prompts/gemini/should/S-13-broken-windows-cascade.txt` | Eingebettet (SVG→JPEG 2026-08-23, keine Mini-Bubbles) |
|
||||
|
||||
|
||||
Reference in new issue
Block a user