# Story-Lifecycle

## Übersicht

```
Research → Plan → Review → Implement → Test → Security → PR
```

Kurzbefehl für alles: `/story`

---

## Phase 1: Research

Ziel: Verstehen was gebaut werden soll und was bereits existiert.

```
# Subagenten für parallele Exploration starten
Agent(Explore): Bestehende Implementierungen finden
Agent(Explore): Test-Patterns analysieren
```

Checkliste:
- [ ] Ähnliche bestehende Funktionen gefunden?
- [ ] Abhängige Modelle/Services identifiziert?
- [ ] Test-Setup verstanden?
- [ ] CLAUDE.md des Projekts gelesen?

---

## Phase 2: Planung

```
/model opus    # Für beste Planqualität
EnterPlanMode
```

Checkliste:
- [ ] Context-7 für alle beteiligten Frameworks konsultiert?
- [ ] Akzeptanzkriterien definiert?
- [ ] Test-Typen festgelegt (Unit / Integration / E2E)?
- [ ] Migrations-Bedarf (Alembic) geprüft?
- [ ] Security-relevante Pfade markiert?

---

## Phase 3: Plan-Review

```
/plan-review   # Startet Opus-basierten plan-reviewer-Agent
```

Der Agent prüft:
- Vollständigkeit der Akzeptanzkriterien
- Fehlende Test-Abdeckung
- Security-Risiken
- Abhängigkeiten zu anderen Features
- Migrations-Korrektheit

Erst nach ✅ des Reviews: Implementierung starten.

---

## Phase 4: Implementierung

```
/model sonnet  # Zurück auf Sonnet
ExitPlanMode
```

Regeln:
- Feature-Branch (niemals direkt auf `main`)
- Commits mind. stündlich
- Kleine, fokussierte Commits
- Subagenten für isolierte Teilaufgaben nutzen

---

## Phase 5: Test + Simplify + PR

```
/go
```

Führt aus:
1. `test-runner`-Agent (Haiku): Tests + Coverage
2. `code-simplifier`-Agent: Code-Review + Refactoring
3. PR-Erstellung via Gitea-API

---

## Phase 6: Security-Audit

Wird automatisch nach jeder Story durch CLAUDE.md-Regel ausgelöst,
oder manuell:

```
# security-audit-Agent starten (Opus)
Agent(security-audit): Neuen Code auf Sicherheitslücken prüfen
```

---

## Phase 7: PR-Review & Merge

- Akzeptanzkriterien einzeln als Checkboxen im PR
- Review-Feedback als separater Commit (nicht amenden)
- Squash-Merge auf main

---

## Kontext-Strategie pro Phase

| Phase | Kontext-Empfehlung |
|---|---|
| Research | Subagenten (Explore) — schützt Haupt-Kontext |
| Planung | Haupt-Kontext, Opus |
| Review | Subagent (plan-reviewer) |
| Implementierung | Haupt-Kontext, bei > 200k: /compact |
| Test | Subagent (test-runner) |
| Security | Subagent (security-audit) |
| PR | Subagent oder Haiku direkt |