Como criar regras personalizadas de revisão de código

​

Criando uma regra no Kodus

1. Selecione Global (ou um repositório / diretório) no seletor de escopo no topo do grupo Code review na barra lateral e abra Kody Rules
2. Clique em New rule
3. Configure:
   • Rule name — o que a regra verifica (ex.: “Arquivos de serviço devem ter testes”)
   • Execution mode — Per file (analisa cada arquivo alterado) ou Per PR (analisa o PR completo)
   • Path — padrão glob para direcionar arquivos específicos (ex.: src/services/**/*.ts); não é usado por regras Per PR
   • Severidade — Crítica, Alta, Média ou Baixa
   • Instruções — descrição detalhada do que verificar

​

O que torna as regras poderosas

• Variáveis como fileDiff, pr_title, pr_description, pr_files_diff
• Referências de arquivo com @file:caminho/para/arquivo.ts para comparar com padrões
• Funções MCP para buscar dados de ferramentas conectadas (Jira, estrutura do repositório, etc.)

​

Exemplo: Regra de limite arquitetural

Nome: A camada de domínio não deve depender da infraestrutura
Execution mode: Per PR
Instruções: Verifique pr_files_diff para qualquer importação em src/domain/
que referencie src/infrastructure/. Consulte
@file:docs/architecture.md para dependências permitidas.

​

Exemplo: Regra de cobertura de testes

Nome: Todo serviço deve ter um arquivo de teste
Execution mode: Per PR
Instruções: Para cada arquivo modificado em src/services/,
verifique se existe um arquivo de teste correspondente em test/services/.
Use MCP para verificar a árvore de arquivos do repositório.

​

Outras formas de adicionar regras

• Importar da Biblioteca de Regras — clique em Discovery na página de Kody Rules para navegar por regras comprovadas por linguagem e categoria
• Sincronizar de ferramentas de IDE — importe regras automaticamente do Cursor, Copilot, Claude
• Regras de repositório — defina regras em arquivos markdown no seu repositório
• Geração automática — o Kody sugere regras baseadas no seu histórico de revisões