claude-vault/skills/vault-janitor/SKILL.md

name	description	argument-hint	allowed-tools
vault-janitor	Organisiert den Vault durch Memory Distillation, Skill Audits und Integrity Checks. Extrahiert Patterns aus Logs, prüft YAML-Frontmatter und aktualisiert den vault-index. Für Wartung und Aufräumen.	mode distill|audit|propose|sync-projects|anti-pattern-detect|stats|index|check	Read, Write, Edit, Glob, Grep, Bash

ROLE

Du bist der "Hausmeister" dieses Vaults. Dein Ziel ist es, die Entropie zu verringern und sicherzustellen, dass Claude jederzeit die präzisesten und aktuellsten Informationen findet.

AUFGABEN-MODI

1. Memory Distillation (distill) - Wissen destillieren

Ziel: Extrahiere Patterns aus Session-Logs

Vorgehen:

1. Scanne /memory/log/ nach allen .md Dateien (außer archive/)
2. Identifiziere wiederkehrende Muster:
   • Gleiche Probleme (z.B. "N+1 Query" mehrfach erwähnt)
   • Bewährte Lösungen (z.B. "select_related nutzen")
   • Lessons Learned (aus "Lessons Learned" Sektionen)
3. Für jedes Pattern (≥2 Vorkommen):
   • Erstelle/Update Eintrag in /memory/patterns.md
   • Format: ## Pattern-Name, **Problem:**, **Lösung:**, **Beispiel:**
4. Verschiebe verarbeitete Logs nach /memory/log/archive/
5. Erstelle Report: Wieviele Patterns extrahiert, wieviele Logs archiviert

Trigger: Wenn ≥5 neue Logs vorhanden

---

2. Skill Audit (audit) - Fähigkeiten-Check

Ziel: Validiere alle Skills auf Konsistenz und Aktualität

Vorgehen:

1. Finde alle SKILL.md Files in /skills/
2. Prüfe YAML-Frontmatter:
   • Zeile 2: name: vorhanden? (lowercase, hyphens only)
   • Zeile 3: description: vorhanden? (max 200 Zeichen)
   • argument-hint: vorhanden?
   • allowed-tools: vorhanden?
3. Prüfe auf Konflikte:
   • Duplikate (gleicher name: mehrfach)
   • Widersprüchliche Anweisungen (z.B. Django 5.0 vs 5.2)
4. Prüfe Aktualität:
   • Veraltete Tech-Stacks (vs. /knowledge/preferences.md)
   • Verweise auf nicht-existierende Dateien
5. Erstelle Report mit Findings (Critical, Warning, Info)

Output: Audit-Report in /memory/snapshots/YYYY-MM-DD_skill-audit.md

---

3. Skill-Proposal-Detection (propose) - NEU ✨

Ziel: Erkenne wiederholte Aufgaben und schlage neue Skills vor

Vorgehen:

1. Scanne /memory/log/ nach Beschreibungen (Session-Logs)
2. Identifiziere wiederkehrende Aufgaben (≥3x gleiche Worte/Pattern)
3. Für jedes Pattern:
   • Generiere Skill-Name aus Aufgabe (lowercase, hyphens)
   • Erstelle Proposal in /skills/proposals/YYYY-MM-DD_<skill-name>.md
   • Template nutzen mit Trigger-Count und erkanntem Muster
4. Verhindere Duplikate (skip wenn Proposal bereits existiert)
5. Report: Wieviele neue Proposals erstellt

Beispiel:

• 3x "Django Model für X erstellen" → Proposal: django-model-generator
• 4x "API Tests schreiben" → Proposal: api-test-generator

Output: Proposals in /skills/proposals/, Report mit Links

---

4. Projekt-Sync (sync-projects) - NEU ✨

Ziel: Synchronisiere alle Projekt-MEMORYs zwischen Claude und Vault

Vorgehen:

1. Rufe scripts/sync-project-memory.sh auf (via Bash tool)
2. Lese Output und parse Sync-Status
3. Erstelle Zusammenfassung:
   • Wieviele Projekte synchronisiert
   • Welche Richtung (Claude → Vault oder Vault → Claude)
   • Konflikte (falls vorhanden)
4. Report mit Details

Trigger: Täglich via Cron, oder manuell bei Multi-Projekt-Arbeit

---

5. Anti-Pattern-Detection (anti-pattern-detect) - NEU ✨

Ziel: Lerne aus Fehlern und dokumentiere Anti-Patterns

Vorgehen:

1. Scanne /memory/log/ nach Fehler-Indikatoren:
   • Worte: "Fehler", "Bug", "Problem", "Fix", "Gefixt"
   • Code-Snippets mit "ERROR", "FAILED"
2. Für jeden Fehler:
   • Extrahiere Kontext (was war das Problem?)
   • Prüfe ob bereits in /knowledge/anti-patterns/ dokumentiert
   • Falls NEU: Erstelle Proposal für Anti-Pattern
3. Nutze /knowledge/anti-patterns/template.md
4. Output: Proposals in /knowledge/anti-patterns/proposals/

Beispiel:

• 3x "Circular Import Problem" → Anti-Pattern: circular-imports.md
• 2x "Missing Migration" → Anti-Pattern: missing-migrations.md

---

6. Statistics (stats) - NEU ✨

Ziel: Zeige Vault-Gesundheit und Aktivität

Vorgehen:

1. Berechne Metriken:
   • Skills: Total, lp-*, generic
   • Agents: Total
   • Memory: Logs (total, letzte 7 Tage), Snapshots, Patterns-Count
   • Projekte: Total, Liste
   • Proposals: Offen, umgesetzt
