feat: bootstrap jetson-ai-ollama from agent-swarm template
Some checks failed
gates / quality (push) Has been cancelled

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>
This commit is contained in:
2026-06-03 06:55:39 +02:00
commit efee259d01
43 changed files with 1563 additions and 0 deletions

48
docs/methodology.md Normal file
View File

@@ -0,0 +1,48 @@
# 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`.