A pergunta
Como uma parte do trabalho vira uma sessão rodando, na ferramenta certa, sem que eu monte tudo à mão e sem tirar o aceite de quem orquestra?
Montar uma subtarefa à mão exige criar worktree e branch, abrir uma aba, escolher a ferramenta e o modelo, iniciar a ferramenta e colar o contexto e o contrato. O subagente nativo de cada ferramenta evita parte disso, mas prende a subtarefa à ferramenta da sessão principal e não deixa a divisão registrada.
O que ele faz
O Demerzel lê as unidades declaradas num contrato do Radiant e despacha cada uma como uma sessão do Claude Code ou do Codex. Depois acompanha o estado dessa sessão e, quando ela termina, recolhe o relatório de conclusão e entrega ao orquestrador, que relê o resultado e decide se aceita.
Ele não tem julgamento. Não divide o trabalho, não escolhe a regra de roteamento e não aceita entregas. Valida e executa a regra que o orquestrador escolheu. O orquestrador chama o Demerzel no lugar da ferramenta nativa de subagente, e eu também posso chamá-lo direto.
É um CLI não interativo, em Bun e TypeScript, sem dependências de runtime. Os comandos são dispatch, status, wait, collect, resume e close, e a saída pode vir em JSON. O código de saída diz se deu certo, se há algo pendente ou se houve recusa sem efeito, e os erros dizem o que fazer em seguida.
units:
- id: TC-0025.1
role: radiant-dev
requires: []
objective: Fetch external sources by rev for the cache.
writes: [src/sources/, tests/sources/]
depends_on: []
done_when: The tests in tests/sources pass and the cache refuses a mismatched digest.
- id: TC-0025.2
role: radiant-dev
capability: deep
capability_reason: Refusing a digest requires security judgment.
requires: []
objective: Wire digest verification into sync.
writes: [src/sync/]
depends_on: [TC-0025.1]
done_when: bun run check passes and sync refuses content without a matching digest.
Núcleo e integração
O Demerzel tem dois andares. O núcleo recebe tudo já resolvido (ferramenta, modelo, esforço, caminhos e pedido), guarda o registro dos despachos de cada projeto e acompanha as sessões. Ele não conhece o Radiant. A prova é a suíte de testes do núcleo, que roda com um backend falso e sem nenhuma cópia do Radiant no ambiente.
A integração com o Radiant acha o projeto, lê as unidades do contrato, confere se o projeto está na revisão do Radiant que declarou, aplica as regras de roteamento e espera o relatório de conclusão. Nesta primeira versão, ela é a única porta de entrada. Despachar fora de um projeto Radiant fica para quando houver um caso real que peça isso.
O Radiant também é o processo com que desenvolvo o Demerzel, com Frame, Spec, Plan e contratos. Essa dependência fica no processo. O código do núcleo continua sem ela.
No herdr
As sessões rodam no herdr, o primeiro backend, atrás de uma interface do próprio Demerzel. Um despacho segue esta ordem:
- Confere o projeto e a revisão do Radiant.
- Lê a unidade e confere se as dependências terminaram e se os caminhos que ela escreve não se sobrepõem aos de outra unidade em andamento.
- Aplica a regra de roteamento e registra a decisão antes de lançar.
- No herdr, cria o worktree com uma branch própria, inicia a ferramenta e envia o pedido.
statusewaitacompanham a sessão até ela terminar ou travar.collectlê o relatório de conclusão no worktree e entrega ao orquestrador.
O pedido leva só caminhos: o papel, onde está o Radiant, o contrato, a unidade e onde deixar o retorno. Nunca leva o conteúdo do contrato nem segredos. A ferramenta lançada lê o contrato e o envia ao seu provedor de modelo, como numa sessão aberta à mão. Por isso, escolher a ferramenta também é escolher para onde o contrato vai.
O que ele recusa
Algumas decisões ficam fora do Demerzel de propósito:
- Não altera contratos nem muda escopo.
- Não faz merge, push nem abre PR, e não remove branch. Worktree e branch só são apagados com uma flag explícita de descarte que eu dou.
- Não responde pedidos de permissão. Quando uma sessão para num deles, ele avisa o orquestrador, que traz a pergunta para mim.
- Não rebaixa capacidade em silêncio. Sem candidato viável na capacidade pedida, a unidade fica em HOLD.
Todas as checagens rodam antes do primeiro efeito, e uma recusa não cria nada.
Com o Radiant
O Demerzel nasceu de uma decisão do Radiant, que passou a dividir contratos em unidades e a rotear cada uma para uma ferramenta. O Radiant define o formato das unidades e das regras, e o Demerzel faz a parte mecânica. Já usei o Demerzel para despachar as unidades de um contrato real do AIKM.
Repositório do DemerzelPúblico, licença MIT
Atualizações
- Primeira publicação.