@pathbit/agentdevkit 0.0.0-stage → 0.0.5

package/.pbai4devs/COMPATIBILIDADE.md

@@ -0,0 +1,109 @@
+---
+description: Formatos de descoberta e limites dos adaptadores de clientes.
+---
+
+# Compatibilidade
+
+`.pbai4devs` é a fonte única. Os clientes recebem referências e metadados
+nativos; ferramentas, scripts, templates e downloads ficam no hub. Um link
+orienta a leitura, sem garantir que o cliente importe seu conteúdo.
+
+## Escolher clientes
+
+Use `--agents codex,claude` na instalação ou `agents codex,claude` para alterar
+depois. `--clients` e `clients` são aliases. A CLI salva os IDs no projeto;
+`all` inclui todos, inclusive os legados. Sem seleção explícita, reutiliza a
+salva; sem ambas, usa `all`. Não há detecção automática do agente em execução.
+
+| Cliente | ID | Pastas necessárias |
+| --- | --- | --- |
+| [Codex][codex] | `codex` | `.codex`, `.agents` |
+| [Claude][claude] | `claude` | `.claude` |
+| [Cursor][cursor] | `cursor` | `.cursor` |
+| [Copilot][cp] | `copilot` | `.github`, `.vscode` |
+| [OpenCode V2][opencode] | `opencode` | `.opencode` |
+| [Gemini CLI][gemini] | `gemini` | `.gemini` |
+| [Antigravity][antigravity] | `antigravity` | `.agents` |
+| Antigravity legado | `antigravity-legacy` | `.agent`, `.agents` |
+| [ZCode][zcode] | `zcode` | `.zcode` |
+| [Kimi Code][kimi] | `kimi` | `.kimi-code` |
+| Kimi legado | `kimi-legacy` | `.kimi` |
+| [MiniMax Code][minimax] | `minimax` | `.minimax` |
+| [MiMo Code][mimo] | `mimo` | `.mimocode` |
+| [DeepSeek Harness][deepseek] | `deepseek` | `.dsh` |
+
+Aliases de IDs: `vscode` → `copilot`, `claude-code` → `claude`,
+`kimi-code` → `kimi`, `xiaomi` → `mimo`. Nomes de pastas não são IDs.
+Pastas compartilhadas permanecem se algum escolhido precisar delas.
+`.vscode` recebe apenas seu `.gitignore` local. O hub continua completo;
+seleção altera derivações, sem apagar arquivos próprios dos clientes.
+
+## Formatos nativos
+
+Os grupos são preservados quando a descoberta permite. Abaixo, `grupo/`
+representa categorias opcionais; `nome` é o identificador único do recurso.
+Os caminhos são relativos à pasta do cliente, exceto onde indicado.
+
+- Codex: `.agents/skills/grupo/nome/SKILL.md` e referências agrupadas em
+  `.codex`. `AGENTS.md` apresenta o hub; demais tipos são referências.
+- Claude: `skills/nome/SKILL.md`, `commands/grupo/nome.md`,
+  `rules/grupo/nome/RULE.md` e `agents/nome.md`.
+- Cursor: `skills/grupo/nome/SKILL.md`, `rules/grupo/nome.mdc`,
+  `agents/nome.md` e `commands/nome.md`.
+- Copilot: `skills/nome/SKILL.md`, `agents/nome.agent.md`,
+  `instructions/grupo/nome.instructions.md` e
+  `prompts/grupo/nome.prompt.md` para Local.
+- OpenCode: `skills/grupo/nome/SKILL.md`, `commands/grupo/nome.md`,
+  `agents/grupo/nome.md`; regras como referências.
+- Gemini: `skills/nome/SKILL.md`, `commands/grupo/nome.toml`,
+  `agents/nome.md`; regras como referências.
+- Antigravity: skills e regras agrupadas, agentes planos registrados nos
+  manifestos; comandos como referências. `.agent` é a opção legada.
+- ZCode: `skills/nome/SKILL.md`, comandos diretos; demais tipos são referências.
+- Kimi: `skills/grupo/nome/SKILL.md`; comandos exigem plugin, não configurado
+  pelos apontamentos. `.kimi` é a opção legada.
+- MiniMax e DeepSeek: `skills/nome/SKILL.md`; demais tipos como referências.
+- MiMo: `skills/grupo/nome/SKILL.md`, agentes e comandos diretos;
+  regras como referências.
+
+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
+planas em plugins. Mantemos esses layouts; não presumimos recursão em agentes ou
+comandos quando o fornecedor só documenta arquivos diretos.
+
+Antigravity busca um nível por padrão. Os arquivos `.agents/skills.json`,
+`rules.json` e `agents.json` registram explicitamente cada referência;
+o sincronizador os atualiza ao criar, mover ou remover recursos. Eles são
+manifestos nativos, distintos dos catálogos internos homônimos em `.pbai4devs`.
+
+OpenCode V2 percorre até seis níveis de skills. Kimi percorre agrupadores sem
+`SKILL.md`; um diretório que já define uma skill não é uma categoria comum.
+Esses limites devem ser respeitados ao criar grupos.
+
+Prompts `.prompt.md` pertencem ao harness Local do VS Code, anunciado para
+remoção em fevereiro de 2027. No Copilot, use skills para rotinas invocáveis.
+`GEMINI.md` importa `AGENTS.md`; `CLAUDE.md` aponta para esse mesmo guia.
+
+O instalador gera a seleção e a política em `espelhos.conf`; `sincronizar`
+reconstrói os apontamentos somente com Node e os arquivos do hub instalado.
+`--check` não altera arquivos. `--force` faz backup ignorado antes de substituir
+conteúdo próprio que conflite com caminhos gerenciados.
+
+As fontes confirmam formatos, não execução de cada cliente. Valide descoberta,
+invocação e resultado no cliente escolhido antes de considerar uma integração
+comprovada. As razões e fontes por adaptador também ficam em
+`templates/clients/ADAPTERS.json` no hub de fontes do AgentDevKit.
+
+[codex]: https://learn.chatgpt.com/docs/build-skills
+[claude]: https://code.claude.com/docs/en/skills
+[cursor]: https://cursor.com/docs/skills
+[cp]: https://docs.github.com/en/copilot/how-tos/copilot-sdk/features/skills
+[opencode]: https://opencode.ai/docs/skills
+[gemini]: https://geminicli.com/docs/cli/skills/
+[antigravity]: https://antigravity.google/docs/customization-discovery
+[zcode]: https://zcode.z.ai/en/docs/skill
+[kimi]: https://moonshotai.github.io/kimi-code/en/customization/skills
+[minimax]: https://github.com/MiniMax-AI/minimax-code
+[mimo]: https://mimo.xiaomi.com/mimocode/skills
+[deepseek]: https://github.com/deepseek-ai/deepseek-harness

