01
Hangar de treino
Não é um dashboard. É o chão onde o agente trabalha e o humano segura o merge.
T25 Factory
Os agentes escrevem. O T25 governa.
O T25 é o harness da sua fábrica: os agentes que vocês já pagam escrevem; a fábrica governa. Não mais um agente. Da spec ao pull request, plano, gate, implementação e QA. O go/no-go continua seu.
Os agentes que você já assina.
O T25 chama os CLIs instalados e autenticados na sua máquina, com uma lista de fallback por papel. Sem chave de API nova.
- Claude Code
- Codex
- Cursor
- Gemini
- Kimi
- OpenCode
- Grok
- Pi
- Vibe
02
O agente já escreveu APPROVE.
Isso não é o merge. É o palpite.
03
O veredito do agente não é o merge.
Reconstrução rotulada de TASK-0020. O reviewer já assinou. Aperte APPROVE.
- severity
- high
- category
- correctness
- inScope
- true
- description
- finding in-scope no relatório (amostra rotulada)
O modelo já assinou. A política ainda não leu o array.
Bloqueado pela política
04
Do pedido ao pull request, em camadas.
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
Uma ordem entra. Um pull request sai.
-
01
Spec → plano
O pedido vira critérios verificáveis e fatias de trabalho.
-
02
Gate → implementação
A política libera o agente em um worktree isolado.
-
03
QA → review → PR
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.
-
Você O time
Define prioridade, risco e o merge. O humano continua atrás do portão.
-
T25 A política
evaluateReview, worktree isolado, teto de diff. O APPROVE do modelo não é o merge.
-
CLIs Os agentes
Claude Code, Codex, Cursor, os que você já assina. O T25 governa o veredito deles.
-
Produção O git
Um worktree por ordem, branch feat/TASK-* ou fix/TASK-*, pull request na sua mão.
CLI direto × CLI com T25
| 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 |
05
From the field
O que aprendemos construindo uma fábrica de software.
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.
O que é uma software factory para agentes de código (e o que ela não é)
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.
O APPROVE do modelo não é o merge
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.
Uma ordem, um worktree: isolando agentes de código com git worktree
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.
What is a software factory for AI coding agents (and what it isn't)
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.
The model's APPROVE is not the merge
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.
One task, one worktree: isolating AI coding agents with git worktree
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.
06
Perguntas que aparecem antes do primeiro run.
Não achou a sua? E-mail para [email protected] ou leia a documentação.
Produto
01 O T25 substitui Claude Code, Codex ou Cursor?
Não. O T25 não é mais um agente. É o harness da fábrica: coordena os CLIs que você já usa e acrescenta política, worktree isolado, QA e uma decisão humana antes do merge.
02 Quais CLIs de agente o T25 suporta?
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, a fábrica usa o próximo.
03 Preciso de uma chave de API?
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.
04 O APPROVE do agente faz merge automaticamente?
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.
Código e segurança
05 O código sai da minha máquina?
O T25 é self-hosted. O orquestrador, o banco e os worktrees ficam no ambiente em que você executa a fábrica; o que cada CLI envia ao próprio provedor segue as credenciais e políticas que você configurou.
06 Onde o agente escreve?
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.
07 O que acontece quando o QA ou o review reprovam?
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.
08 E se o agente reescrever meio repositório?
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.
Uso
09 O que eu preciso para rodar?
Node 22, Docker ou um Postgres acessível, e pelo menos um CLI de agente autenticado. Roda em Linux e macOS.
10 Como faço para testar o T25?
Por convite. Estamos montando uma coorte de early evaluators: 30 dias, gratuito, rodando na sua máquina. O código, os prompts e as credenciais não saem do seu ambiente. As inscrições abrem em breve — a página do convite explica o programa.
11 O T25 é open source?
Não. O código não é público. Avaliadores recebem um pacote privado sob os Termos de Avaliação, que proíbem redistribuição, engenharia reversa e uso comercial sem contrato.
12 Como envio feedback ou uma mudança?
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.
07
Instalar na minha máquina
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 — código, prompts e credenciais não saem dela.
# dados do convite de avaliação
export T25_PACKAGE_TARBALL='<url-do-tarball-privado>'
export T25_PACKAGE_SHA256='<sha256-do-tarball>'
bash ./install.sh
t25 init
t25 db up
export DATABASE_URL=postgres://t25:[email protected]:5432/t25
t25 upgrade
t25 doctor --evaluation
t25 servet25 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 é seut25 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 yoursSolicitar convite · Guia de instalação ·
T25 Factory. Roda na sua máquina. Documentação.