Guias
Início rápido.
Do convite à primeira ordem parada no gate. O acesso é por convite: um link pessoal de download chega por e-mail. A instalação leva alguns minutos, e o passo que mais trava é o último pré-requisito: um CLI de agente já autenticado e um Postgres acessível.
Antes de começar
- Node.js 22 ou mais novo. Confira com
node --version. -
Ao menos um CLI de agente autenticado na máquina —
claude,codex,kimi,geminie outros. Autenticado de verdade: a T25 invoca o binário que você já usa, ela não guarda chave nenhuma. - Git. Cada ordem cria um worktree, então o diretório precisa ser um repositório Git de verdade.
-
GitHub CLI (
gh) 2.50 ou mais novo, autenticado. É oghque abre o PR e confere os checks antes do merge. Confira comgh --version. O pacote doaptdo Ubuntu é antigo: instale pelo repositório oficial do GitHub CLI e rodegh auth login. -
PostgreSQL acessível. Instale o PostgreSQL 16 ou mais novo, confira
com
psql --versione exporteDATABASE_URL, por exemploexport DATABASE_URL=postgresql://t25:[email protected]:5432/t25. Sem PostgreSQL, nemnpm run devnemt25 createsobem.
1. Baixar e instalar o pacote privado
O acesso ao T25 é por convite e o pacote não é publicado no npm público. O convite chega por e-mail com um link pessoal de download: o instalador baixa o tarball privado, verifica o SHA-256 antes de instalar e remove o arquivo temporário ao terminar.
# substitua pelos dados recebidos no convite 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
Não tem convite? A página Solicitar convite explica o programa de early evaluators. O acesso ao código é restrito; o caminho do avaliador é o do convite, acima.
2. Subir o cockpit
Se executou o instalador, ele já iniciou o cockpit; pule o bloco abaixo. Use-o apenas para setup manual, sem executar o instalador.
t25 init t25 db up # ou use um Postgres acessível export DATABASE_URL=postgresql://t25:[email protected]:5432/t25 t25 upgrade # aplica migrations t25 doctor --evaluation # pré-flight do avaliador; falha em check error t25 serve # sobe em http://localhost:4173
Abra http://localhost:4173. As ordens, execuções e eventos ficam no Postgres. Apagar .t25/ remove overlays e blobs locais, mas não apaga as ordens do banco.
O instalador executa a inicialização, prepara o banco, aplica migrations e inicia t25 serve. Não repita os comandos de inicialização depois de executar o instalador. Para setup manual, use os comandos acima no lugar do instalador.
3. Conferir o ambiente
t25 doctor --evaluation
O doctor --evaluation imprime um relatório JSON de pré-flight para o programa
de avaliação — CLIs de agente detectáveis, Git, versão, cliente PostgreSQL,
state_dir, web/dist — e sai com erro se algum check estiver em
error. É o primeiro lugar a olhar quando algo não sobe e o próximo passo
quando tudo está verde é a primeira ordem.
4. Abrir a primeira ordem
t25 create "Adicionar endpoint de métricas" \ --body "Expor latência por rota" --type feature --risk medium
A ordem fica em RECEIVED até um worker aprovado executar o pipeline. Registre-o nesta ordem: t25 worker-bootstrap --project default, t25 worker run --control-plane-url https://<control-plane> --worker-id worker-a e então t25 worker-approve worker-a; então a task pode chegar a SPEC para sua aprovação. Acompanhe pelo cockpit ou por t25 list.
A descoberta read-only pode ser consultada em GET /api/v1/projects/:id/discovery;
se não houver backlog, informe um objetivo em POST /api/v1/projects/:id/work-items.
O T25 deve apresentar WorkItem/spec/plano/critério/risco antes da execução. Para risco médio, a evidência exige REVIEWED; MERGE_READY é exigido para risco alto ou crítico. O merge é sempre humano.
PR_OPEN sozinho não é sucesso.
5. Aprovar o briefing e o plano
t25 spec TASK-0001 # ler o briefing t25 spec-approve TASK-0001 # liberar para o flight plan t25 approve TASK-0001 # o gate de go/no-go
Com risco médio ou alto a ordem para de novo em AWAITING_APPROVAL, agora com
o plano e os critérios de aceite. É a parada de propósito: é aqui que você decide se a
fábrica segue.
6. Deixar rodar
Depois do gate a ordem vai sozinha por implementação, QA e review, no worktree dela. Quando QA ou review reprovam, ela volta para implementação em vez de seguir torta. No fim o pull request é aberto de verdade no GitHub; em projeto sem GitHub, o fluxo espera a aprovação humana de entrega local (`LOCAL_APPROVED`). O merge continua seu.
t25 workspace TASK-0001 # onde o worktree da ordem está t25 cleanup TASK-0001 # remover (recusa se houver mudança não commitada)
Quando algo dá errado
- Um estágio falhou:
t25 retry TASK-0001. - Você mudou de ideia:
t25 cancel TASK-0001. -
Nenhum agente disponível: o roteamento é uma cadeia de preferência, não
um CLI fixo por papel. Se nenhum da lista está no
PATH, o estágio não roda — veja configuração.
Próximo Configuração: roteamento, limites e risco no t25.yaml →