Ein Brain ist eine Markdown-Architektur. Dylan Engelbrecht hat eine gebaut und verfeinert, damit Agenten viel Kontext halten können — und trotzdem nur die Information wählen, die zur Aufgabe passt.
Es wirkt wie eine Karte. Der Agent merkt sich nicht die ganze Bibliothek. Er orientiert sich, und öffnet dann einen Pfad.
Diese Idee hat einen Namen: progressive disclosure (Nielsen Norman Group). Sie ähnelt dem, wie Menschen denken. Sie beginnen am Anfang mit einer Karte. Sie orientieren sich. Sie lesen nicht zuerst jeden Straßennamen in der Stadt.
Der Chat ist nicht diese Karte. Der Chat ist das aktuelle Gespräch. AGENTS.md ist auch nicht diese Karte. Sie sagt dem Agenten, wie er im Repo arbeitet — bauen, testen, das Haus nicht kaputt machen. Das Brain ist Gedächtnis der Welt, in der der Agent handelt: Personen, Services, Entscheidungen, Vokabular, was letzte Woche passiert ist.
Ordnernamen sind nicht das Protokoll. Das Protokoll ist die Form: ein Index, eine einzeilige Beschreibung neben jedem Eintrag, und Wissen, das an einem Ort bleibt.
Ein Rundgang (vereinfacht)
Ein stark vereinfachtes Beispiel, aber bleiben Sie dabei.
Die Aufgabe lautet: „Was ist mein Lieblingsessen?“
Der Agent lädt nicht jede Datei. Er beginnt beim Index. Der Index listet erstklassige Pfade. Jede Zeile ist kurz genug, damit der Agent entscheiden kann: „öffnen“ oder „überspringen“.
Nehmen Sie den Baum unten mit einer Prise Salz. Passen Sie die Namen an Ihre Welt an. Was zählt, ist der Index, die einzeiligen Beschreibungen, und dass das Wissen zusammenhängt.
Ein Baum mit einer Prise Salz — Namen anpassen
AGENTS.md — mentions that the user's name is x
INDEX.md — the map
Wiki/
People/
x.md — a page about the user
y.mdDer Agent hat in AGENTS.md schon gesehen, dass der Nutzer x heißt. Er schaut in den Index. Er sieht Wiki/People/. Er sieht eine Datei namens x. Das könnte relevant sein, also öffnet er diese Datei. Er öffnet nicht y.md. Er dumpt nicht das ganze Wiki.
In x.md findet er vielleicht eine Notiz: Lieblingsessen ist eine Limette. Die Notiz ist als unbestätigt markiert. Vielleicht hat ein früherer Agent das geschlossen. Es ist nicht bestätigt.
Also sollte der Agent nicht sagen: „Dein Lieblingsessen ist Limette.“ Er sollte etwa sagen: „Ich denke, dein Lieblingsessen ist eine Limette, aber das ist nicht bestätigt. Liege ich richtig?“
Das ist das Protokoll im Kleinen. Zuerst die Karte. Ein Treffer. Eine Datei. Unbestätigte Fakten bekommen eine Frage, keine Vermutung.
Was der Index leisten muss
Wenn der Agent die Datei öffnen muss, um zu wissen, ob die Datei relevant war, ist der Index gescheitert.
Eine gute Indexzeile ist ein Routing-Hinweis: Thema, Pfad, wann öffnen. Verschachtelte Indizes (Personen, Services, Incidents) sind mehr Karte, nicht mehr Boot-Dateien. Ein Fakt lebt an einem Ort. Wenn Sie ihn woanders brauchen, zeigen Sie darauf. Kopieren Sie ihn nicht. Kopien driften.
Dieselbe Regel gilt für Anweisungen. Die nächstgelegene AGENTS.md zu den bearbeiteten Dateien gewinnt. Defaults an der Wurzel. Ausnahmen am Teilbaum. Siehe The AGENTS.md standard for AI coding agents.
Nach dem Spielzeugbeispiel: drei Lebensdauern
Wenn Sie einmal eine Suche gesehen haben, sind die Schichten leichter.
Manche Notizen gelten für diese Woche. Diesen Incident. Diesen Launch. Archivieren oder löschen, wenn sie veralten.
Manche Seiten bleiben über Wochen wahr: Personen, Services, Vokabular, Architekturentscheidungen. Versionieren Sie die.
Manche Records sind schon passiert und dürfen nicht an Ort und Stelle überschrieben werden: Incident-Write-ups, ausgelieferte Meilensteine, Audit-Notizen. Für Entitätsfakten verlinken. Nicht duplizieren.
Fakten können wandern, wenn sie stabil werden. Eine Vermutung, die bestätigt wird, wird eine verifizierte Zeile auf der Personen-Seite. Eine Chat-Anweisung, die zweimal auftaucht, wird eine Playbook-Zeile. Ein Name, der immer wieder kommt, wird eine Wiki-Entität. Erfinden Sie keine Extra-Ordner, bis Agenten dieselbe Frage stellen oder denselben Fehler machen.
Schreiben Sie auf, woher Sie es wissen
Markdown ist für Menschen leicht zu lesen. Agenten brauchen außerdem ein Stoppschild.
Sagen Sie zu jedem Fakt oder jeder Datei:
status — verified, needs-verification oder deprecated.
source — eine URL, eine Person, ein Ticket, ein Dokument.
last-verified — ein Datum.
Behandeln Sie needs-verification wie im Limetten-Beispiel. Fragen oder zitieren. Nicht erfinden. Unbekanntes bleibt unbekannt.
Das ist Provenienz. Sie beantwortet: ist das wahr, laut wem, seit wann?
Zugriffskontrolle ist ein anderer Job. Sie fragt, wer die Datei sehen darf. Manche Brains brauchen Labels wie intern, restricted oder secret. Falten Sie das nicht in die Verifikationsfelder.
Regeln leben neben der Schicht, die sie steuern
Koppeln Sie jede Schicht mit eigenem AGENTS.md. Die Root-Datei setzt globale Grenzen und die Lesereihenfolge. Die Wiki-Datei erklärt, wann eine Personen- oder Service-Seite geschrieben wird. Die Hot-Context-Datei sagt, wann archiviert wird. Agenten entdecken Regeln im nächstgelegenen Verzeichnis. Dasselbe Vorrangmodell wie in einem Code-Repo.
Derselbe Rundgang, Arbeitskontext
Stellen Sie sich ein Team vor, das eine Billing-API ausliefert. Die Aufgabe lautet: „Was ist das Billing-Failover?“
Der Agent beginnt beim Index, nicht bei der öffentlichen Homepage. Der Index sagt: für Billing-Failover öffne wiki/runbooks/billing-failover.md. Er öffnet dieses Runbook. Er lädt nicht jede Service-Seite.
Eine Skizze dieser Karte:
INDEX.md — eine Karte, kein Dump
# INDEX.md — Agent brain
## Read order
1. working-memory/current.md
2. wiki/INDEX.md
3. governance.md
## Layers
| Layer | Path | Lifespan |
| Hot context | working-memory/ | This week |
| Wiki | wiki/ | Stays true |
| Incidents | incidents/ | Already happened |
## Open when
| Signal | Path |
| On-call or Sev | working-memory/current.md, then incidents/ |
| What is service X? | wiki/services/INDEX.md |
| Billing failover | wiki/runbooks/billing-failover.md |Heißer Kontext könnte so aussehen — achten Sie auf Quelle und Datum:
working-memory/current.md — diese Woche, mit Provenienz
---
title: Current focus
status: verified
last-verified: 2026-08-29
source: #inc-1842 retro notes
---
## This week
- Billing retry storm after the card-network timeout change.
- Cut over invoice PDF rendering to the new worker.
## Open threads
- Confirm whether legacy accounts still hit /v1/invoices:finalize.Und der Wiki-Ordner kann eigene Regeln tragen, entdeckt nur, wenn der Agent in diesem Ordner ist:
wiki/AGENTS.md — Regeln im nächstgelegenen Verzeichnis
# AGENTS.md — Wiki
## Purpose
Durable entities: services, customers, concepts, runbooks.
## When to write here
- Stable facts with a source (ticket, spec, or named owner).
- One file per service or concept.
## Never
- Duplicate SLOs or owner names that live on the service page — link.
- Treat chat summaries as canonical.Das ist immer noch eine Skizze. Ein Forschungslabor könnte papers/ und experiments/ halten. Ein Ops-Team könnte incidents/ bis zur zweiten Wiederholung weglassen. Die Ordnernamen sind nicht das Protokoll.
Klein starten
Ein Index. Eine Hot-Context-Datei. Ein Entitäts-Template. Eine Seite, die sagt: „wenn du es nicht weißt, frag.“
Fügen Sie eine Schicht hinzu, wenn Wiederholung die Lücke beweist. Ein Brain ist kein Wiki-Dump. Es ist eine Karte, plus Dateien, die Sie absichtlich öffnen, plus die Gewohnheit, die Limette nicht zu erfinden.
Zusammenfassung
Dumpen Sie nicht den Korpus. Beginnen Sie mit einer Karte und orientieren Sie sich. Folgen Sie einer Indexzeile. Öffnen Sie eine Datei. Jeder Speicher eine Lebensdauer. Jede Behauptung eine Quelle. Ein kanonischer Ort. Regeln neben der Schicht, die sie steuern. Wenn es nicht bestätigt ist, fragen.
Dylan Engelbrecht aktualisiert diesen Knowledge Hub, wenn sich die Agentenpraxis weiterentwickelt. Behandeln Sie diese Artikel als lebendige Referenz — aktuelle Praxis, kein eingefrorener Snapshot.