PT EN
Instalar

A fábrica inteira cabe em um arquivo.

O t25.yaml diz quem executa cada papel, até onde uma ordem pode ir e onde ela para. Ele fica no seu repositório, junto com o código.

fig. 1: trechos do t25.yaml do repositório do T25, lidos no build desta página

Uma lista de preferência por papel: o primeiro CLI disponível assume. Se ele faltar, o próximo entra.

routing:
analyst: [codex, pi]Conversa de negócio, antes de a ordem existir.
triage: [codex, pi]Tipo, risco e escopo da ordem.
planner: [codex, pi]Spec e plano.
research: [codex, pi]Contexto do repositório.
dev-frontend: [codex, pi]Implementação na worktree da ordem.
dev-backend: [codex, pi]Implementação na worktree da ordem.
qa-frontend: [codex, pi]Navegador, testes e veredito.
qa-backend: [codex, pi]Testes e veredito.
reviewer: [codex, pi]Leitura do diff.
security: [codex, pi]Segredos, dependências e riscos.
docs: [codex, pi]Documentação.
release: [codex, pi]Prepara o pull request.

Onde a fábrica para, por nível de risco. Com sandbox: docker, implementação e QA rodam num container.

risk:
low: { approval: none, sandbox: docker }PR automático, sem merge.
medium: { approval: plan, sandbox: docker }Você aprova o plano.
high: { approval: plan_and_pr, sandbox: docker }Você aprova o plano e o PR.
critical: { approval: human_required, sandbox: docker }Nunca automatiza deploy.

O freio contra o agente que não para.

limits:
max_same_error_retries: 2Errou igual duas vezes? Volta para você.
max_files_changed: 40Limite de arquivos alterados por ordem.
max_diff_lines: 2000Limite de linhas alteradas por ordem.

Orçamento por ordem e por dia.

cost:
defaultBudgetUsd: 5Teto de cada ordem, em dólares.
periodBudgetUsd: 0Teto do dia (UTC). Zero desliga.
warnRatio: 0.8Avisa ao chegar em 80% do teto.
stop: pauseNo teto, a ordem pausa e não perde o trabalho.

O comportamento geral da fábrica.

t25:
worktrees_dir: .t25/worktreesCada ordem em sua própria worktree.
max_task_minutes: 60Tempo máximo de um estágio, salvo override por papel.
require_plan_approval: trueGate humano antes de liberar o build.

Doze papéis, cada um com o seu agente.

Cada papel tem a sua lista de fallback, o seu modelo e o seu esforço. A QA pode rodar num agente diferente de quem escreveu o código.

analyst, triage
Entendem o pedido e definem tipo, risco e escopo.
planner, research
Escrevem a spec e o plano a partir do contexto do repositório.
dev-frontend, dev-backend
Implementam na worktree isolada da ordem.
qa-frontend, qa-backend
Exercitam a entrega e dão o veredito.
reviewer, security
Leem o diff em busca de defeito e de risco.
docs, release
Atualizam a documentação e preparam o pull request.

Prefere a tela? O cockpit edita os mesmos papéis.

Referência completa