hrconsultnj/claude-plugins

O que claude-plugins faz?

Plugin para Claude Code — hooks de qualidade de código, grafo de conhecimento, revisões cientes de impacto e aplicação de decomposição. Babá para a qualidade de código da sua IA.

Visão Geral

Este conjunto de plugins e regras transforma o Claude Code em um assistente de desenvolvimento disciplinado. Ele automaticamente:

• Executa verificações de qualidade antes e depois de commits.
• Mantém um grafo de conhecimento do projeto para avaliar o impacto das mudanças.
• Exige que tarefas complexas sejam decompostas em etapas menores.
• Fornece revisões de código com consciência de contexto (impact-aware).

Como Funciona

1. Plugins Ativados:

   • pre-commit: Verifica lint, formatação e testes básicos antes de cada commit.
   • post-commit: Atualiza o grafo de conhecimento após mudanças bem-sucedidas.
   • impact-analysis: Analisa dependências e sugere possíveis regressões.
   • decomposition: Exige que solicitações grandes sejam divididas em subtarefas.

2. Grafo de Conhecimento:

   • Mapeia módulos, funções e suas dependências.
   • Armazena metadados sobre mudanças anteriores (autor, motivo, impacto).
   • Usado pela análise de impacto para prever consequências de alterações.

3. Regras de Revisão:

   • Verificações de estilo (PEP8 para Python, ESLint para JS/TS).
   • Verificação de cobertura de testes.
   • Detecção de código morto ou duplicado.
   • Sugestões de refatoração baseadas em padrões.

Instalação

# Adicione o repositório como submodulo ou copie os arquivos
cd seu-projeto
git submodule add https://github.com/hrconsultnj/claude-plugins .claude/plugins

# Instale dependências
pip install -r .claude/plugins/requirements.txt

Configuração

No arquivo .claude/claude.json ou claude.toml:

{
  "plugins": [
    "hrconsultnj/claude-plugins"
  ],
  "settings": {
    "claude.plugins.enforcePreCommit": true,
    "claude.plugins.enforcePostCommit": true,
    "claude.plugins.impactAnalysis": true,
    "claude.plugins.decomposition": true,
    "claude.plugins.knowledgeGraphPath": ".claude/knowledge-graph.json"
  }
}

Requisitos

• Claude Code (CLI ou integrado ao editor)
• Python 3.8+ (para scripts auxiliares)
• Git (para hooks)

Exemplo de Uso

# Ative o plugin manualmente
claude run --plugin hrconsultnj/claude-plugins

# O Claude Code então:
# 1. Antes de escrever código, pergunta: "Qual é o impacto desta mudança?"
# 2. Após o commit, analisa: "Esta alteração quebra alguma dependência?"
# 3. Se a tarefa for grande: "Decomponha em 3 etapas menores."

Licença

MIT

Contribuição

Pull requests são bem-vindos. Consulte o arquivo CONTRIBUTING.md para detalhes.