Files
jetson-ai-ollama/docs/methodology.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.2 KiB

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.