package/.pbai4devs/INSTRUCTIONS.md

@@ -0,0 +1,87 @@
+---
+description: Ordem de trabalho e manutenção dos agentes.
+---
+
+# Como usar
+
+Peça a skill pelo nome ou solicite a leitura de seu `SKILL.md`.
+
+Antes de instalar ou preparar ferramentas, pergunte quais clientes o usuário
+usa, se não houver escolha no pedido ou no estado do kit. A CLI aceita
+`--agents codex,claude`; `agents` consulta ou altera a seleção depois.
+Use os IDs da [compatibilidade](COMPATIBILIDADE.md), sem deduzir o agente pelo
+aplicativo, SO ou pastas. Sem resposta disponível, mantenha a escolha salva ou
+`all`. Registre pela CLI, sem editar hashes do estado manualmente.
+
+1. `configurar-projeto`: preparar o trabalho sem iniciar código.
+2. `criar-prd` e `criar-ux-ui`: definir produto e experiência.
+3. `criar-design-doc`: aprovar arquitetura e tecnologia.
+4. `gerenciar-roadmap`: planejar entregas e dependências.
+5. `criar-spec`: exige os documentos anteriores aprovados; UX/UI pode ser
+   não aplicável com justificativa aprovada.
+6. `implementar-spec`: esclarecer dúvidas, aprovar plano, configurar/verificar
+   o ambiente, implementar e provar os critérios de aceite.
+
+Enquanto configurar os agentes, mantenha apenas modelos. Os documentos reais
+serão preenchidos por perguntas e respostas quando o projeto começar.
+Combine destinos e registre-os no estado futuro de configuração. Ao finalizar
+uma etapa, explique a próxima e reúna suas perguntas. Use
+[proximos-passos](skills/projeto/proximos-passos/SKILL.md) e respeite o idioma
+salvo em `.pbai4devs/estado/agentdevkit.json`; sem escolha, use português.
+Evolua README e documentos pelos [modelos da fase](templates/README.md).
+Atualize fatos e links afetados; registre ausência de impacto com justificativa.
+
+Para desenvolver um projeto existente, use `preparar-dev`: diagnostique e
+prepare a máquina sem recriar documentos de produto. Melhorias de estrutura
+e mudanças funcionais têm escopo próprio. O [modelo de ambiente][ambiente]
+define as perguntas e os arquivos obrigatórios da configuração técnica.
+
+## Criar e manter recursos
+
+Use `criar-recurso`; ele encaminha à skill específica ou cria um novo tipo.
+Após criar, alterar, renomear ou remover recursos, use `sincronizar-agentes`.
+Isso regenera `catalog.json` e os índices auxiliares; não mantenha listas JSON
+manualmente. Confira com `--check` antes de concluir a alteração.
+Antes dos `.mjs`, confira Node/npm pelo [primeiro uso][preparo].
+Com Node 18+ disponível, use `BOOTSTRAP.mjs --runtime-only` para preparar
+Node 24+. Sem Node/npm, instale primeiro pelo mecanismo nativo do SO.
+`instalar-ferramentas` usa o fluxo completo: prepara o runtime e executa
+`setup` para instalar e verificar as ferramentas compatíveis.
+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.
+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.
+Consulte [skills externas](external-skills/README.md) antes de reinventar um
+procedimento; ative referências pela tarefa, respeitando a stack decidida.
+`preparar-ferramentas` baixa/atualiza ferramentas locais para o SO/arquitetura;
+cada ferramenta tem `TOOL.json` e `SCRIPT.mjs` em `.pbai4devs/tools/<nome>`.
+Binários e registros em `.local/`, cache e launchers são ignorados.
+
+O arquivo local `espelhos.conf` registra seleção, layouts e pontos nativos.
+O catálogo local `catalog.json` reúne inventário e comandos das ferramentas.
+Os registros `skills.json`, `rules.json` e `agents.json` indexam as fontes.
+Codex e Antigravity compartilham `.agents`; `.agent` é uma opção legada.
+Gemini usa `.gemini`; Copilot/VS Code usa `.github` e `.vscode`. Veja os demais
+clientes e seus limites na [compatibilidade](COMPATIBILIDADE.md).
+Só clientes selecionados recebem derivações; uma pasta compartilhada permanece
+quando outro cliente precisa dela. Atualizar ou sincronizar respeita a seleção.
+Somente recursos agênticos têm apontamentos; templates, scripts, tools e estado
+permanecem exclusivamente em `.pbai4devs`.
+O sincronizador mantém a proteção Git das saídas locais e de `.pbai4devs`.
+Use os [modelos de ignore](templates/gitignore/TEMPLATE.md) para alterar a lista
+de fontes e derivados; em Git, os apontamentos usam exclusões locais.
+Sem repositório, o `.gitignore` da raiz protege os derivados até o Git existir.
+Documentos de produto também ficam fora dos espelhos. O comando `sincronizar`
+reconstrói apontamentos com `--force`; `--check` verifica sem alterações.
+
+Os [comandos](commands/README.md) são entradas dos casos de uso: diagnóstico,
+preparo local, atualização de ferramentas, sincronização e verificações.
+Para consultas, leia o [comando de status](commands/status-roadmap/COMMAND.md).
+Use o [revisor](agents/revisor/AGENT.md) para revisão. Links orientam a leitura;
+a descoberta automática depende dos formatos de cada ferramenta.
+
+[ambiente]: templates/ambiente-local/TEMPLATE.md
+[preparo]: scripts/preparar-ferramentas/README.md
+[revisao]: commands/revisar-entrega/COMMAND.md

