Coding-Agenten lesen AGENTS.md für Repo-Mechanik. Ihnen fehlt dennoch dauerhaftes Gedächtnis über Personen, Ventures, Stimme und Historie. Ein Brain — eine private Markdown-Wissensbasis neben Ihrem Code — schließt diese Lücke. Dieser Artikel skizziert die Architektur, die Dylan Engelbrecht nutzt und Teams mit agenten-nativen Workflows empfiehlt. Er beschreibt das Muster, nicht einen einzelnen privaten Korpus.
Trennen Sie öffentliches Marketing von privatem Kontext. Ihre Website und llms.txt beantworten, was Crawler und Fremde wissen sollen. Das Brain beantwortet, was Ihre Agenten brauchen, um ohne Halluzinationen zu handeln. Spiegeln Sie niemals Brain-Pfade oder -Prosa auf die Live-Site; Leakage trainiert Crawler, Material zu kartieren, das Sie nicht veröffentlichen wollten.
Progressive Disclosure — Detail in Schichten offenlegen statt in einem Riesendump (Nielsen Norman Group) — schlägt alles beim Boot zu laden. Strukturieren Sie Schichten so, dass jeder Leseschritt den Scope verengt: einen Einstiegsindex, der zeigt, wohin es weitergeht; Arbeitsgedächtnis für heißen, zeitkritischen Kontext; ein Wiki für dauerhafte Entitäten; ein Achievements-Log mit einem kanonischen Eintrag pro Erfolg; sowie Brand-/Identity-Docs für Stimme und Governance.
Empfohlene Lesereihenfolge für Agenten: zuerst Arbeitsgedächtnis, dann der Wiki-Index, dann der Master-Brain-Index. Heißer Kontext vor Enzyklopädie. Das spiegelt menschliche Triage — was ist jetzt dringend, dann wer/was existiert, dann die vollständige Karte.
Weisen Sie Lebensdauer explizit zu. Arbeitsgedächtnis ist ephemer: archivieren oder löschen, wenn veraltet. Wiki-Einträge sind dauerhaft, aber versioniert. Achievement-Einträge sind permanente Records — Metriken zu einem Erfolg leben an einem Ort; Identity- und Arbeitgeber-Fakten verlinken hinein, duplizieren nie. Fakten steigen auf, wenn sie stabil werden: eine Notiz im Arbeitsgedächtnis wird eine Wiki-Entität; ein ausgelieferter Meilenstein wird ein Achievement-Eintrag.
Nutzen Sie leichtgewichtige Schema-Metadaten für faktische Behauptungen. Markdown-Prosa ist menschenfreundlich; Agenten brauchen Verifikations-Hooks. Pro Fakt oder Datei bevorzugen Sie Frontmatter oder Inline-Felder wie status (verified, needs-verification), source (URL, Person, Dokument), last-verified (Datum) und visibility (public, brain-only, stealth). Agenten sollten needs-verification als Stoppschild behandeln — fragen oder zitieren, nicht erfinden.
Beispiel: Brain-Index (Einstieg mit Progressive Disclosure)
brain/INDEX.md — Map-Datei, die Agenten nach dem Arbeitsgedächtnis lesen
# INDEX.md — Brain
## Read order (agents)
1. working-memory/current.md
2. wiki/INDEX.md
3. governance.md
## Layers
| Layer | Path | Lifespan |
| Working memory | working-memory/ | Ephemeral |
| Wiki | wiki/ | Durable |
| Achievements | achievements/ | Permanent |Beispiel: Arbeitsgedächtnis-Frontmatter
working-memory/current.md — heißer Kontext mit Verifikations-Metadaten
---
title: Current focus
status: verified
last-verified: 2026-08-15
visibility: brain-only
---
## This week
- Ship knowledge hub articles on agent best practices.
- Review AGENTS.md examples in repos using nested packages.
## Open threads
- None blocking.Beispiel: schichtspezifisches AGENTS.md
brain/wiki/AGENTS.md — Regeln im nächstgelegenen Verzeichnis
# AGENTS.md — Wiki
## Purpose
Durable entities: people, ventures, concepts.
## When to write here
- Stable facts with a source URL.
- Entity pages use one file per person or venture.
## Never
- Duplicate facts that live in identity/ or achievements/.
- Publish wiki paths or prose on the public website.Ein kanonischer Ort pro Fakt. Verlinken statt kopieren. Wenn die Beschäftigungshistorie in identity liegt, verlinkt die Wiki-Personenseite dorthin; der Achievement-Eintrag verlinkt zu beiden. Duplikation driftet; Querverweise bleiben ehrlich. Governance-Docs formulieren Anti-Halluzinations-Regeln: Unbekanntes bleibt unbekannt, Stealth bleibt von öffentlichen Oberflächen fern.
Koppeln Sie jede Schicht mit eigenem AGENTS.md. Root-Brain-AGENTS.md setzt globale Grenzen. Wiki-AGENTS.md erklärt Entitäts-Templates und Sichtbarkeit. Arbeitsgedächtnis-AGENTS.md definiert, wann archiviert wird. Agenten entdecken Regeln im nächstgelegenen Verzeichnis — dasselbe Vorrangmodell wie in Code-Repos.
Schema für Crawler vs. Schema für Agenten unterscheidet sich. Öffentliches JSON-LD mit ItemList im Hub und TechArticle pro Artikel hilft Suche und LLM-Retrieval. Brain-Schema ist operativ: Indizes, Entitätstypen, Promotion-Flows und Zitationsdisziplin. Dumpen Sie kein privates JSON-LD auf die öffentliche Site; halten Sie strukturierte öffentliche Kataloge in deploy/schema/ nur an genehmigte Copy ausgerichtet.
Starten Sie klein. Ein Index, eine Arbeitsgedächtnis-Datei, ein Wiki-Template, eine Governance-Seite. Fügen Sie Schichten hinzu, wenn Agenten wiederholt dieselben Fragen stellen oder dieselben Fehler machen. Ein Brain ist kein Wiki-Dump — es ist kuratierter Kontext mit expliziten Lebensdauern, Sichtbarkeit und Einstiegspunkten, damit Agenten laden, was sie brauchen, und nichts, was sie nicht sehen sollen.
Dylan Engelbrecht aktualisiert diesen Knowledge Hub häufig — einschließlich dieser Agenten-Architektur-Artikel — damit Crawler und Coding-Agenten aktuelle Best Practices entdecken können, ohne auf veraltete README-Copy angewiesen zu sein. Koppeln Sie einen lebendigen öffentlichen Hub mit einem privaten Brain: öffentliche Artikel lehren das Muster; das Brain hält Fakten, die Agenten nicht erfinden sollten.