failproofai 0.0.6-beta.0 → 0.0.6-beta.2

package/.next/standalone/docs/pt-br/custom-policies.mdx

@@ -1,10 +1,10 @@
 ---
 title: Políticas Personalizadas
-description: "Escreva suas próprias políticas em JavaScript - aplique convenções, evite desvios, detecte falhas e integre com sistemas externos"
+description: "Escreva suas próprias políticas em JavaScript — aplique convenções, evite desvios, detecte falhas e integre com sistemas externos"
 icon: code
 ---
 
-As políticas personalizadas permitem que você escreva regras para qualquer comportamento do agente: aplicar convenções do projeto, evitar desvios, bloquear operações destrutivas, detectar agentes travados ou integrar com Slack, fluxos de aprovação e muito mais. Elas utilizam o mesmo sistema de eventos de hook e as decisões `allow`, `deny`, `instruct` das políticas integradas.
+As políticas personalizadas permitem criar regras para qualquer comportamento do agente: aplicar convenções do projeto, evitar desvios, bloquear operações destrutivas, detectar agentes travados ou integrar com Slack, fluxos de aprovação e muito mais. Elas utilizam o mesmo sistema de eventos de hook e as mesmas decisões `allow`, `deny` e `instruct` das políticas integradas.
 
 ---
 
@@ -29,7 +29,7 @@ customPolicies.add({
 });
 ```
 
-Instale:
+Instale com:
 
 ```bash
 failproofai policies --install --custom ./my-policies.js
@@ -41,44 +41,44 @@ failproofai policies --install --custom ./my-policies.js
 
 ### Opção 1: Baseada em convenção (recomendada)
 
-Coloque arquivos `*policies.{js,mjs,ts}` na pasta `.failproofai/policies/` e eles serão carregados automaticamente — sem flags ou alterações de configuração. Funciona como git hooks: basta adicionar o arquivo e pronto.
+Coloque arquivos `*policies.{js,mjs,ts}` na pasta `.failproofai/policies/` e eles serão carregados automaticamente — sem flags ou alterações de configuração. Funciona como git hooks: adicione o arquivo e pronto.
 
 ```
-# Nível de projeto — versionado no git, compartilhado com a equipe
+# Nível do projeto — commitado no git, compartilhado com o time
 .failproofai/policies/security-policies.mjs
 .failproofai/policies/workflow-policies.mjs
 
-# Nível de usuário — pessoal, aplicado a todos os projetos
+# Nível do usuário — pessoal, aplicado a todos os projetos
 ~/.failproofai/policies/my-policies.mjs
 ```
 
 **Como funciona:**
-- Os diretórios de projeto e usuário são verificados (união — sem prioridade por escopo)
-- Os arquivos são carregados em ordem alfabética dentro de cada diretório. Use o prefixo `01-`, `02-` para controlar a ordem
-- Somente arquivos que correspondem a `*policies.{js,mjs,ts}` são carregados; outros arquivos são ignorados
+- Tanto o diretório do projeto quanto o do usuário são verificados (união — sem prioridade por escopo)
+- Os arquivos são carregados em ordem alfabética dentro de cada diretório. Use prefixos como `01-`, `02-` para controlar a ordem
+- Apenas arquivos que correspondem ao padrão `*policies.{js,mjs,ts}` são carregados; os demais são ignorados
 - Cada arquivo é carregado de forma independente (fail-open por arquivo)
-- Funciona em conjunto com `--custom` explícito e políticas integradas
+- Funciona junto com `--custom` explícito e políticas integradas
 
 <Tip>
-As políticas por convenção são a forma mais fácil de compartilhar políticas em uma equipe. Versione `.failproofai/policies/` no git e todos os membros da equipe receberão as políticas automaticamente.
+As políticas por convenção são a forma mais fácil de estabelecer um padrão de qualidade para sua organização. Faça commit de `.failproofai/policies/` no git e todos os membros do time receberão as mesmas regras automaticamente — sem configuração individual. À medida que o time identifica novos modos de falha, adicione uma política e faça push. Com o tempo, elas se tornam um padrão de qualidade vivo que melhora a cada contribuição.
 </Tip>
 
 ### Opção 2: Caminho de arquivo explícito
 
 ```bash
-# Instalar com um arquivo de políticas personalizadas
+# Instalar com um arquivo de políticas personalizado
 failproofai policies --install --custom ./my-policies.js
 
 # Substituir o caminho do arquivo de políticas
 failproofai policies --install --custom ./new-policies.js
 
-# Remover o caminho de políticas personalizadas da configuração
+# Remover o caminho de políticas personalizado da configuração
 failproofai policies --uninstall --custom
 ```
 
 O caminho absoluto resolvido é armazenado em `policies-config.json` como `customPoliciesPath`. O arquivo é carregado novamente a cada evento de hook — não há cache entre eventos.
 