package/.pbai4devs/README.md

@@ -0,0 +1,50 @@
+---
+description: Índice da estrutura compartilhada dos agentes.
+---
+
+# Recursos do AgentDevKit
+
+`.pbai4devs` é a origem compartilhada dos recursos instalados pelo AgentDevKit.
+Para a ordem de trabalho e os comandos,
+leia [INSTRUCTIONS.md](INSTRUCTIONS.md).
+O catálogo local `catalog.json` é gerado das fontes pelo sincronizador.
+Ele inclui recursos, ferramentas, automações, modelos e referências externas.
+Os arquivos `skills.json`, `rules.json` e `agents.json` são índices auxiliares
+das fontes. Os clientes selecionados usam seus diretórios de apontamentos.
+O estado `estado/agentdevkit.json` guarda `clients`: `["all"]` ou os IDs
+escolhidos. Catálogos, manifesto, estado e pastas nativas são derivados locais;
+não devem ser commitados. No repositório do kit, o código do produto fica em
+`src/`, `bin/`, `tests/` e `scripts/release/`, na raiz.
+Use `agents` na CLI para consultar ou alterar; `all` inclui os clientes legados.
+O hub fica completo; clientes podem compartilhar pastas necessárias.
+
+| Pasta | Para que serve |
+| --- | --- |
+| [skills](skills/README.md) | Procedimentos de tarefas e seus criadores |
+| [agents](agents/README.md) | Perfis para revisão e delegação |
+| [commands](commands/README.md) | Casos de uso e encaminhamento |
+| [rules](rules/README.md) | Orientações aplicadas por contexto |
+| [templates](templates/README.md) | Modelos para documentos futuros |
+| [scripts](scripts/README.md) | Automações e seleção de ferramentas |
+| [tools](tools/README.md) | Definições e instalações locais ignoradas |
+| [external-skills][externas] | Catálogo curado e downloads locais |
+
+Somente `SKILL.md`, `AGENT.md`, `COMMAND.md` e `RULE.md` em suas pastas
+têm apontamentos nas ferramentas. A origem é agrupada; os destinos usam o
+layout registrado. Veja a [compatibilidade](COMPATIBILIDADE.md) dos clientes.
+Recursos auxiliares e guias ficam exclusivamente em `.pbai4devs`.
+Os testes das automações ficam em `scripts/<nome>/tests/`; seus resultados são
+ignorados em `.agent-tests/`.
+O `.gitignore` desta pasta controla sua árvore. As saídas nos clientes são
+protegidas por regras locais geradas dos [modelos](templates/gitignore/TEMPLATE.md).
+Um `.gitignore` não consegue ignorar irmãos com `../`; o gerador usa o local
+correto do Git e preserva configurações humanas.
+Os modelos acompanham cada fase. Após implementar, use `atualizar-documentacao`
+e o comando `revisar-entrega` para fechar documentação, revisão e evidências.
+
+Use o [comando sincronizar](commands/sincronizar/COMMAND.md) para reparar tudo;
+o script também aceita `--check` para só conferir.
+Os [exemplos de maturidade](scripts/testar-maturidade/README.md) são gerados em
+`examples/generated/`, com cópias portáveis da estrutura e relatórios ignorados.
+
+[externas]: external-skills/README.md

