Communitygithub.com

company-agent-guardrails

Define e aplique guardrails de segurança práticos para agentes de IA na Keshet — controle visível e confirmado por humanos sobre ações perigosas, sem segurança de nível sandbox.

O que é company-agent-guardrails?

Este skill define guardrails de segurança práticos para agentes de IA de codificação na Keshet, focando em controle visível e confirmado por humanos sobre ações perigosas, em vez de segurança absoluta de sandbox. Ele é aplicável a todos os agentes em Claude Code, Cowork e qualquer pipeline ou automação que use Claude. O skill estabelece princípios como classificar ações como negar, perguntar, monitorar ou orientar, e fornece um workflow de criação de regras que prioriza regras pequenas e explícitas, preservando a produtividade do desenvolvedor. Ele também inclui categorias de políticas padrão, caminhos de arquivos por aplicativo e um modelo de saída para propor conjuntos de guardrails, além de instruções claras sobre o que NÃO fazer, como não executar comandos destrutivos sem confirmação ou acessar credenciais.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add Amitro1234/keshet-claude-skills

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

  1. Identifique a superfície de ação: shell, leituras/escritas de arquivos, git, chamadas MCP, instalações de pacotes, hooks, skills, segredos.
  2. Classifique cada controle como negar, perguntar, monitorar ou orientação.
  3. Prefira regras pequenas e explícitas a regras amplas e vagas.
  4. Preserve a produtividade do desenvolvedor — pergunte em ações ambíguas, negue apenas ações claramente inseguras.
  5. 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

  1. Pergunte onde a regra deve residir: configuração pessoal, configuração compartilhada do projeto ou ambos.
  2. Pergunte o que deve acontecer por categoria: bloquear, perguntar, monitorar ou permitir.
  3. Elabore o menor conjunto de regras útil.
  4. Inclua exemplos de ações que acionam a regra.
  5. Inclua limitações conhecidas — o que ainda precisa de sandbox ou controles de endpoint.
  6. 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 .env ou 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>

Habilidades Relacionadas