Pular para o conteúdo
  1. fael.tech
  2. Estudos
  3. Demerzel

Demerzel.

Como cada unidade de um contrato do Radiant vira uma sessão do Claude Code ou do Codex no herdr, sem eu montar a sessão à mão.

Tipo
Projeto
Estado
Em andamento
Publicado em

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.
Exemplo do bloco de unidades de um contrato, como a decisão do Radiant que deu origem ao Demerzel define o formato. É isso que o Demerzel lê.

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:

  1. Confere o projeto e a revisão do Radiant.
  2. 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.
  3. Aplica a regra de roteamento e registra a decisão antes de lançar.
  4. No herdr, cria o worktree com uma branch própria, inicia a ferramenta e envia o pedido.
  5. status e wait acompanham a sessão até ela terminar ou travar.
  6. collect lê 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:

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

  1. Primeira publicação.
← Todos os estudos