package/.pbai4devs/agents/README.md

@@ -0,0 +1,18 @@
+---
+description: Finalidade e criação dos perfis de agentes.
+---
+
+# Agentes
+
+O perfil compartilhado usa metadados portáteis. YAMLs ao lado da origem adaptam
+campos e permissões por cliente. A integração usa `templates/clients/`,
+fora das instruções distribuídas aos projetos.
+Consulte a [compatibilidade](../COMPATIBILIDADE.md) antes de prometer descoberta.
+
+Perfis definem papel, entrada, resultado, ferramentas e limites. Use
+`criar-agente` quando uma tarefa justificar revisão ou delegação especializada.
+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.

package/.pbai4devs/agents/revisor/AGENT.md

@@ -0,0 +1,16 @@
+---
+name: revisor
+description: Revisa alterações e critérios de aceite em modo de leitura.
+---
+
+# Revisor
+
+Revise os arquivos ou o diff fornecidos sem alterá-los; se faltarem, peça-os ao
+agente principal. Verifique comportamento, regressões e critérios de aceite;
+confira a documentação afetada, decisões sem impacto e evidências reais por ID.
+Use a skill `atualizar-documentacao` e as referências externas pertinentes.
+Não aprove com provas faltantes, artefatos versionados ou snapshot desatualizado.
+para contexto de entrega, consulte a skill
+`.pbai4devs/skills/specs/gerenciar-roadmap/SKILL.md`. Relate achados acionáveis
+com arquivo, linha e impacto; informe limitações ou ausência de achados.
+O agente principal aplica correções e registra o resultado em `revisar-entrega`.

