codebase-md: Ferramenta gera automaticamente CLAUDE.md com manutenção de git hook

Visão geral da ferramenta

codebase-md é uma ferramenta Python que gera e mantém automaticamente arquivos CLAUDE.md para projetos usando Claude Code. A versão 0.1.0 está em fase alfa e licenciada sob MIT.

Instalação e uso básico

Instale com suporte AST: pip install "codebase-md[ast]"

Analise e gere: codebase scan . seguido por codebase generate .

Conteúdo gerado

A ferramenta cria CLAUDE.md com:

• Detecção de padrões de arquitetura (monólito, monorepositório, microsserviço, CLI, etc.)
• Convenções detectadas automaticamente incluindo estilo de nomenclatura, padrões de importação e padrões de design via árvore sintática AST tree-sitter
• Verificações de saúde de dependências contra registros PyPI/npm
• Insights do git com análise de contribuidores e pontos críticos de arquivos
• Roteamento inteligente de contexto para o Claude consultar partes relevantes da base de código

Recursos adicionais

Gera arquivos de configuração para outras ferramentas: .cursorrules, AGENTS.md, codex.md e .windsurfrules a partir da mesma análise.

Instalação de hooks do git: codebase hooks install . mantém os arquivos gerados atualizados automaticamente.

Inteligência de dependências

Inclui comando deps para gerenciamento de dependências:

• codebase deps . - Painel completo de saúde
• codebase deps . --offline - Pontuação apenas local, ignora chamadas ao registro
• codebase deps . --upgrade fastapi - Plano de atualização para pacotes específicos

O sistema de dependências verifica versões fixadas contra registros e sinaliza pacotes desatualizados, pacotes mal mantidos e mudanças disruptivas em caminhos de atualização.

Detalhes de desenvolvimento

A ferramenta foi construída usando Claude Code para decisões de arquitetura, integração com árvore sintática AST tree-sitter, sistema de classificação de contexto TF-IDF e uma suíte de 354 testes. O próprio CLAUDE.md do projeto foi gerado pelo codebase-md.