Skip to main content
Uma diretiva de revisão permite dizer à Kody onde concentrar a análise mais profunda em uma revisão específica. Em vez de mudar qualquer configuração, você anexa uma instrução curta ao acionar a revisão — por exemplo, “foque na lógica de auth e sessão” — e a Kody gasta a análise mais rigorosa no código alterado que corresponde a isso.
Uma diretiva é efêmera: vale apenas para aquela execução de revisão. Ela não é salva nas suas configurações e não afeta revisões futuras. Para mudar o comportamento da Kody de forma permanente, use Custom Prompts ou Kody Rules.

​
Quando Usar

  • Um PR mexe em muitos arquivos, mas você se importa mais com uma área arriscada (auth, pagamentos, uma migração).
  • Você quer que a Kody rastreie os callers e callees de uma mudança específica e a questione com mais rigor.
  • Você está reexecutando uma revisão e quer direcionar a atenção sem editar nenhuma configuração.

​
Prioridade, Não Filtro

Este é o ponto mais importante de entender:
Uma diretiva define prioridade, não filtro. A Kody prioriza a área de foco, mas ainda reporta qualquer bug, problema de segurança ou de performance concreto que perceba em outros pontos do diff. Ela nunca suprime achados fora do foco e nunca aprova o resto do PR sem olhar.
Use uma diretiva para dizer “olhe aqui com mais afinco” — não “olhe só aqui.”

​
Como Acionar

Coloque o texto de foco logo após o comando de revisão em um comentário do pull request:
Você também pode usar start-review e combinar com --force:
--force reexecuta a review mesmo quando Kody normalmente pularia (“nenhum commit novo desde a última review”). Use — com ou sem diretiva de foco — para obter uma nova análise depois de corrigir o que fez a execução anterior falhar, ou para aplicar configurações atualizadas a um PR já revisado.
Apenas a primeira linha após o comando é usada como diretiva. Tudo nas linhas seguintes é ignorado, então mantenha o foco em uma única linha.
Funciona no GitHub, GitLab, Azure DevOps, Bitbucket e Forgejo.

​
Heavy mode

Alpha — acesso sob pedido. O heavy mode não vem ligado para ninguém. Para experimentar, peça para habilitarmos na sua organização no Discord ou em support@kodus.io. Até lá a flag é aceita mas não tem efeito — veja Disponibilidade abaixo.
Uma diretiva de foco diz ao Kody onde olhar com mais atenção. O --heavy diz para olhar por mais tempo: o finder roda passadas extras de crítico (“o que você deixou passar?”) sobre o mesmo diff, trazendo mais problemas reais ao custo de uma revisão mais lenta e mais candidatos para triar.
O --heavy pode ficar em qualquer posição da linha — antes ou depois do texto de foco — e é removido da diretiva de qualquer jeito, então @kody review foca na lógica de retry --heavy foca em “foca na lógica de retry”.
Para combinar com --force, coloque o --force primeiro. O --force só é reconhecido imediatamente após o comando, então @kody review --force --heavy roda uma revisão heavy forçada, enquanto @kody review --heavy --force roda uma revisão heavy que não é forçada.
O traço é obrigatório: um heavy solto é lido como texto de diretiva, então @kody review heavy fluxo de checkout foca em “heavy fluxo de checkout” em vez de ligar a flag.

​
Disponibilidade

O heavy mode é um recurso alpha. Ele só roda para organizações que habilitamos explicitamente:
A flag falha em silêncio, não com erro. Se sua organização não está habilitada, o --heavy é aceito e a revisão roda normalmente — sem erro, sem aviso, sem resultado diferente. Se você pediu acesso e não consegue saber se está ativo, fale com a gente em vez de presumir.
Para pedir acesso, chame a gente no Discord ou mande um e-mail para support@kodus.io com o nome da sua organização.
Use nas mudanças em que deixar algo passar sai caro — uma migration, uma mudança de auth, um fluxo de pagamento — não como padrão. Em PRs do dia a dia os candidatos extras costumam ser ruído que você vai ter que filtrar.

​
Escrevendo uma Boa Diretiva

  • Seja específico sobre a área, não sobre o veredito. “foque em concorrência no consumidor da fila” funciona melhor que “encontre bugs”.
  • Nomeie o código, não o resultado. Aponte para um módulo, fluxo ou preocupação (“a lógica de retry”, “o SQL no serviço de relatórios”).
  • Seja breve. Diretivas têm limite de 500 caracteres; só a primeira linha do comentário é lida.
  • @kody review foque no fluxo de autenticação e refresh de token
  • @kody review foque no novo tratamento do webhook do Stripe
  • kodus review --focus "condições de corrida no worker em background"
  • @kody review por favor seja minucioso — não há área para priorizar.
  • @kody review comente só no arquivo X — uma diretiva não é filtro; use caminhos ignorados para restringir arquivos.

​
Observações e Limites

  • Tamanho: diretivas são truncadas em 500 caracteres.
  • Só a primeira linha: em comentários de PR, apenas a primeira linha após o comando vira a diretiva.
  • Não confiável por design: como qualquer pessoa que pode comentar no PR pode fornecer uma diretiva, o texto é sanitizado antes do uso (caracteres de controle e sinais de menor/maior são removidos). Isso não altera o seu foco — apenas impede que o texto adultere o prompt interno da Kody.
  • Não persistida: nada é gravado nas configurações do seu repositório ou organização.