6.9 KiB
6.9 KiB
Claude-Vault Quick Start - OHNE Cron-Jobs
Ziel: Maximiere Learning aus Claude-Sessions durch proaktive Automatisierung (keine Cron-Jobs).
Philosophie: Claude agiert als intelligenter Assistant und führt Wartung zur richtigen Zeit durch.
🚀 3-Minuten Setup
1. Aliases installieren (2 Min)
cd ~/Work/claude-vault
./scripts/setup-aliases.sh
source ~/.zshrc # oder ~/.bashrc
vault-help # Test
Ausgabe:
✅ Installation erfolgreich!
💡 Wichtig:
- KEINE Cron-Jobs installiert
- Claude führt Wartung automatisch durch (via global-instructions.md)
- Manueller Fallback via Aliases verfügbar
2. Dashboard erstellen (1 Min)
vault-status
Erstellt automatisch memory/dashboard.md und zeigt Statistiken.
3. Fertig! 🎉
Das war's! Claude übernimmt den Rest automatisch.
🤖 Wie funktioniert die Automatisierung?
global-instructions.md enthält Context-Aware Triggers
Claude prüft automatisch:
Session-Start (Montag)
✅ Dashboard veraltet? → "Soll ich aktualisieren?"
✅ ≥5 neue Logs? → "Pattern-Extraktion durchführen?"
✅ Proposals offen? → Info-Hinweis
Session-Start (1. des Monats)
✅ "Health-Check durchführen?"
✅ "Backup-Reminder"
✅ "Skill-Usage-Matrix aktualisieren?"
Session-Ende (bei "exit", "fertig", "danke")
✅ "Session-Log erstellen? Kurze Beschreibung?"
→ Du: "Team-Stats API erstellt"
→ Claude: Erstellt Log automatisch
Projekt-Wechsel
✅ Erkennt neues Projekt
✅ Synchronisiert Projekt-Memory automatisch
✅ Lädt Projekt-MEMORY.md
Fehler-Fix
✅ Prüft ob Fehlertyp bereits dokumentiert
✅ "Als Anti-Pattern speichern?" (falls neu)
📋 Workflow-Beispiele
Beispiel 1: Montag morgen
Du: "Hallo Claude"
Claude: "Guten Morgen!
📊 Dashboard ist 8 Tage alt. Aktualisieren?
📚 7 neue Logs. Pattern-Extraktion? (/vault-janitor distill)
💡 2 offene Skill-Proposals."
Du: "Ja, beides"
Claude: *aktualisiert Dashboard*
*führt /vault-janitor distill aus*
"✅ Fertig! 3 neue Patterns extrahiert, 7 Logs archiviert."
Beispiel 2: Session-Ende
Du: "Danke, fertig für heute"
Claude: "Session-Log erstellen? Kurze Beschreibung?"
Du: "Celery Task für Report-Generierung"
Claude: *erstellt memory/log/2026-02-04_session.md*
"✅ Session geloggt. Bis morgen!"
Kein manuelles claude-done nötig!
Beispiel 3: Projekt-Wechsel
Du: "Wechsel zu ligalytics"
Claude: "Projekt-Wechsel erkannt: league-planner → ligalytics
Synchronisiere Memory..."
*führt sync-project-memory.sh aus*
"✅ Memory aktualisiert
Letzte Arbeit: 2026-01-28
Womit kann ich helfen?"
Beispiel 4: Bug-Fix
Du: "N+1 Query Problem in API gefixt"
Claude: *prüft /knowledge/anti-patterns/n-plus-1-queries.md*
"N+1 Queries bereits als Anti-Pattern dokumentiert ✅
Soll ich das Pattern in diesem Projekt updaten?"
(Falls NEU gewesen wäre: "Als Anti-Pattern dokumentieren?")
🖐️ Manuelle Befehle (Fallback)
Falls du Claude nicht automatisch handeln lassen willst:
Täglich
# Session-Log (falls Claude nicht fragt)
claude-done <projekt> "<beschreibung>"
Wöchentlich (5 Min)
vault-status # Dashboard
vault-proposals # Proposals
/vault-janitor distill # Patterns (in Claude)
Monatlich (15 Min)
vault-health # Health-Check
vault-analyze # Skill-Usage-Matrix
vault-patterns # Patterns reviewen
vault-backup # Backup
🎯 Wichtigste Aliases
# Session-Management
claude-done <projekt> "<desc>" # Log erstellen (Fallback)
claude-log # Heutiges Log öffnen
# Status & Monitoring
vault-status # Dashboard
vault-health # Health-Check
vault-analyze # Skill-Usage-Matrix
vault-sync # Projekt-Memory sync
# Quick-Access
vault-dashboard # Dashboard öffnen
vault-patterns # Patterns öffnen
vault-proposals # Proposals anzeigen
vault-help # Alle Befehle
🆚 Warum OHNE Cron-Jobs?
Mit Cron (alt)
❌ Läuft im Hintergrund (keine Kontrolle)
❌ Feste Zeiten (egal ob du arbeitest)
❌ Keine Interaktion
❌ "Magisch" (nicht transparent)
Ohne Cron, mit global-instructions (neu)
✅ Claude als proaktiver Assistant
✅ Context-Aware (nur wenn relevant)
✅ Du entscheidest: "Ja" oder "Später"
✅ Volle Transparenz & Kontrolle
✅ Interaktiv & lehrreich
📈 Erwartete Verbesserungen
Nach 1 Woche
- ✅ 3-5 Session-Logs
- ✅ Claude fragt proaktiv nach Wartung
- ✅ Dashboard zeigt Trends
Nach 1 Monat
- ✅ 10+ Session-Logs
- ✅ 3+ Patterns extrahiert
- ✅ 1+ Skill-Proposal umgesetzt
- ✅ 10x mehr Learning aus gleicher Arbeit
Nach 3 Monaten
- ✅ 30+ Session-Logs
- ✅ 10+ Patterns
- ✅ 3+ neue Skills
- ✅ Cross-Projekt-Learning nachweisbar
🔍 Erfolg messen
Wöchentlich
vault-status
Zeigt:
- Logs diese Woche
- Patterns extrahiert
- Proposals offen
- Empfehlungen
Monatlich
vault-health
Zeigt:
- Vollständiger Health-Check
- Trends vs. letzten Monat
- Wartungs-Empfehlungen
🚨 Troubleshooting
Problem: vault-help nicht gefunden
Lösung:
source ~/Work/claude-vault/scripts/bash-aliases.sh
# Oder permanent installieren:
./scripts/setup-aliases.sh
Problem: Claude fragt nicht nach Session-Log
Lösung:
# Manuell loggen
claude-done <projekt> "<beschreibung>"
# Oder in global-instructions.md prüfen ob Trigger aktiv
Problem: Dashboard zeigt alte Daten
Lösung:
vault-status # Aktualisiert automatisch
# Oder manuell:
~/Work/claude-vault/scripts/update-dashboard.sh
📚 Weitere Dokumentation
- MANUAL-WORKFLOW.md - Detaillierte Workflow-Beschreibung
- OPTIMIZATION-ROADMAP.md - Vollständiger Plan
- vault-index.md - Skills & Agents
- system/global-instructions.md - Automatisierungs-Trigger
✨ Zusammenfassung
Setup:
./scripts/setup-aliases.sh
source ~/.zshrc
vault-status
Workflow:
- Claude fragt proaktiv (Session-Start/Ende, Projekt-Wechsel)
- Du sagst "ja" oder "später"
- Manueller Fallback via Aliases verfügbar
Ergebnis:
- Proaktive Wartung ohne Cron-Jobs
- Context-Aware statt zeitgesteuert
- Interaktiv statt "magisch"
- 10x mehr Learning aus gleicher Arbeit
Starte JETZT:
cd ~/Work/claude-vault
./scripts/setup-aliases.sh
source ~/.zshrc
# Bei nächster Session einfach mit Claude arbeiten
# → Claude fragt automatisch nach Logs, Wartung, etc.
Claude wird dein proaktiver Assistent für systematisches Learning! 🚀