package/.pbai4devs/agents/revisor/antigravity.yaml

@@ -0,0 +1,8 @@
+---
+name: revisor
+description: Revisa alterações e critérios de aceite em modo de leitura.
+tools: [view_file, grep_search]
+mainAgent: false
+subagent: true
+commandExecutionPolicy: "off"
+---

package/.pbai4devs/agents/revisor/claude.yaml

@@ -0,0 +1,5 @@
+---
+name: revisor
+description: Revisa alterações e critérios de aceite em modo de leitura.
+tools: Read, Grep, Glob
+---

package/.pbai4devs/agents/revisor/cursor.yaml

@@ -0,0 +1,5 @@
+---
+name: revisor
+description: Revisa alterações e critérios de aceite em modo de leitura.
+readonly: true
+---

package/.pbai4devs/agents/revisor/gemini.yaml

@@ -0,0 +1,6 @@
+---
+name: revisor
+description: Revisa alterações e critérios de aceite em modo de leitura.
+kind: local
+tools: [read_file, grep_search]
+---

package/.pbai4devs/agents/revisor/github.yaml

@@ -0,0 +1,5 @@
+---
+name: revisor
+description: Revisa alterações e critérios de aceite em modo de leitura.
+tools: [read, search]
+---

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

@@ -0,0 +1,5 @@
+---
+name: revisor
+description: Revisa alterações e critérios de aceite em modo de leitura.
+tools: [Read, Grep, Glob]
+---

package/.pbai4devs/agents/revisor/mimocode.yaml

@@ -0,0 +1,10 @@
+---
+description: Revisa alterações e critérios de aceite em modo de leitura.
+mode: subagent
+permission:
+  "*": deny
+  read: allow
+  glob: allow
+  grep: allow
+  skill: allow
+---

package/.pbai4devs/agents/revisor/opencode.yaml

@@ -0,0 +1,7 @@
+---
+description: Revisa alterações e critérios de aceite em modo de leitura.
+mode: subagent
+permission:
+  edit: deny
+  bash: deny
+---

package/.pbai4devs/agents/revisor/zcode.yaml

@@ -0,0 +1,5 @@
+---
+name: revisor
+description: Revisa alterações e critérios de aceite em modo de leitura.
+tools: [Read, Grep, Glob]
+---

package/.pbai4devs/commands/README.md

