# AGENTS.md — Einstiegspunkt für jede Session

> **Lies dies zuerst. Lies NICHT das ganze Repo.** Orientiere dich in dieser
> Reihenfolge und höre auf, sobald du genug Kontext für deine Aufgabe hast.

## Lese-Reihenfolge (klarer Start)
1. **Dieses Dokument** — wer macht was, wo steht was.
2. **`STATE.md`** — *wo wir gerade stehen* (Now / In Progress / Blocked / Next /
   offene Audit-Findings). Die einzige Quelle für den aktuellen Stand.
3. **`CONVENTIONS.md`** — verbindliche Regeln (Naming, Pfade, Commits, Ownership,
   Model-Attribution, Review-Gate).
4. **Deine Rollen-Datei** — `docs/roles/{leader,worker,reviewer}.md`.
   Welches Modell für welche Arbeit: `docs/roles/model-routing.md`.
5. **Die relevante Loop-Datei** — `docs/loops/{feature,audit}-loop.md`.
   Bei Research-Items: `docs/loops/spike-gate.md`.
6. **Dein Session-Prompt** — `session-prompts/` (fertig ausgefüllter Prompt für
   diese Session — kein Lesen des ganzen Repos nötig).
7. Nur bei Bedarf: `manifests/requirements.md`, betroffene ADRs, Code.

## Wo finde ich was?
| Frage | Datei |
|---|---|
| Aktueller Stand / nächster Schritt | `STATE.md` |
| Regeln & gemeinsamer Vertrag | `CONVENTIONS.md` |
| Plan / Board / Ready-Set (DAG) | `ROADMAP.md` |
| Befülltes Beispiel zum Lernen | `examples/walkthrough/` |
| Warum wurde X so entschieden | `docs/adr/` |
| Anforderung → Datei → Test → Status | `manifests/requirements.md` |
| Was hat die letzte Session getan | `sessions/` (neuester Eintrag) |
| Offene Prüf-Befunde + Model-Zuweisung | `audits/` |
| Welches Modell für welche Arbeit | `docs/roles/model-routing.md` |
| Kaltstartfähige Session-Prompts | `session-prompts/` |
| Token-Kosten kontrollieren | `docs/token-hygiene.md` |

## Pflicht am Session-Ende
- `STATE.md` aktualisieren · Session-Log aus `sessions/TEMPLATE.md` anlegen
  (inkl. **Token-Verbrauch** + Model-Attribution) · betroffene Manifeste/Docs anpassen ·
  Quality-Gate ausführen (`scripts/gate-session-hygiene.sh`).