claude-vault/QUICK-START.md

# Claude-Vault Optimization - Quick Start Guide

**Ziel:** Maximiere Learning aus Claude-Sessions durch automatisiertes Memory-Logging.

**Problem:** Aktuell werden nur ~10% des Wissens aus Sessions gespeichert.

**Lösung:** Automatisierte Workflows + 30 Sekunden pro Session investieren → 10x mehr Learning.

---

## 🚀 Sofort-Setup (5 Minuten)

### 1. Bash-Aliases installieren

**Option A: Direkt in Shell laden (temporär)**
```bash
source ~/Work/claude-vault/scripts/bash-aliases.sh
```

**Option B: Permanent in ~/.zshrc / ~/.bashrc (empfohlen)**
```bash
echo "source ~/Work/claude-vault/scripts/bash-aliases.sh" >> ~/.zshrc
source ~/.zshrc
```

**Test:**
```bash
vault-help  # Sollte Hilfe anzeigen
```

---

### 2. Initial Dashboard erstellen

```bash
cd ~/Work/claude-vault
./scripts/update-dashboard.sh
```

**Ausgabe:** `memory/dashboard.md` mit aktuellen Statistiken

**Anzeigen:**
```bash
vault-status
```

---

### 3. Ersten Health-Check durchführen

```bash
./scripts/weekly-health-check.sh
```

**Ausgabe:** `memory/snapshots/YYYY-MM-DD_weekly-health.md`

---

### 4. Git-Hooks installieren (optional, aber empfohlen)

```bash
cd ~/Work/claude-vault

# Pre-Commit Hook (YAML-Validierung)
cat > .git/hooks/pre-commit <<'EOF'
#!/bin/bash
STAGED_SKILLS=$(git diff --cached --name-only | grep "skills/.*/SKILL.md")

if [ -n "$STAGED_SKILLS" ]; then
    echo "🔍 Validiere YAML-Frontmatter..."
    for skill in $STAGED_SKILLS; do
        NAME=$(sed -n '2p' "$skill" | grep -oE 'name:\s+[a-z-]+')
        if [ -z "$NAME" ]; then
            echo "❌ Fehler in $skill: 'name:' fehlt in Zeile 2"
            exit 1
        fi
    done
    echo "✅ Alle Skills validiert"
fi
EOF

chmod +x .git/hooks/pre-commit
```

---

### 5. Cron-Jobs einrichten (Automatisierung)

```bash
cd ~/Work/claude-vault
./scripts/setup-cron.sh
```

**Zeitplan:**
- **Montag 09:00:** Weekly Health Check + Skill-Usage-Matrix
- **Montag 10:00:** Skill-Proposal Detection
- **Täglich 20:00:** Projekt-Memory Sync
- **Täglich 21:00:** Dashboard Update

**Prüfen:**
```bash
crontab -l  # Zeigt installierte Cron-Jobs
```

**Logs überwachen:**
```bash
tail -f ~/Work/claude-vault/memory/log/cron.log
```

---

## 📋 Neuer Standard-Workflow

### Während einer Claude-Session

**Vorher:**
```
1. cd ~/Work/mein-projekt
2. claude
3. [Arbeit mit Claude]
4. exit
```

**Nachher:**
```
1. cd ~/Work/mein-projekt
2. claude
3. [Arbeit mit Claude]
   - Nutze Skills: /lp-django-model, /lp-drf-api, etc.
   - Nutze Agents: league-planner-architect, etc.
4. exit
5. claude-done mein-projekt "Team-Stats API + Tests"  ← NEU! (30 Sekunden)
```

---

### Nach der Session (30 Sekunden)

```bash
# Logge die Session
claude-done <projekt-name> "<kurzbeschreibung>"

# Beispiele:
claude-done league-planner "Team-Stats API endpoint mit Tests erstellt"
claude-done ligalytics "N+1 Query in Spielplan-View gefixt"
claude-done vault "Neue Scripts für Memory-Logging erstellt"
```

