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>
2.0 KiB
2.0 KiB
AGENTS.md — Einstiegspunkt für jede Session
Lies dies zuerst. Lies NICHT das ganze Repo. Orientiere dich in dieser Reihenfolge und höre auf, sobald du genug Kontext für deine Aufgabe hast.
Lese-Reihenfolge (klarer Start)
- Dieses Dokument — wer macht was, wo steht was.
STATE.md— wo wir gerade stehen (Now / In Progress / Blocked / Next / offene Audit-Findings). Die einzige Quelle für den aktuellen Stand.CONVENTIONS.md— verbindliche Regeln (Naming, Pfade, Commits, Ownership, Model-Attribution, Review-Gate).- Deine Rollen-Datei —
docs/roles/{leader,worker,reviewer}.md. Welches Modell für welche Arbeit:docs/roles/model-routing.md. - Die relevante Loop-Datei —
docs/loops/{feature,audit}-loop.md. Bei Research-Items:docs/loops/spike-gate.md. - Dein Session-Prompt —
session-prompts/(fertig ausgefüllter Prompt für diese Session — kein Lesen des ganzen Repos nötig). - Nur bei Bedarf:
manifests/requirements.md, betroffene ADRs, Code.
Wo finde ich was?
| Frage | Datei |
|---|---|
| Aktueller Stand / nächster Schritt | STATE.md |
| Regeln & gemeinsamer Vertrag | CONVENTIONS.md |
| Plan / Board / Ready-Set (DAG) | ROADMAP.md |
| Befülltes Beispiel zum Lernen | examples/walkthrough/ |
| Warum wurde X so entschieden | docs/adr/ |
| Anforderung → Datei → Test → Status | manifests/requirements.md |
| Was hat die letzte Session getan | sessions/ (neuester Eintrag) |
| Offene Prüf-Befunde + Model-Zuweisung | audits/ |
| Welches Modell für welche Arbeit | docs/roles/model-routing.md |
| Kaltstartfähige Session-Prompts | session-prompts/ |
| Token-Kosten kontrollieren | docs/token-hygiene.md |
Pflicht am Session-Ende
STATE.mdaktualisieren · Session-Log aussessions/TEMPLATE.mdanlegen (inkl. Token-Verbrauch + Model-Attribution) · betroffene Manifeste/Docs anpassen · Quality-Gate ausführen (scripts/gate-session-hygiene.sh).