Tarik Moussa
d7a0cf7457
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>
95 lines
3.5 KiB
Markdown
95 lines
3.5 KiB
Markdown
# Session-Prompt-Template
|
||
|
||
Kopiere diesen Block in eine frische Session. Fülle alle `_…_`-Platzhalter aus.
|
||
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?_
|
||
|
||
## Details
|
||
Vollständige Spezifikation in: `_<Pfad zum Detail-Dokument>_`
|
||
Betroffene Dateien: `_<Pfad(e)>_`
|
||
|
||
## Akzeptanzkriterien
|
||
- [ ] _Kriterium 1 (messbar, konkret)_
|
||
- [ ] _Kriterium 2_
|
||
- [ ] Tests grün: `_<Test-Befehl>_`
|
||
|
||
## 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`).
|
||
2. `STATE.md` aktualisieren (Now / In Progress / Next).
|
||
3. Session-Log schreiben (`sessions/TEMPLATE.md` → `sessions/<id>-<datum>.md`).
|
||
4. Hygiene-Gate ausführen: `bash scripts/gate-session-hygiene.sh`.
|
||
5. PR-URL + Test-Zählstand reporten.
|
||
```
|
||
|
||
---
|
||
|
||
## Review-Gate-Prompt (Opus, kalt, nach jeder Implement-Session)
|
||
|
||
```
|
||
Modell: Opus
|
||
|
||
Du bist ein externer Reviewer ohne Vorkontext aus der Implement-Session.
|
||
Lies NUR den Diff von Branch `_<branch>_` gegen `main`.
|
||
|
||
Repo: _<absoluter Pfad>_
|
||
Diff: `git diff main..._<branch>_`
|
||
|
||
## Prüf-Checkliste
|
||
- [ ] Build sauber; Test-Suite grün (kein Regressions-Zählstand).
|
||
- [ ] Keine bestehenden Tests verändert (außer explizit begründet).
|
||
- [ ] Numerische Änderungen sind wert-identisch wo behauptet, oder getestet.
|
||
- [ ] Neue Public-Surface (Typen, Enums, API) ist absichtlich und dokumentiert.
|
||
- [ ] Commit-Message enthält Model-Attribution des Implementers.
|
||
- [ ] Finding / Phase als ✅ in der Orchestration-Tabelle mit Commit-Ref eingetragen.
|
||
|
||
## Ergebnis
|
||
APPROVE — alles ok.
|
||
CHANGES-REQUESTED — konkrete Liste der notwendigen Korrekturen.
|
||
```
|
||
|
||
---
|
||
|
||
## Hinweise zum Befüllen
|
||
|
||
- **Scope zuerst** — was liegt AUSSERHALB? Das verhindert Scope-Creep.
|
||
- **Test-Befehl ist Pflicht** — kein "irgendwie testen", sondern der exakte Aufruf.
|
||
- **Model-Routing prüfen** — falsches Modell ist teuer; s. `docs/roles/model-routing.md`.
|
||
- **Kein Vorkontext annehmen** — der Prompt landet in einer frischen Session ohne
|
||
History. Alle nötigen Pfade, Befehle und Entscheidungen müssen im Prompt stehen.
|