Workflows
Kern-Abläufe der Agentik-Infrastruktur als Diagramm — Kästen sind Schritte, Pfeile zeigen den Ablauf.
Spec-Driven Development + Zwei-Agenten-TDD
Der volle Weg von der Anforderung bis zum reviewbereiten Diff, für nicht-triviale oder mehrdateiige Features (siehe .claude/rules/spec-driven-development.md).
Specspec-Skill: Problem/Ziel, User Stories, Akzeptanzkriterien, Out of Scope.
Freigabe (Konrad)Menschliches Review-Gate — ohne Freigabe kein Übergang zum Plan.
Planplanner-Agent: Datei-für-Datei-Plan inkl. Interfaces & Contracts.
Freigabe (Konrad)Zweites Gate vor Implementierung.
Rot: testerSchreibt fehlschlagende Tests aus Spec-Kriterien + Plan-Kontrakten.
Grün: implementerVerifiziert den Rot-Grund, implementiert exakt gegen die Kontrakte.
Quality-Gateslint/typecheck/test/build des Projekts — grün ist Pflicht.
reviewerPrüft gegen die Akzeptanzkriterien der Spec.
security (bedingt)Nur bei Auth/Backend/Datenverarbeitung.
docsREADME/CHANGELOG/Docblocks bei nutzersichtbaren Änderungen.
commit-SkillKonrad entscheidet — kein automatischer Commit.
Globales TDD-Gate (tdd-gate.sh)
Blockiert git commit ohne grünen Testlauf und gh pr create ohne grüne Gates, seit der letzten Code-Änderung — automatisch durchgesetzt, nicht nur als Konvention.
Edit/Write/MultiEditCode-Datei geändert (Doku/specs zählt nicht als "dirty").
PostToolUse: dirty markierenLegt .git/claude-{tdd,lint,typecheck}-dirty an.
Testlauf (Bash)npm test / phpunit / pytest o. ä.
PostToolUse: dirty löschenNur bei Erfolg (exit 0) wird der jeweilige Marker entfernt.
git commit (PreToolUse)Prüft Marker vor der Ausführung.
BLOCKED (exit 2)Commit wird verweigert, Grund wird ausgegeben.
Commit erlaubtKein offener dirty-Marker → Ausführung geht durch.
Dashboard-Sync (dieses Dashboard)
Wie dieses Dashboard selbst automatisch aktuell bleibt, ohne main direkt zu committen und ohne Redeploy pro Datenupdate.
Relevante ÄnderungEdit/Write unter ~/.claude/{agents,skills,rules,hooks} oder ein git commit in einem Workspace-Repo.
PostToolUse: dashboard-dirty markiereninfra-dashboard-sync.sh setzt einen Marker.
Stop-Hook (async)Läuft am Ende jeder Session/Runde.
Marker + Throttle prüfenNur wenn dirty UND letzter Sync ≥10min her.
generate-snapshot.tsScannt Repos, Agents, Skills, Rules, Hooks, lokale TDD-Gate-Logs, CI-Status.
Commit auf data-BranchSeparater persistenter Klon, NICHT der main-Arbeitsbaum.
git pushAuf den bot-only data-Branch dieses Repos.
App: fetch zur LaufzeitNext.js liest raw GitHub Content mit revalidate — kein Redeploy nötig.
Parallele Agenten mit Worktrees
Wie mehrere code-schreibende Subagents gleichzeitig arbeiten, ohne sich gegenseitig Dateien zu überschreiben.
Multi-Task-AnfrageMehrere unabhängige Slices eines Features oder mehrere Aufgaben gleichzeitig.
Agent-Tool mit isolation: worktreeJeder Subagent bekommt einen eigenen Arbeitsbaum.
Worktree AEigener Branch, eigenes Rot-Grün-Refactor.
Worktree BEigener Branch, eigenes Rot-Grün-Refactor.
Ergebnisse integrierenUnveränderte Worktrees werden automatisch aufgeräumt.