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:
@@ -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 (1–3 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`).
|
||||
|
||||
Reference in New Issue
Block a user