Ao vivo 18/11 · Turma 318 nov às 19:00 MSK — aula prática gratuita de agentes de IA · Turma 3 ao vivo começa 23/11Aula 18/11 →Turma 3 (23/11)
LançamentoAnálise · No radarHabr AI→ original

DEMIURGOS adiciona modo de depuração de regras para agentes de IA e suporte a mais de 20 ferramentas

DEMIURGOS é um «arquiteto de regras» para agentes de programação: ele reúne o contexto do projeto e gera .rules/, AGENTS.md e adaptadores para Claude Code, Cursor, Copilot e outras ferramentas. A atualização mais recente traz o modo /debug, que mostra quais regras realmente foram aplicadas, onde o agente tem lacunas e o que vale adicionar ou reescrever. A expectativa é reduzir o tempo gasto com explicações repetidas e correções.

Processado por IA de Habr AI; editado por Hamidun News
DEMIURGOS adiciona modo de depuração de regras para agentes de IA e suporte a mais de 20 ferramentas
Fonte: Habr AI. Colagem: Hamidun News.
Ouvir artigo
Ficha técnica e números-chave
ParâmetroDados
Fonte originalHabr AI ↗
Editor-chefe
Dado-chave #1Um único conjunto de regras fica no repositório e vai para o git junto com o código
Dado-chave #2Os adaptadores permitem conectar as mesmas instruções ao Claude Code, Cursor, Copilot, Windsurf, Zed, Codex, Cline e outras ferramentas
Dado-chave #3Antes de entregar o resultado, o sistema roda de 3 a 5 cenários típicos, como adicionar um endpoint de API, refatorar um módulo ou corrigir um bug na autenticação

DEMIURGOS é uma ferramenta para quem escreve código com agentes de IA e cansou de explicar o projeto do zero a cada novo chat. Ela reúne as regras da equipe em um único sistema, distribui para diferentes agentes e, na nova versão, mostra quais instruções realmente funcionaram e onde o contexto ficou com buracos.

Por que os agentes erram

O principal problema dos agentes de programação hoje está menos no modelo e mais no contexto. Claude, GPT, Gemini, Qwen e outros sabem escrever código, mas não sabem como um repositório específico é organizado: onde ficam os testes, qual é o formato das respostas da API, quais diretórios não podem ser tocados, onde é preciso usar o modo estrito do TypeScript e onde vale outro conjunto de regras.

O resultado é que o desenvolvedor gasta tempo não com a tarefa, mas com correções constantes: explica de novo a estrutura do projeto, flagra desvios de estilo e conserta soluções que formalmente funcionam, mas se encaixam mal na base de código.

Como funciona o DEMIURGOS

O DEMIURGOS resolve esse problema com um esquema de três camadas. Na base está o núcleo .rules/, que guarda a fonte da verdade sobre o projeto: stack, padrões de arquitetura, restrições, formato das respostas e nível de acesso.

Sobre ele são criados adaptadores para cada ferramenta. O Cursor tem seus próprios arquivos de regras, o Claude Code usa o CLAUDE.md, o GitHub Copilot usa o .github/copilot-instructions.md, e para as demais pode-se usar o AGENTS.md como formato universal. Extensões como subagents, hooks e MCP só aparecem quando realmente são necessárias, e não «para o futuro».

A abordagem não gira em torno de uma pasta bonita, mas da portabilidade das regras entre agentes e IDEs. Um desenvolvedor pode trabalhar no Cursor, outro no Claude Code, o líder técnico no Copilot, e todos recebem o mesmo retrato do projeto sem sincronizar prompts manualmente.

O autor também embute minimalismo no sistema: antes de criar um novo arquivo, verifica-se se ele resolve um problema real e se não bastaria uma linha em um documento já existente.

  • Um único conjunto de regras fica no repositório e vai para o git junto com o código
  • Os adaptadores permitem conectar as mesmas instruções ao Claude Code, Cursor, Copilot, Windsurf, Zed, Codex, Cline e outras ferramentas
  • Antes de entregar o resultado, o sistema roda de 3 a 5 cenários típicos, como adicionar um endpoint de API, refatorar um módulo ou corrigir um bug na autenticação
  • Se uma regra atrapalha, é ignorada ou duplica um contexto já conhecido, o sistema sugere suavizá-la, subi-la de nível ou removê-la