-### Usando ambas juntas
+### Usando os dois juntos
 
 As políticas por convenção e o arquivo `--custom` explícito podem coexistir. Ordem de carregamento:
 
@@ -104,7 +104,7 @@ Registra uma política. Chame quantas vezes forem necessárias para múltiplas p
 customPolicies.add({
   name: string;                         // obrigatório - identificador único
   description?: string;                 // exibido na saída de `failproofai policies`
-  match?: { events?: HookEventType[] }; // filtra por tipo de evento; omitir para corresponder a todos
+  match?: { events?: HookEventType[] }; // filtra por tipo de evento; omita para corresponder a todos
   fn: (ctx: PolicyContext) => PolicyResult | Promise<PolicyResult>;
 });
 ```
@@ -113,30 +113,30 @@ customPolicies.add({
 
 | Função | Efeito | Quando usar |
 |----------|--------|----------|
-| `allow()` | Permite a operação silenciosamente | A ação é segura, sem mensagem necessária |
+| `allow()` | Permite a operação silenciosamente | A ação é segura e não precisa de mensagem |
 | `deny(message)` | Bloqueia a operação | O agente não deve executar esta ação |
 | `instruct(message)` | Adiciona contexto sem bloquear | Fornece contexto adicional ao agente para mantê-lo no caminho certo |
 
-`deny(message)` — a mensagem aparece para Claude com o prefixo `"Blocked by failproofai:"`. Um único `deny` interrompe toda avaliação subsequente.
+`deny(message)` — a mensagem é exibida para o Claude com o prefixo `"Blocked by failproofai:"`. Um único `deny` interrompe toda avaliação subsequente.
 
-`instruct(message)` — a mensagem é anexada ao contexto do Claude para a chamada de ferramenta atual. Todas as mensagens `instruct` são acumuladas e entregues juntas.
+`instruct(message)` — a mensagem é adicionada ao contexto do Claude para a chamada de ferramenta atual. Todas as mensagens `instruct` são acumuladas e entregues juntas.
 
 <Tip>
-Você pode adicionar orientações extras a qualquer mensagem `deny` ou `instruct` incluindo um campo `hint` em `policyParams` — sem necessidade de alteração no código. Isso também funciona para políticas personalizadas (`custom/`), de convenção de projeto (`.failproofai-project/`) e de convenção de usuário (`.failproofai-user/`). Consulte [Configuração → hint](/pt-br/configuration#hint-cross-cutting) para mais detalhes.
+Você pode adicionar orientações extras a qualquer mensagem `deny` ou `instruct` incluindo um campo `hint` em `policyParams` — sem necessidade de alterar o código. Isso funciona também para políticas personalizadas (`custom/`), por convenção do projeto (`.failproofai-project/`) e por convenção do usuário (`.failproofai-user/`). Consulte [Configuração → hint](/pt-br/configuration#hint-cross-cutting) para mais detalhes.
 </Tip>
 
 ### Mensagens informativas de allow
 
-`allow(message)` permite a operação **e** envia uma mensagem informativa para Claude. A mensagem é entregue como `additionalContext` na resposta stdout do handler de hook — o mesmo mecanismo usado por `instruct`, mas semanticamente diferente: é uma atualização de status, não um aviso.
+`allow(message)` permite a operação **e** envia uma mensagem informativa de volta ao Claude. A mensagem é entregue como `additionalContext` na resposta stdout do handler de hook — o mesmo mecanismo usado por `instruct`, mas semanticamente diferente: é uma atualização de status, não um aviso.
 
 | Função | Efeito | Quando usar |
 |----------|--------|----------|
-| `allow(message)` | Permite e envia contexto para Claude | Confirma que uma verificação passou ou explica por que foi ignorada |
+| `allow(message)` | Permite e envia contexto ao Claude | Confirmar que uma verificação passou, ou explicar por que foi ignorada |
 
 Casos de uso:
-- **Confirmações de status:** `allow("All CI checks passed.")` — informa ao Claude que tudo está ok
-- **Explicações de fail-open:** `allow("GitHub CLI not installed, skipping CI check.")` — informa ao Claude por que uma verificação foi ignorada para que ele tenha contexto completo
-- **Múltiplas mensagens se acumulam:** se várias políticas retornarem `allow(message)`, todas as mensagens são unidas com quebras de linha e entregues juntas
+- **Confirmações de status:** `allow("All CI checks passed.")` — informa ao Claude que tudo está em ordem
+- **Explicações de fail-open:** `allow("GitHub CLI not installed, skipping CI check.")` — informa ao Claude por que uma verificação foi ignorada, garantindo contexto completo
+- **Múltiplas mensagens são acumuladas:** se várias políticas retornarem `allow(message)`, todas as mensagens são unidas com quebras de linha e entregues juntas
 
 ```js
 customPolicies.add({
@@ -146,7 +146,7 @@ customPolicies.add({
     const cwd = ctx.session?.cwd;
     if (!cwd) return allow("No working directory, skipping branch check.");
 
-    // ... verificar status do branch ...
+    // ... check branch status ...
     if (allPushed) {
       return allow("Branch is up to date with remote.");
     }
@@ -160,27 +160,27 @@ customPolicies.add({
 | Campo | Tipo | Descrição |
 |-------|------|-------------|
 | `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
-| `toolName` | `string \| undefined` | A ferramenta sendo chamada (ex: `"Bash"`, `"Write"`, `"Read"`) |
+| `toolName` | `string \| undefined` | A ferramenta sendo chamada (ex.: `"Bash"`, `"Write"`, `"Read"`) |
 | `toolInput` | `Record<string, unknown> \| undefined` | Os parâmetros de entrada da ferramenta |
-| `payload` | `Record<string, unknown>` | Payload completo do evento bruto do Claude Code |
+| `payload` | `Record<string, unknown>` | Payload bruto completo do evento do Claude Code |
 | `session` | `SessionMetadata \| undefined` | Contexto da sessão (veja abaixo) |
 
 ### Campos de `SessionMetadata`
 
 | Campo | Tipo | Descrição |
 |-------|------|-------------|
-| `sessionId` | `string` | Identificador de sessão do Claude Code |
+| `sessionId` | `string` | Identificador da sessão do Claude Code |
 | `cwd` | `string` | Diretório de trabalho da sessão do Claude Code |
 | `transcriptPath` | `string` | Caminho para o arquivo de transcrição JSONL da sessão |
 
 ### Tipos de evento
 
-| Evento | Quando dispara | Conteúdo de `toolInput` |
+| Evento | Quando é disparado | Conteúdo de `toolInput` |
 |-------|--------------|----------------------|
-| `PreToolUse` | Antes de Claude executar uma ferramenta | A entrada da ferramenta (ex: `{ command: "..." }` para Bash) |
-| `PostToolUse` | Após uma ferramenta ser concluída | A entrada da ferramenta + `tool_result` (a saída) |
-| `Notification` | Quando Claude envia uma notificação | `{ message: "...", notification_type: "idle" \| "permission_prompt" \| ... }` - hooks devem sempre retornar `allow()`, não podem bloquear notificações |
-| `Stop` | Quando a sessão Claude encerra | Vazio |
+| `PreToolUse` | Antes do Claude executar uma ferramenta | A entrada da ferramenta (ex.: `{ command: "..." }` para Bash) |
+| `PostToolUse` | Após a conclusão de uma ferramenta | A entrada da ferramenta + `tool_result` (a saída) |
+| `Notification` | Quando o Claude envia uma notificação | `{ message: "...", notification_type: "idle" \| "permission_prompt" \| ... }` — hooks sempre devem retornar `allow()`, não podem bloquear notificações |
+| `Stop` | Quando a sessão do Claude é encerrada | Vazio |
 
 ---
 
@@ -190,8 +190,8 @@ As políticas são avaliadas nesta ordem:
 
 1. Políticas integradas (na ordem de definição)
 2. Políticas personalizadas explícitas de `customPoliciesPath` (na ordem de `.add()`)
-3. Políticas de convenção do projeto em `.failproofai/policies/` (arquivos em ordem alfabética, ordem de `.add()` dentro de cada arquivo)
-4. Políticas de convenção do usuário em `~/.failproofai/policies/` (arquivos em ordem alfabética, ordem de `.add()` dentro de cada arquivo)
+3. Políticas por convenção do projeto em `.failproofai/policies/` (arquivos em ordem alfabética, ordem de `.add()` dentro de cada arquivo)
+4. Políticas por convenção do usuário em `~/.failproofai/policies/` (arquivos em ordem alfabética, ordem de `.add()` dentro de cada arquivo)
 
 <Note>
 O primeiro `deny` interrompe todas as políticas subsequentes. Todas as mensagens `instruct` são acumuladas e entregues juntas.
@@ -201,7 +201,7 @@ O primeiro `deny` interrompe todas as políticas subsequentes. Todas as mensagen
 
 ## Importações transitivas
 
-Arquivos de políticas personalizadas podem importar módulos locais usando caminhos relativos:
+Arquivos de política personalizados podem importar módulos locais usando caminhos relativos:
 
 ```js
 // my-policies.js
@@ -218,46 +218,46 @@ customPolicies.add({
 });
 ```
 
-Todas as importações relativas acessíveis a partir do arquivo de entrada são resolvidas. Isso é implementado reescrevendo as importações `from "failproofai"` para o caminho real em dist e criando arquivos `.mjs` temporários para garantir compatibilidade com ESM.
+Todas as importações relativas acessíveis a partir do arquivo de entrada são resolvidas. Isso é implementado reescrevendo as importações `from "failproofai"` para o caminho real de dist e criando arquivos `.mjs` temporários para garantir compatibilidade com ESM.
 
 ---
 
 ## Filtragem por tipo de evento
 
-Use `match.events` para limitar quando uma política é disparada:
+Use `match.events` para limitar quando uma política é acionada:
 
 ```js
 customPolicies.add({
   name: "require-summary-on-stop",
   match: { events: ["Stop"] },
   fn: async (ctx) => {
-    // Só dispara quando a sessão encerra
+    // Só é acionado quando a sessão é encerrada
     // ctx.session.transcriptPath contém o log completo da sessão
     return allow();
   },
 });
 ```
 
-Omita `match` completamente para disparar em todos os tipos de evento.
+Omita `match` completamente para acionar em todos os tipos de evento.
 
 ---
 
 ## Tratamento de erros e modos de falha
 
-Políticas personalizadas são **fail-open**: erros nunca bloqueiam políticas integradas nem derrubam o handler de hook.
+As políticas personalizadas são **fail-open**: erros nunca bloqueiam as políticas integradas nem causam falha no handler de hook.
 
 | Falha | Comportamento |
 |---------|----------|
 | `customPoliciesPath` não configurado | Nenhuma política personalizada explícita é executada; políticas por convenção e integradas continuam normalmente |
-| Arquivo não encontrado | Aviso registrado em `~/.failproofai/hook.log`; integradas continuam |
-| Erro de sintaxe/importação (explícito) | Erro registrado em `~/.failproofai/hook.log`; políticas personalizadas explícitas ignoradas |
-| Erro de sintaxe/importação (convenção) | Erro registrado; aquele arquivo é ignorado, outros arquivos de convenção continuam carregando |
-| `fn` lança exceção em tempo de execução | Erro registrado; aquele hook é tratado como `allow`; outros hooks continuam |
+| Arquivo não encontrado | Aviso registrado em `~/.failproofai/hook.log`; políticas integradas continuam |
+| Erro de sintaxe/importação (explícito) | Erro registrado em `~/.failproofai/hook.log`; políticas personalizadas explícitas são ignoradas |
+| Erro de sintaxe/importação (convenção) | Erro registrado; aquele arquivo é ignorado, os demais arquivos de convenção continuam carregando |
+| `fn` lança erro em tempo de execução | Erro registrado; aquele hook é tratado como `allow`; os demais hooks continuam |
 | `fn` demora mais de 10s | Timeout registrado; tratado como `allow` |
-| Diretório de convenção ausente | Nenhuma política de convenção é executada; sem erro |
+| Diretório de convenção ausente | Nenhuma política por convenção é executada; sem erro |
 
 <Tip>
-Para depurar erros em políticas personalizadas, acompanhe o arquivo de log:
+Para depurar erros em políticas personalizadas, monitore o arquivo de log:
 
 ```bash
 tail -f ~/.failproofai/hook.log
@@ -285,7 +285,7 @@ customPolicies.add({
   },
 });
 
-// Mantém o agente no caminho certo: verificar testes antes de fazer commit
+// Mantém o agente no caminho certo: verifica testes antes de commitar
 customPolicies.add({
   name: "remind-test-before-commit",
   description: "Keep the agent on track: verify tests pass before committing",
@@ -300,7 +300,7 @@ customPolicies.add({
   },
 });
 
-// Evita mudanças de dependências não planejadas durante o período de freeze
+// Impede mudanças de dependências não planejadas durante o período de freeze
 customPolicies.add({
   name: "dependency-freeze",
   description: "Prevent unplanned dependency changes during freeze period",
@@ -323,14 +323,14 @@ export { customPolicies };
 
 ## Exemplos
 
-O diretório `examples/` contém arquivos de políticas prontos para uso:
+O diretório `examples/` contém arquivos de política prontos para uso:
 
 | Arquivo | Conteúdo |
 |------|----------|
-| `examples/policies-basic.js` | Cinco políticas iniciais cobrindo modos comuns de falha de agentes |
-| `examples/policies-advanced/index.js` | Padrões avançados: importações transitivas, chamadas assíncronas, sanitização de saída e hooks de fim de sessão |
-| `examples/convention-policies/security-policies.mjs` | Políticas de segurança baseadas em convenção (bloquear escritas em .env, evitar reescrita de histórico git) |
-| `examples/convention-policies/workflow-policies.mjs` | Políticas de fluxo de trabalho baseadas em convenção (lembretes de teste, auditoria de escritas em arquivos) |
+| `examples/policies-basic.js` | Cinco políticas iniciais cobrindo modos de falha comuns de agentes |
+| `examples/policies-advanced/index.js` | Padrões avançados: importações transitivas, chamadas assíncronas, limpeza de saída e hooks de encerramento de sessão |
+| `examples/convention-policies/security-policies.mjs` | Políticas de segurança baseadas em convenção (bloquear escritas em .env, impedir reescrita do histórico git) |
+| `examples/convention-policies/workflow-policies.mjs` | Políticas de fluxo de trabalho baseadas em convenção (lembretes de teste, auditoria de escritas em arquivo) |
 
 ### Usando exemplos com arquivo explícito
 
@@ -341,11 +341,11 @@ failproofai policies --install --custom ./examples/policies-basic.js
 ### Usando exemplos baseados em convenção
 
 ```bash
-# Copiar para o nível de projeto
+# Copiar para o nível do projeto
 mkdir -p .failproofai/policies
 cp examples/convention-policies/*.mjs .failproofai/policies/
 
-# Ou copiar para o nível de usuário
+# Ou copiar para o nível do usuário
 mkdir -p ~/.failproofai/policies
 cp examples/convention-policies/*.mjs ~/.failproofai/policies/
 ```

package/.next/standalone/docs/pt-br/examples.mdx

@@ -8,34 +8,34 @@ Exemplos prontos para uso em cenários comuns. Cada um mostra como instalar e o
 
 ---
 
-## Configurando hooks para o Claude Code
+## Configurando hooks para Claude Code
 
-O Failproof AI se integra ao Claude Code por meio do seu [sistema de hooks](https://docs.anthropic.com/en/docs/claude-code/hooks). Quando você executa `failproofai policies --install`, ele registra comandos de hook no `settings.json` do Claude Code que são acionados em cada chamada de ferramenta.
+O Failproof AI se integra ao Claude Code por meio do seu [sistema de hooks](https://docs.anthropic.com/en/docs/claude-code/hooks). Quando você executa `failproofai policies --install`, ele registra comandos de hook no `settings.json` do Claude Code, que são acionados a cada chamada de ferramenta.
 
 <Steps>
-  <Step title="Instale o failproofai">
+  <Step title="Instalar o failproofai">
     ```bash
     npm install -g failproofai
     ```
   </Step>
-  <Step title="Ative todas as políticas integradas">
+  <Step title="Habilitar todas as políticas integradas">
     ```bash
     failproofai policies --install
     ```
   </Step>
-  <Step title="Verifique se os hooks foram registrados">
+  <Step title="Verificar se os hooks foram registrados">
     ```bash
     cat ~/.claude/settings.json | grep failproofai
     ```
 
-    Você deverá ver entradas de hook para os eventos `PreToolUse`, `PostToolUse`, `Notification` e `Stop`.
+    Você deve ver entradas de hook para os eventos `PreToolUse`, `PostToolUse`, `Notification` e `Stop`.
   </Step>
-  <Step title="Execute o Claude Code">
+  <Step title="Executar o Claude Code">
     ```bash
     claude
     ```
 
-    As políticas agora são executadas automaticamente em cada chamada de ferramenta. Tente pedir ao Claude para executar `sudo rm -rf /` — o comando será bloqueado.
+    As políticas agora são executadas automaticamente a cada chamada de ferramenta. Tente pedir ao Claude para executar `sudo rm -rf /` — o comando será bloqueado.
   </Step>
 </Steps>
 
@@ -46,26 +46,26 @@ O Failproof AI se integra ao Claude Code por meio do seu [sistema de hooks](http
 Se você está desenvolvendo com o [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk), pode usar o mesmo sistema de hooks de forma programática.
 
 <Steps>
-  <Step title="Instale o failproofai no seu projeto">
+  <Step title="Instalar o failproofai no seu projeto">
     ```bash
     npm install failproofai
     ```
   </Step>
-  <Step title="Configure os hooks no seu agente">
-    Passe os comandos de hook ao criar o processo do seu agente. Os hooks são acionados da mesma forma que no Claude Code — via stdin/stdout JSON:
+  <Step title="Configurar hooks no seu agente">
+    Passe comandos de hook ao criar o processo do seu agente. Os hooks são acionados da mesma forma que no Claude Code — via stdin/stdout JSON:
 
     ```bash
     failproofai --hook PreToolUse   # chamado antes de cada ferramenta
     failproofai --hook PostToolUse  # chamado após cada ferramenta
     ```
   </Step>
-  <Step title="Escreva uma política personalizada para seu agente">
+  <Step title="Escrever uma política personalizada para seu agente">
     ```javascript
     import { customPolicies, allow, deny } from "failproofai";
 
     customPolicies.add({
       name: "limit-to-project-dir",
-      description: "Keep the agent inside the project directory",
+      description: "Mantém o agente dentro do diretório do projeto",
       match: { events: ["PreToolUse"] },
       fn: async (ctx) => {
         const path = String(ctx.toolInput?.file_path ?? "");
@@ -77,7 +77,7 @@ Se você está desenvolvendo com o [Agents SDK](https://docs.anthropic.com/en/do
     });
     ```
   </Step>
-  <Step title="Instale a política personalizada">
+  <Step title="Instalar a política personalizada">
     ```bash
     failproofai policies --install --custom ./my-agent-policies.js
     ```
@@ -123,7 +123,7 @@ import { customPolicies, allow, instruct } from "failproofai";
 
 customPolicies.add({
   name: "slack-on-idle",
-  description: "Alert Slack when the agent is waiting for input",
+  description: "Alerta o Slack quando o agente está aguardando entrada",
   match: { events: ["Notification"] },
   fn: async (ctx) => {
     const webhookUrl = process.env.SLACK_WEBHOOK_URL;
@@ -150,7 +150,7 @@ customPolicies.add({
 });
 ```
 
-Instale assim:
+Instale:
 
 ```bash
 SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
@@ -167,7 +167,7 @@ import { customPolicies, allow, deny } from "failproofai";
 
 customPolicies.add({
   name: "stay-on-branch",
-  description: "Prevent the agent from checking out other branches",
+  description: "Impede o agente de fazer checkout em outras branches",
   match: { events: ["PreToolUse"] },
   fn: async (ctx) => {
     if (ctx.toolName !== "Bash") return allow();
@@ -184,14 +184,14 @@ customPolicies.add({
 
 ## Exigir testes antes de commits
 
-Lembra os agentes de executar os testes antes de fazer commit.
+Lembra os agentes de executar testes antes de fazer commit.
 
 ```javascript
 import { customPolicies, allow, instruct } from "failproofai";
 
 customPolicies.add({
   name: "test-before-commit",
-  description: "Remind the agent to run tests before committing",
+  description: "Lembra o agente de executar testes antes de fazer commit",
   match: { events: ["PreToolUse"] },
   fn: async (ctx) => {
     if (ctx.toolName !== "Bash") return allow();
@@ -206,11 +206,11 @@ customPolicies.add({
 
 ---
 
-## Proteger um repositório de produção
+## Bloquear um repositório de produção
 
-Faça commit de uma configuração no nível do projeto para que todos os desenvolvedores do seu time usem as mesmas políticas.
+Faça commit de uma configuração no nível do projeto para que todos os desenvolvedores da sua equipe utilizem as mesmas políticas.
 
-Crie o arquivo `.failproofai/policies-config.json` no seu repositório:
+Crie `.failproofai/policies-config.json` no seu repositório:
 
 ```json
 {
@@ -238,7 +238,61 @@ git add .failproofai/policies-config.json
 git commit -m "Add failproofai team policies"
 ```
 
-Todos os membros do time que tiverem o failproofai instalado irão automaticamente receber essas regras.
+Todo membro da equipe que tiver o failproofai instalado receberá essas regras automaticamente.
+
+---
+
+## Construir um padrão de qualidade organizacional com políticas de convenção
+
+A configuração de maior impacto: faça commit de `.failproofai/policies/` no seu repositório com políticas adaptadas ao seu projeto. Todos os membros da equipe as recebem automaticamente — sem comandos de instalação, sem alterações de configuração.
+
+<Steps>
+  <Step title="Criar o diretório e adicionar políticas">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    // Enforce your team's preferred package manager
+    // (or enable the built-in prefer-package-manager policy instead)
+    customPolicies.add({
+      name: "enforce-bun",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        const cmd = String(ctx.toolInput?.command ?? "");
+        if (/\bnpm\b/.test(cmd)) return deny("Use bun instead of npm.");
+        return allow();
+      },
+    });
+
+    // Remind the agent to run tests before committing
+    customPolicies.add({
+      name: "test-before-commit",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
+          return instruct("Run tests before committing.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="Fazer commit no git">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+  </Step>
+  <Step title="Continue melhorando">
+    À medida que sua equipe encontra novos problemas, adicione políticas e faça push. Todos recebem a atualização no próximo `git pull`. Essas políticas se tornam um padrão de qualidade vivo que cresce junto com a sua equipe.
+  </Step>
+</Steps>
 
 ---
 
@@ -248,6 +302,6 @@ O diretório [`examples/`](https://github.com/exospherehost/failproofai/tree/mai
 
 | Arquivo | O que demonstra |
 |---------|-----------------|
-| `policies-basic.js` | Políticas iniciais — bloqueia escritas em produção, force-push e scripts redirecionados |
+| `policies-basic.js` | Políticas iniciais — bloquear escrita em produção, force-push e scripts redirecionados |
 | `policies-notification.js` | Alertas no Slack para notificações de inatividade e encerramento de sessão |
 | `policies-advanced/index.js` | Importações transitivas, hooks assíncronos, limpeza de saída no PostToolUse e tratamento do evento Stop |

package/.next/standalone/docs/pt-br/getting-started.mdx

@@ -1,13 +1,13 @@
 ---
 title: Primeiros passos
-description: "Instale o failproofai, ative as políticas e deixe seus agentes rodando com confiabilidade"
+description: "Instale o failproofai, ative as políticas e deixe seus agentes rodarem de forma confiável"
 icon: rocket
 ---
 
 ## Requisitos
 
 - **Node.js** >= 20.9.0
-- **Bun** >= 1.3.0 (opcional — necessário apenas para compilar a partir do código-fonte)
+- **Bun** >= 1.3.0 (opcional - necessário apenas para compilar a partir do código-fonte)
 
 ---
 
@@ -31,13 +31,13 @@ bun add -g failproofai
 
 <Steps>
   <Step title="Ativar políticas">
-    Políticas são regras executadas antes e depois de cada chamada de ferramenta do agente. Elas interceptam comandos destrutivos, vazamento de segredos e outros modos de falha antes que causem danos.
+    Políticas são regras que executam antes e depois de cada chamada de ferramenta do agente. Elas interceptam comandos destrutivos, vazamento de segredos e outros modos de falha antes que causem danos.
 
     ```bash
     failproofai policies --install
     ```
 
-    Isso grava entradas de hook no `settings.json` do Claude Code. Você também pode instalar para um único projeto ou escolher políticas específicas:
+    Isso insere entradas de hook no `settings.json` do Claude Code. Você também pode instalar para um único projeto ou escolher políticas específicas:
 
     ```bash
     failproofai policies --install --scope project
@@ -59,7 +59,7 @@ bun add -g failproofai
     Abre um painel local em `http://localhost:8020` onde você pode navegar por sessões, inspecionar chamadas de ferramentas e gerenciar políticas.
   </Step>
   <Step title="Executar seu agente">
-    Inicie o Claude Code normalmente. Se o agente tentar algo arriscado, o failproofai o intercepta automaticamente. Deixe-o rodando sem supervisão e revise o que aconteceu no painel.
+    Inicie o Claude Code normalmente. Se o agente tentar algo arriscado, o failproofai intercepta automaticamente. Deixe-o rodando sem supervisão e revise o que aconteceu no painel.
   </Step>
 </Steps>
 
@@ -75,27 +75,79 @@ Claude Code  →  failproofai --hook PreToolUse  →  reads stdin JSON
                                                  writes decision to stdout
 ```
 
-Cada política retorna uma das três decisões:
+Cada política retorna uma de três decisões:
 
-- **allow** — o agente continua normalmente
-- **deny** — a ação é bloqueada e o agente recebe uma explicação do motivo
-- **instruct** — contexto adicional é inserido no prompt do agente
+- **allow** - o agente prossegue normalmente
+- **deny** - a ação é bloqueada e o agente é informado do motivo
+- **instruct** - contexto adicional é inserido no prompt do agente
 
 <Note>
-As políticas são executadas no seu processo local. Nenhuma informação é enviada para um serviço remoto.
+As políticas são executadas no seu processo local. Nada é enviado a um serviço remoto.
 </Note>
 
 ---
 
+## Configure políticas de equipe com políticas baseadas em convenção
+
+A forma mais rápida de estabelecer padrões de qualidade em toda a sua equipe é a convenção `.failproofai/policies/`. Basta colocar arquivos de política nesse diretório e eles são carregados automaticamente — sem flags, sem alterações de configuração, sem comandos de instalação.
+
+<Steps>
+  <Step title="Criar o diretório de políticas">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+  </Step>
+  <Step title="Adicionar arquivos de política">
+    Copie os exemplos iniciais ou escreva os seus próprios:
+
+    ```bash
+    cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/
+    ```
+
+    Ou crie um novo:
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    customPolicies.add({
+      name: "test-before-commit",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
+          return instruct("Run tests before committing.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="Enviar para o git">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+
+    Todo membro da equipe que tiver o failproofai instalado receberá essas políticas automaticamente. Sem necessidade de configuração individual por desenvolvedor.
+  </Step>
+</Steps>
+
+<Tip>
+Faça commit de `.failproofai/policies/` no seu repositório para que toda a equipe compartilhe os mesmos padrões. À medida que sua equipe descobre novos modos de falha, adicione políticas e faça push — todos recebem a atualização no próximo `git pull`. Com o tempo, essas políticas se tornam um padrão de qualidade vivo que continua melhorando.
+</Tip>
+
+---
+
 ## Armazenamento de dados
 
-Todas as configurações e logs ficam na sua máquina:
+Todas as configurações e logs permanecem na sua máquina:
 
 | Caminho | O que armazena |
 |---------|----------------|
 | `~/.failproofai/policies-config.json` | Configuração global de políticas |
 | `~/.failproofai/hook-activity.jsonl` | Histórico de execução de hooks |
-| `~/.failproofai/hook.log` | Log de depuração para erros em hooks personalizados |
+| `~/.failproofai/hook.log` | Log de depuração para erros de hooks personalizados |
 | `.failproofai/policies-config.json` | Configuração por projeto (versionada) |
 | `.failproofai/policies-config.local.json` | Substituições pessoais (ignoradas pelo git) |