143 lines
6.1 KiB
Markdown
143 lines
6.1 KiB
Markdown
# 🗂️ 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)*
|