# 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