--- title: aria-brain Schema und Konventionen type: schema tags: [meta, schema, agent-rules] date: 2026-05-11 status: aktiv related: [[SOUL]], [[CORRECTIONS]], [[SELF-IMPROVEMENT]], [[HEARTBEAT]], [[02-Wissen/aria-architektur-tief-2026-05-08]], [[02-Wissen/aria-folder-aspirations]], [[CLAUDE.archive]] --- # aria-brain Schema und Konventionen > Konvention für den aria-brain Vault. Sowohl Kais (in Obsidian) als auch Aria (als Agent) richten sich danach. > Stand: KAR-68 Split (11.05.2026). Sektion 2a in `02-Wissen/aria-folder-aspirations.md`, Änderungs-Log in `CLAUDE.archive.md`. ## 1. Frontmatter (Properties) Jede neue MD-Datei bekommt Frontmatter im YAML-Format. Pflichtfelder: ```yaml --- title: Kurzer Titel der Note type: project | reference | research | daily | identity | system | learnings | template | inbox | audit | schema | moc tags: [tag1, tag2] date: 2026-05-08 status: aktiv | archiv | draft | done --- ``` Optional aber empfohlen: - `related: [[Note1]], [[Note2]]` (Wiki-Links zu verwandten Notes) - `source: ` (wenn aus externem Material abgeleitet) - `confidence: high | medium | low` (bei Behauptungen oder Schätzungen) - `superseded_by: [[Newer Note]]` (bei abgelösten Notes, statt Löschen) Konvention: snake_case für Property-Keys, lowercase für Tag-Werte. Optionales Datenklassen-Feld (KAR-884, 08.07.2026 — Struktur-Antwort auf die Hard-Constraint „Datenklassen strikt trennen"): - `data_class: privat | bmw | kommerziell | aria` — Pflicht-Empfehlung für Notes in `02-Wissen/bmw-allgemein/`, `02-Wissen/kadicon-business/` und bei privaten Inhalten. BMW-markierte Notes nie an externe Dienste senden. **Dokumentierte Schema-Ausnahme (KAR-884):** Die AKP-Video-Pipeline schreibt Notes in `00-Inbox/Videos/` mit eigenem Vokabular (`klassifikation:` statt `type:`, plus `plattform`/`channel`/`prioritaet`/`confidence`). Das ist eine bewusste Pipeline-Konvention, kein Verstoß — bei Promotion einer Video-Note nach `02-Wissen/` wird sie auf das Standard-Schema (inkl. `type:`) umgezogen. ## 2. Folder-Schema (real existent) Top-Level-Folders sind numerisch (Johnny-Decimal-light), 1 Subfolder-Ebene maximal. | Nr | Folder | Inhalt | Anti-Pattern / Hinweis | |----|--------|--------|------------------------| | 00 | Inbox | Vorsortierung, schnelle Notizen | append-only, Aria sortiert | | 01 | Projekte | Aktive Projekte (KADiCon, Aria, Kunden) | aktuell leer, befüllen wenn benötigt | | 02 | Wissen | Recherchen, Konzepte, Erklärungen, Architektur-Audits | nicht für Status oder Tasks | | 03 | Recherchen | Tiefere Recherchen mit Quellen | aktuell leer, ggf. konsolidiert mit 02 | | 04 | Feedback | Kais-Feedback, externe Reviews | append-only | | 05 | Referenzen | Aria-Templates, Snapshots, n8n-Backups, YouTube-Transcripts | Reference-Material | | 06 | Daily | Tages-Logs, Wochen-Reviews | TABU für Renames (Hook) | **Aktueller Stand**: alle 7 Folders existieren. 00-Inbox hat 1 Sub-Folder "Videos". 02-Wissen hat aktive Architektur-Docs (openclaw-vs-aria, hermes-vs-aria, aria-architektur-tief, aria-folder-aspirations). 06-Daily hat Tages-Logs. **Aspirationelle Folders** (nicht angelegt, bei Bedarf erweitern): siehe `02-Wissen/aria-folder-aspirations.md` für 07-Memory-Consolidated, 08-Finanzen, 09-Buch-Aria, 11-Legal, 12-Templates, 14-Branding, 15-Media, 16-AI-Output, 99-SelfAudit. ## 3. Wiki-Links und MOCs - Jede Note bekommt mindestens 1 Wikilink in `related:` Frontmatter (oder im Body). - Bereichs-INDEX-Files dienen als Maps of Content (MOCs). Bei Bedarf anlegen wenn ein Bereich >5 Notes hat. - Globaler Einstiegspunkt: `00-Inbox/INDEX.md` (anlegen wenn Inbox >10 Notes wächst). ## 4. Atomic Notes - Eine Note = ein Thema. Keine Dump-Files mit 5 Themen. - Bei zu langen Notes: aufteilen in mehrere Notes mit Wiki-Link-Verbindung. - Reference-Dokumente (Verträge, Mietspiegel-Auszüge, etc.) dürfen lang sein, gehören aber in eigene Files. ## 4a. PARA-Mapping (Konvention seit 10.05.2026) Adaptiert aus Tiago Forte's PARA und Paperclip's `para-memory-files`-Skill. Die existierenden Folder werden **nicht** umbenannt — die PARA-Buckets sind eine Convention-Layer darüber. Bei neuem Content den passenden Bucket wählen, bei Refactor in den Bucket konsolidieren. | PARA-Bucket | Folder heute | Definition | Lifecycle | |---|---|---|---| | **Projects** | `01-Projekte/` | Aktive, zeitlich begrenzte Deliverables mit klarem Outcome | Aktiv → Done → Archive | | **Areas** | (virtuell — kein eigener Folder) | Laufende Verantwortungsbereiche ohne End-Datum | Permanent, periodisch reviewed | | **Resources** | `02-Wissen/` + `03-Recherchen/` + `05-Referenzen/` | Wissen für späteren Bezug, kein konkretes Project | Append-only, gelegentlich konsolidieren | | **Archives** | `06-Daily/Archiv/` + `CORRECTIONS.archive/` + `HANDOFF.archive/` + `CLAUDE.archive.md` | Abgeschlossene Projekte, alte Tages-Logs, abgelöste Versionen | Read-only, nie aktiv editiert | | **Inbox** | `00-Inbox/` | Vorsortierung — bevor PARA-Bucket geklärt ist | Wird wöchentlich von Aria sortiert | | **Root** | `SOUL.md`, `IDENTITY.md`, `USER.md`, `TOOLS.md`, `ENGINEERING.md`, `CORRECTIONS.md`, `SELF-IMPROVEMENT.md`, `HEARTBEAT.md`, `HOOKS.md`, `HANDOFF.md` | Identity-Layer + Behavioral Rules (PARA-orthogonal) | Im SessionStart-Hook geladen, Bootstrap-Cap 12 KB/file | **Beim neuen Content fragen:** Hat das Ende-Datum oder klares Outcome? → Projects. Ist es eine Dauer-Verantwortung? → Areas (virtuell). Reference-Material? → Resources. Done und nur noch zum Nachschlagen? → Archives. **Folder-Rename Phase 2:** Optional, separates KAR-Issue (KAR-53). Nicht jetzt — Wiki-Links/Hooks/Skripte referenzieren die Folder-Namen. ## 4b. Supersession-Rule (Konvention seit 10.05.2026, Paperclip-Pattern) Wenn ein Wissens-Stand durch einen neuen ersetzt wird: **superseden, nicht stillschweigend löschen**. Drei Mechanismen je nach Typ: 1. **Frontmatter-Pointer** in der alten Note: `superseded_by: [[Newer Note]]` — Note bleibt im Repo, ist als veraltet markiert. Default für Resources. 2. **`[SUPERSEDED ]` im Titel** + `**Superseded by:** LRN-XXXX` Block am Anfang. Default für CORRECTIONS-LRNs. 3. **Move nach `*.archive/`** wenn die Note physisch im Weg ist. Nur für komplette Files, nicht für Sektionen. Was *nicht* geht: silent delete von Knowledge-Inhalt. Auch nicht „kürzen weil veraltet". Wenn Aria oder Kais was ablöst → Pointer hinterlassen, dann ggf. archivieren. **Ausnahme:** Tages-Logs >30 Tage werden in `06-Daily/Archiv/` verschoben (kein Pointer nötig, das ist Standard-Lifecycle). **Warum:** Memory-Recall braucht Spuren. „Wir hatten das früher anders" ohne Pointer = Aria muss raten oder Kais erklären. Pointer = Aria findet die Begründung selbst. ## 4c. Conflict-Resolution-Hierarchie (KAR-756) Bei **widersprüchlichen** Brain-Quellen NICHT still die höher-gescorte nehmen — nach dieser Hierarchie auflösen (oben gewinnt): 1. Kais' aktuelle Session-Entscheidung 2. SOUL/Identity-Regeln (SOUL, CORRECTIONS, SELF-IMPROVEMENT) 3. Neuere Brain-Note mit höherer `confidence` 4. Ältere Brain-Note 5. Code-Kommentar / abgeleitete Quelle Querregel: eine `superseded_by`-Note verliert immer gegen ihre Nachfolgerin. `aria-brain-search.py` surft `superseded_by` + `status: archiv|historical|dormant` mit ⚠ — Konflikte sichtbar machen, nicht still wählen („Detecting is not Resolving"). Detail: [[02-Wissen/aria-conflict-resolution-hierarchy]]. ## 5. Schreibrechte des Agenten **Aria darf autonom schreiben/ändern in:** - 06-Daily (Tages-Logs) - 02-Wissen (eigene Recherchen, Architektur-Audits) - 03-Recherchen (eigene Recherchen) - 00-Inbox (Vorsortierung) - Aria-eigene Files in 02-Wissen (eigene Audits, Eigenanalyse) **Aria fragt vor Änderung in:** - 01-Projekte (kann Projekt-Status verschieben) - 04-Feedback (Kais-Feedback ist sein Eigentum) - 05-Referenzen (Templates und Snapshots) - Root-Files (SOUL, IDENTITY, USER, TOOLS, CORRECTIONS, SELF-IMPROVEMENT, HEARTBEAT, HOOKS, HANDOFF) **Aria fragt IMMER vor Änderung wenn ein Schutzzonen-Folder existiert** (08-Finanzen, 09-Buch-Aria, 11-Legal). Heute existieren diese nicht — sobald sie angelegt werden, gilt die Schutzzonen-Regel. **Aria löscht NIE ohne explizites Go von Kais.** ## 6. SessionStart-Hook (Pflichtlektüre) **Die kanonische Ladeliste steht in [[BOOTSTRAP]]** (Layer-0-Manifest, KAR-878 / Agent-OS-Audit 08.07.2026). Hier wird bewusst KEINE eigene Liste mehr geführt — drei divergierende Listen (dieses File, /root/aria/CLAUDE.md, Hook) waren die Drift-Ursache. `session-start.sh` implementiert exakt BOOTSTRAP.md; jede Ladelisten-Änderung ändert Hook UND BOOTSTRAP.md im selben Commit. Geladene Files dürfen NIE umbenannt oder verschoben werden ohne Hook+BOOTSTRAP-Update. Caps: 12 KB/File, 80 KB total; bei Überschreitung Warnung + Truncation + Telegram-Ping. **Test-Mode**: `ARIA_HOOK_TEST=1 bash session-start.sh` überspringt Telegram-Ping. ## 7. sources/ vs wiki/ Trennung (aspirationell) - `sources/` = unveränderbare Eingaben (Original-PDFs, Mail-Exporte, Telegram-Snapshots, Verträge als Original). - `wiki/` = abgeleitete, agentengeschriebene Notes mit Verweisen auf `sources/` via `source:` Frontmatter-Feld. **Aktueller Stand**: `sources/` existiert nicht. Wenn Aria größere Source-Materialien verarbeitet, dann anlegen. Heute reicht es Notes in 02-Wissen mit `source:` Field zu versehen. ## 8. Anti-Patterns (vermeiden) - Folders 4+ Ebenen tief - Doppelte Folder-Nummern (post-08.05.2026 in V5 Sprint 0 bereinigt) - Leere Folders (visuelles Rauschen) - Inline-Tags und Frontmatter-Tags vermischt ohne Regel - Lange Notes mit mehreren Themen - Screenshots im Brain - Schreib- und Lese-Pfade des Agenten nicht getrennt - File-Sizes >12 KB (Bootstrap-Limit-Verletzung) ## 9. Wichtige On-Demand-Files (nicht im Hook, gezielt laden) Diese Files werden nicht beim SessionStart automatisch geladen, müssen aber bei spezifischen Aufgaben gezielt gelesen werden. ### Architektur-Audits (vor Aria-Upgrades Pflicht) - `02-Wissen/aria-architektur-tief-2026-05-08.md` — Eigenanalyse - `02-Wissen/openclaw-vs-aria-2026-05-08.md` — OpenClaw-Vergleich - `02-Wissen/hermes-vs-aria-2026-05-08.md` — Hermes-Vergleich ### Vault-Schema Detail-Files - `02-Wissen/aria-folder-aspirations.md` — Aspirationelle Folders (07/08/09/11/12/14/15/16/99) - `CLAUDE.archive.md` — Änderungs-Log ### Corporate Design (aspirationell — bei Brand-Output erst anlegen) CD-Files sind aktuell nicht im Brain. Wenn Branding-Outputs (Aria/KADiCon/MH) wieder aktuell werden, anlegen unter `14-Branding/`. ### Bereichs-Indexes (bei Bedarf) INDEX-Files für Bereiche mit >5 Notes. Aktuell keiner notwendig. ## 10. Änderungs-Log Ausgelagert nach `CLAUDE.archive.md` (KAR-68 Split, 11.05.2026). Bei Schema-Änderung dort append. ## Verwandte Notes - [[SOUL]] (Identität und Werte) - [[CORRECTIONS]] (Aktive Lern-Regeln) - [[SELF-IMPROVEMENT]] (Behavioral Rules) - [[HEARTBEAT]] (Routinen, Cron-Jobs) - [[HOOKS]] (Hook-Inventory) - [[02-Wissen/aria-architektur-tief-2026-05-08]] (Eigenanalyse) - [[02-Wissen/aria-folder-aspirations]] (Aspirationelle Folders) - [[CLAUDE.archive]] (Schema-Änderungs-Log)