user2595/agent-swarm-repo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
35a363500fb7087685a968772aa0368de28f1d48
agent-swarm-repo/AGENTS.md
Tarik Moussa 696eddb5ef
Some checks failed
gates / quality (push) Has been cancelled
Details
feat: initial agent-swarm-repo template 
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.
2026-06-03 06:35:06 +02:00

2.0 KiB
Raw Blame History

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).