> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Editor de políticas

> Crie e revise políticas versionadas a partir de um modo de falha confirmado.

Use o editor de políticas para transformar um achado ou problema em uma regra implantável. Mantenha a autoria separada da implantação para que um rascunho não possa alterar silenciosamente o comportamento em produção.

Quando um problema tem um padrão de ação repetível, abra-o em **Analyze → issues** e selecione **generate policy**. O Failproof AI primeiro explica se uma política consegue expressar o problema e, em seguida, leva o contexto do achado e a intenção revisada para o editor. O código-fonte gerado permanece como rascunho até que você o publique.

## Publicar uma versão de política

<Tabs>
  <Tab title="Dashboard">
    1. Vá para **Admin → policy editor** e, em **compose**, descreva o modo de falha ou cole o código-fonte JavaScript da política.
    2. Valide o código-fonte e corrija todos os erros reportados.
    3. Informe a identidade da política e publique-a; use **library** para comparar ou desativar versões.
    4. Selecione **enforcement** quando a versão estiver pronta para implantação em máquinas.

           <img src="https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/policy-editor.png?fit=max&auto=format&n=WgPwQzedeDNwJBTy&q=85&s=7c01c862f4ec601d0535a6969eb619ce" alt="A visão de composição do editor de políticas, com identidade da política, elaboração assistida por IA, validação do código-fonte e controles de publicação." width="2938" height="1608" data-path="images/dashboard/policy-editor.png" />
  </Tab>

  <Tab title="CLI">
    O CLI na nuvem não publica versões de política. Valide o código-fonte localmente antes de copiá-lo para o editor:

    ```bash theme={null}
    failproofai policies --install --custom ./checkout.policies.ts \
      --cli claude --scope project
    ```

    Publique a versão revisada a partir de **Admin → policy editor**.
  </Tab>
</Tabs>

## Lista de verificação para autoria

1. Nomeie o modo de falha com linguagem operacional.
2. Selecione os eventos de hook e as ferramentas que contêm evidências suficientes para decidir.
3. Escreva a condição mais restrita possível que corresponda ao comportamento inseguro.
4. Retorne uma justificativa que indique ao agente ou operador qual é o próximo passo.
5. Adicione exemplos que devem corresponder e exemplos que precisam continuar permitidos.
6. Salve uma nova versão e solicite revisão.

Use `instruct` quando o agente puder corrigir o curso com segurança. Use `deny` quando permitir a ação criaria um risco inaceitável ou irreversível.

<Info>
  Versões de política são entradas de implantação imutáveis. Editar um rascunho cria uma nova versão; isso não deve reescrever a versão já atribuída às máquinas.
</Info>
