claude-vault/MANUAL-WORKFLOW.md

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

# 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)

# 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)

# 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

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

# 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

claude-done <projekt> "<beschreibung>"  # Fallback, falls Claude nicht fragt
claude-log                              # Heutiges Log öffnen

Status & Monitoring

vault-status      # Dashboard anzeigen
vault-health      # Health-Check erstellen
vault-sync        # Projekt-Memory sync
vault-analyze     # Skill-Usage-Matrix

Wartung (in Claude)

/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

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:

./scripts/setup-aliases.sh
source ~/.zshrc
vault-help

Dann einfach mit Claude arbeiten - alles andere läuft automatisch! 🎉