O que o /debug traz

A atualização mais visível são os modos /debug e /debug full. Depois de um pedido comum, o agente não só entrega o código, mas também mostra quais regras foram acionadas, de qual arquivo vieram e como influenciaram a solução final.

Isso transforma o sistema de caixa-preta em algo observável. Se a regra sobre transações não está sendo aplicada, isso fica evidente de imediato. Se o projeto não tem convenção para nomenclatura de inputs, feedback de UI com cooldown, FOUC ou tratamento de APIs do navegador, o modo de depuração aponta essas lacunas e sugere o que adicionar ao patterns.md ou ao constraints.md.

Na prática, o /debug não avalia as regras por avaliar, mas ajuda a enxergar sua cobertura após uma série de pedidos reais. Depois de 10–20 tarefas, já dá para ver onde o agente se apoia com segurança no .rules/, onde recorre à heurística embutida do modelo e onde começa a improvisar. O modo é especialmente útil para equipes que vão fazendo seu sistema de regras crescer aos poucos e não querem reescrevê-lo às cegas a cada erro.

«Regras não são “configurar e esquecer”».

Daí vem também a lógica das atualizações: se o mesmo erro se repetiu duas vezes, é preciso adicionar uma regra; se a instrução atrapalha, simplificar ou remover; se o agente a ignora, subi-la de nível e reforçá-la com um exemplo. O artigo descreve as regras como um documento vivo, e não como um artefato estático.

Ou seja, não se trata de um prompt avulso, mas de um ciclo de manutenção em que as regras evoluem junto com o projeto, a stack e os hábitos de trabalho da equipe.

O que isso significa

O mercado de agentes de programação está saindo dos prompts avulsos para uma infraestrutura completa ao redor deles. O DEMIURGOS é interessante não como mais um chatbot, mas como uma camada de controle do comportamento dos agentes no repositório: com versionamento, adaptadores, auditoria e feedback.

Para equipes que já vivem no Claude Code, Cursor, Copilot ou Windsurf, é uma forma prática de reduzir explicações repetidas, diminuir o ruído no código e levar o agente de IA a um comportamento previsível mais rápido.

História

Perguntas frequentes sobre a notícia

Por que os agentes erram?

O principal problema dos agentes de programação hoje está menos no modelo e mais no contexto. Claude, GPT, Gemini, Qwen e outros sabem escrever código, mas não sabem como um repositório específico é organizado: onde ficam os testes, qual é o formato das respostas da API, quais diretórios não podem ser tocados, onde é preciso usar o modo estrito do TypeScript e onde vale outro conjunto de regras.

Como funciona o DEMIURGOS?

O DEMIURGOS resolve esse problema com um esquema de três camadas. Na base está o núcleo .rules/, que guarda a fonte da verdade sobre o projeto: stack, padrões de arquitetura, restrições, formato das respostas e nível de acesso. Sobre ele são criados adaptadores para cada ferramenta. O Cursor tem seus próprios arquivos de regras, o Claude Code usa o CLAUDE.md, o GitHub Copilot usa o .github/copilot-instructions.md, e para as demais pode-se usar o AGENTS.md como formato universal.

O que o /debug traz?

A atualização mais visível são os modos /debug e /debug full. Depois de um pedido comum, o agente não só entrega o código, mas também mostra quais regras foram acionadas, de qual arquivo vieram e como influenciaram a solução final. Isso transforma o sistema de caixa-preta em algo observável. Se a regra sobre transações não está sendo aplicada, isso fica evidente de imediato.

ZK
Zhemal Khamidun — CPO da Alpina Digital, gerente de produto do AlpinaGPT. Cria produtos de IA desde 2019. O Hamidun News é um projeto pessoal que virou um agregador em produção com mais de 6.000 leitores.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
O que você acha?
Carregando comentários…