@@ -0,0 +1,30 @@
+---
+description: Casos de uso para acionar skills, scripts e ferramentas compartilhadas.
+---
+
+# Comandos
+
+Cada `<nome>/COMMAND.md` é a entrada de um caso de uso: informa entrada,
+pré-requisitos, execução e saída. A skill orienta as decisões; o script executa
+a automação; a ferramenta fornece a capacidade. Referencie-os sem copiar suas
+instruções ou implementação. Pastas indicam onde ler ou salvar arquivos.
+
+- [diagnosticar](diagnosticar/COMMAND.md): identificar ambiente e projeto.
+- [preparar-dev](preparar-dev/COMMAND.md): preparar ou reparar a máquina.
+- [instalar-ferramentas](instalar-ferramentas/COMMAND.md): conferir Node/npm,
+  instalar e validar ferramentas em um fluxo.
+- [atualizar-ferramentas](atualizar-ferramentas/COMMAND.md): atualizar ferramentas.
+- [sincronizar](sincronizar/COMMAND.md): manter os apontamentos dos agentes.
+- [verificar-agentes](verificar-agentes/COMMAND.md): conferir recursos e testes.
+- [revisar-entrega](revisar-entrega/COMMAND.md): fechar documentação e provas.
+- [testar-navegador](testar-navegador/COMMAND.md): provar um fluxo web real.
+- [status-roadmap](status-roadmap/COMMAND.md): consultar o andamento.
+- [proximos-passos](proximos-passos/COMMAND.md): orientar a próxima ação útil.
+
+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).
+Argumentos vêm do usuário; `$ARGUMENTS` só existe quando a ferramenta o oferece.
+
+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.

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

@@ -0,0 +1,17 @@
+---
+description: Atualiza as ferramentas locais dos agentes para a plataforma atual.
+---
+
+# Atualizar ferramentas
+
+Entrada: `base`, `all`, grupo ou nome do
+[índice de ferramentas](../../tools/README.md); padrão: `base`.
+Pré-requisitos: Node.js 24+ com npm e acesso ao registro oficial.
+
+Siga [preparar-ferramentas](../../skills/projeto/preparar-ferramentas/SKILL.md).
+Use `executar-script` com `preparar-ferramentas update <seleção>`; depois,
+confira a mesma seleção com `check`. Para uma ferramenta, também pode chamar
+`node <pasta-da-ferramenta>/SCRIPT.mjs` com `update` e `check`.
+
+Saída: versões, plataforma, alterações e falhas. Instalações ficam somente em
+`.pbai4devs/tools/<nome>/.local/`; preserve a versão anterior em caso de falha.

package/.pbai4devs/commands/diagnosticar/COMMAND.md

@@ -0,0 +1,18 @@
+---
+description: Identifica o ambiente local e a estrutura do projeto sem alterações.
+---
+
+# Diagnosticar
+
+Entrada: nenhuma. Confira Node/npm conforme o
+[primeiro uso](../../scripts/preparar-ferramentas/README.md) antes dos scripts.
+
+Use [executar-script](../../skills/projeto/executar-script/SKILL.md) para rodar
+[diagnosticar-ambiente](../../scripts/diagnosticar-ambiente/) e
+[inspecionar-projeto](../../scripts/inspecionar-projeto/), sem `--check`.
+Este caso só inspeciona; não instala ferramentas nem inicia a aplicação.
+Interprete a disponibilidade informada; saída zero não aprova dependências
+ausentes ou ferramentas ainda não verificadas.
+
+Saída: tipo de projeto, SO, ferramentas disponíveis e pendências. Resuma os
+resultados; salve relatórios apenas em `.agent-tests/` quando necessários.

package/.pbai4devs/commands/instalar-ferramentas/COMMAND.md

