claude-workflow/workflow/plan.md

Plan: Optimaler Entwicklungs-Workflow

Kontext

Ziel ist ein vollständig eingerichteter, kostenoptimierter Entwicklungsworkflow für Claude Code. Aktueller Stand: 3 Agenten (test-runner, security-audit, n8n-architect), 5 Plugins, kein skills/- oder commands/-Verzeichnis, kein Hooks-Setup. Alles soll in /home/martin/.claude/workflow/ dokumentiert und in den Standard-Verzeichnissen (skills/, agents/, hooks/) aktiviert werden.

---

Zu erstellende Struktur

/home/martin/.claude/
├── workflow/                        ← Neue Dokumentations-Zentrale
│   ├── README.md                    ← Gesamtübersicht + Schnellreferenz
│   ├── models.md                    ← Modell-Strategie + Kostenmatrix
│   └── story-lifecycle.md           ← Story-Workflow von Plan bis PR
├── skills/                          ← NEU: Global auto-discoverable Skills
│   ├── go.md                        ← /go: Test + Simplify + PR
│   ├── plan-review.md               ← /plan-review: Opus reviewt Plan
│   └── story.md                     ← /story: Voller Story-Lifecycle
├── hooks/                           ← NEU: Hook-Skripte
│   ├── auto-format.sh               ← PostToolUse: Format nach Edit/Write
│   └── verify-on-stop.sh            ← Stop: Test-Erinnerung
└── agents/                          ← Ergänzung: neuer Agent
    └── plan-reviewer.md             ← Opus-basierter Plan-Reviewer

Zusätzlich: settings.json um Hooks-Sektion erweitern.

---

Modell-Strategie (kostenoptimiert)

Phase	Modell	Begründung
Planung / Review	Opus 4.7	Qualität > Kosten
Implementierung	Sonnet 4.6	Optimales Preis-Leistungs-Verhältnis
Test / Lint / Fmt	Haiku 4.5	Schnell + günstig
Security-Audit	Opus 4.7	Sicherheit hat Priorität
PR-Erstellung	Haiku 4.5	Mechanische Aufgabe

---

Detaillierter Umsetzungsplan

Schritt 1: Verzeichnisse anlegen

• /home/martin/.claude/workflow/
• /home/martin/.claude/skills/
• /home/martin/.claude/hooks/

Schritt 2: workflow/README.md

Schnellreferenz: Welcher Befehl für welche Phase, Modell-Matrix, Link zu den Detail-Docs.

Schritt 3: workflow/models.md

Vollständige Modell-Strategie mit Beispielen und Kostenschätzungen.

Schritt 4: workflow/story-lifecycle.md

Story-Lifecycle dokumentiert: Research → Plan → Review → Implement → Test → Security → PR.

Schritt 5: skills/go.md

/go-Skill kombiniert:

1. test-runner-Agent starten
2. code-simplifier-Agent starten
3. Gitea-PR via secret-tool-Token erstellen Kontext: fork (isolierter Subagent).

Schritt 6: skills/plan-review.md

/plan-review-Skill:

• Startet Opus 4.7-basierten plan-reviewer-Agent
• Dieser reviewt den aktuellen Plan auf Vollständigkeit, Risiken, fehlende Tests
• Gibt strukturierten Review-Bericht zurück.

Schritt 7: skills/story.md

/story-Skill orchestriert den vollen Lifecycle:

1. Plan-Modus (EnterPlanMode)
2. Plan-Review via plan-reviewer-Agent (Opus)
3. Implementierung (Sonnet)
4. /go (Test + Simplify + PR)

Schritt 8: hooks/auto-format.sh

PostToolUse-Hook nach Edit/Write:

• Erkennt Dateityp (Python → ruff format, JS/Vue → eslint --fix)
• Verhindert CI-Fehler durch Formatierungs-Abweichungen.

Schritt 9: hooks/verify-on-stop.sh

Stop-Hook:

• Prüft ob unbeendete Tasks vorhanden sind
• Gibt kurze Erinnerung aus (kein Blockieren).

Schritt 10: agents/plan-reviewer.md

Neuer Agent plan-reviewer:

• Modell: Opus 4.7
• Aufgabe: Plan auf Lücken/Risiken/fehlende Tests prüfen
• Tools: Read, Glob, Grep (read-only)
• Gibt strukturierten Bericht: ✅ OK / ⚠️ Risiko / ❌ Fehlt.

Schritt 11: settings.json Hooks ergänzen

"hooks": {
  "PostToolUse": [{
    "matcher": "Edit|Write",
    "hooks": [{"type": "command", "command": "bash ~/.claude/hooks/auto-format.sh"}]
  }],
  "Stop": [{
    "hooks": [{"type": "command", "command": "bash ~/.claude/hooks/verify-on-stop.sh"}]
  }]
}

---

Nicht verändert

• Bestehende Agenten: test-runner.md, security-audit.md, n8n-architect.md → bleiben unverändert
• Globale CLAUDE.md → keine Änderung (bereits vollständig)
• Projektspezifische Konfigurationen → keine Änderung

---

Verifikation

1. claude /go im Testprojekt → PR in Gitea erscheint
2. claude /plan-review nach EnterPlanMode → Review-Bericht erscheint
3. Datei editieren → auto-format.sh läuft (keine Fehler)
4. Session beenden → verify-on-stop.sh gibt Status aus
5. cat ~/.claude/workflow/README.md → Schnellreferenz lesbar