PathruleNão é uma sugestão.
É uma regra que vale.
Regras e restrições para agentes de programação com IA. Cada uma tem um escopo, uma prioridade e um nível de aplicação, para que um requisito nunca chegue com o peso de uma preferência.
Dinheiro é armazenado como inteiros em centavos.
- onde
- Só em /services/billing
- com que força
- Sempre enviada quando está no escopo
- em uma violação
- Uma edição correspondente é negada antes de acontecer
O escopo está resolvido. A prioridade, não.
- Uma regra de segurança soa como dica de estilo
- Pesa diferente no quadragésimo turno
- Descreve um erro, mas não consegue impedi-lo
- Sem histórico da própria regra
- Nunca publique a service keyhigh, strict
- Dinheiro em centavos inteiroshigh
- Prefira exports nomeadoslow
- services/billing/checkout.ts
- Cada regra carrega sua prioridade
- Só dispara onde se aplica
- Uma regra estrita pode recusar a edição
- Versionada e revisável
Os arquivos de instruções já conseguem apontar uma regra para uma pasta. A própria documentação da Anthropic ainda os chama de “contexto, não configuração imposta” e recomenda hooks para tudo o que precisa valer.
Prioridade alta é um orçamento.
Tudo em alta
- alta, sempre enviada
- 96
- média, quando relevante
- 0
- baixa, quando há espaço
- 0
Maioria em média
- alta, sempre enviada
- 5
- média, quando relevante
- 28
- baixa, quando há espaço
- 16
Se metade das regras tem prioridade alta, nenhuma tem. Use média como padrão e promova uma regra só quando você souber dizer qual incidente uma violação causa.
Onde uma regra estrita pode bloquear.
No Claude Code, a edição é bloqueada.
por quê O pathrule setup registra o hook do Pathrule, que verifica a edição antes de ela ser executada.
por quê O mesmo hook do Claude Code, em torno de cada edição e gravação.
por quê Hooks de ferramenta rodam em torno de cada edição, junto com as Cursor Rules.
por quê A CLI e a extensão para VS Code registram o hook onde o Copilot o executa.
por quê O Windsurf não tem hooks, então não há um evento anterior à gravação em que bloquear.
por quê O endpoint hospedado não instala hooks. As regras chegam como contexto.
Depende do cliente, não da regra. Onde existe um hook anterior à gravação, uma regra estrita com um padrão de bloqueio aprovado impede uma edição correspondente e se apresenta como o motivo.
Isso é mesmo uma regra?
- A resposta começa com “depende”?O agente deve ponderar de acordo com a situação.Escreva uma memória
- É uma sequência que alguém vive repetindo?A ordem importa mais do que qualquer passo isolado.Escreva uma skill
- Inegociável?Dê a ela um escopo, uma prioridade e um nível de aplicação.É uma regra
Escrever uma preferência como regra tira a credibilidade de todas as suas outras regras.
Perguntas frequentes.
O que é uma regra para agentes de IA?
Uma restrição que um agente de programação com IA precisa seguir dentro de um escopo definido. Uma regra tem um tipo de escopo (folder, file_type ou project), uma prioridade (high, medium ou low) e um nível de aplicação (advisory ou strict), que juntos decidem onde ela se aplica, com que força aparece e o que acontece quando algo a viola.
Qual é a diferença entre uma regra e uma memória?
Uma memória diz o que é verdade aqui, e o agente a pondera diante da situação. Uma regra diz o que não pode acontecer e não está aberta a negociação. Se a resposta honesta é “depende, o agente deveria pensar nisso”, escreva uma memória: escrever isso como regra tira a credibilidade de todas as suas outras regras.
Por que meu agente de IA ignora as regras?
Normalmente porque a regra disputa espaço com orientações sem relação com ela em um arquivo de instruções longo, porque o escopo está errado e ela nunca dispara nos caminhos onde importa, ou porque está escrita como preferência e, por isso, é corretamente deixada de lado. Leituras longas: por que as regras do Cursor são ignoradas em silêncio e por que o Claude Code ignora seu CLAUDE.md.
Uma regra consegue mesmo bloquear uma alteração, ou só orienta?
As duas coisas são possíveis, e depende do cliente. Uma regra estrita com um padrão de bloqueio aprovado é verificada pelo hook local do Pathrule, que nega uma edição correspondente antes de ela acontecer e apresenta a regra como motivo. A CLI do Pathrule e a extensão para VS Code registram esse hook para Claude Code, Codex, Cursor e GitHub Copilot. O Windsurf e o Remote MCP recebem as regras como contexto, sem um evento anterior à gravação em que bloquear.
Quantas regras devem ter prioridade alta?
Poucas. Prioridade alta significa ser sempre injetada quando o escopo corresponde, então é um orçamento: se metade das suas regras tem prioridade alta, nenhuma tem. Reserve para violações que causam bugs, regressões de segurança ou problemas de conformidade, e deixe todo o resto em média.
Qual a diferença disso para as Cursor Rules ou o CLAUDE.md?
As regras do Cursor e as do Claude Code podem ser vinculadas a caminhos, e os dois produtos expõem hooks. O Pathrule armazena cada regra com escopo, prioridade e aplicação em uma única fonte do espaço de trabalho, seleciona a regra para a tarefa e a envia a Claude Code, Codex, Cursor, GitHub Copilot e Windsurf. Lado a lado: Pathrule vs Cursor Rules e Pathrule vs arquivos de instruções.
Preciso apagar meus arquivos de regras atuais?
Não. O Pathrule fica acima deles. CLAUDE.md, AGENTS.md e .cursorrules continuam fazendo o que fazem bem, que é guardar as constantes do repositório inteiro. O Pathrule carrega as restrições vinculadas a caminhos que esses arquivos não conseguem modelar bem.
A mesma regra pode valer para mais de um caminho?
Sim. As regras são reutilizáveis: um único objeto de regra pode ser vinculado a vários nós, então uma restrição compartilhada é escrita e revisada uma vez, em vez de copiada em cada diretório. Como escrever regras traz os detalhes de autoria.