diff --git a/workflow/plan.md b/workflow/plan.md new file mode 100644 index 0000000..d317254 --- /dev/null +++ b/workflow/plan.md @@ -0,0 +1,129 @@ +# 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 +```json +"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