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:
62
docs/loops/feature-loop.md
Normal file
62
docs/loops/feature-loop.md
Normal file
@@ -0,0 +1,62 @@
|
||||
# Feature-Loop (vorwärts)
|
||||
|
||||
Ziel: neue Fähigkeit, sauber dokumentiert und belegt.
|
||||
|
||||
## Kern-Pipeline
|
||||
|
||||
```
|
||||
Roadmap-Item
|
||||
-> Leader klassifiziert (port / research / infra)
|
||||
-> Leader zerlegt in disjunkte Pakete (+ STATE-Ownership)
|
||||
|
||||
┌── PORT ────────────────────────────────────────────┐
|
||||
│ Worker (Sonnet): golden-oracle Implementierung │
|
||||
│ Validation (Sonnet): Parität-Tests │
|
||||
└────────────────────────────────────────────────────┘
|
||||
|
||||
┌── RESEARCH ─────────────────────────────────────────────────────────┐
|
||||
│ Theorist (Opus): Formeln aus Papers ableiten, Validation entwerfen │
|
||||
│ Spike (Prototyper): Wegwerf-Implementierung auf scratch/**-Branch │
|
||||
│ GO/NO-GO-Gate: math korrekt? → GO: weiter; NO-GO: → Roadmap │
|
||||
│ Research-Implementer (Opus→Sonnet): produktiv umsetzen │
|
||||
└─────────────────────────────────────────────────────────────────────┘
|
||||
|
||||
-> Validation Engineer: Test-Batterie je Item-Typ bauen
|
||||
-> Review-Gate (Opus, kalt): math korrekt? Parität? Public-API ok?
|
||||
APPROVE → weiter | CHANGES-REQUESTED → zurück zu Implement
|
||||
-> Leader integriert & löst Konflikte
|
||||
-> Manifest + Docs + STATE aktualisiert
|
||||
-> Quality-Gate (Hygiene/Kontext/Token)
|
||||
PASS: Item nach "Done" | FAIL: Korrektur-Task
|
||||
```
|
||||
|
||||
## Klassifikation Port vs. Research
|
||||
|
||||
| Typ | Kriterium | Oracle | Validation-Pflicht |
|
||||
|---|---|---|---|
|
||||
| **Port** | hat Referenz-Implementierung (Java, Python, Pseudo-Code) | golden values bit-for-bit | FD-Gradient + Parität |
|
||||
| **Research** | kein direkter Vorläufer, nur Paper-Formeln | keine extern | Invarianten + analyt. Grenzfälle + Konvergenz |
|
||||
| **Infra** | kein fachlicher Inhalt (CLI, CI, Docs) | trivial | Smoke-Test |
|
||||
|
||||
Regel: Research-Items **müssen** durch das Spike-Gate, bevor Produktions-Code
|
||||
geschrieben wird. Näheres: `docs/loops/spike-gate.md`.
|
||||
|
||||
## Model-Routing (grobe Heuristik)
|
||||
|
||||
Vollständige Matrix: `docs/roles/model-routing.md`. Kurzform:
|
||||
- Mechanische Arbeit (Umbenennen, Docs, CLI-Glue) → **Haiku**
|
||||
- Implementierung mit klarer Spec → **Sonnet**
|
||||
- Mathe, Architektur, jede Review-Gate-Session → **Opus**
|
||||
|
||||
## Session-Prompts
|
||||
|
||||
Kaltstartfähige Prompts je Phase/Paket unter `session-prompts/`.
|
||||
Template: `session-prompts/TEMPLATE.md`.
|
||||
|
||||
## Eintrittskriterien
|
||||
Roadmap-Item priorisiert; Klassifikation (Port/Research/Infra) klar;
|
||||
betroffene Konventionen geklärt.
|
||||
|
||||
## Austrittskriterien (Definition of Done, s. CONVENTIONS.md)
|
||||
Tests grün · Manifest `done` · Docs/STATE aktuell · Session-Log ·
|
||||
Review-Gate `APPROVE` · Hygiene-Gate `PASS`.
|
||||
Reference in New Issue
Block a user