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

@@ -18,10 +18,16 @@ nur daraus.
Ready-Set = { Items mit Status 🔲, deren Prereqs ALLE ✅ sind }
```
1. Ready-Set bilden (Board unten lesen).
2. Ein Item ziehen; Modell aus `docs/roles/model-routing.md` setzen.
3. Session-Prompt aus `session-prompts/` ausfüllen (Template: `session-prompts/TEMPLATE.md`).
2. Ein Item ziehen; Modell + Rolle aus `docs/roles/model-routing.md` setzen.
3. Session-Prompt **vollständig ausfüllen und committen** — BEVOR der Worker-Agent startet.
Template: `session-prompts/TEMPLATE.md` (Pflichtfelder: Rolle, Pflichtlektüre, Out-of-Scope-Regel).
4. **🔌/🧱** → direkt Worker. **🔬** → erst durch das Spike-Gate (`docs/loops/spike-gate.md`).
5. Nach Implement: Review-Gate (Opus) → Merge → Item hier auf ✅, Dependents werden frei.
5. Worker dispatchen (kalt — kein Kontext aus Leader-Session weitergeben).
6. Nach Implement: Review-Gate (Opus, kalt) → Merge → Item hier auf ✅, Dependents werden frei.
> **Invariante:** Session-Prompt existiert immer vor dem Worker-Dispatch.
> Ein Worker der keinen vorbereiteten Prompt vorfindet, soll NICHT beginnen
> sondern `STATE.md` auf "Blocked — kein Prompt" setzen.
## Abhängigkeits-DAG (Projekt: tg-bot-jetson)