Gate: rule-types
Every code letter is declared in the vocabulary, with no conflict.
| Propriedade | Valor |
|---|---|
| Verificação | rule-types |
| Confronta | spec |
| Bloqueante por padrão — projeto novo | sim |
| Bloqueante por padrão — projeto existente | não — informa |
| Duplicidade | uma declaração que ele controla repetida no mesmo arquivo o reprova; duplicates: false desliga |
Como declarar
Seção intitulada “Como declarar”gates: - name: rule-types on: [spec] check: rule-typesFonte: verificação · sua spec (em inglês)
🎯 O que este gate mede?
Seção intitulada “🎯 O que este gate mede?”Garante que os prefixos e letras de códigos seguem a declaração de tipos de regras do projeto.
Em termos simples: este gate garante que o seu software não cometa erros por descuido ou falta de sincronização. Se você ou uma inteligência artificial alterar um arquivo coberto por este gate, ele inspeciona o trabalho imediatamente.
🛡️ Por que isso é importante?
Seção intitulada “🛡️ Por que isso é importante?”Mantém o vocabulário de letras de regras padronizado em todo o repositório.
Sem este gate ativo, esse tipo de defeito passa despercebido pelos testes comuns e só estoura em produção ou durante refatorações dolorosas semanas depois.
⚙️ Como funciona por baixo dos panos?
Seção intitulada “⚙️ Como funciona por baixo dos panos?”Compara as letras de regras usadas nas specs contra o vocabulário rule_types do anchors.yaml.
Condições dos Vereditos:
Seção intitulada “Condições dos Vereditos:”✓ Pass(Aprovado): Todas as letras de códigos pertencem ao vocabulário oficial.✗ Fail(Reprovado): Letra de código não cadastrada no anchors.yaml.~ Indeterminado/Pending: Não se aplica.Skip(Dispensado): Não se aplica.
📋 Exemplo de Configuração no anchors.yaml
Seção intitulada “📋 Exemplo de Configuração no anchors.yaml”Para ativar este gate no seu projeto, adicione o bloco abaixo na seção gates: do seu anchors.yaml:
gates: - name: rule-types blocking: true measures: "as letras dos códigos estão no vocabulário declarado"💡 Recomendações de Uso
Seção intitulada “💡 Recomendações de Uso”- Quando ativar: Bloqueante para manter a consistência da taxonomia.
- Fase de execução: Configure em
when: [pre-commit, ci]para verificações rápidas, ouwhen: [pre-push, ci]para gates que rodam ferramentas mais pesadas. - Transição de maturidade: Comece com
blocking: falsepara avaliar o estado atual do repositório comanchors check. Quando zerar as ocorrências, altere parablocking: true.
🔧 Como corrigir quando este gate reprovar?
Seção intitulada “🔧 Como corrigir quando este gate reprovar?”Se o anchors check acusar falha (✗) neste gate:
- Use as letras padrão (B, V, E, S, DS, VR) ou declare a nova letra em
rule_types. - Reexecute a verificação no terminal:
Terminal window anchors check - Se o gate suportar correção automática, você pode tentar o comando:
Terminal window anchors check --fix
🔗 Conceitos Relacionados
Seção intitulada “🔗 Conceitos Relacionados”- Guia Completo de Camadas: Entenda quais camadas exigem este gate.
- A Unidade (The Unit): A relação entre Spec, Feature, Teste e Código.
- Gates e Vereditos: A mecânica completa de avaliação do Anchors.
- Catálogo Completo de Gates: Retornar ao índice pesquisável de todos os gates.