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
Didn't find yours? E-mail para [email protected] or read the documentation.
No. T25 is not another agent. It is the harness: it coordinates the CLIs you already use and adds policy, an isolated worktree, QA and a human decision before the merge.
Claude Code, Codex, Cursor, Gemini, Kimi, OpenCode, Grok, Pi and Vibe. Each role (planner, dev, QA, reviewer) has a preference list: if the first CLI isn't installed or signed in, T25 uses the next one. Cursor is supported through the cursor adapter, which runs the cursor-agent command. Install the command and make it available on the PATH of the environment where T25 runs.
No. T25 calls the CLIs already signed in on your machine, so it runs on the subscription you already pay for with each tool.
No. The model's verdict is a signal. T25 recomputes the review outcome from the findings, and the merge stays an explicit team decision, after the required checks.
The orchestrator, database and worktrees run in your environment, and T25 does not collect your code, prompts, logs or credentials. No collector or telemetry is active by default. Agent CLIs still send data to their providers under your account and subject to each provider’s policies; gh can send the repository to GitHub when you create PRs.
In a git worktree of its own for the task, on a branch like feat/TASK-0042. No implementation agent runs in your main checkout, and cleanup refuses to delete uncommitted work.
The task goes back to implementation with the findings attached. Findings outside the plan's scope are recorded without turning into rework, and a retry limit prevents an endless loop.
After implementation, T25 measures the diff against configurable limits on changed files, diff lines and duplicated lines. Past the limit, the task fails instead of moving on to a pull request.
Node 22, Docker or a reachable Postgres, and at least one signed-in agent CLI. Runs on Linux and macOS.
By invite. We're putting together a 30-day, free early evaluators cohort running on your machine. T25 does not collect your code, prompts, logs or credentials; no collector or telemetry is active by default. Agent CLIs send data to their providers under your account and subject to each provider’s policies. Sign-ups open soon — the invite page explains the program.
No. No license is granted. The code is not public. Use, copying, or cloning requires a written license from the copyright holder.
Send feedback through the channel indicated in your invite — the [email protected] e-mail. For vulnerabilities, write to [email protected]. We do not accept issues or pull requests through the repository.
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.
# evaluation invite data
export T25_PACKAGE_TARBALL='<private-tarball-url>'
export T25_PACKAGE_SHA256='<tarball-sha256>'
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
# Manual setup
t25 init
t25 db up
export DATABASE_URL=postgresql://t25:[email protected]:5432/t25
t25 upgrade
t25 doctor --evaluation
t25 serve
Request an invite · Guia de instalação
T25. Roda na sua máquina. Documentação.