Files
jetson-ai-ollama/docs/loops/audit-loop.md
Tarik Moussa efee259d01
Some checks failed
gates / quality (push) Has been cancelled
feat: bootstrap jetson-ai-ollama from agent-swarm template
Leader-Bootstrap (Planung) aus Template + Jetson-Meta-Prompt:
- ROADMAP-Board W1-W6 als Abhaengigkeits-DAG (Ready-Set = {W1})
- STATE mit disjunkter Datei-Ownership W2-W6
- CONVENTIONS Projekt-Vertrag (Profile, Pfade, Ports, Daemon-Env, num_ctx, DVC, Scope)
- manifests/requirements.md = kalt verifizierbares Review-Manifest (R-01..R-10)
- REVIEW.md Kalt-Review-Einstieg; ADR 0002 (Ollama-nativ, kein Swapper/Gateway)
- session-prompts/W1..W6 dispatch-fertig; .gitignore um Jetson-Ignores erweitert
- examples/walkthrough entfernt (Projekt hat eigenes gefuelltes Board)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-03 06:57:40 +02:00

2.0 KiB

Audit-Loop (rückwärts)

Ziel: Korrektheit & Hygiene erhalten, Drift früh fangen.

Kalter Auditor (Opus, neue Session)
  -> Orientierung allein aus AGENTS/STATE/CONVENTIONS pruefen
    -> Manifest verifizieren + Tests ausfuehren
      -> Drift & Hygiene-Befunde sammeln
        -> audits/<datum>.md: Finding-Tabelle mit Severity + Model-Zuweisung
          -> Korrektur-Tasks in ROADMAP/STATE einstellen
            -> Observability-Gate (Effizienz + Doku-Drift) aktualisieren

Trigger

Nach N Feature-Zyklen, oder sofort bei Drift-Signal aus den Observability-Gates.

Finding-Orchestration

Findings werden in audits/<datum>.md mit Model-Zuweisung erfasst:

ID Typ Sev Status Model Session
F-01 drift 🔴 Sonnet S1
F-02 hygiene 🟡 abc123 Haiku S1

Severity: 🔴 hoch · 🟡 mittel · 🔵 niedrig

Model-Routing (s. docs/roles/model-routing.md):

  • Haiku — mechanisch, lokal, kein Risiko (Docs, Umbenennen, Konstanten)
  • Sonnet — klare Akzeptanzkriterien (Tests, Error-Handling, kleine API-Änderungen)
  • Opus — Numerik, Architektur, irreversible Entscheidungen + jede Review-Gate-Session

Entscheidungs-Regel: nicht "wie schwer", sondern "wie viel muss verstanden werden, um es richtig zu machen."

Session-Sequenz

Findings werden in Sessions gebündelt (ähnliche Model-Zuweisung, ähnlicher Scope). Nach jeder Implement-Session kommt eine Opus-Review-Session (kalt, unabhängig):

Implement-Session (Sonnet/Haiku)
  -> dedizierten Review-Gate-Session (Opus, kalt)
    APPROVE → Finding ✅ + Commit-Ref eintragen
    CHANGES-REQUESTED → zurück zu Implement

Kaltstartfähige Prompts für jede Session: session-prompts/.

Ergebnis

Priorisierte Korrektur-Tasks mit Model-Zuweisung, die der nächste Feature-Loop abräumt. Handoff zu Feature-Dev: jedes bereinigte Finding bestätigt, dass das Repo wieder der Clean-Start-Invariante genügt.