# 🗂️ 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](./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](./skills/django-model/SKILL.md)** | Django 6 Models mit Fat Model Pattern, Custom Managers | `/lp-django-model` |
| **[drf-api](./skills/drf-api/SKILL.md)** | DRF API Endpoints mit @api_view, drf-spectacular | `/lp-drf-api` |
| **[celery-task](./skills/celery-task/SKILL.md)** | Celery 5.5 Tasks mit AbortableTask, Progress Tracking | `/lp-celery-task` |
| **[permissions](./skills/permissions/SKILL.md)** | Multi-Tier Permissions mit Decorators, Session-based Access | `/lp-permissions` |
| **[query-optimizer](./skills/query-optimizer/SKILL.md)** | N+1 Query Fixes, select_related/prefetch_related | `/lp-query-optimizer` |
| **[solver](./skills/solver/SKILL.md)** | PuLP/Xpress MIP Solver Integration | `/lp-solver` |
| **[testing](./skills/testing/SKILL.md)** | Django TestCase mit Multi-DB Support, CRUD Tags | `/lp-testing` |

### Allgemeine Skills
| Skill | Beschreibung | Invocation |
|-------|--------------|------------|
| **[skill-creator](./skills/skill-creator/SKILL.md)** | Meta-Skill zum Erstellen neuer Skills | `/skill-creator` |
| **[vault-janitor](./skills/vault-janitor/SKILL.md)** | Vault-Wartung, Memory Distillation, Integrity Checks | `/vault-janitor` |
| **[doc-gen](./skills/doc-gen/SKILL.md)** | Technische Dokumentation, READMEs, API-Docs | `/doc-gen` |
| **[reviewer](./skills/reviewer/SKILL.md)** | Code-Reviews für Sicherheit, Performance, Clean Code | `/reviewer` |
| **[sparring-partner](./skills/sparring-partner/SKILL.md)** | Sokratischer Mentor für Architektur-Diskussionen | `/sparring-partner` |
| **[tech-researcher](./skills/tech-researcher/SKILL.md)** | Aktuelle Tech-Recherche via Reddit, HN, GitHub | `/tech-researcher` |

---

## 🤖 AGENTS (Spezialisierte Agenten)
*Pfad: `/agents/`*

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

### Optimization & Compute
| Agent | Beschreibung | Farbe |
|-------|--------------|-------|
| **[mip-optimization-xpress](./agents/mip-optimization-xpress.md)** | Mixed-Integer Programming mit FICO Xpress | 🟣 purple |
| **[cluster-compute-architect](./agents/cluster-compute-architect.md)** | K3s-Cluster, Dockerfiles, CI/CD, Autoscaling | 🔵 blue |

### Operations & Quality
| Agent | Beschreibung | Farbe |
|-------|--------------|-------|
| **[plg-monitoring-architect](./agents/plg-monitoring-architect.md)** | Prometheus, Loki, Grafana Monitoring | 🟡 yellow |
| **[debugging-specialist](./agents/debugging-specialist.md)** | Systematische Fehlerdiagnose, Root Cause Analysis | 🔴 red |
| **[code-reviewer](./agents/code-reviewer.md)** | Proaktive Code-Reviews nach Code-Änderungen | 🩵 cyan |

---

## 📁 PROJECTS (Projekt-spezifische Kontexte)
*Pfad: `/projects/`*

| Projekt | Beschreibung |
|---------|--------------|
| **[ligalytics-staffeleinteilung](./projects/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/](./memory/log/)** | Chronologische Sammlung von "Lessons Learned" aus vergangenen Sessions |
| **[/log/archive/](./memory/log/archive/)** | Archivierte Logs nach Pattern-Extraktion |
| **[patterns.md](./memory/patterns.md)** | Destillierte Best Practices aus den Logs |
| **[/snapshots/](./memory/snapshots/)** | Status-Reports zu bestimmten Zeitpunkten |

---

## 📚 KNOWLEDGE (Kontext & Daten)
*Pfad: `/knowledge/`*

| Datei/Ordner | Beschreibung |
|--------------|--------------|
| **[preferences.md](./knowledge/preferences.md)** | Persönliche Vorlieben: Tech-Stacks, Coding-Styles |
| **[/anti-patterns/](./knowledge/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](./scripts/sync-project-memory.sh)** | Sync MEMORY.md zwischen Claude-Projekten und Vault | `~/Work/claude-vault/scripts/sync-project-memory.sh` |

Siehe [scripts/README.md](./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-05 (Neuer Skill: tech-researcher)*