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