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údecodebase deps . --offline- Pontuação apenas local, ignora chamadas ao registrocodebase 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.
📖 Leia a fonte completa: r/ClaudeAI
👀 See Also
7 comandos de barra, $0.45/post: Este pipeline do Claude Code executa uma operação completa de conteúdo SEO
Um desenvolvedor disponibilizou como open source um pipeline de 7 comandos do Claude Code que lida com pesquisa SEO, escrita, otimização e publicação. Custa $0,45/post (API Perplexity), é executado em 15 min/dia. Resultados: 18× mais impressões mensais em 12 meses.
bareguard: Um Portão de Segurança Leve para Agentes de IA — Agora no npm
bareguard v1.0 é uma camada de segurança de ~1000 linhas e dependência única para agentes de IA que bloqueia ações destrutivas (rm -rf, DROP TABLE) e impõe limites de orçamento com escalonamento humano. Parte do bare suite, disponível no npm.
MatchKit: Gerador de Sistema de Design para Projetos de Código Claude
MatchKit é uma ferramenta que gera sistemas de design completos e personalizados para projetos desenvolvidos com Claude Code. Ela extrai as cores da marca de logos enviados e gera componentes, layouts e tokens de design personalizáveis para evitar a aparência genérica comum em ferramentas de codificação por IA.
Claude-File-Recovery: Ferramenta de linha de comando extrai arquivos do histórico de sessões do Claude Code
claude-file-recovery é uma ferramenta CLI em Python e TUI que analisa transcrições de sessão JSONL de ~/.claude/projects/ para recuperar arquivos criados, modificados ou lidos pelo Claude Code, incluindo recuperação pontual de versões anteriores de arquivos.