# klaassen-thinkroom-compounding-knowledge-lifecycle-2026-07-02

## Veille

Agent-Guide (Thinkroom, die Plattform von Kieran Klaassen), der den **Compounding Knowledge Lifecycle** des compound-engineering-plugin (Every) dokumentiert: wie eine einmal gelernte Lektion sich „weiter auszahlt" — erfasst, gespeichert, abgerufen und auf Richtigkeit gehalten. Beschreibt die Anatomie eines *Learning* (`docs/solutions/`), dessen Erfassung über `/ce-compound`, die Gedächtniskarte (dauerhaft vs. flüchtig), den *grep-first*-Abruf (learnings-researcher), der an 5 Skills in Entscheidungspunkte eingebunden ist, sowie die drei Gegenkräfte, die das Gedächtnis davon abhalten, zu lügen. Direkt relevant: Es ist die Doktrin hinter der `docs/solutions/`-Konvention dieses Repos. Bereich: Compound Engineering, agentisches Wissensmanagement, Skills.

## Titre Article

The Compounding Knowledge Lifecycle — Agent Guide

## Date

2026-07-02

## URL

https://thinkroom.kieranklaassen.com/d/Yxr8tfwAVV

## Keywords

Compound Engineering, Compounding Knowledge Lifecycle, Learning, Solution Doc, docs/solutions, /ce-compound, learnings-researcher, Pattern doc, dauerhaftes vs. flüchtiges Gedächtnis, grep-first, Frontmatter, vorliegende Evidenz gewinnt, coherence neighborhood, /ce-compound-refresh, Abschaffung von Fehlerklassen, CONCEPTS.md, repo-profile cache

## Authors

Kieran Klaassen (Thinkroom / Every — compound-engineering-plugin) ; document « Agent Guide » généré (byline « Claude Code / Anthropic »)

## Ton

