Oi pessoal!

Como muitos de vocês, eu uso assistentes de IA (Claude, Cursor) diariamente. Mas notei um problema: a IA muitas vezes sugere mudanças sem entender toda a arquitetura. Ela pode sugerir a exclusão de um arquivo que parece não utilizado, mas que na verdade é importado dinamicamente, ou não vê o "raio de explosão" de uma mudança de refatoração.

Então eu construí o Sistema de Saúde do Código — um kit de ferramentas de código aberto que atua como uma camada de contexto para agentes de IA.

(Divulgação completa: sou um desenvolvedor jovem, e este projeto foi construído com a forte assistência de IA/Cline. Estou tentando aprender e criar algo útil usando fluxos de trabalho modernos nativos de IA.)

🚀 O que o torna único?

Não é apenas um linter; é uma camada de segurança para o seu assistente de IA.

🏝️ Localizador de Ilhas Mortas: Em vez de encontrar funções não utilizadas isoladas (o que cria ruído), ele encontra clusters de arquivos que formam "ilhas" isoladas de código morto. Seguro para excluir todo o módulo!
💥 Previsão de Raio de Explosão: Antes de mudar auth.py, pergunte: "O que acontece se eu mudar isso?". Ele prevê a cascata de erros em todo o projeto.
🤖 Integração MCP (Para IA): Este é o objetivo principal. Ele funciona como um servidor local. Você apenas faz perguntas como ask("Posso excluir services/old.py?") e ele verifica dependências, histórico do git e segurança.
⏳ Ferramenta de Sequência - você pode habilitar até 10 ferramentas sequencialmente e obter um mini-relatório, em vez de executar 10 solicitações LLM ao mesmo tempo.
❓ FAQ (Antecipando suas perguntas)

P: Como isso é diferente do vulture ou pylint*?* R: vulture encontra variáveis/códigos não utilizados. O Sistema de Saúde do Código encontra padrões arquitetônicos. vulture diz "esta função não é utilizada", mas pode estar errado (importação dinâmica). Minha ferramenta analisa pontos de entrada e gráficos de dependência para dizer "esta pasta inteira é uma ilha isolada que ninguém chama". É mais seguro.

P: O que é "MCP"? R: Você já sabe o que é "MCP". É uma ferramenta de IA conveniente usada no Claude Desktop, Cursor e Windsurf. Este programa foi escrito no vscode e testado no Cline.

P: É seguro executar? R: Sim. Ele roda localmente na sua máquina. Não envia seu código para a nuvem. Ele apenas analisa o AST e o gráfico localmente.

💬 Feedback necessário!

Sou um desenvolvedor jovem, e este é meu primeiro lançamento sério de código aberto. Estou muito interessado em saber: Esta ferramenta é realmente útil para as pessoas? O conceito de "Contexto para IA" faz sentido?

Estou buscando feedback sobre a arquitetura, qualidade do código e se devo continuar desenvolvendo isso. Se você tiver um minuto, por favor, verifique o repositório.

GitHub: https://github.com/atm0sph3re/code-health-system

PyPI: pip install code-health-system

P.S. > "Construído com assistência de IA por um desenvolvedor júnior. Feedback é bem-vindo!"

python #ai #opensource #beginners #showdev