403 lines
9.0 KiB
Markdown
403 lines
9.0 KiB
Markdown
# Manual Workflow - Claude-Vault ohne Cron-Jobs
|
|
|
|
**Philosophie:** Claude führt Wartungsaufgaben **proaktiv** durch (via `global-instructions.md`), oder du triggerst sie **manuell** via Aliases.
|
|
|
|
**Vorteil:** Volle Kontrolle, keine Hintergrund-Prozesse, Claude als aktiver Assistant.
|
|
|
|
---
|
|
|
|
## 🤖 Automatisierung via global-instructions.md
|
|
|
|
Die `system/global-instructions.md` enthält jetzt **Context-Aware Triggers**, sodass Claude proaktiv Wartung durchführt:
|
|
|
|
### Session-Start Triggers
|
|
|
|
#### Montag morgens
|
|
```
|
|
Claude prüft automatisch:
|
|
├─ Dashboard älter als 7 Tage? → "Dashboard aktualisieren?"
|
|
├─ ≥5 neue Logs vorhanden? → "/vault-janitor distill durchführen?"
|
|
└─ ≥3 Skill-Proposals offen? → Info-Hinweis
|
|
```
|
|
|
|
**Deine Aktion:** Einfach "ja" sagen, Claude macht den Rest.
|
|
|
|
---
|
|
|
|
#### 1. des Monats
|
|
```
|
|
Claude bietet an:
|
|
├─ Health-Check durchführen
|
|
├─ Backup-Reminder
|
|
└─ Skill-Usage-Matrix aktualisieren
|
|
```
|
|
|
|
---
|
|
|
|
### Session-Ende Trigger
|
|
|
|
#### Bei "exit", "fertig", "danke"
|
|
```
|
|
Claude fragt AUTOMATISCH:
|
|
"Session-Log erstellen? Kurze Beschreibung?"
|
|
|
|
→ Du: "Team-Stats API + Tests"
|
|
→ Claude: Erstellt Log in memory/log/2026-02-04_session.md
|
|
```
|
|
|
|
**Kein manuelles `claude-done` nötig!** Claude macht das direkt.
|
|
|
|
---
|
|
|
|
### Projekt-Wechsel Trigger
|
|
|
|
#### Wenn du in neuem Projekt arbeitest
|
|
```
|
|
Claude erkennt automatisch:
|
|
"Projekt-Wechsel erkannt: league-planner → ligalytics"
|
|
|
|
Führe aus: scripts/sync-project-memory.sh
|
|
Info: "Projekt-Memory synchronisiert"
|
|
```
|
|
|
|
---
|
|
|
|
### Fehler/Bug-Fix Trigger
|
|
|
|
#### Bei Fehler-Behebung
|
|
```
|
|
Claude prüft:
|
|
- Ist Fehlertyp bereits in /knowledge/anti-patterns/?
|
|
- Falls NEIN: "Als Anti-Pattern dokumentieren?"
|
|
|
|
→ Du: "Ja"
|
|
→ Claude: Erstellt Anti-Pattern via Template
|
|
```
|
|
|
|
---
|
|
|
|
## 🖐️ Manuelle Triggers (via Aliases)
|
|
|
|
Falls du Claude nicht automatisch handeln lassen willst, nutze Aliases:
|
|
|
|
### Täglich
|
|
|
|
```bash
|
|
# Nach Claude-Session (falls Claude nicht automatisch fragt)
|
|
claude-done <projekt> "<beschreibung>"
|
|
|
|
# Beispiel
|
|
claude-done league-planner "Celery Task für Report-Generierung"
|
|
```
|
|
|
|
---
|
|
|
|
### Wöchentlich (Montag, 5 Minuten)
|
|
|
|
```bash
|
|
# 1. Dashboard prüfen
|
|
vault-status
|
|
|
|
# 2. Skill-Proposals anschauen
|
|
vault-proposals
|
|
|
|
# 3. Falls ≥5 Logs: Pattern-Extraktion
|
|
# In Claude:
|
|
/vault-janitor distill
|
|
```
|
|
|
|
---
|
|
|
|
### Monatlich (1. des Monats, 15 Minuten)
|
|
|
|
```bash
|
|
# 1. Health-Check
|
|
vault-health
|
|
|
|
# 2. Skill-Usage analysieren
|
|
~/Work/claude-vault/scripts/analyze-skill-usage.sh
|
|
|
|
# 3. Patterns reviewen
|
|
vault-patterns
|
|
|
|
# 4. Backup
|
|
vault-backup
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 Vergleich: Automatisch vs. Manuell
|
|
|
|
| Aufgabe | Cron (alt) | global-instructions (neu) | Manuell (Fallback) |
|
|
|---------|------------|---------------------------|---------------------|
|
|
| Session-Logging | ❌ | ✅ Claude fragt am Ende | `claude-done` |
|
|
| Dashboard-Update | ⏰ Täglich 21:00 | ✅ Claude bietet montags an | `vault-status` |
|
|
| Health-Check | ⏰ Montag 09:00 | ✅ Claude bietet monatlich an | `vault-health` |
|
|
| Pattern-Extraktion | ❌ | ✅ Claude schlägt vor (≥5 Logs) | `/vault-janitor distill` |
|
|
| Skill-Proposals | ⏰ Montag 10:00 | ✅ Claude erkennt automatisch (3x Task) | `/vault-janitor propose` |
|
|
| Projekt-Sync | ⏰ Täglich 20:00 | ✅ Claude bei Projekt-Wechsel | `vault-sync` |
|
|
|
|
**Ergebnis:** Du bekommst **mehr Interaktion** und **Kontrolle**, Claude wird **proaktiver Assistant** statt stiller Cron-Job.
|
|
|
|
---
|
|
|
|
## 🎯 Workflow-Beispiel: Typische Woche
|
|
|
|
### Montag, 09:00 - Session-Start
|
|
|
|
```
|
|
Du: "Hallo Claude"
|
|
|
|
Claude: "Guten Morgen!
|
|
📊 Dashboard ist 8 Tage alt. Soll ich aktualisieren?
|
|
📚 7 neue Logs gefunden. Pattern-Extraktion durchführen? (/vault-janitor distill)
|
|
💡 2 offene Skill-Proposals zum Reviewen."
|
|
|
|
Du: "Ja, Dashboard aktualisieren. Distill später."
|
|
|
|
Claude: *führt update-dashboard.sh aus*
|
|
"✅ Dashboard aktualisiert:
|
|
- 7 Logs diese Woche
|
|
- 2 neue Patterns erkannt
|
|
- Empfehlung: Distill durchführen"
|
|
```
|
|
|
|
---
|
|
|
|
### Dienstag, 14:00 - Arbeit an Projekt
|
|
|
|
```
|
|
Du: "Erstelle Django Model für Team-Stats"
|
|
|
|
Claude: *nutzt /lp-django-model Skill*
|
|
*erstellt Model*
|
|
|
|
Du: "Danke, fertig für heute"
|
|
|
|
Claude: "Session-Log erstellen? Kurze Beschreibung?"
|
|
|
|
Du: "Team-Stats Model erstellt"
|
|
|
|
Claude: *erstellt Log in memory/log/2026-02-05_session.md*
|
|
"✅ Session geloggt. Bis morgen!"
|
|
```
|
|
|
|
---
|
|
|
|
### Freitag, 16:00 - Projekt-Wechsel
|
|
|
|
```
|
|
Du: "Wechsel zu ligalytics Projekt"
|
|
|
|
Claude: "Projekt-Wechsel erkannt: league-planner → ligalytics
|
|
Synchronisiere Projekt-Memory..."
|
|
|
|
*führt sync-project-memory.sh aus*
|
|
|
|
"✅ Memory synchronisiert
|
|
Projekt: ligalytics
|
|
Letzte Arbeit: 2026-01-28
|
|
|
|
Projekt-MEMORY geladen. Womit kann ich helfen?"
|
|
```
|
|
|
|
---
|
|
|
|
### Samstag, 11:00 - Bug-Fix
|
|
|
|
```
|
|
Du: "Circular Import Problem in models.py gefixt"
|
|
|
|
Claude: *prüft /knowledge/anti-patterns/*
|
|
|
|
"Circular Import ist noch nicht als Anti-Pattern dokumentiert.
|
|
Soll ich ein Anti-Pattern erstellen?"
|
|
|
|
Du: "Ja, gerne"
|
|
|
|
Claude: *nutzt template.md*
|
|
*erstellt /knowledge/anti-patterns/circular-imports.md*
|
|
|
|
"✅ Anti-Pattern dokumentiert:
|
|
- Problem: Circular Imports
|
|
- Lösung: Lazy Imports, Refactoring
|
|
- Beispiel aus deinem Code"
|
|
```
|
|
|
|
---
|
|
|
|
## 🔧 Setup (5 Minuten)
|
|
|
|
### 1. Aliases installieren
|
|
|
|
```bash
|
|
cd ~/Work/claude-vault
|
|
./scripts/setup-aliases.sh
|
|
```
|
|
|
|
**Output:**
|
|
```
|
|
✅ Installation erfolgreich!
|
|
|
|
Nächste Schritte:
|
|
1. Shell neu laden: source ~/.zshrc
|
|
2. Testen: vault-help
|
|
3. Bei nächster Claude-Session nutzen: claude-done <projekt> "<beschreibung>"
|
|
|
|
💡 Wichtig:
|
|
- KEINE Cron-Jobs installiert (wie gewünscht)
|
|
- Claude führt Wartung automatisch durch (via global-instructions.md)
|
|
```
|
|
|
|
---
|
|
|
|
### 2. global-instructions.md ist bereits aktualisiert
|
|
|
|
Die `system/global-instructions.md` enthält jetzt alle Trigger:
|
|
- ✅ Session-Start (Montag, 1. des Monats)
|
|
- ✅ Session-Ende (Log-Erstellung)
|
|
- ✅ Projekt-Wechsel (Memory-Sync)
|
|
- ✅ Fehler-Fix (Anti-Pattern-Detection)
|
|
|
|
**Keine weitere Konfiguration nötig!**
|
|
|
|
---
|
|
|
|
### 3. Test
|
|
|
|
```bash
|
|
# Shell neu laden
|
|
source ~/.zshrc
|
|
|
|
# Test
|
|
vault-help
|
|
|
|
# Sollte zeigen:
|
|
🔧 Claude-Vault Aliases
|
|
[... Liste aller Befehle ...]
|
|
```
|
|
|
|
---
|
|
|
|
## 💡 Best Practices
|
|
|
|
### 1. Vertraue Claude
|
|
- Claude fragt proaktiv nach Wartungsaufgaben
|
|
- Sag einfach "ja" oder "später"
|
|
- Claude übernimmt die Ausführung
|
|
|
|
### 2. Nutze Aliases als Fallback
|
|
- Falls Claude mal nicht fragt: Manuell triggern
|
|
- `vault-status` für Quick-Check
|
|
- `vault-health` für monatlichen Überblick
|
|
|
|
### 3. Wöchentlicher Review (Montag, 5 Min)
|
|
- Lass Claude Dashboard aktualisieren
|
|
- Lass Claude Proposals zeigen
|
|
- Bei ≥5 Logs: `/vault-janitor distill`
|
|
|
|
### 4. Monatlicher Deep-Dive (1. des Monats, 15 Min)
|
|
- Health-Check durchführen lassen
|
|
- Patterns reviewen (`vault-patterns`)
|
|
- Backup erstellen (`vault-backup`)
|
|
|
|
---
|
|
|
|
## 🆚 Vorher vs. Nachher
|
|
|
|
### Vorher (mit Cron)
|
|
```
|
|
⏰ Cron-Jobs laufen im Hintergrund
|
|
→ Du weißt nicht wann/was passiert
|
|
→ Keine Interaktion
|
|
→ "Magic" im Hintergrund
|
|
```
|
|
|
|
### Nachher (ohne Cron, mit global-instructions)
|
|
```
|
|
🤖 Claude agiert als proaktiver Assistant
|
|
→ Fragt zur richtigen Zeit
|
|
→ Du entscheidest: "Ja" oder "Später"
|
|
→ Volle Transparenz & Kontrolle
|
|
```
|
|
|
|
---
|
|
|
|
## 🎓 Philosophie
|
|
|
|
**Cron-Jobs:** Automatisierung ohne Kontext
|
|
**Claude:** Automatisierung **mit** Kontext
|
|
|
|
**Beispiel:**
|
|
- Cron läuft Montag 09:00 → Egal ob du arbeitest oder nicht
|
|
- Claude erkennt: "Montag-Session" → Bietet Wartung an → Nur wenn du da bist
|
|
|
|
**Ergebnis:** **Smarter, nicht nur automatisiert.**
|
|
|
|
---
|
|
|
|
## 📚 Kommandos-Übersicht
|
|
|
|
### Session-Management
|
|
```bash
|
|
claude-done <projekt> "<beschreibung>" # Fallback, falls Claude nicht fragt
|
|
claude-log # Heutiges Log öffnen
|
|
```
|
|
|
|
### Status & Monitoring
|
|
```bash
|
|
vault-status # Dashboard anzeigen
|
|
vault-health # Health-Check erstellen
|
|
vault-sync # Projekt-Memory sync
|
|
vault-analyze # Skill-Usage-Matrix
|
|
```
|
|
|
|
### Wartung (in Claude)
|
|
```bash
|
|
/vault-janitor distill # Patterns extrahieren
|
|
/vault-janitor propose # Skill-Proposals erkennen
|
|
/vault-janitor stats # Statistiken
|
|
/vault-janitor anti-pattern-detect # Anti-Patterns aus Logs
|
|
```
|
|
|
|
### Quick-Access
|
|
```bash
|
|
vault-dashboard # Dashboard öffnen
|
|
vault-patterns # Patterns öffnen
|
|
vault-proposals # Proposals anzeigen
|
|
vault-help # Hilfe
|
|
```
|
|
|
|
---
|
|
|
|
## ✅ Zusammenfassung
|
|
|
|
**Setup:**
|
|
1. `./scripts/setup-aliases.sh` ausführen
|
|
2. Shell neu laden: `source ~/.zshrc`
|
|
3. Fertig! Claude macht den Rest.
|
|
|
|
**Workflow:**
|
|
- **Session-Start:** Claude fragt nach Dashboard/Distill (Montag/Monatlich)
|
|
- **Session-Ende:** Claude fragt nach Log-Beschreibung
|
|
- **Projekt-Wechsel:** Claude synct automatisch
|
|
- **Fehler-Fix:** Claude schlägt Anti-Pattern vor
|
|
|
|
**Manuell (Fallback):**
|
|
- `vault-status` - Dashboard
|
|
- `vault-health` - Health-Check
|
|
- `/vault-janitor distill` - Patterns
|
|
|
|
**Ergebnis:** **Proaktive Wartung ohne Cron-Jobs. Claude als intelligenter Assistant.**
|
|
|
|
---
|
|
|
|
**Nächster Schritt:**
|
|
```bash
|
|
./scripts/setup-aliases.sh
|
|
source ~/.zshrc
|
|
vault-help
|
|
```
|
|
|
|
**Dann einfach mit Claude arbeiten - alles andere läuft automatisch!** 🎉
|