Tarik Moussa
696eddb5ef
Some checks failed
gates / quality (push) Has been cancelled
Generelles Git-Repo-Template fuer KI-Agenten-Arbeit (multi-agent swarm pattern). Enthaelt: - Rollen-System (Leader, Worker, Reviewer) mit Model-Routing-Matrix (Tier-basiert) - Zwei komplementaere Loops: Feature-Loop (vorwaerts) + Audit-Loop (rueckwaerts) - Spike-Gate fuer Research-Items (GO/NO-GO vor Produktionscode) - Obligatorische Opus-Review-Gate nach jeder Implement-Session - Drei ausfuehrbare Gates: session-hygiene, ownership (Cross-Edit-Schutz), doc-drift -- alle dormant bis zur ersten Initialisierung, dann automatisch aktiv - Bootstrap: scripts/init.sh + session-prompts/BOOTSTRAP.md - Worked Example (URL-Shortener-Domaene): Board, Session-Log, Audit-Finding, ADR - Token-Hygiene (3-Tier: Session-Schnitt / Command-Disziplin / Cache-Disziplin) - GitHub Actions CI (gates.yml) laeuft auf jedem Push/PR Muster destilliert aus produktiv-bewaehrten Patterns des ConformalLabpp-Projekts.
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`).
|