Tarik Moussa
696eddb5ef
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.
63 lines
3.0 KiB
Markdown
63 lines
3.0 KiB
Markdown
# 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`.
|