Crag: Ferramenta de código aberto gera regras unificadas para agentes de IA a partir de configurações de projeto

O que o Crag faz

Crag é uma ferramenta de código aberto que resolve a divergência de configuração entre múltiplos arquivos de regras de agentes de IA para programação. Ele analisa as configurações existentes do seu projeto e gera um arquivo de governança unificado, depois compila isso em todos os arquivos de regras específicos necessários por diferentes agentes de IA.

O problema que ele aborda

Desenvolvedores que usam múltiplos agentes de IA para programação enfrentam desafios de gerenciamento de configuração. De acordo com a fonte, um desenvolvedor mantinha 12 arquivos de regras em 4 projetos (48 arquivos no total), incluindo:

• CLAUDE.md para Claude Code
• AGENTS.md para Codex
• .cursor/rules/ para Cursor
• copilot-instructions.md para Copilot
• Fluxos de trabalho de CI para impor regras

Esses arquivos divergiram ao longo do tempo, causando problemas onde os agentes escreviam código que o CI rejeitava porque as regras de lint não correspondiam. O problema passou despercebido porque "ninguém lê todos os 12 arquivos".

Como o Crag funciona

A ferramenta tem dois comandos principais:

• crag analyze lê as configurações do seu projeto, incluindo fluxos de trabalho de CI, package.json, tsconfig e configurações de teste
• crag compile --target all gera todos os arquivos de regras a partir do arquivo de governança unificado

A análise gera um arquivo governance.md (~80 linhas) que inclui:

• Gates
• Diretrizes de arquitetura
• Perfil de teste
• Regras de estilo de código
• Anti-padrões a evitar
• Convenções de framework

A saída é descrita como "gerada automaticamente, parece que foi escrita por um engenheiro sênior".

Detalhes técnicos

Crag tem várias características técnicas notáveis:

• Não requer LLM
• Sem dependências de rede
• Zero dependências
• Saída determinística
• Verificado com SHA em todas as plataformas

Para experimentar: npx @whitehatd/crag demo (remova o espaço entre @ e whitehatd)

Fonte e disponibilidade

A ferramenta é de código aberto e está disponível no GitHub em https://github.com/WhitehatD/crag.