# Feature-Loop (vorwärts)

Ziel: neue Fähigkeit, sauber dokumentiert und belegt.

## Kern-Pipeline

```
Roadmap-Item
  -> Leader klassifiziert (port / research / infra)
  -> Leader zerlegt in disjunkte Pakete (+ STATE-Ownership)

  ┌── PORT ────────────────────────────────────────────┐
  │  Worker (Sonnet): golden-oracle Implementierung    │
  │  Validation (Sonnet): Parität-Tests                │
  └────────────────────────────────────────────────────┘

  ┌── RESEARCH ─────────────────────────────────────────────────────────┐
  │  Theorist (Opus): Formeln aus Papers ableiten, Validation entwerfen │
  │  Spike (Prototyper): Wegwerf-Implementierung auf scratch/**-Branch  │
  │  GO/NO-GO-Gate: math korrekt? → GO: weiter; NO-GO: → Roadmap       │
  │  Research-Implementer (Opus→Sonnet): produktiv umsetzen             │
  └─────────────────────────────────────────────────────────────────────┘

  -> Validation Engineer: Test-Batterie je Item-Typ bauen
  -> Review-Gate (Opus, kalt): math korrekt? Parität? Public-API ok?
       APPROVE → weiter | CHANGES-REQUESTED → zurück zu Implement
  -> Leader integriert & löst Konflikte
  -> Manifest + Docs + STATE aktualisiert
  -> Quality-Gate (Hygiene/Kontext/Token)
       PASS: Item nach "Done" | FAIL: Korrektur-Task
```

## Klassifikation Port vs. Research

| Typ | Kriterium | Oracle | Validation-Pflicht |
|---|---|---|---|
| **Port** | hat Referenz-Implementierung (Java, Python, Pseudo-Code) | golden values bit-for-bit | FD-Gradient + Parität |
| **Research** | kein direkter Vorläufer, nur Paper-Formeln | keine extern | Invarianten + analyt. Grenzfälle + Konvergenz |
| **Infra** | kein fachlicher Inhalt (CLI, CI, Docs) | trivial | Smoke-Test |

Regel: Research-Items **müssen** durch das Spike-Gate, bevor Produktions-Code
geschrieben wird. Näheres: `docs/loops/spike-gate.md`.

## Model-Routing (grobe Heuristik)

Vollständige Matrix: `docs/roles/model-routing.md`. Kurzform:
- Mechanische Arbeit (Umbenennen, Docs, CLI-Glue) → **Haiku**
- Implementierung mit klarer Spec → **Sonnet**
- Mathe, Architektur, jede Review-Gate-Session → **Opus**

## Session-Prompts

Kaltstartfähige Prompts je Phase/Paket unter `session-prompts/`.
Template: `session-prompts/TEMPLATE.md`.

## Eintrittskriterien
Roadmap-Item priorisiert; Klassifikation (Port/Research/Infra) klar;
betroffene Konventionen geklärt.

## Austrittskriterien (Definition of Done, s. CONVENTIONS.md)
Tests grün · Manifest `done` · Docs/STATE aktuell · Session-Log ·
Review-Gate `APPROVE` · Hygiene-Gate `PASS`.