jlholm/noodle

Gehirn

Persistentes Gedächtnis über Sitzungen hinweg. Obsidian-Vault unter brain/.

Das Gehirn ist die Grundlage des gesamten Workflows – jeder Agent, jedes Skill und jede Sitzung liest daraus. Inhalte von geringer Qualität oder spekulativer Natur beeinträchtigen alles Nachgelagerte. Bevor du etwas hinzufügst, frage: „Verbessert dies wirklich die Arbeitsweise des Systems?“ Wenn die Antwort nicht ein klares Ja ist, schreibe es nicht.

Vor dem Schreiben

Lies zuerst brain/index.md. Lies dann den relevanten Einstiegspunkt für dein Thema:

• brain/principles.md für Prinzipien-Updates
• brain/plans/index.md für planbezogene Notizen

Für Verzeichnisse ohne dedizierte Index-Datei (bisher brain/codebase/, brain/audits/) scanne nahegelegene Dateien direkt und bearbeite nach Möglichkeit eine vorhandene Notiz.

Struktur

brain/
├── index.md              ← Wurzeleinstieg, verlinkt auf alles
├── principles.md         ← Index für principles/
├── todos.md              ← Produkt-Backlog
├── vision.md             ← Elevator Pitch + Link zur Architektur
├── architecture.md       ← vollständige technische Referenz
├── principles/           ← Engineering- und Designprinzipien
├── codebase/             ← projektspezifisches Wissen und Fallstricke
├── plans/                ← nummerierte Feature-Pläne (02-arrow-bindings/, etc.)
└── audits/               ← Design- und Qualitätsaudits (datum-präfixierte Dateinamen, z. B. 2026-02-20-quality-audit.md)

Regeln:

• Ein Thema pro Datei. brain/codebase/noodle-spawn-gotchas.md, keine Mega-Datei.
• Vorhandene Index-Einstiegspunkte beibehalten: brain/index.md, brain/principles.md, brain/plans/index.md.
• Wenn du eine neue Kategorie auf oberster Ebene einführst, füge einen indexartigen Einstiegspunkt dafür hinzu (nur Links, kein eingebetteter Inhalt).
• brain/index.md ist die Wurzel. Jede Gehirn-Datei muss von dort erreichbar sein.
• Dateinamen: Kleinbuchstaben, mit Bindestrichen. worktree-gotchas.md.
• Plan-Verzeichnisse: Mit der Todo-ID aus brain/todos.md als Präfix. 02-arrow-bindings/ mit overview.md und phase-N-*.md darin.

Wiki-Links

Format: [[section/file-name]]. Auflösungsreihenfolge: gleiches Verzeichnis, dann relativer Pfad, dann Vault-Stamm. Überschriftenanker ([[file#heading]]) werden bei der Auflösung entfernt.

Schreibstil

• Aufzählungspunkte statt Fließtext. Keine Einleitung.
• Einfaches Markdown mit # Titel. Kein Obsidian-Frontmatter.
• Notizen unter ~50 Zeilen halten. Bei Längere aufteilen.

Nach dem Schreiben

Aktualisiere brain/index.md für alle Dateien, die du hinzugefügt oder entfernt hast. Aktualisiere auch den relevanten Einstiegspunkt (brain/principles.md, brain/delegation.md oder brain/plans/index.md), wenn zutreffend. Halte Indizes rein linkbasiert und überfliegbar.

Haltbarkeitstest

Frage: „Würde ich dies in eine Aufforderung für eine andere Aufgabe aufnehmen?“

• Ja → schreibe in brain/. Es ist dauerhaftes Wissen.
• Nein, es ist planspezifisch → aktualisiere stattdessen das Phasendokument des Plans.
• Nein, es ist ein Skill-Problem → aktualisiere die Skill-Datei direkt.
• Nein, es erfordert Folgearbeit → erstelle eine Aufgabe mit dem Skill todo.

Wartung

• Lösche veraltete oder überholte Notizen.
• Lösche zufällig benannte Dateien in brain/plans/ – veraltete Plan-Modus-Artefakte.
• Fasse sich überschneidende Notizen zusammen, bevor du neue hinzufügst.