Agint: Uma ferramenta CLI em Rust que detecta contradições em arquivos de instrução de agentes de IA

O que o Agint faz

O Agint aborda um problema específico que os desenvolvedores enfrentam ao gerenciar múltiplos arquivos de instrução de agentes de IA: contradições silenciosas entre diferentes documentos de configuração. A ferramenta foi criada depois que o autor experimentou comportamento inconsistente de "ajudantes de codificação" devido a instruções conflitantes entre arquivos.

Como funciona

A ferramenta examina todos os seus arquivos de instrução, incluindo:

• CLAUDE.md
• AGENTS.md
• .cursorrules
• Outros arquivos de documentação

Ela identifica três tipos de problemas:

• Contradições entre arquivos
• Referências a arquivos que não existem mais
• Arquivos que ficaram dessincronizados

O sistema usa uma abordagem de duas camadas:

• A análise estática lida com problemas estruturais
• Chamadas opcionais à API do Claude (ou outros LLMs) capturam contradições semânticas que padrões de regex perderiam

O autor observou que o Claude funcionou particularmente bem para este projeto em duas áreas: engenharia de prompt para o caso de uso específico e servindo como a camada de análise.

Instalação e uso

Instale via Cargo:

cargo install agint

Comandos básicos:

agint config
agint check

A ferramenta está disponível no GitHub em https://github.com/itsdandanlai/agint.

Contexto

Esse tipo de ferramenta se torna cada vez mais valioso à medida que os desenvolvedores usam mais agentes de codificação de IA em múltiplos projetos. Arquivos de instrução como CLAUDE.md e AGENTS.md normalmente contêm diretrizes específicas do projeto, padrões de codificação e restrições comportamentais para assistentes de IA. Quando esses arquivos se contradizem, isso pode levar a comportamentos imprevisíveis do agente e desafios de depuração.