2. Erstelle Snapshot in /memory/snapshots/YYYY-MM-DD_stats.md
3. Zeige Top 5 Skills (aus skill-usage-matrix.md falls vorhanden)
4. Zeige Trends (vs. letzter Stats-Snapshot)
5. Empfehlungen basierend auf Metriken:
   • Keine Logs → "Session-Logging aktivieren"
   • Viele Proposals → "Proposals reviewen"
   • Wenig Patterns → "Distillation durchführen"

Output: Stats-Snapshot + Terminal-Summary

---

7. Indexing & README (index)

Ziel: Aktualisiere vault-index.md mit allen Skills/Agents

Vorgehen:

1. Scanne /skills/ für alle SKILL.md
2. Extrahiere aus YAML: name, description
3. Gruppiere: League-Planner Skills (lp-*), Generic Skills
4. Scanne /agents/ für alle .md Files
5. Aktualisiere /vault-index.md:
   • Skill-Tabelle mit Name, Beschreibung, Prefix
   • Agent-Tabelle mit Name, Beschreibung, Model, Farbe
6. Sortiere alphabetisch innerhalb Gruppen

Output: Aktualisiertes vault-index.md

---

8. Integrity Check (check)

Ziel: Finde kaputte Links und "Leichen"

Vorgehen:

1. Suche leere Dateien: find /memory /skills /knowledge -size 0
2. Suche TODO-Marker: grep -r "TODO" /skills /knowledge
3. Prüfe Symlinks (falls möglich via Bash):
   • ls -l ~/.claude/skills/ → Alle grün?
   • ls -l ~/.claude/agents/ → Alle grün?
4. Suche nach Fragmenten:
   • .md Dateien ohne Frontmatter (in /skills)
   • Proposals ohne Entscheidung (status: proposed, >30 Tage alt)
5. Report mit Findings

Output: Integrity-Report in /memory/snapshots/YYYY-MM-DD_integrity.md

ARBEITSWEISE

Standard-Workflow (alle Modi)

1. Analyse:

   • Scanne relevante Dateien
   • Identifiziere Änderungen/Probleme
   • Erstelle Preview-Liste

2. Bestätigung:

   • Zeige Zusammenfassung: "X Patterns gefunden, Y Logs archivieren"
   • WICHTIG: Warte auf User-OK bei destruktiven Aktionen (Löschen, Verschieben)
   • Bei Read-Only-Modi (stats, check): Kein OK nötig

3. Ausführung:

   • Nutze Read/Write/Edit/Glob/Grep Tools
   • Bei Scripts: Nutze Bash Tool (scripts/*.sh)
   • Atomic Changes: Eine Änderung pro File

4. Dokumentation:

   • Erstelle Report (wo? siehe Modi-Beschreibung)
   • Terminal-Summary für User
   • Update Dashboard (falls relevant)

Modus-Auswahl

Explizit: /vault-janitor <mode>

• /vault-janitor distill → Memory Distillation
• /vault-janitor audit → Skill Audit
• /vault-janitor propose → Skill-Proposal-Detection
• /vault-janitor sync-projects → Projekt-Sync
• /vault-janitor anti-pattern-detect → Anti-Pattern-Detection
• /vault-janitor stats → Statistiken
• /vault-janitor index → Indexing
• /vault-janitor check → Integrity Check

Implizit (basierend auf User-Anfrage):

• "Vault aufräumen" → distill + check
• "Wissen konsolidieren" → distill
• "Skills validieren" → audit
• "Zeige Statistiken" → stats
• "Neue Skills vorschlagen" → propose
• "Sync Projekte" → sync-projects

Default (kein Argument): Zeige Übersicht aller Modi + letzte Runs

Output-Locations

Modus	Output
distill	/memory/patterns.md (Update), /memory/log/archive/ (Logs)
audit	/memory/snapshots/YYYY-MM-DD_skill-audit.md
propose	/skills/proposals/YYYY-MM-DD_<skill-name>.md
sync-projects	Terminal-Output (via script)
anti-pattern-detect	/knowledge/anti-patterns/proposals/
stats	/memory/snapshots/YYYY-MM-DD_stats.md + Terminal
index	/vault-index.md (Update)
check	/memory/snapshots/YYYY-MM-DD_integrity.md

BEST PRACTICES

Pattern-Extraktion (distill)

• Threshold: Min. 2 Vorkommen für Pattern
• Format: Konsistent mit bestehendem patterns.md
• Kategorien: Django, API, Testing, Performance, Security, etc.

Skill-Proposals (propose)

• Threshold: Min. 3 Vorkommen für Proposal
• Naming: Beschreibend, nicht zu generisch ("django-model" ✅, "create-thing" ❌)
• Dedupe: Prüfe ob ähnliches Proposal bereits existiert

Anti-Patterns (anti-pattern-detect)

• Qualität > Quantität: Nur echte Fehler, keine false positives
• Template nutzen: /knowledge/anti-patterns/template.md
• Kontext: Problem + Warum schlecht + Bessere Alternative

KOMMANDO-TRIGGER

Explizit:

• /vault-janitor distill
• /vault-janitor stats
• etc.

Implizit:

• "Vault aufräumen"
• "Janitor-Mode"
• "Wissen konsolidieren"
• "Zeige Vault-Statistiken"
• "Prüfe Skills auf Fehler"
• "Schlage neue Skills vor"

Automatisch (via Cron):

• Wöchentlich: stats (Montag 09:00)
• Monatlich: distill (vom User getriggert)
• Bei Bedarf: audit, check