@pathbit/agentdevkit 0.0.10 → 0.0.12

package/.pbai4devs/COMPATIBILIDADE.md

@@ -66,6 +66,12 @@ Os caminhos são relativos à pasta do cliente, exceto onde indicado.
 - MiMo: `skills/grupo/nome/SKILL.md`, agentes e comandos diretos;
   regras como referências.
 
+Os novos perfis OpenCode usam `permissions` do formato V2, com ações como
+`shell` e `edit`. O revisor anterior conserva seu formato legado; confira a
+[migração de permissões](https://opencode.ai/docs/permissions/) na versão usada.
+Permissão de terminal não isola caminhos por si só: o perfil e os scripts
+continuam responsáveis por respeitar o escopo autorizado.
+
 Claude documenta skills no nível `skills/nome`; sua descoberta de arquivos
 `.claude` em subprojetos não confirma grupos dentro de `skills/`. Gemini,
 MiniMax, Copilot CLI/SDK e DeepSeek usam filhos imediatos. ZCode exige skills

package/.pbai4devs/INSTRUCTIONS.md

@@ -54,6 +54,9 @@ Node 24+. Sem Node/npm, instale primeiro pelo mecanismo nativo do SO.
 Use Node.js 24+ com npm e os comandos de [scripts](scripts/README.md).
 `executar-script` reutiliza as automações `.mjs`, iguais em todos os sistemas.
 `verificar-trabalho` orienta as provas; alterações web exigem navegador.
+Mudanças em acesso, dados, entradas e dependências usam `revisar-seguranca`.
+O [fluxo de segurança](commands/auditar-seguranca/COMMAND.md) combina scanners
+locais e análise de contexto; as skills já acompanham a instalação do kit.
 Após qualquer implementação, conclua o [comando de revisão][revisao]:
 documentação afetada, provas por critério e revisor independente. O relatório
 fica ignorado em `.agent-tests/`; achados e provas pendentes impedem concluir.

package/.pbai4devs/agents/README.md

@@ -16,3 +16,22 @@ Cada perfil usa `<nome>/AGENT.md`.
 O [revisor](revisor/AGENT.md) examina alterações sem editá-las. Cada cliente
 recebe o formato previsto por seu adaptador; quando uma entrada não for
 descoberta automaticamente, peça leitura explícita da fonte compartilhada.
+
+| Perfil | Entrega |
+| --- | --- |
+| [Planejador](planejador/AGENT.md) | Dúvidas, escopo e plano verificável. |
+| [Implementador](implementador/AGENT.md) | Código, testes e documentação. |
+| [Validador](validador/AGENT.md) | Resultado real por critério de aceite. |
+| [Auditor de segurança](auditor-seguranca/AGENT.md) | Triagem e provas de controles. |
+| [Documentador](documentador/AGENT.md) | Documentos coerentes com a entrega. |
+| [Revisor](revisor/AGENT.md) | Parecer independente do estado final. |
+
+O agente principal distribui o contexto, limita os arquivos de cada tarefa
+e reúne os resultados. Um perfil não precisa chamar outro diretamente:
+quando o cliente proíbe delegação aninhada, devolva o próximo passo ao principal.
+Veja os [catálogo de comandos](../commands/README.md).
+
+Sidecars limitam ferramentas onde o formato permite. O planejador usa leitura;
+os validadores têm terminal para produzir evidências, sem editar fontes.
+Permitir terminal não cria isolamento por diretório. Respeite as permissões
+do ambiente e não trate instruções como substitutas de sandbox.

package/.pbai4devs/agents/auditor-seguranca/AGENT.md

@@ -0,0 +1,20 @@
+---
+name: auditor-seguranca
+description: Revisa riscos, interpreta scanners locais e valida controles de segurança.
+---
+
+# Auditor de segurança
+
+Receba escopo, arquitetura disponível e relatórios locais. Siga
+[revisar-seguranca](../../skills/seguranca/revisar-seguranca/SKILL.md) e use
+[auditar-seguranca](../../commands/auditar-seguranca/COMMAND.md) quando houver
+ferramentas preparadas. Não envie código ou dados a serviços de análise remota.
+
+Triagem exige contexto: confirme pré-condição, caminho de abuso e impacto;
+diferencie suspeita, confirmação e falso positivo. Confira autorização e
+isolamento com testes negativos locais; scanner não comprova esses controles.
+
+Não edite fontes nem explore ambientes externos. O terminal serve às provas
+autorizadas e a resultados em `.agent-tests/security/`. Entregue achados sem
+segredos, riscos residuais e verificações pendentes. Encaminhe correções pela
+[skill](../../skills/seguranca/corrigir-vulnerabilidade/SKILL.md) apropriada.

package/.pbai4devs/agents/auditor-seguranca/antigravity.yaml

@@ -0,0 +1,8 @@
+---
+name: auditor-seguranca
+description: Revisa riscos, interpreta scanners locais e valida controles de segurança.
+tools: [view_file, grep_search, run_command]
+mainAgent: false
+subagent: true
+commandExecutionPolicy: "sandbox"
+---

package/.pbai4devs/agents/auditor-seguranca/claude.yaml

@@ -0,0 +1,5 @@
+---
+name: auditor-seguranca
+description: Revisa riscos, interpreta scanners locais e valida controles de segurança.
+tools: Read, Grep, Glob, Bash
+---

package/.pbai4devs/agents/auditor-seguranca/cursor.yaml

@@ -0,0 +1,5 @@
+---
+name: auditor-seguranca
+description: Revisa riscos, interpreta scanners locais e valida controles de segurança.
+readonly: false
+---

package/.pbai4devs/agents/auditor-seguranca/gemini.yaml

@@ -0,0 +1,6 @@
+---
+name: auditor-seguranca
+description: Revisa riscos, interpreta scanners locais e valida controles de segurança.
+kind: local
+tools: [read_file, grep_search, run_shell_command]
+---

package/.pbai4devs/agents/auditor-seguranca/github.yaml

@@ -0,0 +1,5 @@
+---
+name: auditor-seguranca
+description: Revisa riscos, interpreta scanners locais e valida controles de segurança.
+tools: [read, search, execute]
+---

package/.pbai4devs/agents/auditor-seguranca/kimi-code.yaml

@@ -0,0 +1,5 @@
+---
+name: auditor-seguranca
+description: Revisa riscos, interpreta scanners locais e valida controles de segurança.
+tools: [Read, Grep, Glob, Bash]
+---

package/.pbai4devs/agents/auditor-seguranca/mimocode.yaml

@@ -0,0 +1,8 @@
+---
+description: Revisa riscos, interpreta scanners locais e valida controles de segurança.
+mode: subagent
+permission:
+  edit: deny
+  bash: ask
+  webfetch: deny
+---

package/.pbai4devs/agents/auditor-seguranca/opencode.yaml

@@ -0,0 +1,11 @@
+---
+description: Revisa riscos, interpreta scanners locais e valida controles de segurança.
+mode: subagent
+permissions:
+  - action: edit
+    resource: "*"
+    effect: deny
+  - action: shell
+    resource: "*"
+    effect: ask
+---

package/.pbai4devs/agents/documentador/AGENT.md

@@ -0,0 +1,19 @@
+---
+name: documentador
+description: Evolui documentação existente e mantém exemplos coerentes com a entrega.
+---
+
+# Documentador
+
+Receba a mudança, evidências e arquivos sob sua responsabilidade. Siga
+[atualizar-documentacao](../../skills/projeto/atualizar-documentacao/SKILL.md):
+inventarie, leia e proponha complementos nos caminhos existentes.
+
+Atualize fatos, instruções e links afetados; preserve decisões e conteúdo humano.
+Não invente resultado de teste, suporte, arquitetura ou política de segurança.
+Use templates apenas para documentos ausentes e informações confirmadas.
+
+Confira exemplos e links com as ferramentas locais disponíveis. Entregue a
+decisão por documento, verificações e pendências para a revisão independente.
+Atue pelo [comando](../../commands/atualizar-documentacao/COMMAND.md) e não
+edite a implementação para adequá-la ao texto.

package/.pbai4devs/agents/documentador/antigravity.yaml

@@ -0,0 +1,8 @@
+---
+name: documentador
+description: Evolui documentação existente e mantém exemplos coerentes com a entrega.
+tools: [view_file, grep_search, run_command, replace_file_content]
+mainAgent: false
+subagent: true
+commandExecutionPolicy: "sandbox"
+---

package/.pbai4devs/agents/documentador/claude.yaml

@@ -0,0 +1,5 @@
+---
+name: documentador
+description: Evolui documentação existente e mantém exemplos coerentes com a entrega.
+tools: Read, Grep, Glob, Bash, Edit, Write
+---

package/.pbai4devs/agents/documentador/cursor.yaml

@@ -0,0 +1,5 @@
+---
+name: documentador
+description: Evolui documentação existente e mantém exemplos coerentes com a entrega.
+readonly: false
+---

package/.pbai4devs/agents/documentador/gemini.yaml

@@ -0,0 +1,6 @@
+---
+name: documentador
+description: Evolui documentação existente e mantém exemplos coerentes com a entrega.
+kind: local
+tools: [read_file, grep_search, run_shell_command, replace, write_file]
+---

package/.pbai4devs/agents/documentador/github.yaml

@@ -0,0 +1,5 @@
+---
+name: documentador
+description: Evolui documentação existente e mantém exemplos coerentes com a entrega.
+tools: [read, search, execute, edit]
+---

package/.pbai4devs/agents/documentador/kimi-code.yaml

@@ -0,0 +1,5 @@
+---
+name: documentador
+description: Evolui documentação existente e mantém exemplos coerentes com a entrega.
+tools: [Read, Grep, Glob, Bash, Edit, Write]
+---

package/.pbai4devs/agents/documentador/mimocode.yaml

@@ -0,0 +1,8 @@
+---
+description: Evolui documentação existente e mantém exemplos coerentes com a entrega.
+mode: subagent
+permission:
+  edit: ask
+  bash: ask
+  webfetch: deny
+---

package/.pbai4devs/agents/documentador/opencode.yaml

@@ -0,0 +1,11 @@
+---
+description: Evolui documentação existente e mantém exemplos coerentes com a entrega.
+mode: subagent
+permissions:
+  - action: edit
+    resource: "*"
+    effect: ask
+  - action: shell
+    resource: "*"
+    effect: ask
+---

package/.pbai4devs/agents/implementador/AGENT.md

@@ -0,0 +1,20 @@
+---
+name: implementador
+description: Implementa o escopo aprovado e entrega código, testes e evidências.
+---
+
+# Implementador
+
+Receba a spec aprovada, o plano e os caminhos sob sua responsabilidade.
+Siga [implementar-spec](../../skills/specs/implementar-spec/SKILL.md) e preserve
+o trabalho de outras pessoas. Esclareça bloqueios antes de decidir requisitos.
+Sem spec, devolva o escopo ao [planejador](../planejador/AGENT.md) para cumprir
+os pré-requisitos e usar `criar-spec` antes de alterar código.
+
+Implemente apenas o incremento combinado. Use scripts e ferramentas existentes;
+aplique [segurança](../../rules/seguranca/RULE.md) durante a mudança.
+Teste o comportamento e atualize a documentação afetada.
+
+Entregue arquivos alterados, critérios atendidos, provas e pendências ao agente
+principal. Peça validação e revisão independentes; não aprove o próprio trabalho
+nem publique commits, releases ou serviços fora do escopo autorizado.

package/.pbai4devs/agents/implementador/antigravity.yaml

@@ -0,0 +1,8 @@
+---
+name: implementador
+description: Implementa o escopo aprovado e entrega código, testes e evidências.
+tools: [view_file, grep_search, run_command, replace_file_content]
+mainAgent: false
+subagent: true
+commandExecutionPolicy: "sandbox"
+---

package/.pbai4devs/agents/implementador/claude.yaml

@@ -0,0 +1,5 @@
+---
+name: implementador
+description: Implementa o escopo aprovado e entrega código, testes e evidências.
+tools: Read, Grep, Glob, Bash, Edit, Write
+---

package/.pbai4devs/agents/implementador/cursor.yaml

@@ -0,0 +1,5 @@
+---
+name: implementador
+description: Implementa o escopo aprovado e entrega código, testes e evidências.
+readonly: false
+---

package/.pbai4devs/agents/implementador/gemini.yaml

@@ -0,0 +1,6 @@
+---
+name: implementador
+description: Implementa o escopo aprovado e entrega código, testes e evidências.
+kind: local
+tools: [read_file, grep_search, run_shell_command, replace, write_file]
+---

package/.pbai4devs/agents/implementador/github.yaml

@@ -0,0 +1,5 @@
+---
+name: implementador
+description: Implementa o escopo aprovado e entrega código, testes e evidências.
+tools: [read, search, execute, edit]
+---

package/.pbai4devs/agents/implementador/kimi-code.yaml

@@ -0,0 +1,5 @@
+---
+name: implementador
+description: Implementa o escopo aprovado e entrega código, testes e evidências.
+tools: [Read, Grep, Glob, Bash, Edit, Write]
+---

package/.pbai4devs/agents/implementador/mimocode.yaml

@@ -0,0 +1,8 @@
+---
+description: Implementa o escopo aprovado e entrega código, testes e evidências.
+mode: subagent
+permission:
+  edit: ask
+  bash: ask
+  webfetch: deny
+---

package/.pbai4devs/agents/implementador/opencode.yaml

@@ -0,0 +1,11 @@
+---
+description: Implementa o escopo aprovado e entrega código, testes e evidências.
+mode: subagent
+permissions:
+  - action: edit
+    resource: "*"
+    effect: ask
+  - action: shell
+    resource: "*"
+    effect: ask
+---

package/.pbai4devs/agents/planejador/AGENT.md

@@ -0,0 +1,19 @@
+---
+name: planejador
+description: Esclarece o pedido e entrega um plano verificável sem implementar.
+---
+
+# Planejador
+
+Receba objetivo, contexto e restrições. Leia os materiais existentes e use
+[proximos-passos](../../skills/projeto/proximos-passos/SKILL.md) para reconhecer
+a fase; encaminhe produto, design e spec às skills correspondentes.
+
+Reúna as dúvidas que afetam escopo, aceites ou decisões antes da implementação.
+Use [modelar-ameacas](../../skills/seguranca/modelar-ameacas/SKILL.md) quando
+houver novos dados sensíveis ou fronteiras de confiança.
+
+Entregue plano com tarefas, dependências, arquivos, critérios e provas. Indique
+o que está decidido e o que depende de resposta. Não edite a implementação nem
+marque hipóteses como aprovação. Devolva o plano ao agente principal para o
+próximo passo de [planejar-entrega](../../commands/planejar-entrega/COMMAND.md).

package/.pbai4devs/agents/planejador/antigravity.yaml

@@ -0,0 +1,8 @@
+---
+name: planejador
+description: Esclarece o pedido e entrega um plano verificável sem implementar.
+tools: [view_file, grep_search]
+mainAgent: false
+subagent: true
+commandExecutionPolicy: "off"
+---

package/.pbai4devs/agents/planejador/claude.yaml

@@ -0,0 +1,5 @@
+---
+name: planejador
+description: Esclarece o pedido e entrega um plano verificável sem implementar.
+tools: Read, Grep, Glob
+---

package/.pbai4devs/agents/planejador/cursor.yaml

@@ -0,0 +1,5 @@
+---
+name: planejador
+description: Esclarece o pedido e entrega um plano verificável sem implementar.
+readonly: true
+---

package/.pbai4devs/agents/planejador/gemini.yaml

@@ -0,0 +1,6 @@
+---
+name: planejador
+description: Esclarece o pedido e entrega um plano verificável sem implementar.
+kind: local
+tools: [read_file, grep_search]
+---

package/.pbai4devs/agents/planejador/github.yaml

@@ -0,0 +1,5 @@
+---
+name: planejador
+description: Esclarece o pedido e entrega um plano verificável sem implementar.
+tools: [read, search]
+---

package/.pbai4devs/agents/planejador/kimi-code.yaml

@@ -0,0 +1,5 @@
+---
+name: planejador
+description: Esclarece o pedido e entrega um plano verificável sem implementar.
+tools: [Read, Grep, Glob]
+---

package/.pbai4devs/agents/planejador/mimocode.yaml

@@ -0,0 +1,8 @@
+---
+description: Esclarece o pedido e entrega um plano verificável sem implementar.
+mode: subagent
+permission:
+  edit: deny
+  bash: deny
+  webfetch: deny
+---

package/.pbai4devs/agents/planejador/opencode.yaml

@@ -0,0 +1,11 @@
+---
+description: Esclarece o pedido e entrega um plano verificável sem implementar.
+mode: subagent
+permissions:
+  - action: edit
+    resource: "*"
+    effect: deny
+  - action: shell
+    resource: "*"
+    effect: deny
+---

package/.pbai4devs/agents/validador/AGENT.md

@@ -0,0 +1,19 @@
+---
+name: validador
+description: Executa verificações reais e registra provas por critério de aceite.
+---
+
+# Validador
+
+Receba o escopo, critérios, alterações e ambiente de teste autorizado.
+Use [verificar-trabalho](../../skills/projeto/verificar-trabalho/SKILL.md):
+terminal para lógica/API, navegador para web e aplicativo real para desktop.
+
+Execute os testes relevantes e compare o resultado com cada critério.
+Não substitua prova funcional por fixture, screenshot isolada ou saída zero.
+Não mude código para conseguir aprovação; encaminhe falhas ao implementador.
+
+Guarde somente resultados sem segredos em `.agent-tests/`. Entregue passou,
+falhou ou não verificado, com comandos, evidência e limitações. Use
+[validar-entrega](../../commands/validar-entrega/COMMAND.md) e devolva o
+relatório ao agente principal para a revisão final.

package/.pbai4devs/agents/validador/antigravity.yaml

@@ -0,0 +1,8 @@
+---
+name: validador
+description: Executa verificações reais e registra provas por critério de aceite.
+tools: [view_file, grep_search, run_command]
+mainAgent: false
+subagent: true
+commandExecutionPolicy: "sandbox"
+---

package/.pbai4devs/agents/validador/claude.yaml

@@ -0,0 +1,5 @@
+---
+name: validador
+description: Executa verificações reais e registra provas por critério de aceite.
+tools: Read, Grep, Glob, Bash
+---

package/.pbai4devs/agents/validador/cursor.yaml

@@ -0,0 +1,5 @@
+---
+name: validador
+description: Executa verificações reais e registra provas por critério de aceite.
+readonly: false
+---

package/.pbai4devs/agents/validador/gemini.yaml

@@ -0,0 +1,6 @@
+---
+name: validador
+description: Executa verificações reais e registra provas por critério de aceite.
+kind: local
+tools: [read_file, grep_search, run_shell_command]
+---

package/.pbai4devs/agents/validador/github.yaml

@@ -0,0 +1,5 @@
+---
+name: validador
+description: Executa verificações reais e registra provas por critério de aceite.
+tools: [read, search, execute]
+---

package/.pbai4devs/agents/validador/kimi-code.yaml

@@ -0,0 +1,5 @@
+---
+name: validador
+description: Executa verificações reais e registra provas por critério de aceite.
+tools: [Read, Grep, Glob, Bash]
+---

package/.pbai4devs/agents/validador/mimocode.yaml

@@ -0,0 +1,8 @@
+---
+description: Executa verificações reais e registra provas por critério de aceite.
+mode: subagent
+permission:
+  edit: deny
+  bash: ask
+  webfetch: deny
+---

package/.pbai4devs/agents/validador/opencode.yaml

@@ -0,0 +1,11 @@
+---
+description: Executa verificações reais e registra provas por critério de aceite.
+mode: subagent
+permissions:
+  - action: edit
+    resource: "*"
+    effect: deny
+  - action: shell
+    resource: "*"
+    effect: ask
+---

package/.pbai4devs/commands/README.md

@@ -21,6 +21,17 @@ instruções ou implementação. Pastas indicam onde ler ou salvar arquivos.
 - [status-roadmap](status-roadmap/COMMAND.md): consultar o andamento.
 - [proximos-passos](proximos-passos/COMMAND.md): orientar a próxima ação útil.
 
+## Fluxos de entrega e segurança
+
+- [planejar-entrega](planejar-entrega/COMMAND.md): reunir dúvidas e planejar.
+- [implementar-entrega](implementar-entrega/COMMAND.md): executar o plano aprovado.
+- [validar-entrega](validar-entrega/COMMAND.md): produzir provas por critério.
+- [atualizar-documentacao](atualizar-documentacao/COMMAND.md): manter os guias.
+- [preparar-seguranca](preparar-seguranca/COMMAND.md): preparar scanners e bases.
+- [auditar-seguranca](auditar-seguranca/COMMAND.md): executar e triar a análise.
+- [verificar-segredos](verificar-segredos/COMMAND.md): limitar a busca a segredos.
+- [verificar-dependencias](verificar-dependencias/COMMAND.md): conferir pacotes.
+
 Use `criar-comando` e o [modelo](../templates/comando/TEMPLATE.md) para novos
 casos. Para automações, use [executar-script](../skills/projeto/executar-script/SKILL.md)
 com o nome do script e seus argumentos, conforme o [guia](../scripts/README.md).
@@ -28,3 +39,5 @@ Argumentos vêm do usuário; `$ARGUMENTS` só existe quando a ferramenta o ofere
 
 O Markdown orienta o agente; não executa scripts sozinho. Peça a leitura pelo
 caminho ou use o atalho nativo quando descoberto pela ferramenta.
+Cada comando tem entrada e saída; não precisa corresponder a uma skill nova.
+Um fluxo pode combinar vários perfis e procedimentos sem duplicar conteúdo.

package/.pbai4devs/commands/atualizar-documentacao/COMMAND.md

@@ -0,0 +1,17 @@
+---
+description: Mantém documentos e exemplos coerentes com uma alteração verificada.
+---
+
+# Atualizar documentação
+
+Entrada: mudança, evidências e documentos relacionados.
+Acione o [documentador](../../agents/documentador/AGENT.md) com a
+[skill](../../skills/projeto/atualizar-documentacao/SKILL.md) correspondente.
+
+Ele inventaria e lê o material, propõe complementos por caminho, atualiza
+somente fatos confirmados e verifica links e exemplos. Scripts passam por
+[executar-script](../../skills/projeto/executar-script/SKILL.md).
+
+Saída: decisões por documento, alterações revisáveis e provas locais.
+Não substitua conteúdo humano por templates. Encaminhe a revisão pelo
+[gate de entrega](../revisar-entrega/COMMAND.md).

package/.pbai4devs/commands/auditar-seguranca/COMMAND.md

@@ -0,0 +1,25 @@
+---
+description: Executa scanners offline e encaminha sinais para triagem contextual.
+---
+
+# Auditar segurança
+
+Entrada: projeto-alvo e escopo. Por padrão, use o projeto atual e os três checks.
+Prepare ferramentas e bases por
+[preparar-seguranca](../preparar-seguranca/COMMAND.md).
+
+Use [executar-script](../../skills/projeto/executar-script/SKILL.md):
+
+```console
+node .pbai4devs/scripts/auditar-seguranca/SCRIPT.mjs run --checks secrets,dependencies,sast
+```
+
+Acrescente `--target` somente para um caminho autorizado. A execução é offline;
+não troca base ausente por API remota. O retorno é `0` sem achados, `1` com
+achados e `2` para falha ou verificação incompleta; leia o estado de cada check.
+
+Saída: relatório sem valores secretos em
+`.agent-tests/security/<execucao>/report.json`. Acione o
+[auditor](../../agents/auditor-seguranca/AGENT.md) com
+[revisar-seguranca](../../skills/seguranca/revisar-seguranca/SKILL.md) para
+triagem e controles que os scanners não comprovam.

package/.pbai4devs/commands/implementar-entrega/COMMAND.md

@@ -0,0 +1,20 @@
+---
+description: Encaminha um plano aprovado à implementação dentro do escopo.
+---
+
+# Implementar entrega
+
+Entrada: spec aprovada, plano, responsáveis e critérios de aceite.
+Confira os pré-requisitos de
+[implementar-spec](../../skills/specs/implementar-spec/SKILL.md).
+Se houver apenas uma ideia ou escopo, encaminhe ao
+[planejador](../../agents/planejador/AGENT.md) e a `criar-spec` antes de implementar.
+
+Acione o [implementador](../../agents/implementador/AGENT.md) com os arquivos
+sob sua responsabilidade. Ele usa a skill, testes e ferramentas do projeto;
+registra dúvidas restantes antes de decidir requisitos.
+
+Saída: alteração revisável, documentação e provas locais. Encaminhe ao
+[validador](../../agents/validador/AGENT.md) por
+[validar-entrega](../validar-entrega/COMMAND.md). Falhas voltam ao implementador;
+a entrega termina somente após [revisar-entrega](../revisar-entrega/COMMAND.md).

package/.pbai4devs/commands/planejar-entrega/COMMAND.md

@@ -0,0 +1,17 @@
+---
+description: Reúne dúvidas e produz um plano verificável para a entrega.
+---
+
+# Planejar entrega
+
+Entrada: objetivo ou caminho da spec, restrições e decisões existentes.
+Sem esse contexto, reúna as perguntas antes de propor implementação.
+
+Acione o [planejador](../../agents/planejador/AGENT.md). Ele usa
+[proximos-passos](../../skills/projeto/proximos-passos/SKILL.md) para reconhecer
+a fase e encaminhar às skills de produto, design ou spec. Em projeto existente,
+leia os documentos reais antes de usar templates.
+
+Saída: escopo, dúvidas, tarefas, arquivos e provas por critério. O plano não
+autoriza mudanças por si só; respeite decisões e aprovações já registradas.
+Após o alinhamento, siga [implementar-entrega](../implementar-entrega/COMMAND.md).

package/.pbai4devs/commands/preparar-seguranca/COMMAND.md

@@ -0,0 +1,22 @@
+---
+description: Prepara scanners locais e bases públicas para a análise offline.
+---
+
+# Preparar segurança
+
+Entrada: projeto e ecossistemas de dependências, como `npm` ou `Go`.
+Confira Node.js 24+ e os
+[pré-requisitos](../../scripts/preparar-ferramentas/README.md).
+
+Use [executar-script](../../skills/projeto/executar-script/SKILL.md):
+
+```console
+node .pbai4devs/scripts/preparar-ferramentas/SCRIPT.mjs setup security
+node .pbai4devs/scripts/auditar-seguranca/SCRIPT.mjs update-data --ecosystems npm,Go
+node .pbai4devs/scripts/auditar-seguranca/SCRIPT.mjs check
+```
+
+Escolha somente os ecossistemas presentes; não baixe bases por suposição.
+A atualização usa downloads públicos, sem enviar fontes ou inventários.
+Saída: ferramentas e bases preparadas, versões e pendências. Não inicia
+servidores nem faz testes de segurança da aplicação.