Wyattputrescent882/ai-code-governance-skill

O que ai-code-governance-skill faz?

Imponha padrões de arquitetura e fluxos de trabalho de mantenedores para agentes de codificação de IA, prevenindo duplicação de código, verificando alterações e controlando dependências do projeto.

• Fonte: https://github.com/Wyattputrescent882/ai-code-governance-skill
• Estrelas no GitHub: 0
• Último push: 2026-06-16T08:26:18Z
• Adicionado por Awesome Skills daily skill hunter em 2026-06-16.

Visão Geral

Esta habilidade permite que agentes de codificação de IA apliquem regras de governança de código diretamente durante o desenvolvimento. Ela garante que todas as alterações propostas estejam em conformidade com os padrões de arquitetura do projeto, evitando duplicação desnecessária, validando alterações e controlando dependências de terceiros.

Como Funciona

1. Detecção de Duplicação: A skill analisa o código existente e o diff proposto para identificar padrões duplicados e sugere refatorações para manter a base de código enxuta.
2. Verificação de Padrões: Ela confere se as alterações seguem os padrões de arquitetura definidos, como nomenclatura de classes, estrutura de diretórios e uso de design patterns.
3. Controle de Dependências: A skill valida a adição de novas dependências, garantindo que apenas bibliotecas aprovadas e versões permitidas sejam utilizadas.

Plataformas Suportadas

• Claude Code
• Cursor
• Codex
• Qualquer agente de IA compatível com skills baseadas em markdown

Configuração

Para usar esta skill, você precisa definir as regras de governança em um arquivo de configuração (por exemplo, .governance-rules.yaml ou governance.json). Exemplo:

# .governance-rules.yaml
standards:
  naming:
    classes: PascalCase
    functions: camelCase
  dependencies:
    allowed-scopes:
      - production
      - development
    blocklist:
      - deprecated-library
      - unlicensed-package
duplication:
  threshold: 5  # Número máximo de linhas duplicadas permitidas
  exclude-dirs:
    - vendor/
    - generated/

Uso com Agentes de IA

Quando um agente de IA gerar código que viola as regras, a skill irá:

1. Exibir um aviso claro com a violação específica
2. Sugerir uma correção automática quando possível
3. Recusar a aplicação da alteração até que a violação seja resolvida

Exemplo de Interação

Usuário: Adicione uma nova classe de serviço para processar pagamentos.
Agente: [Analisando...] Detecto que a classe proposta `paymentService` não segue o padrão PascalCase (deveria ser `PaymentService`). Além disso, a dependência `unlicensed-package` está na lista de bloqueio. Vou sugerir uma correção.

Correção sugerida:
- Renomear `paymentService` para `PaymentService`
- Substituir `unlicensed-package` por `licensed-payment-lib`

Benefícios

• Consistência: Código gerado por IA sempre segue as mesmas regras que o código humano.
• Economia de Tempo: Reduz a necessidade de revisões manuais de código para problemas triviais.
• Segurança: Impede a introdução de dependências não aprovadas ou vulneráveis.

Contribuição

Contribuições são bem-vindas! Envie um pull request ou abra uma issue no repositório oficial.

Licença

Este projeto está licenciado sob a licença MIT.