**Was passiert:**
- Session wird in `memory/log/YYYY-MM-DD_session.md` geloggt
- Projekt, Beschreibung, Timestamp werden gespeichert
- Falls Projekt ein Git-Repo: Commits der letzten 30 Min werden extrahiert

---

### Wöchentlich (5 Minuten, Montag morgen)

```bash
# 1. Dashboard prüfen
vault-status

# 2. Health-Check reviewen (wird automatisch via Cron erstellt)
code ~/Work/claude-vault/memory/snapshots/$(ls -t ~/Work/claude-vault/memory/snapshots/*.md | head -1)

# 3. Skill-Proposals durchsehen
vault-proposals

# Optional: Proposals reviewen
ls -lh ~/Work/claude-vault/skills/proposals/
```

---

### Monatlich (15 Minuten)

```bash
# 1. Memory-Distillation (extrahiert Patterns aus Logs)
claude  # Starte Claude
/vault-janitor distill

# 2. Patterns reviewen und ergänzen
vault-patterns

# 3. Anti-Patterns aktualisieren (aus Fehlern lernen)
code ~/Work/claude-vault/knowledge/anti-patterns/

# 4. Backup erstellen
vault-backup
```

---

## 🎯 Wichtige Aliases (Cheat Sheet)

### Session-Management
```bash
claude-done <projekt> "<beschreibung>"  # Session loggen (WICHTIG!)
claude-log                              # Heutiges Log öffnen
```

### Status & Monitoring
```bash
vault-status      # Dashboard mit Statistiken
vault-health      # Health-Check erstellen
vault-analyze     # Skill-Nutzung analysieren
vault-sync        # Projekt-MEMORYs synchronisieren
```

### Quick-Access
```bash
vault-dashboard   # Dashboard öffnen
vault-patterns    # Patterns öffnen
vault-index       # Vault-Index öffnen
vault-proposals   # Skill-Proposals anzeigen
vault-logs        # Letzte 10 Session-Logs
```

### Wartung
```bash
vault-backup      # Backup erstellen
vault-help        # Alle Befehle anzeigen
```

---

## ✅ Erfolg messen

### Nach 1 Woche

**Prüfe:**
```bash
vault-status
```

**Ziel:**
- ✅ Min. 3 Session-Logs in `memory/log/`
- ✅ Dashboard zeigt aktuelle Statistiken
- ✅ Cron-Jobs laufen (prüfe `memory/log/cron.log`)

### Nach 1 Monat

**Prüfe:**
```bash
vault-status
vault-analyze  # Skill-Usage-Matrix
```

**Ziel:**
- ✅ Min. 10 Session-Logs
- ✅ Min. 3 Patterns in `patterns.md` extrahiert (via `/vault-janitor distill`)
- ✅ 1 Skill-Proposal erkannt und umgesetzt
- ✅ Dashboard zeigt Trends

---

## 🔧 Troubleshooting

### Problem: `claude-done` nicht gefunden

**Lösung:**
```bash
# Aliases neu laden
source ~/Work/claude-vault/scripts/bash-aliases.sh

# Oder permanent installieren
echo "source ~/Work/claude-vault/scripts/bash-aliases.sh" >> ~/.zshrc
source ~/.zshrc
```

---

### Problem: Cron-Jobs laufen nicht

**Prüfen:**
```bash
# Sind Cron-Jobs installiert?
crontab -l | grep Claude-Vault

# Gibt es Fehler in den Logs?
tail -50 ~/Work/claude-vault/memory/log/cron.log

# Scripts ausführbar?
ls -l ~/Work/claude-vault/scripts/*.sh
```

**Lösung:**
```bash
# Scripts ausführbar machen
chmod +x ~/Work/claude-vault/scripts/*.sh

# Cron-Jobs neu installieren
~/Work/claude-vault/scripts/setup-cron.sh
```

---

### Problem: Dashboard zeigt veraltete Daten

**Lösung:**
```bash
# Dashboard manuell aktualisieren
~/Work/claude-vault/scripts/update-dashboard.sh

# Dann anzeigen
vault-status
```

