feat: initial agent-swarm-repo template
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:
2026-06-03 06:35:06 +02:00
commit 696eddb5ef
40 changed files with 1310 additions and 0 deletions

60
scripts/init.sh Executable file
View File

@@ -0,0 +1,60 @@
#!/usr/bin/env bash
# init.sh — ein Template-Klon zu einem konkreten Projekt machen.
# Nutzung: bash scripts/init.sh "Mein Projektname"
#
# Was passiert:
# - die Template-README wandert nach docs/about-template.md (Methodik bleibt erhalten)
# - eine frische, projektbezogene README.md wird geschrieben
# - falls noch kein Git-Repo: git init
# - die Gates bleiben DORMANT, bis die erste echte Session STATE.md befuellt
# (die Zeile mit '<id / datum>' ersetzt) — danach greifen sie automatisch.
#
# Naechster Schritt nach init: session-prompts/BOOTSTRAP.md in eine frische
# Leader-Session geben, zusammen mit deinem Projekt-Brief.
set -euo pipefail
name="${1:-}"
if [ -z "$name" ]; then
echo "Nutzung: bash scripts/init.sh \"Projektname\"" >&2
exit 2
fi
[ -f AGENTS.md ] || { echo "Bitte aus dem Repo-Root ausfuehren (AGENTS.md nicht gefunden)." >&2; exit 1; }
if [ -f docs/about-template.md ]; then
echo "Bereits initialisiert (docs/about-template.md existiert). Abbruch." >&2
exit 1
fi
# 1) Template-README bewahren, frische Projekt-README schreiben.
git mv README.md docs/about-template.md 2>/dev/null || mv README.md docs/about-template.md
cat > README.md <<EOF
# ${name}
> Arbeitet nach dem **agent-swarm**-Betriebsmodell. Jeder Agent (Mensch wie KI)
> liest zuerst [\`AGENTS.md\`](AGENTS.md). Methodik im Detail:
> [\`docs/methodology.md\`](docs/methodology.md). Herkunft des Modells:
> [\`docs/about-template.md\`](docs/about-template.md).
## Schnellstart
- **Stand & nächster Schritt:** [\`STATE.md\`](STATE.md)
- **Plan / Ready-Set:** [\`ROADMAP.md\`](ROADMAP.md)
- **Regeln:** [\`CONVENTIONS.md\`](CONVENTIONS.md)
- **Neues Feature anstoßen:** [\`session-prompts/BOOTSTRAP.md\`](session-prompts/BOOTSTRAP.md)
EOF
# 2) Git initialisieren, falls noetig.
if ! git rev-parse --git-dir >/dev/null 2>&1; then
git init -q
echo "[init] leeres Git-Repo angelegt."
fi
echo "[init] '${name}' initialisiert."
echo "[init] Template-Overview liegt jetzt unter docs/about-template.md."
echo
echo "Naechster Schritt:"
echo " 1) Projekt-Brief bereithalten (Ziel, Stack, Constraints)."
echo " 2) session-prompts/BOOTSTRAP.md in eine frische Session geben (Modell: Sonnet)."
echo " 3) Der Leader fuellt ROADMAP/STATE/CONVENTIONS und erzeugt die ersten Session-Prompts."
echo
echo "Die Gates sind dormant, bis die erste Session STATE.md befuellt."