RECEITAS / 05

Uma regra que vale para todos os agentes

Escreva uma vez que os agentes da loja-api respondem em português e não mexem no package.json sem avisar, e confira que o Claude Code e o Codex leem a regra.

Atualizado para o PrumoGrid 0.5.11

O cenário

Você abre agentes diferentes na loja-api e repete as mesmas orientações a cada conversa: responder em português, não alterar package.json sem avisar. Uma regra do projeto resolve isso. Você escreve uma vez, e o PrumoGrid entrega o texto a todos os agentes do projeto pelo arquivo que cada CLI lê ao começar: CLAUDE.md para o Claude Code, AGENTS.md para o Codex.

Veja no vídeo

VÍDEO 08 · 1:27

Regras. Uma regra do projeto gravada no CLAUDE.md, o que o agente recebe e a prova de que ele a segue. Legendas e transcrição ↗

Passo a passo

Escrever a regra

Selecione loja-api e abra Ferramentas → Regras e papéis….
Em Deste projeto, clique em + Nova regra.
Escreva:
Responda sempre em português do Brasil. Não altere package.json sem avisar antes.
Confira Vale para: todos os agentes do projeto loja-api.
Clique em Salvar e entregar. No Fluxo, o contador passa a mostrar Regras deste projeto · 1.

Regras e papéis com a regra do projeto loja-api e as três seções de alcance. — Deste projeto, De todos os projetos e Por papel ou tipo de CLI: o alcance decide quem recebe a regra.

Autorizar a gravação no projeto

A regra chega ao agente por um bloco que o PrumoGrid grava no CLAUDE.md ou no AGENTS.md da pasta. Na primeira vez que precisa gravar nessa pasta, ele pede licença: ao criar a primeira etapa ou, se já houver um agente aberto no projeto, logo ao salvar a regra. Sem agente aberto, fica assim:

Clique em + Nova etapa e escreva: Quais regras deste projeto você deve seguir? Responda em uma linha.
Clique em Criar etapa. Aparece Gravar orientações no CLAUDE.md?.
Use Ver o que será gravado: é um bloco entre dois marcadores, e o resto do arquivo fica como está.
Clique em Permitir neste projeto. A permissão vale para esta pasta, e o PrumoGrid não pergunta de novo.
O Claude Code responde citando as duas orientações, que ele leu do arquivo.

Pedido para gravar orientações no CLAUDE.md, com as opções de ver, permitir ou nunca gravar. — A permissão é por pasta. Nunca gravar neste projeto cria a etapa sem tocar no arquivo.

Conferir o que o agente recebe

Em Regras e papéis…, abra Ver o que o agente lê. A prévia mostra tudo o que o agente recebe e de onde vem cada trecho. Ela só tem conteúdo com um terminal de agente aberto no projeto.
Num PowerShell da loja-api, rode git status --short:

text

?? .terminal-grid/
?? CLAUDE.md

A regra ficou no repositório, em .terminal-grid\regras.json, e a tela marca no repositório. Se você fizer commit desses arquivos, quem clonar o projeto recebe a mesma regra.

Escolher o alcance certo

Onde criar	Quem recebe	Exemplo
Deste projeto	Todos os agentes deste projeto	"Não altere package.json sem avisar antes."
De todos os projetos	Todos os agentes de todos os projetos, só no seu computador	"Explique o plano antes de mudar mais de três arquivos."
Por papel ou tipo de CLI	Só quem estiver num papel (revisor, por exemplo) ou só um tipo de CLI	"Cite arquivo e linha em cada achado", para o revisor

Regra é o que vale sempre. O que é específico de uma tarefa ("corrija a validação do campo nome") vai na instrução da etapa.

Dicas

Escreva orientações curtas e verificáveis. "Responda em português" funciona melhor do que "seja claro".
Prefira uma regra com duas orientações relacionadas a duas regras quase iguais; o contador e a prévia ficam mais fáceis de ler.
Antes de versionar, leia o git diff do CLAUDE.md: só o que está entre os marcadores muda nas gravações seguintes.
Para levar regras a outro computador sem o Git, use Exportar… e Importar… em Regras e papéis. Revise o conteúdo antes de importar.

Limites

O agente lê o arquivo quando a conversa começa. Uma regra salva com a conversa já aberta pode precisar de uma conversa nova para valer.
Com Nunca gravar neste projeto, o agente deixa de receber as regras e a verificação pelo arquivo. O cartão mostra gravação desligada e o link Como religar. Veja Regras.
Regras orientam; não garantem. Para o que precisa ser cumprido sempre, como os testes passarem, use uma verificação.