# brain-import/

**Drop-Folder für Migration-Saatgut.** Inhalt ist komplett gitignored
(außer `.gitkeep` + dieser README) — leg hier Markdown-Dateien ab wenn
du was in die Brain-DB packen willst, klick im Diagnostic-Gehirn-Tab
auf „Migration aus brain-import/", fertig. Was nicht migriert ist,
liegt halt rum.

ARIA pflegt ihr Gedächtnis live in der Qdrant-DB
(`aria-data/brain/qdrant/`) — dieses Verzeichnis ist nicht der
laufende Memory-Store, sondern nur ein Schleusen-Ordner.

## Wofür war das Verzeichnis?

Beim allerersten Bootstrap war das hier das **Saatgut** — Markdown-Dateien
wie `AGENT.md` und `BOOTSTRAP.md` wurden durch
[`aria-brain/migration.py`](../../aria-brain/migration.py) atomar geparst
und als pinned Memory-Punkte in die Vector-DB geschrieben (jeder
Eigenschaftspunkt, jede Regel, jedes Skill-Element ein eigener Eintrag
mit stabilem `migration_key` für Idempotenz).

## Warum jetzt leer?

Seit dem Cleanup im Mai 2026 ist die DB die **Single Source of Truth**:

- ARIA zieht jeden Chat-Turn pinned (Hot Memory) + Top-5 semantisch
  ähnliche (Cold Memory) direkt aus Qdrant
- Stefan kuratiert im Diagnostic-Gehirn-Tab (UI mit Type-Filter,
  Suche, Add/Edit/Delete, Pinned-Toggle)
- Bootstrap-Snapshot (JSON) und Komplettes-Gehirn (tar.gz) sind die
  zwei Backup-/Restore-Pfade — beide spiegeln den aktuellen DB-Stand,
  nicht die Geschichte des Saatguts

Die alten MDs (`AGENT.md`, `BOOTSTRAP.md`, `*.example`) enthielten
Duplikate, OpenClaw-Referenzen und veraltete Architektur-Notizen
und wurden bewusst gelöscht.

## Wann brauchst du das Verzeichnis wieder?

Nur bei Disaster-Recovery **ohne** Bootstrap-Snapshot, oder wenn jemand
ein zweites ARIA von Null aufsetzt und einen reproduzierbaren
Init-Stand via Git haben will. In dem Fall:

1. Frische MDs hier ablegen (z.B. `AGENT.md` mit Identität, Persönlichkeit, …)
2. Diagnostic → Gehirn-Tab → **„Migration aus brain-import/"** klicken
3. ARIA hat Persönlichkeit zurück

Sonst lieber den Bootstrap-Snapshot-Export im Gehirn-Tab nutzen —
der ist immer auf aktuellem Stand.

## .gitkeep / .gitignore

`.gitkeep` und dieser README sind die einzigen Dateien hier die je
ins Repo wandern. Alles andere ist via `.gitignore` ausgeschlossen —
egal ob `AGENT.md`, `USER.md`, `meine-notizen.md`, irgendwas.
