Tarik Moussa
efee259d01
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>
39 lines
2.0 KiB
Markdown
39 lines
2.0 KiB
Markdown
# 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)
|
|
1. **Dieses Dokument** — wer macht was, wo steht was.
|
|
2. **`STATE.md`** — *wo wir gerade stehen* (Now / In Progress / Blocked / Next /
|
|
offene Audit-Findings). Die einzige Quelle für den aktuellen Stand.
|
|
3. **`CONVENTIONS.md`** — verbindliche Regeln (Naming, Pfade, Commits, Ownership,
|
|
Model-Attribution, Review-Gate).
|
|
4. **Deine Rollen-Datei** — `docs/roles/{leader,worker,reviewer}.md`.
|
|
Welches Modell für welche Arbeit: `docs/roles/model-routing.md`.
|
|
5. **Die relevante Loop-Datei** — `docs/loops/{feature,audit}-loop.md`.
|
|
Bei Research-Items: `docs/loops/spike-gate.md`.
|
|
6. **Dein Session-Prompt** — `session-prompts/` (fertig ausgefüllter Prompt für
|
|
diese Session — kein Lesen des ganzen Repos nötig).
|
|
7. 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.md` aktualisieren · Session-Log aus `sessions/TEMPLATE.md` anlegen
|
|
(inkl. **Token-Verbrauch** + Model-Attribution) · betroffene Manifeste/Docs anpassen ·
|
|
Quality-Gate ausführen (`scripts/gate-session-hygiene.sh`).
|