martin/claude-vault

Fork 0

martin d07c7af32d keep knowledge

2026-02-04 22:35:40 +01:00

9.1 KiB

Raw Blame History

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)

source ~/Work/claude-vault/scripts/bash-aliases.sh

Option B: Permanent in ~/.zshrc / ~/.bashrc (empfohlen)

echo "source ~/Work/claude-vault/scripts/bash-aliases.sh" >> ~/.zshrc
source ~/.zshrc

Test:

vault-help  # Sollte Hilfe anzeigen

2. Initial Dashboard erstellen

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

Ausgabe: memory/dashboard.md mit aktuellen Statistiken

Anzeigen:

vault-status

3. Ersten Health-Check durchführen

./scripts/weekly-health-check.sh

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

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

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)

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:

crontab -l  # Zeigt installierte Cron-Jobs

Logs überwachen:

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)

# 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)

# 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)

# 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

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

Status & Monitoring

vault-status      # Dashboard mit Statistiken
vault-health      # Health-Check erstellen
vault-analyze     # Skill-Nutzung analysieren
vault-sync        # Projekt-MEMORYs synchronisieren

Quick-Access

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

vault-backup      # Backup erstellen
vault-help        # Alle Befehle anzeigen

✅ Erfolg messen

Nach 1 Woche

Prüfe:

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:

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:

# 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:

# 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:

# 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:

# 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:

# 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 - Vollständiger Implementierungsplan
vault-index.md - Alle Skills und Agents
CLAUDE.md - Projekt-Instruktionen
memory/patterns.md - Extrahierte Best Practices

💡 Tipps für maximalen Erfolg

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
Nutze Templates
- Session-Logs haben Platzhalter für "Wichtige Entscheidungen" und "Lessons Learned"
- Ergänze diese nachträglich, wenn Zeit ist
Reviewe wöchentlich
- Montag morgen: Dashboard + Health-Check prüfen (5 Min)
- Patterns und Proposals durchsehen
- Gibt klaren Überblick über Fortschritt
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
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:

# 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:

# Cron-Jobs einrichten
~/Work/claude-vault/scripts/setup-cron.sh

Viel Erfolg! 🎉

Fragen? Siehe OPTIMIZATION-ROADMAP.md für Details.

9.1 KiB Raw Blame History

Claude-Vault Optimization - Quick Start Guide

🚀 Sofort-Setup (5 Minuten)

1. Bash-Aliases installieren

2. Initial Dashboard erstellen

3. Ersten Health-Check durchführen

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

5. Cron-Jobs einrichten (Automatisierung)

📋 Neuer Standard-Workflow

Während einer Claude-Session

Nach der Session (30 Sekunden)

Wöchentlich (5 Minuten, Montag morgen)

Monatlich (15 Minuten)

🎯 Wichtige Aliases (Cheat Sheet)

Session-Management

Status & Monitoring

Quick-Access

Wartung

✅ Erfolg messen

Nach 1 Woche

Nach 1 Monat

🔧 Troubleshooting

Problem: claude-done nicht gefunden

Problem: Cron-Jobs laufen nicht

Problem: Dashboard zeigt veraltete Daten

Problem: Keine Skill-Proposals werden erkannt

📚 Weiterführende Dokumentation

💡 Tipps für maximalen Erfolg

🎓 Mindset-Shift

⏱️ Zeit-Investment vs. ROI

🚀 Nächster Schritt

9.1 KiB

Raw Blame History

Problem: `claude-done` nicht gefunden