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, gemini e 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.
PostgreSQL acessível. Instale o PostgreSQL 16 ou mais novo, confira com psql --version e exporte DATABASE_URL, por exemplo export DATABASE_URL=postgres://factory:factory@localhost:5432/factory. Sem PostgreSQL, nem npm run dev nem t25 create sobem.

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>'
bash ./install.sh

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

t25 init
t25 db up                       # ou use um Postgres acessível
export DATABASE_URL=postgres://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. O estado da fábrica é criado em .factory/, na sua máquina, e não é versionado — apagar essa pasta zera tudo, o que é exatamente o que você quer entre experimentos.

O pacote privado do avaliador já vem com o dashboard construído. Quem sobe o servidor a partir do repositório roda npm run web:build antes de iniciar.

3. Conferir o ambiente

npm run 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

npm run t25 -- create "Adicionar endpoint de métricas" \
  --body "Expor latência por rota" --type feature --risk medium

A ordem entra e caminha até SPEC, onde para: um agente escreveu o briefing e está esperando você ler. Acompanhe pelo cockpit ou por npm run t25 -- list.

5. Aprovar o briefing e o plano

npm run t25 -- spec TASK-0001          # ler o briefing
npm run t25 -- spec-approve TASK-0001  # liberar para o flight plan
npm run 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 — e o merge continua seu.

npm run t25 -- workspace TASK-0001  # onde o worktree da ordem está
npm run t25 -- cleanup TASK-0001    # remover (recusa se houver mudança não commitada)

Quando algo dá errado

Um estágio falhou: npm run t25 -- retry TASK-0001.
Você mudou de ideia: npm run 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 →