Regras

Para que serve

Uma regra é uma orientação que vale para toda tarefa, como "responda em português" ou "não altere o package.json sem avisar". Você escreve uma vez em Regras e papéis…, escolhe para quem ela vale, e o PrumoGrid entrega no arquivo que cada CLI lê ao abrir: CLAUDE.md para o Claude Code, AGENTS.md para o Codex e o Gemini. O Claude e o Codex do mesmo projeto passam a receber as mesmas orientações, e você para de repetir isso em cada pedido.

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 ↗

Quando usar e quando não usar

Use uma regra para o que se repete em todas as tarefas de um projeto, ou de todos os seus projetos: idioma da resposta, arquivos que não se mexe sem avisar, "toda mudança em src vem com um teste".

Uma regra é diferente de uma tarefa. "Corrigir o cupom PRIMEIRA" é tarefa: vai na Nova etapa. "Antes de alterar uma interface pública, encontre quem a usa e descreva o impacto" é regra.

As regras são opcionais. Sem nenhuma, terminais, Fluxo e aviso de fim de turno funcionam igual. Se você já mantém um CLAUDE.md escrito à mão, ele continua sendo lido; o PrumoGrid escreve só no trecho dele.

Passo a passo

Criar uma regra para a loja-api

1. Selecione loja-api e abra Ferramentas → Regras e papéis….
2. A tela mostra três grupos de regras: Deste projeto, De todos os projetos e Por papel ou tipo de CLI. Abra Deste projeto.
3. Clique em + Nova regra.
4. Em A regra, escreva Responda sempre em português do Brasil. Não altere package.json sem avisar antes.
5. Confira Vale para: todos os agentes do projeto loja-api. As outras opções são Todos os projetos, Só quem estiver num papel e, em Avançado, só um tipo de agente.
6. Leia a frase de entrega, por exemplo "Ao salvar, Claude Code recebe a regra.", e clique em Salvar e entregar.
7. Feche a tela. No Fluxo, o contador mostra Regras deste projeto · 1.

Uma regra pode ter mais de uma orientação, como esta. O contador conta regras, não frases.

Ver a regra chegar ao agente

1. Clique em + Nova etapa e peça Quais regras deste projeto você deve seguir? Responda em uma linha.
2. Clique em Criar etapa. Na primeira etapa do projeto, aparece Gravar orientações no CLAUDE.md? (veja a seção abaixo).
3. Clique em Ver o que será gravado, leia o bloco e volte. Clique em Permitir neste projeto.
4. O Claude Code abre e responde com as duas orientações. A pergunta não citava nenhuma: ele leu do arquivo.
5. No PowerShell da loja-api, rode git status --short. Aparecem ?? .terminal-grid/ (onde a regra mora) e ?? CLAUDE.md (o arquivo que o agente lê).

O que aparece na tela

Ampliar captura ↗

Ampliar captura ↗

Ver o que o agente lê mostra o arquivo inteiro, na ordem em que o agente lê, com a origem de cada trecho: as suas regras, o que é gerado pelo produto e o que foi escrito à mão (o PrumoGrid não toca). Abra essa prévia quando o agente fizer algo que você não esperava. Ela só tem conteúdo com um terminal de agente aberto no projeto.

Onde as regras ficam

• Regras deste projeto, de papel ou de tipo de CLI podem morar no repositório, em <projeto>\.terminal-grid\regras.json. Elas aparecem no git status, entram no commit e chegam a quem clonar. O PrumoGrid não mexe no .gitignore: para a equipe receber, commite .terminal-grid\regras.json.
• Ou podem ficar só nesta máquina, no seu perfil. Não aparecem no Git e não chegam a mais ninguém.
• Regras de todos os projetos ficam sempre no perfil local, porque um repositório não fala pelos outros.

Para levar regras a outra máquina ou mandar a um colega, use Exportar…, que grava um arquivo JSON, e Importar…, que lê esse arquivo. As regras importadas entram como regras desta máquina; mover para o repositório é um passo à parte. Revise o conteúdo e o alcance antes de importar.

Gravação nos projetos

Para o agente seguir as regras, o PrumoGrid grava um bloco identificado no arquivo que a CLI lê na pasta do projeto: CLAUDE.md para o Claude Code, AGENTS.md para o Codex. O bloco leva o objetivo, a etapa e o papel, as regras, as instruções do tg e, se você marcar Registrar também o comando de verificação neste arquivo, o comando de verificação. Ele fica entre os marcadores tg:begin e tg:end. O resto do arquivo não muda; na gravação seguinte, só o que está entre os marcadores é substituído.

Como é um arquivo do seu repositório, o PrumoGrid pede licença na primeira vez que precisa gravar nessa pasta: ao criar a primeira etapa do projeto ou, se um agente já estiver aberto no projeto, ao salvar e entregar a primeira regra.

1. Aparece Gravar orientações no CLAUDE.md? (ou no AGENTS.md), com o Arquivo, o Projeto e Vale para: as próximas gravações neste projeto.
2. Ver o que será gravado mostra o bloco antes de decidir. Voltar retorna à pergunta.
3. Permitir neste projeto grava agora e nas próximas etapas desta pasta, sem perguntar de novo.
4. Nunca gravar neste projeto cria a etapa sem gravar o arquivo. O agente deixa de receber regras e verificação por ele, e o cartão do projeto passa a mostrar gravação desligada, com o link Como religar.

Ampliar captura ↗

Ampliar captura ↗

A escolha é por pasta. Para rever, abra Ferramentas → Gravação nos projetos…, que leva a Opções avançadas na seção Gravação nos projetos. Cada projeto aparece com o estado (gravação permitida, gravação desligada ou pergunta na primeira etapa) e um botão: Religar na pasta desligada, Desligar nas outras. Religar faz o PrumoGrid voltar a perguntar na próxima etapa.

Depois da primeira etapa permitida, o git diff do CLAUDE.md deve mudar só entre os marcadores. Se você editar à mão, escreva fora do bloco.

Dicas

• Escreva regras curtas e concretas. O contador da regra mostra quantos caracteres o agente lê toda vez que abre.
• Agentes já abertos só releem o arquivo quando alguém pede. Marque Avisar pela mensageria os agentes já abertos ao salvar, ou abra o agente de novo.
• Regras de papel ficam em Por papel ou tipo de CLI: "cite arquivo e linha em cada achado" para o revisor, por exemplo. Veja Papéis.
• Para uma preferência sua em qualquer pasta, como o idioma, use De todos os projetos.

Limites conhecidos

• Escrever uma regra não comprova que o agente obedeceu. Leia a resposta, ou use uma verificação quando houver um comando que pegue a quebra.
• Com a gravação desligada, o agente não recebe as regras nem o comando de verificação pelo arquivo.
• Uma pasta que só existe dentro do WSL não recebe as regras pelo Windows.
• Uma CLI aberta à mão sem um tipo cadastrado em Perfis de agente… não tem arquivo em que gravar, e não recebe a regra.
• Mudar uma regra não muda a instrução já entregue a um fluxo em andamento; ela vale para os próximos fluxos ou ao executar um fluxo planejado.