Trave o seu agente de IA mesmo quando ele desobedece

01Pra que serve

• Barrar comandos do git que apagam trabalho, como push forçado e "git reset --hard", antes de o agente rodar. Se ele tentar, o Claude Code cancela.
• Impedir que uma mudança com teste vermelho entre na versão principal do projeto: a verificação automática do GitHub segura a mudança até tudo passar.
• Bloquear que alguém (ou o agente) mande mudança direto pra versão principal sem passar pela verificação.
• Fazer cada tarefa fechar com prova de cada item pedido (log ou print) e um veredito honesto: PASSOU ou FALHOU.
• Auditar um projeto que você já tem e ver o que falta, item por item, numa lista de conferência pronta.

02O que você precisa

• Claude Code (a assinatura que você já usa)
• Um projeto no GitHub, com o GitHub Actions (as verificações automáticas do GitHub)
• Ser admin do repositório pra ligar a proteção da versão principal
• Os exemplos vêm prontos pra projetos em Node/npm

03Passo a passo

1. Abra o Claude Code dentro da pasta do seu projeto. Primeiro, adicione a loja de plugins do repositório (é só colar no chat do Claude Code):

   Copiar

   /plugin marketplace add goul4rt/quick-guardrails-ia

2. Agora instale o plugin. Ele traz duas habilidades: uma que audita o projeto e outra que escreve o AGENTS.md (o arquivo com as regras do projeto pro agente).

   Copiar

   /plugin install guardrails@metodologias

3. Peça em português: "aplique os guardrails". O agente compara o seu projeto com a lista de conferência do repositório e mostra o que já tem e o que falta. Use o primeiro prompt abaixo.
4. Ligue a trava do git: o repositório traz um arquivo pronto que barra os comandos perigosos antes de rodar. Peça pro agente copiar a pasta templates/.claude/ pro seu projeto (prompt 3 abaixo).
5. Proteja a versão principal no GitHub. Esse passo é manual e só o admin do repositório consegue: nas configurações do repositório, exija a verificação "ci" antes de juntar qualquer mudança e bloqueie envio direto pra versão principal.
6. Confira o tamanho do AGENTS.md. A lista pede menos de 200 linhas. No Mac, rode no terminal (ou peça pro agente rodar):

   Copiar

   wc -l AGENTS.md

04Prompts prontos pra colar no Claude Code

Aplique os guardrails neste repositório.
Compare o projeto com o CHECKLIST.md item por item e me devolva uma tabela em português: item, se já está feito (sim/não/em parte) e a prova que você conferiu (arquivo ou comando).
Não mude nenhum arquivo ainda. No fim, me diga as 3 travas mais importantes pra eu ligar primeiro, considerando que meu projeto é [TIPO DO PROJETO, ex.: site em Next.js].

Escreva o AGENTS.md deste repo comigo.
O projeto é [DESCREVA EM 1 FRASE O QUE ELE FAZ]. Os comandos que eu uso pra rodar e testar são [COMANDOS].
Coloque regras objetivas que dá pra conferir, as pegadinhas que você encontrar no código e as regras de PARAR antes de operações arriscadas.
O arquivo tem que ficar com menos de 200 linhas. Me pergunte o que não souber em vez de inventar.

Copie a trava de comandos git perigosos de templates/.claude/ do repositório quick-guardrails-ia pro meu projeto.
Antes de copiar, me explique em português quais comandos ela barra e quais continuam liberados.
Eu quero bloquear [SÓ O PUSH FORÇADO / TODO PUSH]. Registre essa escolha no próprio arquivo.
Depois teste: tente rodar um comando barrado e me mostre que ele foi cancelado.

Tarefa: [O QUE VOCÊ QUER QUE ELE FAÇA].
Critérios de aceite:
1. [CRITÉRIO 1]
2. [CRITÉRIO 2]
Quando terminar, para cada critério mostre a prova (log do comando ou print) e dê um veredito honesto: PASSOU ou FALHOU.
Se algum falhou, diga que falhou. Não feche a tarefa sem prova de todos.