feat: initial agent-swarm-repo template
Some checks failed
gates / quality (push) Has been cancelled
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.
This commit is contained in:
38
AGENTS.md
Normal file
38
AGENTS.md
Normal file
@@ -0,0 +1,38 @@
|
||||
# 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`).
|
||||
Reference in New Issue
Block a user