O que cartographer faz?
Sistema de compreensão de código focado em agentes — constrói um modelo de mundo persistente e baseado em evidências do seu código-fonte.
Visão Geral
O Cartographer é uma ferramenta projetada para agentes de IA (como o Claude Code) que precisa entender profundamente um código-fonte. Ele não apenas analisa o código, mas constrói um modelo conceitual do sistema, chamado de 'world-model', que é armazenado e atualizado continuamente. Isso permite que o agente tenha uma compreensão semântica e contextual do repositório, em vez de apenas uma visão superficial.
Funcionalidades
- Persistência: O modelo de mundo é salvo e reutilizado entre sessões, permitindo que o agente retome o contexto de onde parou.
- Baseado em Evidências: Cada afirmação no modelo é rastreada até o código-fonte original, garantindo precisão e confiabilidade.
- Algoritmo de Soma: Utiliza um método proprietário de sumarização para extrair e consolidar informações relevantes, sem perder detalhes importantes.
- Foco em Agentes: Otimizado para ser usado por agentes de IA, com estruturas de dados e APIs que facilitam a consulta e a navegação.
Exemplo de Uso
# Inicializar o Cartographer em um repositório
cartographer init
# Construir o modelo de mundo
cartographer build
# Consultar o modelo
cartographer query "Como o sistema de login funciona?"
Como Funciona
- Coleta: O Cartographer varre o código-fonte, analisando arquivos, dependências e estruturas.
- Sumarização: Algoritmos de processamento de linguagem natural (PLN) extraem conceitos, relações e fluxos.
- Construção do Modelo: As informações são organizadas em um grafo semântico persistente.
- Atualização: Quando o código muda, o modelo é incrementalmente atualizado, sem reconstrução completa.
Plataformas Suportadas
- Claude Code
- Cursor
- Codex
- Outros agentes compatíveis
Requisitos
- Python 3.8+
- Git
- Acesso ao repositório local
Licença
MIT License