02
Hangar de treino
Não é um dashboard. É o chão onde o agente trabalha e o humano segura o merge.
T25
O T25 é o harness: os agentes que vocês já pagam escrevem; o T25 governa. Não mais um agente. Da spec ao pull request, plano, gate, implementação e QA. O go/no-go continua seu.
3 esperando você
A fábrica parou no gate, como a política manda. Risco baixo segue direto.
O T25 chama os CLIs instalados e autenticados na sua máquina, com uma lista de fallback por papel. Sem chave de API nova.
01
Você não precisa chegar com um backlog pronto. O T25 lê o projeto, explica com evidência o que encontrou e sugere trabalho. Nada vira issue sem o seu aceite.
Stack, scripts, testes, histórico e issues abertas, cada fato com a evidência ao lado. O que ela não sabe aparece como “não sei”.
O que você corrigir fica guardado e não some na próxima varredura. Se o projeto mudar, ela avisa da divergência.
Candidatos com evidência, sem nada criado ainda. Aceitar abre a issue. Descartar não deixa rastro no GitHub.
Spec, plano, implementação, QA e review em worktree isolada, com o progresso comentado na issue. O merge é seu.
02
Não é um dashboard. É o chão onde o agente trabalha e o humano segura o merge.
03
Isso não é o merge. É o palpite.
04
Reconstrução rotulada de TASK-0020. O reviewer já assinou. Aperte APPROVE.
O modelo já assinou. A política ainda não leu o array.
Bloqueado pela política
05
T25 não é mais um agente. É o harness entre você e os CLIs que já paga: política, worktree, merge na sua mão.
o percurso de uma ordem
O pedido vira critérios verificáveis e fatias de trabalho.
A política libera o agente em um worktree isolado.
O resultado é provado, revisado e chega à sua decisão.
O T25 é o harness do percurso: os agentes escrevem; o go/no-go fica na sua mão.
Define prioridade, risco e o merge. O humano continua atrás do portão.
evaluateReview, worktree isolado, teto de diff. O APPROVE do modelo não é o merge.
Claude Code, Codex, Cursor, os que você já assina. O T25 governa o veredito deles.
Um worktree por ordem, branch feat/TASK-* ou fix/TASK-*, pull request na sua mão.
| Na prática | CLI direto | CLI com T25 |
|---|---|---|
| Onde o agente escreve | No seu checkout | Um worktree e um branch por ordem |
| Plano antes do código | Se você pedir | Spec aprovada por você, plano com gate por risco |
| QA reprovou | Você lê o terminal | Veredito PASS/FAIL devolve para implementação |
| Review escreveu APPROVE | Vale o que o modelo disse | evaluateReview() recalcula pelos findings |
| Agente que não para | Você percebe no diff | Teto de arquivos, linhas e duplicação |
| Merge na main | Depende de disciplina | Sempre humano, depois dos checks |
06
Quem faz o quê, quanto pode gastar e onde parar. Versionado junto com o seu código.
t25.yaml
routing:Quem executa cada papel. A lista é uma ordem de preferência: o primeiro disponível assume. planner: [codex, pi]Doze papéis, do analista ao release. dev-backend: [codex, pi]Se um CLI faltar, o próximo entra, sem você intervir. qa-frontend: [codex, pi]Cada papel tem a própria lista, com o agente e a ordem que você escolher.t25.yaml
risk:Onde a fábrica para, por nível de risco. low: { approval: none }PR automático, sem merge. medium: { approval: plan }Você aprova o plano. high: { approval: plan_and_pr }Você aprova o plano e o PR. critical: { approval: human_required }Nunca automatiza deploy.t25.yaml
limits:O freio contra o agente que não para. max_files_changed: 40Limite de arquivos alterados por ordem. max_diff_lines: 2000O mesmo para linhas alteradas. max_same_error_retries: 2Errou igual duas vezes? Volta para você.t25.yaml
cost:Orçamento por ordem. defaultBudgetUsd: 5Teto de cada ordem. warnRatio: 0.8Avisa ao chegar em 80% do teto. stop: pauseNo teto, a ordem pausa e não perde o trabalho.07
Sem evidência, a ordem não sobe. Quando a prova não existe, a fábrica para e pergunta, e não inventa.
fig. 2: o laço de qualidade
FAIL em QA ou REVIEW devolve para IMPLEMENTING, com os achados. O limite de repetições leva a ordem de volta para você.
Cada critério de aceite vira verificação: comando, interface ou valor esperado.
Scripts aprovados rodam contra o head real da entrega, com a saída guardada como artefato.
Veredito, exercício de interface e par antes e depois vão no corpo do pull request.
08
Nove CLIs suportados, instalados e autenticados por você, com fallback por papel.
Modelo e esforço por papel. O planejador não precisa ser o mesmo que escreve o código.
Orquestrador, Postgres e worktrees no seu computador ou servidor. Implementação e QA em sandbox Docker, quando a política de risco pede.
O T25 não coleta código, prompts, logs nem credenciais. Os CLIs falam com os provedores deles, na sua conta.
09
From the field
Engenharia, guias e bugs reais de quem coordena agentes, protege o repositório e transforma uma ordem em trabalho revisável. Em português e em inglês.
Software factory para agentes de código é a camada que leva uma tarefa da spec ao pull request com estados, gates, worktree isolado e QA. Veja como funciona e onde ela difere de um agente sozinho.
Um agente de code review escreve APPROVE, mas quem decide o merge? Veja como o T25 recalcula o veredito a partir dos findings, o bug que nos ensinou isso e como montar um gate humano que não depende do modelo.
Como usar git worktree para isolar agentes de código como Claude Code e Codex, uma tarefa por worktree. Os guards de caminho, dono, lock e limpeza que o T25 usa, e os erros que eles evitam.
A software factory for AI coding agents takes a task from spec to pull request through fixed states, approval gates, isolated git worktrees and QA. How it works, and how it differs from running one agent on its own.
An AI code review agent writes APPROVE, but who decides the merge? How T25 recomputes the verdict from findings, the bug that taught us to, and how to build a human gate that doesn't depend on the model.
How to use git worktree to isolate AI coding agents like Claude Code and Codex, one task per worktree. The path, ownership, lock and cleanup guards T25 uses, and the mistakes they prevent.
10
Não achou a sua? E-mail para [email protected] ou leia a documentação.
Não. O T25 não é mais um agente. É o harness: coordena os CLIs que você já usa e acrescenta política, worktree isolado, QA e uma decisão humana antes do merge.
Claude Code, Codex, Cursor, Gemini, Kimi, OpenCode, Grok, Pi e Vibe. Cada papel (planner, dev, QA, reviewer) tem uma lista de preferência: se o primeiro CLI não estiver instalado ou autenticado, o T25 usa o próximo. O Cursor é suportado pelo adapter cursor, que executa o comando cursor-agent. Instale o comando e deixe-o disponível no PATH do ambiente onde o T25 roda.
Não. O T25 chama os CLIs já autenticados na sua máquina, então usa a assinatura que você já paga em cada ferramenta.
Não. O veredito do modelo é um sinal. O T25 recalcula o resultado do review a partir dos findings, e o merge continua sendo uma decisão explícita do time, depois dos checks obrigatórios.
O T25 é self-hosted. O orquestrador, o banco e os worktrees ficam no ambiente em que você executa o T25; o que cada CLI envia ao próprio provedor segue as credenciais e políticas que você configurou. Se você abre PRs com gh, o repositório também é enviado ao seu GitHub.
Num git worktree próprio da ordem, num branch como feat/TASK-0042. Nenhum agente de implementação roda no seu checkout principal, e a limpeza se recusa a apagar trabalho não commitado.
A ordem volta para implementação com os findings anexados. Findings fora do escopo do plano ficam registrados sem virar retrabalho, e um teto de tentativas impede loop infinito.
Depois da implementação, o T25 mede o diff contra limites configuráveis de arquivos alterados, linhas de diff e linhas duplicadas. Passou do teto, a ordem falha em vez de seguir para o pull request.
Node 22, Docker ou um Postgres acessível, e pelo menos um CLI de agente autenticado. Roda em Linux e macOS.
Por convite. Estamos montando uma coorte de early evaluators: 30 dias, gratuito, rodando na sua máquina. A T25 não coleta seu código, prompts, logs nem credenciais; não há coletor nem telemetria ativa por padrão. Os CLIs de agente enviam dados aos provedores deles, na sua conta e conforme as políticas de cada provedor. As inscrições abrem em breve — a página do convite explica o programa.
Não. Nenhuma licença é concedida. O código não é público. Usar, copiar ou clonar exige licença escrita do titular.
Envie feedback pelo canal indicado no convite — o e-mail [email protected]. Para vulnerabilidades, escreva para [email protected]. Não recebemos issues nem pull requests pelo repositório.
11
O acesso é por convite: um link pessoal de download chega por e-mail. O instalador verifica o checksum do pacote, o t25 doctor --evaluation valida o ambiente e a primeira ordem está a minutos. Gratuito durante os 30 dias do programa. Roda na sua máquina. A T25 não coleta seu código, prompts, logs nem credenciais; não há coletor nem telemetria ativa por padrão. Os CLIs de agente enviam dados aos provedores deles, na sua conta e conforme as políticas de cada provedor.
# dados do convite de avaliação
export T25_PACKAGE_TARBALL='<url-do-tarball-privado>'
export T25_PACKAGE_SHA256='<sha256-do-tarball>'
curl -fsSL https://raw.githubusercontent.com/ai-t25/t25-factory/main/scripts/install.sh | bash
t25 create "Adicionar retry com backoff no cliente HTTP"
exemplo · os estados são os reais, a ordem é ilustrativa
RECEIVED ordem registrada
SPEC critérios de aceite t25 spec-approve TASK-0042
PLAN plano em fatias
AWAITING_APPROVAL risco médio: plano t25 approve TASK-0042
IMPLEMENTING worktree feat/TASK-0042
QA veredito PASS
REVIEW evaluateReview() sem finding em escopo
PR_OPEN pull request aberto · o merge é seu
t25 create "Add retry with backoff to the HTTP client"
example · the states are real, the task is illustrative
RECEIVED task registered
SPEC acceptance criteria t25 spec-approve TASK-0042
PLAN plan in slices
AWAITING_APPROVAL medium risk: plan t25 approve TASK-0042
IMPLEMENTING worktree feat/TASK-0042
QA verdict PASS
REVIEW evaluateReview() no in-scope finding
PR_OPEN pull request open · the merge is yours
# Setup manual
t25 init
t25 db up
export DATABASE_URL=postgresql://t25:[email protected]:5432/t25
t25 upgrade
t25 doctor --evaluation
t25 serve
Solicitar convite · Guia de instalação
T25. Roda na sua máquina. Documentação.