---
name: brain-documentation-pflicht
description: "Standing Order Kais 13.05.2026 — alle wichtigen Erkenntnisse, Recherchen, Projektdaten, neue Projekte und Items für später müssen im Brain dokumentiert werden, nicht nur in Linear oder Daily-Log"
metadata: 
  node_type: memory
  type: feedback
  originSessionId: e829fdb7-fd6b-45b6-9944-4227750f2220
---

Standing Order Kais 13.05.2026 00:11 CEST (Telegram msg 1567):

> "Wichtige Erkenntnisse, Recherchen, Projektdaten, neue Projekte, wichtig für später usw muss alles im Brain dokumentiert werden."

**Wann was wo:**

- **Erkenntnis aus Recherche/Audit/Subagent-Output** → `02-Wissen/<topic>-YYYY-MM-DD.md` mit Frontmatter
- **Neues Projekt** → `01-Projekte/<slug>/` mit analysis-map + implementation-plan + task-list (doc-manager-pattern)
- **Wichtig für später / Backlog-Item** → Brain + Linear-Issue (nicht nur Linear, weil dort flacher Kontext)
- **Code-Review-Findings** → `02-Wissen/<repo>-code-review-YYYY-MM-DD.md` + Linear-Issues parallel
- **Status-Audits** → `02-Wissen/<repo>-prompt-status-YYYY-MM-DD.md` plus Daily-Log-Verweis

**Why:**
Linear ist Backlog-Tracker mit Title + Description, kein langfristiges Kontext-Repository. Brain bewahrt:
- Mental-Models und Why-Erklärungen die Linear-Issue-Bodies sprengen würden
- Cross-Links zwischen verwandten Notes via [[wikilinks]]
- Versioning via superseded_by-Frontmatter
- Such-Index via aria-brain-search.py

**How to apply:**
Bei jedem Audit/Recherche/Subagent-Output: erst Brain-Note schreiben, dann Linear-Issues anlegen mit Verweis auf Brain-Note. Nicht umgekehrt. Linear-Issue-Body kann auf `brain/02-Wissen/...md` verweisen.