Tiers und Reasoning
Jede Worker-Rolle hat einen Tier (wie viel Modellkapazität) und eine Reasoning-Stufe (wie viel sie vor der Antwort nachdenkt). Beides steht in einer werkzeugneutralen Skala in der Definition der Rolle. Ein echter Modellname erscheint nur in .act/tiers.json und wird angewendet, wenn die Datei der Rolle für dein Werkzeug erzeugt wird.
| Tier | Gedacht für | Standard-Cap (Tool-Aufrufe) |
|---|---|---|
light |
Lesen und Zählen | 10 |
standard |
Implementierung | 40 |
elevated |
Review und Sicherheitsurteil | 60 |
high |
eine Aufgabe, die mehr Reasoning braucht als elevated |
80 |
expert |
Eskalation nach zwei gescheiterten Versuchen an einer Aufgabe | 80 |
Für Claude Code ordnet .act/tiers.json light Haiku zu, standard Sonnet, elevated und high Opus (high mit einer Stufe mehr Reasoning) und expert dem Spitzenmodell. Für Copilot gibt die Tabelle copilot in derselben Datei jedem Tier eine geordnete Modellliste, und das erste Modell, das dein Abo anbietet, gewinnt: light claude-haiku-5.5, dann claude-haiku-4.5; standard claude-sonnet-5.5; elevated und high claude-opus-5.5, dann claude-sonnet-5.5 (high wieder mit einer Stufe mehr Reasoning); expert claude-fable-5.2, dann claude-opus-5.5. Das Reasoning kommt ins Feld reasoning-effort. Andere Werkzeuge haben noch keine Zuordnung; bei ihnen behalten die erzeugten Dateien das Modell, das sie schon haben.
Die Reasoning-Skala lautet low, medium, high, xhigh, max. Daneben kann eine Rolle default sagen: Es wird keine Effort-Zeile geschrieben, es gilt die Stufe des Werkzeugs; für eine -high-Variante zählt sie als medium. Ein älteres none in der Rollen-Tabelle oder einer lokalen Rollen- oder Skill-Datei wird als default gelesen, und act-doctor nennt jede Stelle.
Pro Rolle
Abschnitt betitelt „Pro Rolle“| Rolle | Tier | Reasoning |
|---|---|---|
quick-check |
light |
default |
explorer |
standard |
low |
builder, doc-writer, test-writer, optimizer |
standard |
medium |
debugger |
standard |
high |
reviewer |
elevated |
high |
expert-solver |
expert |
max |
Die Rollenreferenz wird aus dem Template erzeugt und ist immer aktuell; was jede Rolle tut, steht unter Rollen.
Die -high-Varianten
Abschnitt betitelt „Die -high-Varianten“Neben .claude/agents/<role>.md (mit Copilot auch .github/agents/<role>.agent.md) erzeugt das Template für builder und reviewer .claude/agents/<role>-high.md (.github/agents/<role>-high.agent.md): dieselbe Rolle mit dem Reasoning eine Stufe weiter oben auf der Skala. Der Assistent nennt die -high-Variante für einen einzelnen Auftrag, der mehr Nachdenken braucht, ohne die Rolle dauerhaft anzuheben. Die anderen Rollen der Vorlage haben keine Variante, ebenso wenig eine Rolle, die schon an der Spitze der Skala steht (expert-solver); ein Update entfernt früher erzeugte Varianten dieser Rollen. Eine Rolle auf default bekommt in ihrer Variante high. Eine eigene Rolle des Projekts behält ihre Variante. Ein Auftrag, der eine entfernte Variante nannte, nennt die Rolle selbst oder builder-high bzw. reviewer-high.
Eine Rolle überschreiben
Abschnitt betitelt „Eine Rolle überschreiben“Die Tabelle Roles am Ende von docs/ai/config.md ist standardmäßig leer. Fülle eine Zeile, um eine Rolle zu ändern:
| Role | Tier | Reasoning | Model | Copilot || :--- | :--- | :--- | :--- | :--- || builder | elevated | high | | |Tier und Reasoning überschreiben die Werte des Templates; ein gefülltes Model legt das Modell direkt fest und gewinnt gegenüber Tier, gilt aber nur für Claude Code. Copilot nimmt eine kommagetrennte Prioritätsliste von Copilot-Modell-IDs für die Datei der Rolle unter .github/agents/; das erste Modell, das dein Abo anbietet, wird genommen, und eine gefüllte Zelle gewinnt dort gegenüber Tier. Eine Tabelle mit vier Spalten bleibt gültig; nach einer Änderung der Spalte Copilot führst du python .act/scripts/update.py --catch-up --yes aus. Die eigene Rolle eines Projekts (siehe Eigene Regeln, Skills und Rollen) wird dort auf dieselbe Weise benannt. Die erzeugten Dateien werden beim Sitzungsstart und bei jedem Update aufgefrischt; angefasst werden nur ihre Zeilen model und effort (bei Copilot model, models und reasoning-effort), nie deine eigenen Ergänzungen im Text der Rolle.
Reasoning pro Skill
Abschnitt betitelt „Reasoning pro Skill“Ein Skill kann im Frontmatter reasoning: <level> tragen (ein Wert der obigen Skala), um diese Denkstufe für die Dauer seines Laufs anzufordern. In der Claude-Code-Kopie unter .claude/skills/ wird daraus die Zeile effort:; die Spiegelung unter .agents/skills/ bleibt unverändert, und ein Skill ohne den Schlüssel erbt die Sitzung. Um sie für ein Projekt zu ändern, trägst du in der Tabelle Roles eine Zeile ein, die den Skill in der Spalte Role nennt (zum Beispiel act-prepare); dort zählt nur Reasoning.
Jeder Auftrag an einen Worker nennt sein Tier, eine Schätzung und einen Cap für Tool-Aufrufe (Cap: <n>). Die Schätzung steht in Minuten und tkn, nie in Personentagen: ~<n> min · ~<n> tkn fresh · ~<n> tkn cache samt der Annahme dahinter. act-idea, act-prepare und der Assistent stützen sie auf usage.py --estimates, wo Messwerte vorliegen (siehe Rollen). Die Prüfung worker-cap erzwingt ihn mechanisch: Der Worker bekommt beim Erreichen des Caps einen Hinweis und wird ab dem 1,5-fachen Cap abgewiesen. Ohne Zeile Cap: gilt der Standard des Tiers (Tabelle oben): das Tier, das eine Zeile Tier: nennt, sonst das der Rolle (quick-check light, reviewer elevated, expert-solver expert, jede andere Rolle standard, eine -high-Variante wie ihre Basisrolle); ein für die Rolle in der Rollen-Tabelle von docs/ai/config.md gesetztes Tier ersetzt diesen Rollenstandard.
Der Assistent vermerkt nach jedem Ergebnis, ob es angenommen, nachgearbeitet oder eskaliert wurde; eine Nacharbeit oder Eskalation trägt einen Grund: assignment (der Auftrag war unklar), edge-case (ein Grenzfall fehlte), worker (der Worker hat sich geirrt) oder decision (der Orchestrator hat seine eigene Entscheidung geändert). Nur Ergebnisse ohne Grund oder mit worker kommen in das folgende Fenster, denn ein höheres Tier hätte die übrigen nicht vermieden; usage.py --show listet die festgehaltenen Gründe auf. doctor.py --inbox betrachtet die letzten 30 Ergebnisse einer Rolle bei einem Tier und schlägt ein höheres Tier erst vor, wenn 30 vorliegen und mindestens 60 % (18 von 30) nachgearbeitet oder eskaliert wurden; ältere Ergebnisse fallen aus dem Fenster (usage.py --outcome hält ihre Reihenfolge in .act-local/usage.json). Der Vorschlag ist eine eigene Inbox-Frage mit kurzem Hinweis; die Zahlen (der Befund, die Ergebnisse je Rolle und Tier, die Kosten eines höheren Tiers) stehen in einem Inbox-Report, den doctor.py unmittelbar davor schreibt. Die Optionen sind a) erst die Fälle ansehen, wie bei jeder Frage mit **Empfehlung:** markiert (bei language-docs: en **Recommended:**), b) das Tier anheben, c) es lassen. Einen niedrigeren schlägt er nie vor: Angenommene Ergebnisse zeigen nicht, dass ein günstigeres Tier es ebenso gut gemacht hätte. Es ist immer nur ein Vorschlag, nie eine Änderung im laufenden Betrieb; du entscheidest. Ein angelegter Vorschlag kommt auch am selben Tag nicht wieder, bis mindestens 30 weitere Ergebnisse für diese Rolle und dieses Tier vorliegen, und dann nur, wenn weiterhin 60 % der letzten 30 nachgearbeitet oder eskaliert sind.