martinandClaude Sonnet 4.6
e3bf2814ff
Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
130 lines
4.8 KiB
Markdown
130 lines
4.8 KiB
Markdown
# 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
|