---

### Problem: Keine Skill-Proposals werden erkannt

**Grund:** Noch nicht genug wiederholte Aufgaben (Threshold: 3x)

**Lösung:**
```bash
# Manuell Detection ausführen
~/Work/claude-vault/scripts/detect-skill-proposals.sh

# Threshold temporär senken (in detect-skill-proposals.sh Zeile 9):
THRESHOLD=2  # Statt 3
```

---

## 📚 Weiterführende Dokumentation

- **[OPTIMIZATION-ROADMAP.md](OPTIMIZATION-ROADMAP.md)** - Vollständiger Implementierungsplan
- **[vault-index.md](vault-index.md)** - Alle Skills und Agents
- **[CLAUDE.md](CLAUDE.md)** - Projekt-Instruktionen
- **[memory/patterns.md](memory/patterns.md)** - Extrahierte Best Practices

---

## 💡 Tipps für maximalen Erfolg

1. **Konsequenz schlägt Perfektion**
   - Lieber jede Session kurz loggen als perfekte Logs selten schreiben
   - `claude-done mein-projekt "API erstellt"` ist besser als kein Log

2. **Nutze Templates**
   - Session-Logs haben Platzhalter für "Wichtige Entscheidungen" und "Lessons Learned"
   - Ergänze diese nachträglich, wenn Zeit ist

3. **Reviewe wöchentlich**
   - Montag morgen: Dashboard + Health-Check prüfen (5 Min)
   - Patterns und Proposals durchsehen
   - Gibt klaren Überblick über Fortschritt

4. **Monatliche Distillation**
   - `/vault-janitor distill` extrahiert automatisch Patterns aus allen Logs
   - Das ist wo der echte Lerneffekt entsteht!
   - Claude liest `patterns.md` im System-Prompt → bessere Antworten

5. **Experimentiere mit Skill-Proposals**
   - Wenn du 3x die gleiche Aufgabe machst → Skill erstellen
   - Nutze `/skill-creator` für schnelle Umsetzung
   - Automatisiere wiederkehrende Aufgaben

---

## 🎓 Mindset-Shift

**Vorher:**
> "Claude macht Arbeit → Fertig → Vergessen"

**Nachher:**
> "Claude macht Arbeit → Loggen (30 Sek) → Pattern-Extraktion → Nächste Session profitiert"

**Feedback-Loop:**
```
Session → Log → Distillation → Patterns → System-Prompt → Bessere Antworten
   ↑                                                              ↓
   └───────────────────── Nächste Session ←──────────────────────┘
```

---

## ⏱️ Zeit-Investment vs. ROI

**Investition:**
- Setup: 5 Minuten (einmalig)
- Pro Session: 30 Sekunden (`claude-done`)
- Wöchentlich: 5 Minuten (Review)
- Monatlich: 15 Minuten (Distillation)

**Return:**
- 10x mehr Wissen aus Sessions extrahiert
- Permanente Verbesserung der Claude-Antworten
- Automatische Skill-Proposals
- Cross-Projekt-Learning

**Beispiel:**
- Monat 1: N+1 Query Problem in Projekt A → Lösung geloggt → Pattern extrahiert
- Monat 3: Ähnliches Problem in Projekt B → Claude kennt Pattern → Sofort richtige Lösung

---

## 🚀 Nächster Schritt

**JETZT sofort:**
```bash
# 1. Aliases installieren
source ~/Work/claude-vault/scripts/bash-aliases.sh

# 2. Dashboard erstellen
vault-status

# 3. Bei nächster Claude-Session:
claude-done <dein-projekt> "<was du gemacht hast>"
```

**Diese Woche:**
```bash
# Cron-Jobs einrichten
~/Work/claude-vault/scripts/setup-cron.sh
```

**Viel Erfolg! 🎉**

---

**Fragen?** Siehe [OPTIMIZATION-ROADMAP.md](OPTIMIZATION-ROADMAP.md) für Details.