Vault Organizer

Was macht Vault Organizer?

Verwandle einen unordentlichen Markdown-Vault in eine saubere, querverlinkte, indexierte Wissensdatenbank, die ein LLM (oder ein Teammitglied) schnell abrufen kann. Basierend auf Karpathys Prinzip: Behandle Wissen wie Code. Rohdaten sind Quelldateien, das kompilierte Wiki ist das Build-Ergebnis, der INDEX ist das Schema, und dieser Skill ist der Compiler + Linter.

Das Modell (3 Schichten)

Schicht	Was	Wo
RAW	Unverarbeitet: Transkripte, Clips, Dumps, Screenshots	00_Inbox/raw/, nächstgelegener Themenordner
COMPILED	Synthetisierte Seiten, querverlinkt mit [[Wikilinks]]	PARA-Ordner (01_–04_)
SCHEMA	INDEX-Dateien, CLAUDE.md, die Regeln	pro Ordner INDEX.md + ein Master-Index

Jede Datei trägt type:-Frontmatter (raw | compiled | reference | framework | client | index). Siehe references/standards.md für die Frontmatter- und INDEX-Vorlagen.

Arbeitsablauf

Führe diese in der Reihenfolge aus. Überprüfe und schlage vor, bevor du etwas änderst. Lösche oder verschiebe niemals ohne Bestätigung. Bevorzuge ein Git-Repository, damit Änderungen rückgängig gemacht werden können.

1. Audit (nur lesen)

# ganzer Vault:
python3 scripts/audit.py <vault_root> --stale-days 120 --report /tmp/vault-audit.md
# ein Unterordner, aber löse [[Wikilinks]] gegen den gesamten Vault auf (vermeidet falsche „defekt“-Markierungen):
python3 scripts/audit.py <unterordner> --link-root <vault_root> --report /tmp/vault-audit.md

Gibt einen Gesundheitsbericht zurück: fehlendes Frontmatter, defekte/fehlende Wikilinks, Waisen, fehlende Verwandte-Abschnitte, Duplikate, veraltete Dateien, Ordner ohne INDEX. Lies ihn, zeige dann dem Benutzer die Zusammenfassungstabelle und die wichtigsten Probleme. (--json für Maschinenausgabe.)

2. Triage

Gruppiere die Ergebnisse und frage, was jetzt vs. später behoben werden soll. Standardpriorität:

1. Ordner ohne INDEX (verhindert Abruf)
2. Fehlendes Frontmatter (verhindert Suche + Eigenschaften)
3. Defekte Wikilinks (verhindert den Graphen)
4. Fehlende Verwandte-Abschnitte + Waisen (verhindert Entdeckung)
5. Veraltete / Duplikate (Bereinigung)

3. Bereinigung (pro Datei)

Für jede markierte Datei:

• YAML-Frontmatter hinzufügen (title, type, source, author, created, description, tags) – aus Inhalt ableiten, heute für created verwenden, falls unbekannt.
• [[Wikilinks]] bei der ersten Erwähnung eines Konzepts, Werkzeugs, einer Person oder Datei hinzufügen, die woanders im Vault existiert.
• Einen ## Verwandte-Abschnitt am Ende mit 3–8 [[Wikilinks]] zu den am meisten verbundenen Seiten hinzufügen. Füge die Datei wieder in die Verwandte-Abschnitte von 2–3 dieser Seiten ein (bidirektional).
• Defekte Wikilinks reparieren: auf den korrekten Slug umleiten oder als absichtlichen Platzhalter belassen, wenn das Ziel später geschrieben werden soll. Verwende die Vorlagen in references/standards.md. Entferne kein vorhandenes Frontmatter oder Links.

4. Organisation (zuerst vorschlagen)

• Falsch abgelegte Elemente in die richtige Schicht/den richtigen Ordner verschieben (Rohdaten → 00_Inbox/raw/, kompiliert → PARA).
• Dateinamen auf Kebab-Case normalisieren; Duplikate zusammenführen oder umbenennen.
• Verschiebungen klein und rückgängig machbar halten. Liste jede Verschiebung auf und hole ein Ja, bevor du sie ausführst.

5. Registrierung (das Ergebnis)

• Für jeden Inhaltsordner INDEX.md generieren oder aktualisieren: ein einzeiliger Zeiger pro Datei (- [[dateiname]] — kurzer Anker), gruppiert nach Typ, neueste oder wichtigste zuerst.
• Einen Master-Index erstellen/aktualisieren (z.B. INDEX.md im Stammverzeichnis oder ein meta/-Schema-Ordner), der auf jeden Ordner-INDEX verweist.
• Dieses Register macht den Abruf schnell und ist das, was du einem Teammitglied übergibst.

6. Linting (bestätigen)

Führe audit.py erneut aus. Zeige die Vorher/Nachher-Zählungen. Der Vault ist „sauber“, wenn Frontmatter, INDEX-Abdeckung und defekte Link-Zählungen bei Null liegen (Waisen/Veraltete können nach Wahl bestehen bleiben).

An ein Teammitglied weitergeben

Wenn das Ziel darin besteht, den organisierten Vault mit einem Teammitglied zu teilen: Stelle sicher, dass der Master-INDEX aktuell ist, jeder Ordner seinen eigenen INDEX hat und eine kurze README.md im Stammverzeichnis das 3-Schichten-Modell und die Navigation erklärt. Die README + der Master-INDEX sind der Einstiegspunkt.

Regeln

• Zuerst immer ein Nur-Lesen-Audit durchführen. An die Oberfläche bringen, nicht überraschen.
• Niemals ohne explizite Bestätigung löschen oder massenhaft verschieben; empfehle, zuerst zu committen.
• Nicht .obsidian/, .git/ oder Claude Code-Konfiguration (settings.json, Hooks) anfassen.
• Den vorhandenen Konventionen des Vaults entsprechen (dieser: PARA + die Standards in references/standards.md).
• In Batches arbeiten; melden, was sich nach jedem Batch geändert hat.

Dateien

• scripts/audit.py — Nur-Lesen-Scanner, die Engine. Führe ihn zuerst und zuletzt aus.
• references/standards.md — Frontmatter-Spezifikation, Typ-Taxonomie, INDEX + README-Vorlagen.