@@ -0,0 +1,21 @@
+---
+description: Prepara Node e npm automaticamente, instala e valida as ferramentas locais.
+---
+
+# Instalar ferramentas
+
+Entrada: `base`, `all`, grupo ou nome do [índice](../../tools/README.md);
+padrão: `all`. Siga o [preparo automático](../../scripts/preparar-ferramentas/BOOTSTRAP.md):
+identifique o SO e execute o inicializador nativo. Se Node/npm faltar ou falhar,
+ele instala o runtime local e continua com `setup <seleção>` automaticamente.
+Não transfira os passos de instalação para o usuário.
+
+Siga [preparar-ferramentas](../../skills/projeto/preparar-ferramentas/SKILL.md).
+Com Node pronto, também pode usar `executar-script` com
+`preparar-ferramentas setup <seleção>`.
+Esse único fluxo instala o que faltar e verifica cada CLI, preservando
+instalações saudáveis. Rede é necessária quando faltar instalação.
+
+Saída: versões, plataforma, resultados e itens não aplicáveis ou com falha.
+Pacotes ficam ignorados em `.local/`; dependências de UI seguem a tarefa.
+Para buscar versões mais recentes, use [atualizar](../atualizar-ferramentas/COMMAND.md).

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

@@ -0,0 +1,14 @@
+---
+description: Prepara ou repara o ambiente de desenvolvimento de um projeto existente.
+---
+
+# Preparar desenvolvimento
+
+Entrada: objetivo ou erro observado, se houver. Pré-requisito: projeto existente.
+
+Siga [preparar-dev](../../skills/projeto/preparar-dev/SKILL.md), começando pelo
+[diagnóstico](../diagnosticar/COMMAND.md). Reúna dúvidas antes das alterações;
+reutilize os scripts e ferramentas indicados pela skill.
+
+Saída: ambiente verificado, comandos de execução, URL e pendências; evidências
+locais em `.agent-tests/`. Não reinicie o planejamento de produto.

package/.pbai4devs/commands/proximos-passos/COMMAND.md

@@ -0,0 +1,9 @@
+---
+description: Mostra a próxima ação útil conforme o estado e as pendências do projeto.
+---
+
+# Próximos passos
+
+Use [proximos-passos](../../skills/projeto/proximos-passos/SKILL.md).
+Com a CLI disponível, consulte `agentdevkit next --target .`; informe a
+próxima ação e o pré-requisito que ainda falta, quando houver.

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

@@ -0,0 +1,29 @@
+---
+description: Revisa documentação, critérios e provas antes de commit ou merge.
+---
+
+# Revisar entrega
+
+Entrada: referência da mudança, spec quando houver e arquivos do escopo.
+Pré-requisitos: implementação pronta e Node.js 24+. Sem spec em uma correção
+urgente, defina critérios próprios AC-001 e registre o motivo.
+
+1. Siga [atualizar-documentacao][documentacao]
+   e [verificar-trabalho](../../skills/projeto/verificar-trabalho/SKILL.md).
+2. Use `executar-script` para `revisar-entrega prepare --id <referencia>`, com
+   `--spec`, `--scope` e `--output` quando aplicáveis. Complete o JSON gerado
+   conforme o [modelo](../../templates/revisao-entrega/TEMPLATE.md), com provas
+   reais e decisões de documentação justificadas.
+3. Conclua a revisão independente em leitura prescrita pela skill. Aplique os
+   achados; se arquivos mudarem, gere novo snapshot, execute as verificações
+   afetadas e revise novamente antes de registrar `review.status: approved`.
+4. Execute `revisar-entrega seal <relatorio>` para registrar os hashes após a
+   revisão e `revisar-entrega check <relatorio>` pelo mesmo seletor. Falha,
+   critério sem prova ou revisão pendente bloqueiam o commit/merge.
+
+Saída: resultado por critério, pendências e caminho do único `revisao.json` em
+`.agent-tests/<referencia>/<execucao>/`. Esta etapa é obrigatória após qualquer
+implementação; a ausência de spec não elimina a revisão.
+`baseline.json` e `seal.json` são metadados gerados; não os edite manualmente.
+
+[documentacao]: ../../skills/projeto/atualizar-documentacao/SKILL.md

package/.pbai4devs/commands/sincronizar/COMMAND.md

