Guardrails do Agente da Empresa
Propósito
Definir e aplicar guardrails de segurança práticos para agentes de IA de codificação em toda a
Keshet — controle visível e confirmado por humanos sobre ações perigosas, não
segurança de nível sandbox. Aplica-se a todos os agentes no Claude Code, Cowork e
qualquer pipeline ou automação que use Claude. Categorias de política padrão e
caminhos de arquivos por aplicativo estão em reference.md.
Condições de Ativação
Sempre ativo em qualquer sessão de agente de IA. Ative explicitamente quando: uma nova sessão começa em um projeto Keshet, um agente está prestes a executar chamadas shell/git/MCP, um usuário concede ampla autonomia ("só resolva"), um pipeline está sendo projetado ou revisado, ou uma ação tocaria em segredos ou arquivos fora do diretório do projeto.
Primeiros Princípios
- Identifique a superfície de ação: shell, leituras/escritas de arquivos, git, chamadas MCP, instalações de pacotes, hooks, skills, segredos.
- Classifique cada controle como
negar,perguntar,monitorarouorientação. - Prefira regras pequenas e explícitas a regras amplas e vagas.
- Preserve a produtividade do desenvolvedor — pergunte em ações ambíguas, negue apenas ações claramente inseguras.
- Declare as limitações claramente: arquivos de instrução guiam o comportamento; hooks/ferramentas de endpoint impõem mais, mas nenhum deles é um sandbox completo de SO sem contenção real.
Fluxo de Trabalho de Criação de Regras
- Pergunte onde a regra deve residir: configuração pessoal, configuração compartilhada do projeto ou ambos.
- Pergunte o que deve acontecer por categoria: bloquear, perguntar, monitorar ou permitir.
- Elabore o menor conjunto de regras útil.
- Inclua exemplos de ações que acionam a regra.
- Inclua limitações conhecidas — o que ainda precisa de sandbox ou controles de endpoint.
- Se estiver escrevendo arquivos, use o local nativo do aplicativo alvo; mantenha a redação da política independente do aplicativo.
Postura Padrão Recomendada
Use esta postura a menos que a empresa forneça uma política mais rigorosa:
- Negar: exfiltração de segredos, pipe-to-shell (
curl ... | sh), desativação de sandbox/permissão, comandos destrutivos do sistema (exclusão recursiva, formatação de disco, limpeza de histórico), acesso a armazenamento de credenciais. - Perguntar: git push/force-push, deploys, instalações de pacotes, alterações de esquema, escritas fora do diretório do projeto, qualquer chamada de ferramenta MCP não na lista aprovada da organização.
- Monitorar: toda execução de shell, escritas de arquivos dentro do projeto, chamadas de API externas — registradas e visíveis, não bloqueadas.
O que NÃO fazer
- Não instale servidores MCP, hooks ou serviços persistentes sem aprovação explícita do usuário
- Não leia, exiba ou passe arquivos
.envou arquivos de credenciais para nenhum contexto - Não execute comandos shell destrutivos sem confirmação
- Não faça push para git ou deploy sem o usuário ver exatamente o que será enviado
- Não acesse caminhos de arquivos fora do diretório atual do projeto
- Não tente novamente operações falhas silenciosamente — sempre exiba as falhas
- Não trate arquivos de guardrail apenas com instruções como imposição de nível SO
- Não instale ferramentas de agente de terceiros de fontes não verificadas sem uma revisão de segurança — prefira revisar o código-fonte a instalar artefatos de release pré-construídos e direcione as instalações por verificação de checksum e um ambiente piloto
Modelo de Saída
Ao propor um conjunto de guardrails, sempre responda com:
## Resumo dos Guardrails
<breve resumo do que está sendo protegido>
## Políticas
- Negar: <ações que são bloqueadas diretamente>
- Perguntar: <ações que exigem confirmação explícita do usuário>
- Monitorar: <ações que são registradas e visíveis, mas não bloqueadas>
## Arquivos a Criar ou Atualizar
- `<caminho>`: <propósito deste arquivo>
## Limitações
<o que estes guardrails NÃO impõem — o que requer sandbox adicional ou controles de endpoint>