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

2.2 KiB

Raw Blame History

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.

2.2 KiB Raw Blame History