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:
48
docs/methodology.md
Normal file
48
docs/methodology.md
Normal file
@@ -0,0 +1,48 @@
|
||||
# Methodik — Betriebsmodell
|
||||
|
||||
## Grundprinzip
|
||||
Das Repo ist die dauerhafte Erinnerung; Sessions sind flüchtig. Alles
|
||||
Entscheidungsrelevante liegt **auf Disk**, nie nur im Chat. So kann jede neue
|
||||
Session kalt starten.
|
||||
|
||||
## Rollen
|
||||
- **Leader** (`docs/roles/leader.md`) — Orchestrierung & Integration.
|
||||
- **Worker** (`docs/roles/worker.md`) — disjunkte parallele Umsetzung.
|
||||
- **Reviewer** (`docs/roles/reviewer.md`) — kalter Audit in neuer Session; immer Opus.
|
||||
- **Model-Routing** (`docs/roles/model-routing.md`) — welches Modell für welche Arbeit.
|
||||
|
||||
## Zwei Loops (Feature-Dev und Audit)
|
||||
|
||||
- **Feature-Loop / vorwärts** (`docs/loops/feature-loop.md`): erzeugt Fähigkeit.
|
||||
Enthält eine **Port/Research-Klassifikation** und (für Research) ein
|
||||
**Spike-Gate** (`docs/loops/spike-gate.md`) bevor Produktionscode entsteht.
|
||||
- **Audit-Loop / rückwärts** (`docs/loops/audit-loop.md`): erhält Korrektheit &
|
||||
Hygiene, speist Korrekturen mit Model-Zuweisung zurück in Roadmap/State.
|
||||
|
||||
Die Loops **komplementieren sich**: Feature-Dev produziert Module; Audit härtet
|
||||
sie ab. Jedes Merge im Feature-Loop triggert einen Audit-Backlog-Eintrag.
|
||||
Die Loops wechseln sich ab: nach N Feature-Zyklen ein Audit-Zyklus (oder sofort
|
||||
bei Drift-Signal aus den Observability-Gates).
|
||||
|
||||
## Review-Gate (eingebaut in beide Loops)
|
||||
|
||||
Nach **jeder** Implement-Session kommt eine separate Opus-Session (kalt,
|
||||
unabhängig), die den Diff reviewt. Kein Merge ohne Review-Gate `APPROVE`.
|
||||
Details: `docs/roles/reviewer.md`.
|
||||
|
||||
## Session-Prompts
|
||||
|
||||
Für jede Session existiert ein kaltstartfähiger Prompt unter `session-prompts/`.
|
||||
Template: `session-prompts/TEMPLATE.md`. Der Prompt enthält: Modell, Branch,
|
||||
Scope, Befehle, Akzeptanzkriterien — alles was die Session ohne Vorkontext braucht.
|
||||
|
||||
## Gates
|
||||
- **Quality-Gates** (`docs/gates/quality-gates.md`): Session-Hygiene,
|
||||
Kontext-Pflege, Token-Verbrauch.
|
||||
- **Observability-Gates** (`docs/gates/observability-gates.md`): System-Effizienz
|
||||
und Doku-Drift.
|
||||
- **Token-Hygiene** (`docs/token-hygiene.md`): 3-Tier-System zur Kostensteuerung.
|
||||
|
||||
## Clean-Start-Invariante
|
||||
Session-Ende ⇒ neuer Agent orientiert sich allein über
|
||||
`AGENTS.md → STATE.md → CONVENTIONS.md`. Verletzung = Hygiene-Gate `FAIL`.
|
||||
Reference in New Issue
Block a user