Instalar

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

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

Próximo Configuração: roteamento, limites e risco no t25.yaml →