docs: template-improvements — Pflichtlektüre, Rollen-Aktivierung, Out-of-Scope-Regel

Basierend auf Retro der F-06/07-Sessions:
- Pflichtlektüre-Block (AGENTS.md, CONVENTIONS.md, STATE.md) im Template
- Rollen-Aktivierungssatz + Link zur Rollendatei
- Out-of-Scope-Findings-Regel (trivial beheben vs. blockieren)
- "Tests zuerst, dann committen" explizit
- "Nicht selbst mergen" — Review-Gate-Hinweis für Worker
- Swarm-Kontext-Sektion für automatisierten Dispatch
- ROADMAP: Session-Prompt muss VOR Worker-Dispatch existieren (Invariante)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-06-03 23:57:21 +02:00
parent 33ff3a9efd
commit d7a0cf7457
2 changed files with 26 additions and 3 deletions

View File

@@ -7,10 +7,16 @@ Jeder Prompt ist **kaltstartfähig** — die neue Session braucht kein Vorwissen
```
Modell: _Haiku | Sonnet | Opus_
Rolle: _Worker | Porter | Theorist | Reviewer_ → lies `docs/roles/<rolle>.md` vor dem Start.
Du arbeitest in _<absoluter Pfad zum Repo>_ auf einem neuen Branch
`_feat|fix|docs|audit/<name>_` (von `main`).
## Pflichtlektüre (Kaltstart — in dieser Reihenfolge)
1. `AGENTS.md` — Swarm-Rollen und Prozess
2. `CONVENTIONS.md` — Code- und Commit-Standards
3. `STATE.md` — aktueller Live-Stand (was läuft, was blockiert)
## Aufgabe
_Kurze Beschreibung (13 Sätze) was implementiert, geprüft oder dokumentiert
werden soll. Scope klar abgrenzen — was liegt AUSSERHALB dieser Session?_
@@ -27,10 +33,21 @@ Betroffene Dateien: `_<Pfad(e)>_`
## Nicht anfassen
_Dateien / Pakete ausserhalb des Scopes. Kein Cross-Editing._
## Out-of-Scope-Findings
Fehler ausserhalb des Scopes: im Session-Log dokumentieren.
Beheben nur wenn trivial (< 10 Zeilen, kein Design-Entscheid).
Sonst: als Blocking-Issue in `STATE.md` eintragen und nicht mergen.
## Commit & Push
- Tests ZUERST grün: `_<Test-Befehl>_` — erst dann committen.
- Conventional Commit: `_feat|fix|docs|test|chore_: …`
- Trailer: `Co-Authored-By: Claude _<Modell>_ <noreply@anthropic.com>`
- Push nach `origin`, PR öffnen (Base: `main`).
- NICHT selbst mergen — Review-Gate (Opus, kalt) folgt nach diesem Prompt.
## Swarm-Kontext (bei automatisiertem Dispatch ausfüllen, sonst weglassen)
- Leader-Session/Kanal: _<Session-ID, RemoteTrigger-ID oder n/a>_
- Fertigmeldung: `STATE.md` aktualisieren + Hygiene-Gate-Output sichtbar machen.
## Abschluss
1. Manifest-Eintrag updaten (`manifests/requirements.md` → Status `done`).