Instalar

T25

The agents write. T25 governs.

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.

Request an invite

fig. 1: a fábrica. Exemplo ilustrativo; os estados são os reais.

3 esperando você

ordem
RECEIVED
SPEC
PLAN
AWAITING_APPROVAL
IMPLEMENTING
QA
REVIEW
PR_OPEN
Retry com backoff no cliente HTTPTASK-0042 · risco médio
Corrigir typo no READMETASK-0043 · risco baixo
Login com link mágicoTASK-0044 · risco alto
Filtro por data no relatórioTASK-0045 · risco médio
Atualizar dependência de testeTASK-0046 · risco baixo

A fábrica parou no gate, como a política manda. Risco baixo segue direto.

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

01

Conecte o repositório. A fábrica mostra o que entendeu.

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.

  1. 1. descoberta

    Ela lê o projeto

    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”.

  2. 2. confirmação

    Você corrige

    O que você corrigir fica guardado e não some na próxima varredura. Se o projeto mudar, ela avisa da divergência.

  3. 3. candidatos

    Você aceita o trabalho

    Candidatos com evidência, sem nada criado ainda. Aceitar abre a issue. Descartar não deixa rastro no GitHub.

  4. 4. entrega

    Ela leva até o PR

    Spec, plano, implementação, QA e review em worktree isolada, com o progresso comentado na issue. O merge é seu.

02

Hangar de treino

Não é um dashboard. É o chão onde o agente trabalha e o humano segura o merge.

Hangar vazio, bancada de ferramenta, luz fria. Hangar vazio à noite, bancada de ferramenta, luz fria.
CLI direto. O hangar existe. O portão não.
Hangar de treino com marca laranja de instrução ao fundo. Hangar de treino à noite com marca laranja de instrução ao fundo.
T25. Mesmo chão, laranja de alta visibilidade, humano atrás do portão.
Portão laranja de hangar de treino. Portão laranja de hangar de treino à noite.
Laranja de instrução. Não é accent de SaaS.

03

O agente já escreveu APPROVE.

Isso não é o merge. É o palpite.

Hangar à noite, um único ponto de luz no portão. Hangar à noite, um único ponto de luz no portão.
Still de hangar à noite. O quadro segura. A frase é uma.

04

O veredito do agente não é o merge.

Reconstrução rotulada de TASK-0020. O reviewer já assinou. Aperte APPROVE.

review · TASK-0020 APPROVE

O modelo já assinou. A política ainda não leu o array.

05

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.

  1. 01 Spec → plano

    O pedido vira critérios verificáveis e fatias de trabalho.

  2. 02 Gate → implementação

    A política libera o agente em um worktree isolado.

  3. 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.

  1. Você O time

    Define prioridade, risco e o merge. O humano continua atrás do portão.

  2. T25 A política

    evaluateReview, worktree isolado, teto de diff. O APPROVE do modelo não é o merge.

  3. CLIs Os agentes

    Claude Code, Codex, Cursor, os que você já assina. O T25 governa o veredito deles.

  4. 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áticaCLI diretoCLI com T25
Onde o agente escreveNo seu checkoutUm worktree e um branch por ordem
Plano antes do códigoSe você pedirSpec aprovada por você, plano com gate por risco
QA reprovouVocê lê o terminalVeredito PASS/FAIL devolve para implementação
Review escreveu APPROVEVale o que o modelo disseevaluateReview() recalcula pelos findings
Agente que não paraVocê percebe no diffTeto de arquivos, linhas e duplicação
Merge na mainDepende de disciplinaSempre humano, depois dos checks

06

A fábrica inteira cabe em um arquivo.

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

Ela prova o trabalho antes de pedir o seu.

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

  1. IMPLEMENTINGworktree isolada
  2. QAtestes, navegador real, antes e depois
  3. REVIEWreviewer e security no diff
  4. PR_OPENo merge é seu

FAIL em QA ou REVIEW devolve para IMPLEMENTING, com os achados. O limite de repetições leva a ordem de volta para você.

O contrato vem da spec

Cada critério de aceite vira verificação: comando, interface ou valor esperado.

A fábrica confere o que importa

Scripts aprovados rodam contra o head real da entrega, com a saída guardada como artefato.

O PR chega com a prova

Veredito, exercício de interface e par antes e depois vão no corpo do pull request.

08

Seu em cada camada.

  1. camada 1

    Seus agentes

    Nove CLIs suportados, instalados e autenticados por você, com fallback por papel.

  2. camada 2

    Seus modelos

    Modelo e esforço por papel. O planejador não precisa ser o mesmo que escreve o código.

  3. camada 3

    Sua máquina

    Orquestrador, Postgres e worktrees no seu computador ou servidor. Implementação e QA em sandbox Docker, quando a política de risco pede.

  4. camada 4

    Seus dados

    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

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 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.

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.

10

Questions that come up before the first run.

Didn't find yours? E-mail para [email protected] or read the documentation.

Product

01 Does T25 replace Claude Code, Codex or Cursor?

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.

02 Which agent CLIs does T25 support?

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.

03 Do I need an API key?

No. T25 calls the CLIs already signed in on your machine, so it runs on the subscription you already pay for with each tool.

04 Does the agent's APPROVE merge automatically?

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.

Code and security

05 Does my code leave my machine?

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.

06 Where does the agent write?

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.

07 What happens when QA or review fails?

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.

08 What if the agent rewrites half the repository?

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.

Usage

09 What do I need to run it?

Node 22, Docker or a reachable Postgres, and at least one signed-in agent CLI. Runs on Linux and macOS.

10 How do I try T25?

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.

11 Is T25 open source?

No. No license is granted. The code is not public. Use, copying, or cloning requires a written license from the copyright holder.

12 How do I send feedback or a change?

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

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. 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 alternative, if you did not run the installer
# 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.