Documentação
T25, do convite à primeira ordem.
T25 é um orquestrador local que recebe uma ordem e a conduz por briefing, flight plan, gate humano, implementação, QA e release, até o pull request. Roda na sua máquina, com os CLIs de agente que você já assina. Esta documentação cobre o que existe hoje.
Acesso antecipado. O produto muda rápido e parte do código ainda se
chama factory por baixo do capô. Quando esta documentação resume um
arquivo do repositório, o arquivo é a fonte da verdade — cada página diz qual é.
Comece por aqui
Se é a sua primeira vez: baixar o pacote com o convite, abrir uma ordem pela CLI (headless) ou subir o cockpit, e aprovar o gate. MCP e a API REST cobrem o mesmo ciclo sem UI.
Início rápido
Baixar com o convite, instalar, subir em localhost:4173 e abrir a primeira ordem.
Guias
O que já existe em guia e o que ainda vive como documento no repositório.
Arquitetura
Control plane, worker e cockpit — e por que o seu código só vive num deles.
Configuração
As seções do t25.yaml: estado, roteamento, limites, risco, auth.
CLI e MCP
Comandos t25 e o servidor stdio npm run mcp para o seu agente.
API Reference
REST e SSE — o mesmo contrato do cockpit, do MCP e de um script headless.
Especificações
Specs, planos e ADRs — onde cada decisão do desenho ficou registrada.
O modelo mental
Vale ler isto antes de qualquer comando, porque quase toda dúvida de operação cai num destes três pontos.
Uma ordem é uma máquina de estados
A ordem caminha por RECEIVED → SPEC → PLAN → AWAITING_APPROVAL → IMPLEMENTING →
QA → REVIEW → PR_OPEN → DOCS → DONE, com NEEDS_INPUT,
FAILED e CANCELLED como saídas. Transição inválida é bloqueada
no centro, não em cada chamador. QA e review podem devolver a ordem para implementação.
Dois pontos de parada são humanos
A ordem para em SPEC até você aprovar o briefing, e para em
AWAITING_APPROVAL quando a política do projeto ou o risco exigem. O merge do
pull request nunca é da T25.
Agente nenhum toca o seu checkout
Cada ordem recebe um git worktree próprio, em branch factory/<id>. O
CLI de agente roda lá dentro, por argv e sem shell. É a invariante que sustenta todo o
resto — inclusive a possibilidade de a fábrica rodar num host e o código em outro.
Onde fica cada coisa
| Quando você quer | Vá para |
|---|---|
| Subir e ver rodando | Início rápido |
| Entender o desenho | Arquitetura |
| Trocar roteamento, limites ou risco | Configuração |
| Operar pela linha de comando ou MCP | CLI |
| HTTP, SSE, scripts sem UI | API Reference |
| Saber por que algo foi decidido assim | Especificações |
| Saber o que ainda não existe | LEFTOVERS.md |