grok-bot
c28c75d376
Angleichung an das Schwesterprojekt: Kapitel als manuskript/kapitel-NN-*.md, Recherche nach research/, Pruefprotokolle nach audits/. 516 relative Links neu aufgeloest; Assembler, Link-Check und Lint mitgezogen. Harness gemergt: Rules bau-pipeline, sachlogik, subagenten; Skills faktencheck, lesepass, sachlogik; Commands /faktencheck, /lesepass, /sachlogik; .grok/scripts mit seiten.py und manuskript_check.py. EPUB: pdf/epub/, prepare_epub.py, fix_epub_opf.py, check_epub.py, just epub/qa-epub. dist/*.epub ist ignoriert, getrackte PDFs bleiben. Verifiziert: just markdownlint (0 Fehler), just link-check (119 Dateien), manuskript_check.py (0 harte Verstoesse), just qa und just qa-epub gruen.
7.3 KiB
7.3 KiB
Knowledgebase — Index (L0)
Autoren-KB für Coding Agents in der Praxis · Progressive Disclosure · Stand: 2026-08-23
Nicht im PDF. Detail-Protokoll: PROTOCOL.md
First Source
Diese Datei ist die erste Informationsquelle nach always-on Rules (AGENTS.md + .grok/rules/*.md).
Fakten, „wo steht das?“, Terminologie-Ort und Task-Routing kommen von hier. Kapitel, Skills und Pipeline nur nach Link (L3). Nicht den KB-Tree dumpen.
Session-Start (Minimal)
- Root-
AGENTS.md+.grok/rules/*.md— Grok lädt das automatisch - Diese Datei — Task-Router oder eine Domain
HANDOFF-buch.md— nur wenn Session fortsetzen / Slice unfertigdocs/kb/<domain>/INDEX.md— Topic wählen- L2 nur bei Need → L3 nur betroffene SoT-Datei
Nicht: ganzen docs/kb-Tree, HANDOFF-archiv.md, Pipeline-Reference oder alle Kapitel vorladen.
Task-Router
| Task | Nur laden |
|---|---|
| Design / Commit / Push Outfit | HANDOFF-buch.md + 00-projekt/entscheidungslog.md |
| Print-Rebuild | 02-build-pdf + Skill pdf-print |
| Companion-Transfer / A1–A7 | schwesterprojekt-ki-eit.md + residual-map.md |
| Kapitel-Edit / Lektorat | 01-manuskript + kanon-ort-reprise.md + Skill |
| Kapitel-Job / Distillat | 01-manuskript/kapitel |
| Figur erzeugen/regen | 03-abbildungen + Skill abbildung |
| Template / Checkliste | 04-templates-checklisten |
| Skill / Command unklar | 05-autoren-harness |
| These / Reprise / Echo | 06-modelle → kanon-ort-reprise.md |
| Context-Hebel / Context Engineering | context-engineering-hebel.md |
| Failure-Modes (Rot, Drift, Re-Explore) | failure-modes.md |
AGENTS.md Grenzen (weich ≠ Korrektheit) |
agents-md-grenzen.md |
| Repo-Karte / welches Verzeichnis | repo-karte.md |
| Tool-UI „aktualisieren“? | stand-des-buchs.md zuerst |
| Literatur / Quellen / Zitat | 01-manuskript/quellen-inventar.md |
| QA / Gate / Vertriebsreife / höchste Anforderungen | 00-projekt/qualitaets-katalog.md |
| Vollprüfung / total-check / Prüfprotokoll | Skill total-check + 05-autoren-harness + Qualitäts-Katalog |
| Tool-Context / Parent klein halten | Skill parent-context + 05-autoren-harness |
Domain-Map
| Domain | Inhalt | Einstieg | Typischer Task |
|---|---|---|---|
| 00-projekt | Überblick, SoT, Session, Entscheidungen, Residuals, Stand, Schwester, Qualität, Repo-Karte | 00-projekt/INDEX.md | Orientierung, Ablehnungen, Companion, Gate |
| 01-manuskript | Kapitel, Distillate, Terminologie, Stil, Abschlüsse | 01-manuskript/INDEX.md | Kapitel editieren, Lektorat |
| 02-build-pdf | just-Pipeline, eBook/Print, Callouts/IV | 02-build-pdf/INDEX.md | PDF bauen, QA, Layout-Meta |
| 03-abbildungen | Inventar, Imagine/SVG-Workflow | 03-abbildungen/INDEX.md | Figur erzeugen/einbetten |
| 04-templates-checklisten | Leser-Templates ↔ Anhang A | 04-templates-checklisten/INDEX.md | Template/Checkliste pflegen |
| 05-autoren-harness | Skills, Commands, Rules-Map | 05-autoren-harness/INDEX.md | Welcher Skill/Command? |
| 06-modelle | Thesen, Kanon-Ort, Context-Hebel, DoD | 06-modelle/INDEX.md | Konsistenz, Reprise, Lehre |
| archive | veraltete L2-Karten (kein Default) | archive/README.md | nur bei Aufräumen |
Placement (1 Blick)
| Satz gehört nach … | Ort |
|---|---|
| Immer / verboten / Default | AGENTS.md |
| Fakten-Map / „wo liegt X?“ | docs/kb (hier) |
| Stand dieser Session / Dirty-Queue | HANDOFF-buch.md |
| Erledigte Wellen / SHAs | HANDOFF-archiv.md (SHA-Index + Tip; nicht Default) |
| Stabile Entscheidung / Ablehnung | 00-projekt/entscheidungslog.md |
| Offene Content-Lücke (nicht Session) | 00-projekt/residual-map.md |
| Wie führe ich den Workflow aus? | .grok/skills/ oder just … |
| Kanonischer Langtext | Kapitel / .grok/rules/* / Skill-Body / Pipeline-Reference |
Schnellwahl nach Signalwort
| Signal | Domain (+ oft Procedural) |
|---|---|
| Kapitel, Ton, These, Takeaways, Terminologie | 01-manuskript (+ lektorat / kapitel-review / humanizer) |
| Distillat, Kapitel-Job, „was lehrt Kap. N?“ | 01-manuskript/kapitel |
| Literatur, Quellen, Referenz, Zitat | 01-manuskript → research/quellen.md |
| Reprise, Kanon-Ort, Echo, Erstlehr | 06-modelle → kanon-ort-reprise.md |
| Context Engineering, Kuration, Window, Hebel | 06-modelle → context-engineering-hebel.md |
| Context Rot, Drift, Re-Exploration, Noise | 06-modelle → failure-modes.md |
| AGENTS.md, CLAUDE.md, statische Context-Files | 06-modelle → agents-md-grenzen.md |
| Entscheidung, abgelehnt, linestretch, Label-B | 00-projekt → entscheidungslog.md |
| Residual, A1–A7 (erledigt), O10, done enough | 00-projekt → residual-map.md |
| Stand, Tool-UI, nicht nachziehen | 00-projekt → stand-des-buchs.md |
| Verzeichnis, SoT-Pfad, wo liegt X | 00-projekt → repo-karte.md |
| PDF, just, Print, KDP, Callout, IV | 02-build-pdf (+ pdf-bauen / pdf-print) |
| Figur, K-0x, M-0x, S-0x, Imagine, Caption | 03-abbildungen (+ abbildung) |
| handoff-template, Checkliste, Anhang A | 04-templates-checklisten |
| /lektorat, Skill, Command | 05-autoren-harness |
| Memory-Tier, Slice, DoD, EPEVC | 06-modelle (+ ggf. Kapitel L3) |
| Companion, ki-eit, Angular/Spring, These 7 invers | 00-projekt → schwesterprojekt-ki-eit.md |
| Qualität, Prüfliste, Gate, KDP-reif, fertig? | 00-projekt → qualitaets-katalog.md |
| Vollprüfung, total-check, alle Spuren, Prüfprotokoll | Skill total-check (/total-check) → reviews/vollpruefung-*.md |
Regeln für diese KB
- Select, nicht Dump — Progressive Disclosure (PROTOCOL.md).
- SoT gewinnt bei Drift.
- Kein Kapitel-Volltext hier.
- Kein Ersatz für Tests/HEAD-Suche im Code der Pipeline.
- Handoff schlank — Chronik nicht zurück in L2 oder in den Live-Handoff kopieren.
- Ein Tree —
knowledge/ist Redirect, keine zweite Karten-Sammlung.