The Compounding Knowledge Lifecycle — Agent Guide

Kernpunkte

1. Die Grundwette von Compound Engineering. „jede Arbeitseinheit sollte die nächste Einheit leichter machen." Code verbessert das Produkt, nicht den Prozess; was sich kumuliert, ist Wissen — jedes gelöste Problem, jedes benannte Konzept und jede dokumentierte Konvention in einer Form, die genau in dem Moment abrufbar ist, in dem künftige Arbeit sie braucht.
2. Der eigentliche Engpass = Abruf. , nicht das Schreiben. Postmortems „verrotten in Wikis, weil niemand sie erneut liest". Dieses System schließt den Kreislauf, indem es den Abruf über 5 Skills automatisiert, statt ihn der freiwilligen Disziplin zu überlassen.
3. Ein Learning (Solution Doc). = 1 Markdown-Datei = 1 gelöstes Problem, unter docs/solutions/<category>/. Der gesamte Frontmatter dient der Suche, nicht der Erzählung: title (Grep-Ziel Nr. 1), tags (Synonymfläche — grep tags:.*(menu|routing|handoff), ohne eine Datei zu öffnen), module/component („ist das mein Bereich?"), problem_type (die Weiche für die Zuordnung), applies_when (ein 3-zeiliger Selbsttest), severity (Rangfolge, wenn mehrere passen), date (Signal für Veralterung).
4. problem_type = 2 Spuren. bug-track (was kaputtging: runtime_error, test_failure, performance_issue, security_issue …) und knowledge-track (was entschieden/entdeckt wurde: architecture_pattern, design_pattern, tooling_decision, convention, workflow_issue, best_practice …). „Ein System, das nur Bugs festhält, vergisst den wesentlichen Teil dessen, was ein Team lernt." Lebende Zählung: 35 Learnings, 6 Kategorien, skill-design an der Spitze (20).
5. Pattern doc. = eine Stufe darüber: aus mehreren Learnings verallgemeinert → mehr Hebelwirkung, mehr Risiko, falls es veraltet. Bislang wurde hier noch keines befördert (docs/solutions/patterns/critical-patterns.md = ein Platz, der noch zu füllen ist).
6. Erfassung = /ce-compound. , Kerndisziplin = Timing: dokumentieren, solange der Kontext noch frisch ist (dieselbe Sitzung wie der Fix, solange die gescheiterten Versuche und das „ach, DESHALB" noch präsent sind). Eine Woche später → verkommt es zu einer Zusammenfassung.
7. Mechanik. Fan-out von Subagenten (context analyzer = category/name/frontmatter, solution extractor = Fließtext problem/investigation/solution/prevention, related-docs finder = Dedup-Check); nur der Orchestrator schreibt EIN Dokument, Subagenten fassen versionierte Dateien nie an. Weitere Einstiegspunkte: /ce-debug (bietet nach der Ursachenklärung ein Compound an), /ce-pov („compound it" → tooling_decision im Headless-Modus), Lightweight-Modus (kleine Lektionen, überspringt den Dedup-Check).
8. „Das Leben eines Learnings". (kanonisches Beispiel): Issue #714 (der Agent hält nach dem Menü an) → Ursache (Pro-Option-Routing in einer Referenzdatei, die nicht geladen wurde) → Fix + /ce-compound → Learning post-menu-routing-belongs-inline.md → Regressionstest + Doktrin in AGENTS.md („Inline the Trigger, Not the Content"). Ein Vorfall, 4 dauerhafte Artefakte. „Compounding" bedeutet, dass Fehlerklassen abgeschafft werden, nicht, dass sich nur Dokumente anhäufen.
9. Gedächtniskarte, Achse = Dauerhaftigkeit. DAUERHAFT (git): docs/solutions/ (die 35 Learnings), CONCEPTS.md (Vokabular/Glossar, nie Spezifikationen), STRATEGY.md (Richtung/Stränge), docs/plans/ + brainstorms/ (das WARUM). FLÜCHTIG (abgeleitet): repo-profile cache (1×/Commit neu abgeleitet, von 9 Skills geteilt, nie eine Source of Truth — das Löschen verliert nichts). Regel: Wissen, um das man trauern würde → git; neu ableitbar → /tmp. Pläne werden nach der Ausführung nie bearbeitet → sie erklären das Warum noch Monate später.
10. Erkennung: Nichts drängt einem Wissen auf. (kein Digest, kein „lies das Wiki"). 5 Skills ziehen es zum Entscheidungszeitpunkt über ein gemeinsames learnings-researcher-Protokoll, grep-first (das Gedächtnis ist so konzipiert, dass es durchsucht, nicht gelesen wird). Trichter: 35 Dokumente → parallele Frontmatter-Greps → eine Handvoll Kandidaten (~30-zeiliger Frontmatter) → Volllesung der Gewinner → 5 destillierte Befunde in den Kontext des Aufrufers.
11. Konsumenten. /ce-plan (Learnings → Constraints & KTDs), /ce-brainstorm (rahmt den Scope), /ce-code-review (permanent aktiver Reviewer: Urteil befolgt / verletzt gegen den tatsächlichen Diff — „der schärfste Zahn"; ein Verstoß = ein file:line-Befund, kein Vorschlag), /ce-ideate (kappt frühere Sackgassen), /ce-debug (bringt bekannte Ursachen zutage).
12. 2 Vertrauensregeln. (1) Vorliegende Evidenz gewinnt — widerspricht ein Learning dem aktuellen Code, wird der Konflikt markiert, statt es scheitern zu lassen (ein überzeugt falsches Gedächtnis ist schlimmer als keines); (2) Das Datum ist ein Signal — jedes Learning trägt sein Datum, um abzuwägen, ob sich die Welt weitergedreht hat.
13. Refresh — „ein Gedächtnis, das nur wächst, lügt irgendwann.". 3 Gegenkräfte in unterschiedlichem Tempo: zur Lesezeit (vorliegende Evidenz gewinnt, kostenlos); zur Schreibzeit (beim Hinzufügen/Bearbeiten eines CONCEPTS.md-Eintrags wird dessen coherence neighborhood — die referenzierten Nachbarbegriffe — geprüft und Drift wofür es Evidenz gibt korrigiert; begrenzt, nie ein vollständiger Audit-Lauf aus einer Vermutung heraus); bei Bedarf (/ce-compound-refresh, ein gezielter Durchgang, KEIN standardmäßiges Follow-up, läuft nur, wenn es einen Grund gibt, nimmt einen Scope-Hinweis entgegen — /ce-compound-refresh payments — weil ein Refresh des gesamten Korpus fast nie die richtige Investition ist).
14. Der vollständige Kreislauf anhand von /ce-explain. (Skill „gestern" ausgeliefert, alles ist tatsächlich passiert): Das Brainstorming zieht das repo-profile aus dem Cache; die Planung fördert 5 Learnings zutage (3 must-apply: Inline-Menü-Routing [Erbe von #714], $ARGUMENTS-Portabilität, SKILL_DIR-Anker); die Implementierung erzeugt ihren gespiegelten Regressionstest; das Review prüft den Diff gegen 8 Learnings (alle befolgt) und verwirft einen vom Reviewer vorgeschlagenen Fix, der den ursprünglichen Fehlermodus wieder eingeführt hätte („das Gedächtnis hat die Arbeit nicht nur informiert, es hat sie verteidigt"); Compound-Vokabular (Explainer, Check-in → CONCEPTS.md); Rest → Issue #1057 → künftiges Learning #36. „Kein Schritt erforderte, dass sich jemand daran erinnert, das Gedächtnis zu konsultieren."
15. Warum es sich kumuliert (Finanzmetapher). Learning = Kapital, jeder Abruf, der eine Entscheidung ändert, = Zinszahlung, Pattern doc = Reinvestition. Vermiedene Fehlermodi: Wiki-Verrottung, veraltete Vorgaben, die neue Arbeit abwürgen, unkuratierte Anhäufung, unsichtbares Gedächtnis, Verfall, Silos (ein einziges docs/solutions/ bedient 9 Skills).