Files

gates / quality (push) Has been cancelled

Details

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.

2026-06-03 06:35:06 +02:00

3.0 KiB

Raw Permalink Blame History

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.

3.0 KiB Raw Permalink Blame History