Rollen

9 Rollen. Eine Rolle ist eine abgegrenzte Art von Worker; ihr Tier legt fest, wie viel Modellleistung sie bekommt, und .act/tiers.json ordnet Tiers erst bei der Erzeugung konkreten Modellen zu.

builder

Setzt eine abgegrenzte Aufgabe um - Code, Migration, Tests, Konfiguration - und liefert ein Ergebnis samt Beleg; committet nie.

Tier: standard
Reasoning: medium
Werkzeuge: Read, Write, Edit, Bash, Grep, Glob

Setzt eine abgegrenzte Aufgabe um: Code, Migration, Tests, Konfiguration. Wendet R-role-worker an.

Quelle: .act/agents/builder.md

debugger

Sucht die Ursache eines Bugs per Hypothese statt durch Raten; reproduziert zuerst und trennt Symptom von Ursache.

Tier: standard
Reasoning: high
Werkzeuge: Read, Bash, Grep, Glob

Sucht die Ursache eines gemeldeten Bugs, den der Orchestrator beschreibt. Behebt nichts — die Behebung ist ein eigener Auftrag (builder). Wendet R-role-worker an.

Quelle: .act/agents/debugger.md

doc-writer

Pflegt docs/project/ (nie docs/ai/) - arbeitet Befunde in die Projektdoku ein und hält Querverweise und Statusmarken aktuell.

Tier: standard
Reasoning: medium
Werkzeuge: Read, Write, Edit, Grep, Glob, Bash

Pflegt docs/project/ — die Projektdokumentation, nicht den Arbeitsbereich der Zusammenarbeit unter docs/ai/. Wendet R-role-worker an.

Quelle: .act/agents/doc-writer.md

expert-solver

Eskalation mit hohem Reasoning, nur gerufen, wenn ein Worker dieselbe Aufgabe zweimal verfehlt hat oder auf einen unlösbaren Fehler gestoßen ist.

Tier: expert
Reasoning: max
Werkzeuge: Read, Edit, Write, Bash, Grep, Glob

Nur zur Eskalation nach R-role-escalate — gerufen, wenn ein Worker dieselbe Aufgabe zweimal verfehlt hat oder ein Sonderfall einen normalen Worker festhält. Erfahrener Architekt und Problemlöser genau für diesen Fall, nicht für Routine-Implementierung. Wendet R-role-worker an.

Quelle: .act/agents/expert-solver.md

explorer

Lesende Recherche im Code über mehrere Dateien und Verzeichnisse; meldet Befunde mit path:line als Beleg.

Tier: standard
Reasoning: low
Werkzeuge: Read, Grep, Glob, Bash

Lesende Recherche über mehrere Dateien und Verzeichnisse; Befunde mit <path>:<line> belegt. Wendet R-role-worker an.

Quelle: .act/agents/explorer.md

optimizer

Poliert frisch geschriebenen Code auf Kürze und Lesbarkeit - höchstens zwei Runden, kein Algorithmus-Tuning.

Tier: standard
Reasoning: medium
Werkzeuge: Read, Edit, Bash, Grep, Glob

Läuft nach builder, nur über den Code, den dieser Auftrag gerade geschrieben hat — Dateien und Zeilen stehen im Auftrag, nie gewachsener Code von anderswo und nie projektweit. Wendet R-role-worker an.

Quelle: .act/agents/optimizer.md

quick-check

Feste, lesende Abfragen ohne Bewertung (git status, Tests, Dateien, Zeilenzahlen).

Tier: light
Reasoning: none
Werkzeuge: Read, Grep, Glob, Bash

Führt eine feste Reihe lesender Abfragen aus und liefert das rohe Ergebnis, ohne Bewertung. Wendet R-role-worker an.

Quelle: .act/agents/quick-check.md

reviewer

Kritische Prüfung vor einem Commit — Bugs, Stil und Aufgabentreue — sowie ALLOW/BLOCK bei einem markierten Safeguard-Aufruf.

Tier: elevated
Reasoning: high
Werkzeuge: Read, Bash, Grep, Glob

Kritische Prüfung vor einem Commit, dazu ALLOW/BLOCK bei einem markierten Tool-Aufruf. Wendet R-role-worker an.

Quelle: .act/agents/reviewer.md

test-writer

Schreibt Tests zu bestehendem Code oder Test-first allein aus einem Konzept bzw. Interface; prüft Verhalten, nicht Implementierung.

Tier: standard
Reasoning: medium
Werkzeuge: Read, Edit, Write, Bash, Grep, Glob

Schreibt Tests — zu bestehendem Code oder Test-first allein aus einer Konzept- bzw. Interface-Beschreibung — und belegt sie mit einem Testlauf. Wendet R-role-worker an.

Quelle: .act/agents/test-writer.md

Tier-Zuordnung (Claude Code)

Tier	Modell-Alias
`light`	`haiku`
`standard`	`sonnet`
`elevated`	`opus`
`high`	`opus` (Reasoning eine Stufe höher)
`expert`	`fable`