# 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!** 🎉