claude-vault/vault-index.md

🗂️ CLAUDE VAULT INDEX

Dieses Repository ist das zentrale Gedächtnis und die Werkzeugkiste für meine Claude-Agenten.

---

⚙️ SYSTEM (Globale Regeln)

Pfad: /system/

• global-instructions.md: Die Kern-Identität von Claude. Enthält Kommunikationsstil, Git-Workflows und die Anweisung, proaktiv im Vault zu suchen.

---

🛠️ SKILLS (Spezialisierte Fähigkeiten)

Pfad: /skills/

League-Planner Skills

Spezialisiert auf das Django-basierte Liga-Planungssystem:

Skill	Beschreibung	Invocation
django-model	Django 5.2 Models mit Fat Model Pattern, Custom Managers	/lp-django-model
drf-api	DRF API Endpoints mit @api_view, drf-spectacular	/lp-drf-api
celery-task	Celery 5.5 Tasks mit AbortableTask, Progress Tracking	/lp-celery-task
permissions	Multi-Tier Permissions mit Decorators, Session-based Access	/lp-permissions
query-optimizer	N+1 Query Fixes, select_related/prefetch_related	/lp-query-optimizer
solver	PuLP/Xpress MIP Solver Integration	/lp-solver
testing	Django TestCase mit Multi-DB Support, CRUD Tags	/lp-testing

Allgemeine Skills

Skill	Beschreibung	Invocation
skill-creator	Meta-Skill zum Erstellen neuer Skills	/skill-creator
vault-janitor	Vault-Wartung, Memory Distillation, Integrity Checks	/vault-janitor
doc-gen	Technische Dokumentation, READMEs, API-Docs	/doc-gen
reviewer	Code-Reviews für Sicherheit, Performance, Clean Code	/reviewer
sparring-partner	Sokratischer Mentor für Architektur-Diskussionen	/sparring-partner

---

🤖 AGENTS (Spezialisierte Agenten)

Pfad: /agents/

Django-Entwicklung

Agent	Beschreibung	Farbe
league-planner-architect	Liga-Planer spezifisch: @api_view Pattern, Solver-Integration	🟠 orange
django-architect	Generisches Django: ViewSets + Routers (NICHT für league-planner!)	🟢 green
django-mkdocs-docs	MkDocs-Dokumentation für Django-Projekte	🩷 pink

Optimization & Compute

Agent	Beschreibung	Farbe
mip-optimization-xpress	Mixed-Integer Programming mit FICO Xpress	🟣 purple
cluster-compute-architect	K3s-Cluster, Dockerfiles, CI/CD, Autoscaling	🔵 blue

Operations & Quality

Agent	Beschreibung	Farbe
plg-monitoring-architect	Prometheus, Loki, Grafana Monitoring	🟡 yellow
debugging-specialist	Systematische Fehlerdiagnose, Root Cause Analysis	🔴 red
code-reviewer	Proaktive Code-Reviews nach Code-Änderungen	🩵 cyan

---

📁 PROJECTS (Projekt-spezifische Kontexte)

Pfad: /projects/

Projekt	Beschreibung
ligalytics-staffeleinteilung	Django Liga-Planungssystem: MEMORY.md, CLAUDE.md (optional)

Jedes Projekt-Verzeichnis kann enthalten:

• MEMORY.md: Auto-Memory für das Projekt (Sync via sync-project-memory.sh)
• CLAUDE.md: Projektspezifische Instruktionen
• INSTRUCTIONS.md: Alternative Instruktionsdatei

---

🧠 MEMORY (Erfahrungen & Muster)

Pfad: /memory/

Datei/Ordner	Beschreibung
/log/	Chronologische Sammlung von "Lessons Learned" aus vergangenen Sessions
/log/archive/	Archivierte Logs nach Pattern-Extraktion
patterns.md	Destillierte Best Practices aus den Logs
/snapshots/	Status-Reports zu bestimmten Zeitpunkten

---

📚 KNOWLEDGE (Kontext & Daten)

Pfad: /knowledge/

Datei/Ordner	Beschreibung
preferences.md	Persönliche Vorlieben: Tech-Stacks, Coding-Styles
/anti-patterns/	Dokumentierte Fehler, die vermieden werden sollen

---

📋 PROPOSALS

Pfad: /skills/proposals/

Enthält Skill-Entwürfe, die auf Review warten. Erstellt von /skill-creator, geprüft von /vault-janitor.

---

🛠 WARTUNG

Der Vault Janitor (/vault-janitor) ist verantwortlich für:

• Memory Distillation: Patterns aus /memory/log/ extrahieren
• Skill Audit: YAML-Frontmatter und Konflikte prüfen
• Index Update: Diesen Index aktuell halten
• Integrity Check: Verwaiste Dateien finden

---

🤖 SCRIPTS (Automatisierung)

Pfad: /scripts/

Script	Beschreibung	Usage
sync-project-memory.sh	Sync MEMORY.md zwischen Claude-Projekten und Vault	~/Work/claude-vault/scripts/sync-project-memory.sh

Siehe scripts/README.md für Details.

---

---

📊 CHANGELOG

2026-02-04: Project Structure Refactoring

• ✨ Neuer /projects/ Ordner für projektspezifische Dateien
• 🔄 Migration: memory/projects/*.md → projects/*/MEMORY.md
• 📝 Updated: sync-project-memory.sh für neue Struktur
• 📚 Erste Snapshots und Logs erstellt

---

Letzte Aktualisierung: 2026-02-04 (Index korrigiert: lp- Skill-Namen)*