feat: initial agent-swarm-repo template
Some checks failed
gates / quality (push) Has been cancelled
Some checks failed
gates / quality (push) Has been cancelled
Generelles Git-Repo-Template fuer KI-Agenten-Arbeit (multi-agent swarm pattern). Enthaelt: - Rollen-System (Leader, Worker, Reviewer) mit Model-Routing-Matrix (Tier-basiert) - Zwei komplementaere Loops: Feature-Loop (vorwaerts) + Audit-Loop (rueckwaerts) - Spike-Gate fuer Research-Items (GO/NO-GO vor Produktionscode) - Obligatorische Opus-Review-Gate nach jeder Implement-Session - Drei ausfuehrbare Gates: session-hygiene, ownership (Cross-Edit-Schutz), doc-drift -- alle dormant bis zur ersten Initialisierung, dann automatisch aktiv - Bootstrap: scripts/init.sh + session-prompts/BOOTSTRAP.md - Worked Example (URL-Shortener-Domaene): Board, Session-Log, Audit-Finding, ADR - Token-Hygiene (3-Tier: Session-Schnitt / Command-Disziplin / Cache-Disziplin) - GitHub Actions CI (gates.yml) laeuft auf jedem Push/PR Muster destilliert aus produktiv-bewaehrten Patterns des ConformalLabpp-Projekts.
This commit is contained in:
77
session-prompts/TEMPLATE.md
Normal file
77
session-prompts/TEMPLATE.md
Normal file
@@ -0,0 +1,77 @@
|
||||
# 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_
|
||||
|
||||
Du arbeitest in _<absoluter Pfad zum Repo>_ auf einem neuen Branch
|
||||
`_feat|fix|docs|audit/<name>_` (von `main`).
|
||||
|
||||
## 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._
|
||||
|
||||
## Commit & Push
|
||||
- Conventional Commit: `_feat|fix|docs|test|chore_: …`
|
||||
- Trailer: `Co-Authored-By: Claude _<Modell>_ <noreply@anthropic.com>`
|
||||
- Push nach `origin`, PR öffnen (Base: `main`).
|
||||
|
||||
## 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.
|
||||
Reference in New Issue
Block a user