Skip to main content
Na interface de Regras do Kody, você configura duas coisas diferentes, e saber quando usar cada uma torna suas revisões de código mais eficazes. Uma regra prática:
  • Memórias ensinam ao Kody como seu codebase funciona para que futuras revisões e sugestões sejam mais relevantes.
  • Regras de Revisão dizem ao Kody o que ele deve sinalizar quando um PR não estiver batendo com seus padrões.

Regras de Revisão

Regras de Revisão são verificações tradicionais de revisão de código que são executadas durante a etapa dedicada de revisão. Elas analisam diffs de arquivos ou o PR completo em relação aos seus critérios definidos. Melhores para:
  • Limites de arquitetura (“a camada de domínio não deve importar infraestrutura”)
  • Padrões de código (“evite == em condições de loop”)
  • Requisitos de PR (“todo arquivo de serviço deve ter um teste”)
  • Validação estrutural usando variáveis como fileDiff, pr_files_diff
Como funcionam:
  • Executadas por arquivo ou por PR (o Execution mode da regra)
  • Executadas apenas durante a revisão de código
  • Suportam referências de arquivo (@file, @repo) e funções MCP
  • Produzem sugestões com níveis de severidade

Memórias

Memórias são instruções contextuais persistentes injetadas em todas as interações — revisões de código, conversas e sugestões de IA. Elas representam o conhecimento de contexto que o Kody deve carregar sobre seu codebase, suas convenções e preferências. Melhores para:
  • Contexto do codebase (“este repositório espelha uma API de terceiros, então alguns campos externos permanecem intencionalmente em snake_case”)
  • Preferências de sugestão (“ao sugerir utilitários JS aqui, prefira métodos nativos em vez de Lodash”)
  • Contexto de migração (“o módulo de billing está no meio de uma migração, então prefira mudanças incrementais a refactors amplos”)
  • Contexto arquitetural (“este serviço segue arquitetura hexagonal e mantém adapters nas bordas”)
Como funcionam:
  • Injetadas como contexto de alta prioridade em todos os prompts
  • Melhoram sugestões futuras ao dar ao Kody contexto específico do repositório
  • Criadas via conversa (@kody remember: ...) ou manualmente com New memory na aba Memories de Code review → Kody Rules
  • Com escopo de diretório, repositório ou nível de organização
  • O Kody deduplica automaticamente e resolve conflitos entre memórias

Quando usar cada uma

Posso converter entre elas?

Não diretamente — não há uma ação de conversão no app. Memórias pendentes aparecem na seção Pending review de Code review → Kody Rules, onde você pode aprová-las (Approve) ou descartá-las (Discard). Se uma memória precisar de uma aplicação mais estruturada com caminhos de arquivo e níveis de severidade, crie uma Regra de Revisão com New rule na aba Review Rules e exclua ou descarte a memória. Para detalhes, consulte Regras do Kody.