Madar: Compilador de Contexto Local para Claude Code / Cursor — 78% Menos Tokens no Repositório NestJS

Madar é um compilador de contexto local de código aberto para agentes de codificação como Claude Code, Cursor, Copilot e Gemini. Ele mapeia seu repositório TypeScript/Node.js uma vez (localmente, sem dependências de ML) e serve um pacote de contexto mínimo via MCP para cada consulta, evitando que o agente redescubra a base de código a cada sessão.

Como funciona

Instale globalmente e gere um grafo com escopo para seu serviço backend usando --spi (isolamento de pacote único):

npm i -g @lubab/madar
madar generate . --spi
madar claude install   # ou: madar cursor install / madar copilot install

A ferramenta é determinística — análise estática pura de importações e caminhos de chamada, sem embeddings, sem chamadas de modelo.

Benchmark no NestJS + BullMQ (~800 arquivos)

A mesma pergunta ("como o relatório de ideia é gerado") foi feita ao Claude Code com e sem Madar. Números do relatório da Anthropic:

• Tokens de entrada: 1.000.776 (padrão) → 223.539 (com Madar) — redução de 78%
• Custo: US$ 1,84 → US$ 0,69 — economia de 63%
• Turnos: 16 → 5
• Chamadas de ferramenta: 15 → 4

Onde não funciona

O autor é transparente sobre as limitações:

• Testado apenas em um repositório, um agente, um tipo de pergunta ("como X funciona"). Não é uma afirmação geral.
• Escopo é crítico: usar --spi em um único serviço funcionou; apontar para um monorepo inteiro produziu pacotes de contexto que podem aumentar o uso de tokens.
• Tarefas de edição/revisão ainda não foram validadas — o ganho é para consultas do tipo explicação.
• Atualmente funciona apenas para bases de código TypeScript/Node.js.

Para quem é

Desenvolvedores que trabalham em grandes repositórios NestJS, Express ou Node.js e que dependem de agentes de codificação de IA, querendo reduzir o desperdício de tokens na coleta repetitiva de contexto. Não é adequado para monorepos sem um escopo cuidadoso.