355 lines
6.9 KiB
Markdown
355 lines
6.9 KiB
Markdown
# 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)
|
|
|
|
```bash
|
|
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)
|
|
|
|
```bash
|
|
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
|
|
```bash
|
|
# Session-Log (falls Claude nicht fragt)
|
|
claude-done <projekt> "<beschreibung>"
|
|
```
|
|
|
|
### Wöchentlich (5 Min)
|
|
```bash
|
|
vault-status # Dashboard
|
|
vault-proposals # Proposals
|
|
/vault-janitor distill # Patterns (in Claude)
|
|
```
|
|
|
|
### Monatlich (15 Min)
|
|
```bash
|
|
vault-health # Health-Check
|
|
vault-analyze # Skill-Usage-Matrix
|
|
vault-patterns # Patterns reviewen
|
|
vault-backup # Backup
|
|
```
|
|
|
|
---
|
|
|
|
## 🎯 Wichtigste Aliases
|
|
|
|
```bash
|
|
# 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
|
|
```bash
|
|
vault-status
|
|
```
|
|
|
|
Zeigt:
|
|
- Logs diese Woche
|
|
- Patterns extrahiert
|
|
- Proposals offen
|
|
- Empfehlungen
|
|
|
|
### Monatlich
|
|
```bash
|
|
vault-health
|
|
```
|
|
|
|
Zeigt:
|
|
- Vollständiger Health-Check
|
|
- Trends vs. letzten Monat
|
|
- Wartungs-Empfehlungen
|
|
|
|
---
|
|
|
|
## 🚨 Troubleshooting
|
|
|
|
### Problem: `vault-help` nicht gefunden
|
|
|
|
**Lösung:**
|
|
```bash
|
|
source ~/Work/claude-vault/scripts/bash-aliases.sh
|
|
# Oder permanent installieren:
|
|
./scripts/setup-aliases.sh
|
|
```
|
|
|
|
---
|
|
|
|
### Problem: Claude fragt nicht nach Session-Log
|
|
|
|
**Lösung:**
|
|
```bash
|
|
# Manuell loggen
|
|
claude-done <projekt> "<beschreibung>"
|
|
|
|
# Oder in global-instructions.md prüfen ob Trigger aktiv
|
|
```
|
|
|
|
---
|
|
|
|
### Problem: Dashboard zeigt alte Daten
|
|
|
|
**Lösung:**
|
|
```bash
|
|
vault-status # Aktualisiert automatisch
|
|
# Oder manuell:
|
|
~/Work/claude-vault/scripts/update-dashboard.sh
|
|
```
|
|
|
|
---
|
|
|
|
## 📚 Weitere Dokumentation
|
|
|
|
- **[MANUAL-WORKFLOW.md](MANUAL-WORKFLOW.md)** - Detaillierte Workflow-Beschreibung
|
|
- **[OPTIMIZATION-ROADMAP.md](OPTIMIZATION-ROADMAP.md)** - Vollständiger Plan
|
|
- **[vault-index.md](vault-index.md)** - Skills & Agents
|
|
- **[system/global-instructions.md](system/global-instructions.md)** - Automatisierungs-Trigger
|
|
|
|
---
|
|
|
|
## ✨ Zusammenfassung
|
|
|
|
**Setup:**
|
|
```bash
|
|
./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:**
|
|
|
|
```bash
|
|
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! 🚀**
|