Pitch: ContextAtlas - Grafos de Contexto para Agentes de Código de IA

Com o rápido crescimento dos agentes de codificação com IA, um problema recorrente acontece: os agentes perdem o contexto ao longo de sessões longas, levando a:

• Sugestões de código incorretas;
• Alucinações;
• Esquecimento de decisões arquiteturais essenciais ou requisitos;
• Quebra de contratos de sistema existentes sem perceber;
• Obrigação de reexplicar restrições do projeto constantemente;
• Tokens desperdiçados em correções contínuas.

O Problema

LLMs enfrentam dificuldades com memória de longo prazo do projeto e não mantêm o estado real de uma base de código, dependendo apenas do histórico do chat ou de RAG básico. Como resultado, a duração da sessão é inversamente proporcional à qualidade do código gerado.

O Que Eu Construí

Desenvolvi um kit de ferramentas MCP open-source baseado em grafos chamado ContextAtlas, disponível no npm. Ele gera três estruturas de grafos complementares:

• Um grafo de dependências da AST mapeando os relacionamentos reais da base de código;
• Um grafo de raciocínio rastreando decisões do agente e histórico de pensamentos;
• Um grafo de mutações de código capturando as edições exatas realizadas pelo agente.

Isso mantém os agentes de IA ancorados no contexto real do projeto, prevenindo a perda de contexto e possibilitando um raciocínio consistente em múltiplas etapas ao longo de tarefas longas.

Por Que Estou Compartilhando

Este é o meu primeiro grande projeto open-source, nascido de uma frustração pessoal que sei que muitos desenvolvedores compartilham. Gostaria muito de validar se isso resolve um problema real para outros também.

Feedbacks e sugestões são muito bem-vindos!

Como Testar

Instale globalmente via npm:

npm install -g @contextatlas/core

Ou adicione diretamente à configuração do seu cliente MCP (Cursor, Claude Desktop, Windsurf...):

"mcpServers": {
  "contextatlas": {
    "command": "npx",
    "args": ["-y", "@contextatlas/core@latest", "mcp-atlas"]
  }
}

Documentação completa e código-fonte no GitHub: github.com/jose15000/ContextAtlas