The Compounding Knowledge Lifecycle — Agent Guide

Kernpunkte

1. Die Wette von compound engineering. „jede Arbeitseinheit sollte die nächste leichter machen." Code verbessert das Produkt, nicht den Prozess; was sich kumuliert, ist Wissen — jedes gelöste Problem, jedes benannte Konzept, 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 die Schleife, indem es den Abruf über 5 Skills automatisiert, statt ihn einer freiwilligen Disziplin zu überlassen.
3. Ein Learning (Solution Doc). = 1 Markdown-Datei = 1 gelöstes Problem, unter docs/solutions/<category>/. Das 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 meine Zone?"), problem_type (die Routing-Weiche), applies_when (ein 3-zeiliger Selbstauswahltest), severity (Rangfolge bei mehreren Treffern), date (Signal für Veralterung).
4. problem_type = 2 Tracks. 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 behält, vergisst den wesentlichen Teil dessen, was ein Team lernt." Lebendige Zählung: 35 Learnings, 6 Kategorien, skill-design führend (20).
5. Pattern doc. = eine Stufe höher: aus mehreren Learnings verallgemeinert → mehr Hebelwirkung, mehr Risiko, wenn es veraltet. Bisher wurde hier noch keines befördert (docs/solutions/patterns/critical-patterns.md = ein wartender Platz).
6. Erfassung = /ce-compound. , Kerndisziplin = Timing: Dokumentation, solange der Kontext noch frisch ist (dieselbe Sitzung wie der Fix, solange die gescheiterten Versuche und das „ah, DESHALB also" noch präsent sind). Eine Woche später → verkommt es zu einer Zusammenfassung.
7. Mechanik. Subagent-Fan-out (context analyzer = category/name/frontmatter, solution extractor = Fließtext problem/investigation/solution/prevention, related-docs finder = Anti-Duplicate); nur der Orchestrator schreibt EIN Dokument, Subagenten fassen niemals versionierte Dateien an. Weitere Einstiegspunkte: /ce-debug (bietet nach der Ursachenanalyse ein Compound an), /ce-pov („compound it" → tooling_decision im Headless-Modus), Lightweight-Modus (kleine Lektionen, überspringt Anti-Duplicate).
8. „Das Leben eines Learnings". (kanonisches Beispiel): Issue #714 (der Agent stoppt nach dem Menü) → 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 Incident, 4 dauerhafte Artefakte. „Compounding" = Fehlerklassen werden abgeschafft, nicht nur Dokumente angehäuft.
9. Gedächtniskarte, Achse = Dauerhaftigkeit. DAUERHAFT (Git): docs/solutions/ (die 35 Learnings), CONCEPTS.md (Vokabular/Glossar, niemals Specs), STRATEGY.md (Richtung/Tracks), docs/plans/ + brainstorms/ (das WARUM). FLÜCHTIG (abgeleitet): repo-profile cache (1×/Commit 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 ableitbares → /tmp. Pläne werden nach der Ausführung nie bearbeitet → sie erklären das Warum auch Monate später noch.
10. Erkennung: Es wird kein Wissen aufgedrängt. (kein Digest, kein „das Wiki lesen"). 5 Skills rufen es zum Entscheidungszeitpunkt aktiv ab, über ein gemeinsames learnings-researcher-Protokoll, grep-first (das Gedächtnis ist darauf ausgelegt, durchsucht zu werden, ohne gelesen zu werden). Trichter: 35 Dokumente → parallele Frontmatter-Greps → eine Handvoll Kandidaten (~30 Zeilen Frontmatter) → Volltextlektüre der Gewinner → 5 destillierte Findings in den Kontext des Aufrufers.
11. Konsumenten. /ce-plan (Learnings → Constraints & KTDs), /ce-brainstorm (rahmt den Scope), /ce-code-review (permanent aktiver Reviewer: Urteil eingehalten / verletzt gegen den tatsächlichen Diff — „der schärfste Zahn"; ein Verstoß = ein Finding mit file:line, kein Vorschlag), /ce-ideate (kappt vergangene 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 als ungültig zu verwerfen (ein selbstsicher falsches Gedächtnis ist schlimmer als keines); (2) Das Datum ist Signal — jedes Learning trägt sein Datum, um abzuwägen, ob sich die Welt seitdem weiterbewegt hat.
13. Refresh — „ein Gedächtnis, das nur wächst, lügt irgendwann.". 3 Gegenkräfte in unterschiedlichem Tempo: Lesezeitpunkt (vorliegende Evidenz gewinnt, kostenlos); Schreibzeitpunkt (beim Hinzufügen/Bearbeiten eines CONCEPTS.md-Eintrags wird dessen coherence neighborhood — die referenzierten Nachbarbegriffe — geprüft und die Abweichung korrigiert, für die es Evidenz gibt; begrenzt, niemals ein Vollaudit auf Verdacht); bei Bedarf (/ce-compound-refresh, ein gezielter Durchgang, KEIN standardmäßiger Folgeschritt, läuft nur bei einem konkreten Grund, nimmt einen Scope-Hinweis entgegen — /ce-compound-refresh payments — weil ein Refresh des Gesamtkorpus fast nie der richtige Aufwand ist).
14. Der vollständige Kreislauf über /ce-explain. (ein Skill, der „gestern" ausgeliefert wurde, alles tatsächlich geschehen): Der Brainstorm 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 Spiegel-Regressionstest; die Review prüft den Diff gegen 8 Learnings (alle eingehalten) 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); Restposten → 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 Anleitungen, die neue Arbeit abwürgen, unkuratierte Anhäufung, unsichtbares Gedächtnis, Verfall, Silos (ein einziges docs/solutions/ bedient 9 Skills).
16. Direkter Bezug zu diesem Repository. Die docs/solutions/-Konvention (Frontmatter module/tags/problem_type), die in der CLAUDE.md des veille-Repos dokumentiert ist, ist genau dieses System; die compound-engineering:*-Skills (ce-compound, ce-plan, ce-code-review, ce-compound-refresh …) sind hier installiert. Ein natürlicher Kandidat für eine unternehmensweite Beförderung (ein Kapitalisierungsmuster).