@@ -0,0 +1,20 @@
+---
+description: Atualiza ou confere os apontamentos compartilhados dos agentes.
+---
+
+# Sincronizar
+
+Entrada: sem argumentos usa `--force` para reparar; `--check` só confere.
+Pré-requisitos: Node.js 24+ e manifesto `.pbai4devs/espelhos.conf` válido.
+
+Siga [sincronizar-agentes](../../skills/projeto/sincronizar-agentes/SKILL.md)
+e execute o script correspondente pelo seletor. A reconstrução pode sobrescrever
+apontamentos e remover extras dos destinos gerenciados; preserva os arquivos
+nativos fora desse escopo e mantém backup local do conteúdo próprio removido.
+Após reparar, execute também `--check`.
+
+Respeite os clientes registrados no manifesto. Para mudar a seleção salva,
+use `agentdevkit agents <lista>`; sincronizar não ativa todos os clientes.
+
+Saída: apontamentos atualizados ou divergências encontradas. Templates,
+scripts, ferramentas, estado, testes, documentos e guias ficam fora dos espelhos.

package/.pbai4devs/commands/status-roadmap/COMMAND.md

@@ -0,0 +1,12 @@
+---
+description: "Comando para consultar o status do roadmap."
+---
+
+# Status do roadmap
+
+Entrada: nenhuma. Pré-requisito: configuração com o caminho do roadmap.
+
+Use [gerenciar-roadmap](../../skills/specs/gerenciar-roadmap/SKILL.md) em modo
+somente leitura. Se faltar planejamento, informe a próxima etapa do fluxo.
+
+Saída: status das releases e specs, pendências e próxima entrega.

package/.pbai4devs/commands/testar-navegador/COMMAND.md

@@ -0,0 +1,16 @@
+---
+description: Verifica um fluxo web real com ferramentas de navegador disponíveis.
+---
+
+# Testar no navegador
+
+Entrada: URL, ações e resultado esperado. Pré-requisitos: aplicação acessível,
+dados de teste e ferramenta de navegador disponível. Reúna o que faltar.
+
+Siga [verificar-trabalho](../../skills/projeto/verificar-trabalho/SKILL.md)
+para o fluxo web. Use os testes do projeto, agent-browser ou o
+[executor Playwright](../../scripts/testar-navegador/REFERENCE.md), conforme
+as ferramentas disponíveis. O executor MCP não é um programa Node.
+
+Saída: asserções, console/rede, viewports e resultado por critério; relatórios
+e capturas em `.agent-tests/`. Fixtures da infraestrutura não provam o produto.

package/.pbai4devs/commands/verificar-agentes/COMMAND.md

@@ -0,0 +1,19 @@
+---
+description: Confere a estrutura, os testes e as ferramentas locais dos agentes.
+---
+
+# Verificar agentes
+
+Entrada: nenhuma. Pré-requisitos: Node.js 24+ e ferramentas base
+preparadas. Os apontamentos devem estar sincronizados.
+
+Use [executar-script](../../skills/projeto/executar-script/SKILL.md), nesta ordem:
+`verificar-recursos`, `testar-infraestrutura` e
+`preparar-ferramentas check base`. O comando não instala nem corrige arquivos.
+Se os apontamentos divergirem, informe o caso [sincronizar](../sincronizar/COMMAND.md).
+Ao alterar catálogos, sincronização ou instalação, execute também
+`testar-maturidade run` e confira os cenários em `examples/generated/`.
+
+Saída: passou, falhou ou não verificado por etapa, com evidências em
+`.agent-tests/`. Falhas, testes ignorados ou ferramentas ausentes não aprovam
+a etapa. Provas web usam [testar-navegador](../testar-navegador/COMMAND.md).

package/.pbai4devs/estado/README.md

@@ -0,0 +1,12 @@
+---
+description: Estado local do kit e decisões compartilhadas do projeto.
+---
+
+# Estado
+
+`agentdevkit.json` e `derived.json` registram seleção, propriedade e arquivos
+gerados nesta máquina. São locais e ignorados; não os edite manualmente.
+
+As decisões de produto em `configuracao/ESTADO.md`, quando criadas pelo fluxo
+do projeto, são fontes compartilhadas e podem ser versionadas. Comece pelo
+[modelo de configuração](../templates/configuracao/TEMPLATE.md).