**Profil**: ein technischer Referenz-Guide mit agentischem Zweck („Agent Guide"), dritte Person, dichtes analytisches Register, gegliedert in 8 nummerierte Abschnitte + ein Glossar. Hohes technisches Niveau, richtet sich ebenso an Agenten wie an Ingenieure, die Compound Engineering praktizieren.

**Stil**: erklärend und systematisch, jeder Abschnitt beschreibt eine Phase des Zyklus (Prämisse → Erfassung → Speicherung → Erkennung → Refresh → vollständiger Kreislauf → warum es sich kumuliert). Durchgängiger Einsatz von **Tabellen** (die Rolle jedes Frontmatter-Felds, Konsumenten des Gedächtnisses, vermiedene Fehlermodi) und **Diagrammbeschreibungen**. Eine bewusste und „verdiente" **ausgedehnte Finanzmetapher**: *Learning = Kapital*, *ein Abruf, der eine Entscheidung ändert = Zinszahlung*, *Pattern doc = Reinvestition*, der Korpus (35 Dokumente) = *Bilanz*. Doktrin-Formeln: *„Wissen, um das man trauern würde, kommt nach git; Wissen, das man neu ableiten kann, kommt nach /tmp,"* *„vorliegende Evidenz gewinnt,"* *„ein überzeugt falsches Gedächtnis ist schlimmer als keines,"* *„nicht dass sich Dokumente anhäufen, sondern dass Fehlerklassen abgeschafft werden,"* *„keine leeren Hände."* Autorität durch Selbstdemonstration: Der Guide behandelt sich selbst als lebenden Korpus (eine Zählung von 35 Learnings, das Feature `/ce-explain`, „gestern" ausgeliefert, der reale Incident #714). **Zielgruppe**: Designer agentischer Systeme und Skills, Praktiker von Compound Engineering.

## Pense-betes

- **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**.
- **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.
- **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).
- **`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)**.
- **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).
- **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.
- **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).
- **„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.
- **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.
- **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.
- **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).
- **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.
- **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).
- **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."*
- **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).

## RésuméDe400mots

Dieser Agent-Guide von Thinkroom (der Plattform von Kieran Klaassen) beschreibt den **Compounding Knowledge Lifecycle** des compound-engineering-plugin: den Mechanismus, durch den „eine einmal gelernte Lektion sich weiter auszahlt". Die Grundwette von Compound Engineering: *jede Arbeitseinheit sollte die nächste leichter machen*. Doch Code verbessert das Produkt, nicht den Prozess; was **sich kumuliert**, ist **Wissen** — vorausgesetzt, es wird in einer Form dokumentiert, die **genau in dem Moment abrufbar ist, in dem es gebraucht wird**. Der eigentliche Engpass ist also nicht das Schreiben (Postmortems „verrotten in Wikis"), sondern der **Abruf**, der hier über fünf Skills **automatisiert** wird, statt der Disziplin überlassen zu bleiben.

Die Einheit ist das **Learning**: eine Markdown-Datei, ein gelöstes Problem, unter `docs/solutions/<category>/`, dessen **gesamter Frontmatter der Suche dient** (`title`, `tags`, `module`, `problem_type`, `applies_when`, `severity`, `date`). `problem_type` teilt sich in **bug-track** (was kaputtging) und **knowledge-track** (was entschieden/entdeckt wurde) — denn „ein System, das nur Bugs festhält, vergisst das Wesentliche". Lebender Korpus: 35 Learnings, skill-design an der Spitze. Darüber verallgemeinert das **Pattern doc** mehrere Learnings (mehr Hebelwirkung, mehr Risiko, falls es veraltet).

Die **Erfassung** erfolgt über `/ce-compound`, dessen Disziplin das **Timing** ist (Dokumentation, solange der Kontext noch frisch ist), mit einem Fan-out von Subagenten (Analyzer, Extractor, Dedup-Check), wobei nur der Orchestrator ein einziges Dokument schreibt. Das kanonische Beispiel — Incident #714, der zu Fix + Learning + Test + Doktrin wird — zeigt, dass „Compounding" bedeutet, **Fehlerklassen abzuschaffen**, nicht Dokumente aufzustapeln.

Die **Gedächtniskarte** stellt das Dauerhafte (git: `docs/solutions/`, `CONCEPTS.md`, `STRATEGY.md`, Pläne/Brainstorms = das WARUM) dem Flüchtigen (neu ableitbarer repo-profile cache) gegenüber. Die **Erkennung** drängt nichts auf: Fünf Skills **ziehen** zum Entscheidungszeitpunkt über den grep-first-**learnings-researcher** (35 Dokumente → Frontmatter-Greps → Kandidaten → Volllesung → 5 Befunde). `/ce-code-review` ist „der schärfste Zahn": Ein Verstoß wird zu einem `file:line`-Befund. Zwei Vertrauensregeln schützen ihn: **vorliegende Evidenz gewinnt** und **das Datum ist ein Signal**.

Schließlich hält der **Refresh** das Gedächtnis über drei Gegenkräfte davon ab, zu lügen (Lesezeitpunkt, Schreibzeitpunkt über die *coherence neighborhood*, bedarfsgesteuertes, eingegrenztes `/ce-compound-refresh`). Der Kreislauf wird durchgängig anhand der Auslieferung von `/ce-explain` illustriert. Finanzmetapher: Learning = Kapital, Abruf = Zinsertrag, Pattern doc = Reinvestition — ein System, in dem neue Arbeit „immun gegen vergangene Fehler ankommt".

## GrapheDeConnaissance

- Compound engineering —affirme_que→ "chaque unité de travail doit rendre la suivante plus facile" (AFFIRMATION, 0.95)
- Compounding Knowledge Lifecycle —est_basé_sur→ docs/solutions/ (DOCUMENT, 0.94)
- Learning —fait_partie_de→ docs/solutions/ (DOCUMENT, 0.95)
- Learning —est_basé_sur→ frontmatter conçu pour la recherche (grep-first) (CONCEPT, 0.92)
- ce:compound —permet→ Learning (CONCEPT, 0.93)
- ce:compound —utilise→ subagents (context analyzer, solution extractor, related-docs finder) (METHODOLOGIE, 0.9)
- learnings-researcher —permet→ récupération grep-first aux points de décision (5 skills) (CONCEPT, 0.93)
- /ce-code-review —utilise→ learnings pour un verdict followed/violated contre le diff (CONCEPT, 0.92)
- /ce-plan —utilise→ learnings comme contraintes et KTDs (CONCEPT, 0.9)
- Pattern doc —est_basé_sur→ plusieurs learnings généralisées (DOCUMENT, 0.9)
- repo-profile cache —est_instance_de→ connaissance éphémère re-dérivable (CONCEPT, 0.9)
- Compounding Knowledge Lifecycle —recommande→ "present evidence wins" (signaler le conflit si le code contredit) (AFFIRMATION, 0.92)
- /ce-compound-refresh —résout→ obsolescence de la mémoire (balayage scopé, non par défaut) (CONCEPT, 0.9)
- Compounding Knowledge Lifecycle —affirme_que→ "compounding = retirer des classes de défaillance, pas empiler des docs" (AFFIRMATION, 0.9)
- Compounding Knowledge Lifecycle —résout→ wiki rot (postmortems non relus) (CONCEPT, 0.9)
- Kieran Klaassen —a_créé→ Thinkroom (TECHNOLOGIE, 0.85)

---
Canonical: https://www.thekb.eu/de/fiches/klaassen-thinkroom-compounding-knowledge-lifecycle-2026-07-02/