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

58
docs/about-template.md Normal file
View File

@@ -0,0 +1,58 @@
# agent-swarm-repo
Ein **generelles Git-Repo-Template für KI-Agenten-Arbeit**. Das Repo ist die
*dauerhafte gemeinsame Erinnerung* — Sessions sind flüchtig, der Stand lebt in den
Dateien. Agenten koordinieren über Dateien, nicht über den Chat.
## Aktoren & Modelle
| Rolle | Modell | Aufgabe |
|---|---|---|
| Leader | Sonnet | Orchestrierung, Klassifikation, Integration |
| Worker / Porter | Sonnet | Implementierung mit klarer Spec, faithful Ports |
| Theorist | Opus | Formeln ableiten, Validation entwerfen |
| Prototyper (Spike) | Opus→Sonnet | Wegwerf Proof-of-Correctness vor Produktion |
| Reviewer (Gate) | **Opus, immer** | unabhängiger Review-Pass nach jedem Implement |
| Scholar / Doc | Haiku | Docs, Citations, CLI-Glue |
| Human | — | Richtung, Lizenz, Precision-Substrat, Freigabe |
Vollständige Matrix + Entscheidungsregel: `docs/roles/model-routing.md`.
## Zwei Loops (komposit)
- **Feature-Loop (vorwärts):** Roadmap → Port/Research-Klassifikation →
[Research: Theorist → Spike → GO/NO-GO] → Worker parallel → Review-Gate (Opus) →
Integration → Tests + Doku + Manifest → Quality-Gate.
- **Audit-Loop (rückwärts):** kalter Auditor (Opus) → Findings mit Model-Zuweisung →
Implement-Sessions → Review-Gate (Opus, kalt) → Korrektur-Tasks → Observability-Gate.
Die Loops komplementieren sich: Feature-Dev produziert, Audit härtet ab.
Jedes Merge triggert einen Audit-Backlog-Eintrag (expliziter Handoff).
## Drei Schlüsselprinzipien
1. **Review-Gate nach jeder Implement-Session** — immer Opus, immer kalt (eigene
Session). Implement-Modell ≠ Review-Modell ist eine Korrektheitseigenschaft.
2. **Spike vor Research-Code** — throwaway Proof-of-Correctness auf einem Wegwerf-Branch.
NO-GO ist ein valides Ergebnis, kein Versagen. Schützt vor wochen-langen falschen Implementierungen.
3. **Session-Prompts kaltstartfähig** — jede Session hat einen vollständigen Prompt
unter `session-prompts/` (Modell, Branch, Scope, Befehle, Akzeptanzkriterien).
## Clean-Start-Invariante
Am Ende **jeder** Session muss gelten: ein neuer Agent kann sich allein über
`AGENTS.md → STATE.md → CONVENTIONS.md` orientieren. Das erzwingt das
Session-Hygiene-Gate.
## Loslegen (neues Projekt)
1. `bash scripts/init.sh "Projektname"` — macht den Klon zu deinem Projekt
(Template-Overview wandert nach `docs/about-template.md`).
2. `session-prompts/BOOTSTRAP.md` in eine frische Leader-Session geben, Projekt-Brief
anhängen → der Leader füllt Board (`ROADMAP.md`), `STATE.md`, `CONVENTIONS.md`
und erzeugt die ersten Session-Prompts.
3. Die Gates sind **dormant**, bis die erste Session `STATE.md` befüllt — danach greifen sie automatisch.
> **Erst verstehen?** `examples/walkthrough/` zeigt ein komplett befülltes Beispiel
> (Board, Session-Log, Audit-Finding, ADR) an einer generischen Domäne.
## Einstieg (jede Session)
Jeder Agent liest zuerst **`AGENTS.md`**. Methodik im Detail: `docs/methodology.md`.