Initialen Implementierungsplan hinzufügen

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-04-19 10:42:58 +02:00
parent a07c436a7d
commit e3bf2814ff
1 changed files with 129 additions and 0 deletions
@@ -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