Skip to main content
As Fontes Globais de Regras permitem apontar o Kodus para um ou mais repositórios conectados e importar seus arquivos de regras como Kody Rules globais. Diferente das Regras de Repositório — que valem apenas no repositório onde vivem — as regras importadas de uma fonte global valem em todos os repositórios durante o code review. Use isso quando o time mantém seus padrões de arquitetura e de código num repositório dedicado de “standards” e quer esses padrões aplicados em todo lugar, sem copiar arquivos de regra para cada projeto.

​
Como funciona

  • Você seleciona repositórios conectados para atuar como fontes.
  • O Kodus varre cada repositório fonte em busca de arquivos de regra usando os mesmos padrões da Detecção de Arquivos de Regras (CLAUDE.md, AGENTS.md, .cursor/rules/**, .kody/rules/**, e assim por diante).
  • Cada arquivo de regra encontrado é importado para o escopo global e marcado com o repositório fonte de onde veio.
  • No code review de qualquer repositório, essas regras globais são aplicadas junto com as regras do próprio repositório (respeitando a herança).
Somente repositórios já conectados nas suas configurações de git podem ser usados como fontes globais. Isso mantém uma fonte única de verdade para repositórios conectados e garante que as regras importadas fiquem atualizadas pelo gatilho de Pull Request descrito abaixo.

​
Configuração

  1. Abra Settings → Code Review → Kody Rules e mude para a visão global.
  2. Na aba Configuration, encontre Global rule sources.
  3. Clique no seletor de repositórios e escolha um ou mais repositórios conectados.
  4. Clique em Import selected.
A importação roda em background. Ao terminar, as regras importadas aparecem na sua lista de Kody Rules globais, cada uma identificada com seu repositório fonte.
Você pode selecionar quantos repositórios fonte quiser. O Kodus importa os arquivos de regra que encontrar em cada um deles.

​
Mantendo as regras atualizadas

As regras importadas são atualizadas automaticamente e sob demanda:
  • No merge — quando um Pull Request é mergeado num repositório fonte, seus arquivos de regra são revarridos e as regras globais são atualizadas. Arquivos sem alteração são pulados, então isso é barato.
  • Resync now — use o botão Resync now para revarrer todas as fontes configuradas sob demanda. Isso também cobre mudanças enviadas diretamente para a branch padrão de um repositório fonte.
Mudanças enviadas diretamente para a branch padrão de um repositório fonte (sem Pull Request) não são detectadas automaticamente. Use Resync now após um push direto para capturá-las.

​
Removendo uma fonte

Remover um repositório da lista de fontes apaga as regras globais que foram importadas dele — elas deixam de valer no code review. Você será solicitado a confirmar antes de a remoção tomar efeito. Regras importadas das suas outras fontes, e quaisquer regras que você escreveu à mão, nunca são afetadas.

​
Repositórios fonte não são revisados

Um repositório usado puramente como fonte de regras globais é tratado como repositório de configuração, não como base de código. O Kodus pula o code review em Pull Requests abertos numa fonte global de regras, do mesmo jeito que faz para um repositório de configuração centralizada.

​
Disponibilidade por plano

O acesso às Fontes Globais de Regras depende do seu plano:
No plano Trial, ao importar, o Kodus importa as 5 primeiras regras que encontrar entre os repositórios que você selecionou (na ordem dos arquivos do repositório). Um contador na tela mostra quantas das suas 5 regras já foram usadas, e um diálogo de confirmação detalha quantas serão adicionadas antes de você importar.

​
Relacionados