PT EN
Instalar

Dark factory, software factory e human in the loop: o espectro

Três nomes para três lugares da pessoa no pipeline, e onde o padrão do T25 fica.

Read in English Versão em Markdown

Hangar teal vazio, com uma lâmpada laranja no portão mais próximo e os portões seguintes cada vez mais escuros.

Três nomes, três lugares para a pessoa

Uma dark factory de software é um modo de operar: a pessoa entrega o objetivo e a máquina segue até a mudança integrada, com pouca leitura no meio. Uma software factory é a estrutura que torna isso possível, com estados, papéis, gates e isolamento. Human in the loop é outra regulagem em cima da mesma estrutura. A pessoa vira um estado, e a tarefa não avança enquanto esse estado não fecha.

Os três cabem no mesmo repositório. O que muda é qual transição a política deixa a máquina concluir sozinha. O artigo sobre o que é uma software factory descreve a estrutura. Este descreve quem assina cada passo.

Onde o padrão do T25 fica

Passo Padrão O que empurra para uma dark factory
Spec Humano. t25.auto_approve_spec nasce false. A escada de promoção não relaxa approve_spec. Ligar auto_approve_spec assina spec de risco low ou medium quando não há gate de spec, comentário aberto nem critério faltando. high e critical continuam manuais.
Plano require_plan_approval nasce true. Sem overlay no projeto, risco cujo approval não seja none para em AWAITING_APPROVAL. low usa approval: none, então o plano segue sem esse gate, salvo planApprovalLowRisk no projeto. O overlay requirePlanApproval do projeto ganha da flag global: false tira o gate mesmo com a flag ligada, e true mantém o gate mesmo com a flag desligada.
Merge Humano. O merge sai por t25 merge ou pela rota da API. merge fica requires_human até a promoção delegated, e a delegação institucional nasce com enabled: false. São travas separadas. Promover merge a delegated e ligar delegation.actions.merge não bastam, juntas ou separadas. executeMergeIntervention não é chamado por rota, CLI nem estágio, e a semântica nasce desligada, em shadow.
Entrega Até o risco low exige PR utilizável e MERGED antes de DONE. Teste verde não fecha a entrega. No caminho com pull request não há atalho de DONE sem merge. Projeto só local troca a cadeia por QA e LOCAL_APPROVED.

Os defaults de risco estão em src/core/config.ts: low pede none, medium pede plan, high pede plan_and_pr e critical pede human_required. Uma task chore nasce low. Os outros tipos nascem medium, em defaultRiskForType.

O merge continua um comando ou uma rota da API, e o registro leva o nome de quem executou. O post lights-on conta por que o padrão fica nesse ponto, com as fontes de fora. Os nomes das chaves estão na referência de configuração.

O que cada nome não cobre

Dark factory, aqui, não é um produto à parte. É o extremo em que a spec e o plano saem do caminho da pessoa, dentro do que o código ainda segura: risco alto e crítico ficam fora da aprovação automática de spec, e a entrega com PR continua pedindo um merge feito por uma pessoa.

Human in the loop também não é uma pessoa lendo cada token. No padrão, a pessoa assina a spec, o plano quando o risco pede, e o merge. No meio, os papéis de agente rodam sozinhos, cada um na worktree da tarefa. O isolamento dessa worktree está em uma ordem, um worktree.

Como ler o seu YAML

  1. Olhe t25.auto_approve_spec e t25.require_plan_approval. O overlay requirePlanApproval do projeto ganha da flag global.
  2. Olhe risk.<nível>.approval no risco que as suas tasks realmente usam. Chore e o resto não nascem no mesmo nível.
  3. Olhe se delegation.enabled está ligado e se merge já foi promovido a delegated. As duas são travas separadas e não dispensam a pessoa do merge: executeMergeIntervention não entra no pipeline, e a semântica nasce desligada ou em shadow.
  4. Com spec e plano no padrão, a operação é human in the loop nesses pontos, e o merge continua por t25 merge ou pela rota. O código registra qual interruptor mudou.

Perguntas frequentes

Dark factory e software factory são a mesma coisa?

Software factory é a estrutura: estados, papéis, gates e isolamento. Dark factory é operar essa estrutura com o mínimo de parada humana. Dá para ter a estrutura e ainda parar para uma pessoa.

Human in the loop é uma pessoa em cada linha?

No padrão do T25 a pessoa entra na aprovação da spec, no plano quando o risco pede, e no merge. O meio do pipeline é agente, na worktree da tarefa.

Risco baixo tira o humano do merge?

Risco low dispensa a aprovação do plano, porque o approval padrão é none. A entrega com pull request ainda exige PR utilizável e merge antes de DONE.

O T25 aprova a spec sozinho?

Só com t25.auto_approve_spec ligado. Vale para risco low e medium, e só quando a spec não tem gate, comentário aberto nem critério faltando. high e critical ficam manuais.

Desligar o gate de plano deixa a tarefa sem ninguém?

Tira a parada do plano. A spec e o merge seguem as regras deles. São interruptores separados.

Teste o T25 na sua máquina.

O acesso é por convite: o link pessoal de download chega por e-mail, o instalador verifica o checksum do pacote e o doctor --evaluation valida o ambiente. Gratuito durante os 30 dias do programa de early evaluators. O orquestrador, o banco e as worktrees rodam na sua máquina; a T25 não coleta seu código, prompts, logs ou credenciais. Os CLIs de agente enviam dados aos próprios provedores, na sua conta e conforme as políticas deles.

t25 doctor --evaluation
t25 create "Add retry with backoff to the HTTP client"

Solicitar convite