@pathbit/agentdevkit 0.0.0-stage → 0.0.6

package/.pbai4devs/skills/git/git-commit/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: git-commit
+description: Cria um commit com alterações selecionadas do usuário.
+---
+
+# git-commit
+
+Confira status, diff, alterações previamente preparadas e identidades efetivas
+com `git var GIT_AUTHOR_IDENT` e `git var GIT_COMMITTER_IDENT`. Siga a regra
+compartilhada `.pbai4devs/rules/git/RULE.md` para identidade, mensagem e assinatura.
+Prepare somente arquivos autorizados e avaliados na revisão da entrega. Após
+preparar o índice, execute `revisar-entrega check` para alterações de implementação;
+o índice deve corresponder aos arquivos testados. Crie o commit somente com
+critérios, documentação e revisão aprovados. Confira autor, committer e mensagem;
+não inclua trabalho
+incompleto ou alterações alheias.

package/.pbai4devs/skills/git/git-diff/SKILL.md

@@ -0,0 +1,9 @@
+---
+name: git-diff
+description: Examina e resume alterações Git.
+---
+
+# git-diff
+
+Examine os diffs preparados e não preparados conforme o pedido, incluindo
+arquivos não rastreados quando relevantes. Não altere arquivos.

package/.pbai4devs/skills/git/git-fetch/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: git-fetch
+description: Busca atualizações do remoto sem integrar alterações locais.
+---
+
+# git-fetch
+
+Confira o remoto solicitado e busque suas referências sem alterar arquivos de
+trabalho ou integrar branches. Informe atualizações e divergências relevantes;
+não descarte alterações.

package/.pbai4devs/skills/git/git-log/SKILL.md

@@ -0,0 +1,9 @@
+---
+name: git-log
+description: Consulta o histórico Git do projeto.
+---
+
+# git-log
+
+Mostre o histórico, commits ou arquivos solicitados. Preserve autores e
+histórico; não faça alterações.

package/.pbai4devs/skills/git/git-merge/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: git-merge
+description: Integra branches com trabalho concluído e verificado.
+---
+
+# git-merge
+
+Confira origem, destino, histórico, identidades, mensagens, alterações locais e
+verificações; integre somente tarefas completas conforme AGENTS.md. Se os
+commits a integrar identificarem agentes como autores ou coautores, informe e
+não os integre. Se gerar commit de merge, confira as identidades efetivas e siga
+`.pbai4devs/rules/git/RULE.md` para identidade, mensagem e assinatura. Preserve
+alterações, resolva conflitos no escopo autorizado e respeite proteções da branch.

package/.pbai4devs/skills/git/git-pull/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: git-pull
+description: Atualiza uma branch local com alterações do remoto.
+---
+
+# git-pull
+
+Confira branch, upstream, alterações locais e divergência; busque e integre o
+remoto sem descartar trabalho ou reescrever histórico. Se for necessário um
+commit de merge, confira antes as identidades efetivas e siga
+`.pbai4devs/rules/git/RULE.md`. Se houver conflito, preserve o estado e resolva-o
+somente dentro do escopo autorizado.

package/.pbai4devs/skills/git/git-push/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: git-push
+description: Publica commits concluídos e verificados no remoto.
+---
+
+# git-push
+
+Confira branch, upstream, commits a publicar, identidades e mensagens, além das
+verificações. Envie somente tarefas completas e verificadas, respeitando
+`.pbai4devs/rules/git/RULE.md` e as proteções do remoto. Se houver autoria,
+coautoria ou identificação de agente, informe e não publique esses commits.
+Não use push forçado; se houver divergência ou erro, informe e preserve o trabalho.

package/.pbai4devs/skills/git/git-status/SKILL.md

@@ -0,0 +1,9 @@
+---
+name: git-status
+description: Inspeciona o estado do repositório e das branches locais e remotas.
+---
+
+# git-status
+
+Mostre branch, alterações preparadas e não preparadas, arquivos não rastreados e
+divergência do upstream. Não altere arquivos.

package/.pbai4devs/skills/git/git-worktree/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: git-worktree
+description: Cria ou inspeciona worktrees para trabalho paralelo.
+---
+
+# git-worktree
+
+Confira worktrees e branches existentes. Para agentes paralelos, crie worktrees
+com branches auxiliares distintas; preserve alterações e só integre trabalho
+concluído e verificado.

package/.pbai4devs/skills/produto/criar-design-doc/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: criar-design-doc
+description: Define e revisa o design técnico do produto com o usuário.
+---
+
+# Criar design técnico
+
+Siga `.pbai4devs/rules/qualidade/RULE.md` ao criar arquivos Markdown.
+
+Consulte `.pbai4devs/estado/configuracao/ESTADO.md` e confira o PRD aprovado
+e UX/UI aprovado ou não aplicável com justificativa,
+incluindo a evidência das decisões. Se faltar, estiver pendente ou houver
+conflito, informe o bloqueio e encaminhe à skill correspondente.
+
+Leia o contexto e reúna as dúvidas sobre arquitetura, componentes, fluxos,
+integrações, dados, requisitos não funcionais, segurança, testes, implantação,
+alternativas, riscos e dependências. Pergunte o que faltar e não invente
+escolhas ou métricas. Registre a arquitetura e a tecnologia propostas nesta
+etapa; não instale ferramentas nem inicialize a aplicação.
+Consulte `usar-skills-externas` para referências oficiais das opções em análise.
+
+Crie ou atualize o arquivo indicado em `documentos.design` usando
+`.pbai4devs/templates/design/TEMPLATE.md`, com `status: rascunho`, vínculos ao PRD
+e UX/UI, decisões e questões pendentes. Apresente
+para revisão após resolver as decisões essenciais e peça aprovação explícita;
+só depois registre `status: aprovado` e a evidência da aprovação. Mudanças
+materiais exigem voltar a `rascunho` e nova aprovação. Reavalie specs
+dependentes, registre o impacto e retorne a `rascunho` as afetadas para revisão
+e nova aprovação.
+
+Atualize o roadmap com `gerenciar-roadmap` sem inventar datas ou entregas. Com os
+pré-requisitos aprovados, planeje os incrementos no roadmap antes de usar
+`criar-spec` e `implementar-spec`.
+
+Atualize o resumo técnico/links do README e registre ADRs quando aplicável,
+usando os modelos e `atualizar-documentacao`. Sincronize apontamentos somente
+se recursos dos agentes mudarem.

package/.pbai4devs/skills/produto/criar-prd/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: criar-prd
+description: Define e revisa o documento de requisitos do produto com o usuário.
+---
+
+# Criar PRD
+
+Siga `.pbai4devs/rules/qualidade/RULE.md` ao criar arquivos Markdown.
+
+Confira a preparação em `.pbai4devs/estado/configuracao/ESTADO.md`. Se não estiver
+concluída e comprovada, encaminhe a `configurar-projeto` para a fase
+inicial antes de criar o PRD.
+
+Leia o contexto existente e reúna no início as dúvidas sobre problema, público,
+objetivos, escopo, requisitos, restrições, prioridades e critérios de sucesso.
+Pergunte apenas o que ainda falta; não invente decisões ou métricas.
+
+No caminho `documentos.prd` acordado no estado, crie ou atualize o PRD usando
+`.pbai4devs/templates/prd/TEMPLATE.md`, com `status: rascunho`. Preserve o conteúdo
+existente; identifique suposições e itens desconhecidos. Não crie documentos
+reais enquanto o usuário estiver apenas configurando os agentes.
+
+Apresente o documento para revisão, peça aprovação explícita e ajuste-o até o
+usuário aprovar. Antes disso, resolva as decisões essenciais e registre itens
+não aplicáveis; não invente respostas. Só então registre `status: aprovado` e
+a evidência da aprovação no documento. Alterações materiais posteriores voltam
+o PRD a `rascunho` até nova aprovação. Reavalie UX/UI, design e specs
+dependentes: registre o impacto e retorne a `rascunho` os documentos afetados
+para revisão e nova aprovação. Atualize o roadmap acordado usando
+`gerenciar-roadmap`, sem inventar datas ou entregas. A próxima etapa é
+`criar-ux-ui`.
+
+Atualize o resumo e links do README pelo modelo da fase e use
+`atualizar-documentacao` para impactos nos documentos relacionados.
+Sincronize apontamentos somente se recursos dos agentes mudarem.

package/.pbai4devs/skills/produto/criar-ux-ui/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: criar-ux-ui
+description: Define ou justifica a não aplicação de UX e interface com o usuário.
+---
+
+# Criar UX/UI
+
+Siga `.pbai4devs/rules/qualidade/RULE.md` ao criar arquivos Markdown.
+
+Consulte `.pbai4devs/estado/configuracao/ESTADO.md` e confira o PRD
+com `status: aprovado` e a
+aprovação registrada. Se faltar, estiver pendente ou for insuficiente, informe
+o bloqueio e encaminhe a `criar-prd`.
+
+Leia o contexto e pergunte em conjunto o que faltar sobre usuários, jornadas,
+interfaces, acessibilidade, plataformas, estados, referências e validação. Se
+não houver interface, confirme com o usuário se UX/UI não se aplica e registre
+os motivos; não presuma. Não invente decisões ou métricas.
+
+Crie ou atualize o arquivo indicado em `documentos.ux_ui` usando
+`.pbai4devs/templates/ux-ui/TEMPLATE.md`, com
+`status: rascunho`, vínculo ao PRD, decisões e critérios de validação.
+Apresente para revisão
+e peça aprovação explícita após resolver as decisões essenciais. Registre
+`status: aprovado` ou `status: nao-aplicavel`, conforme a decisão, e a evidência
+da aprovação. Mudanças materiais exigem retornar a `rascunho` e nova aprovação.
+Reavalie design e specs dependentes; registre o impacto e retorne a `rascunho`
+os documentos afetados para revisão e nova aprovação.
+
+Atualize o roadmap com `gerenciar-roadmap` sem inventar datas ou entregas. A
+próxima etapa é `criar-design-doc`.
+
+Use `atualizar-documentacao` para refletir jornadas e links afetados no README
+e documentos relacionados. Sincronize somente recursos dos agentes alterados.

package/.pbai4devs/skills/projeto/atualizar-documentacao/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: atualizar-documentacao
+description: Atualiza documentos afetados e sua coerência com a entrega.
+---
+
+# Atualizar documentação
+
+Leia o diff, os critérios e o comportamento comprovado. Reúna no início as
+dúvidas que mudam contratos; use o [catálogo](../../../templates/README.md) para
+escolher modelos da fase atual, sem criar documentos de produto antecipados.
+
+Confira README da raiz/pastas, AGENTS/CLAUDE/GEMINI, contribuição, notas de versão,
+produto/design/specs, ADRs, configuração/exemplos e comentários/docstrings
+relevantes. Atualize só o que a mudança afeta; documente comportamento real,
+pré-requisitos, comandos, compatibilidade e limites. Evite repetir instruções.
+Segurança pública depende de suporte e canal confirmado, sem dados fictícios.
+
+Registre por caminho a decisão `updated`, `no-impact` ou `not-applicable`, com
+justificativa, no relatório da entrega ou no resultado da tarefa. Verifique
+links e exemplos; código de teste é versionado, evidências ficam ignoradas.
+
+Acione o [revisor](../../../agents/revisor/AGENT.md) em leitura com o diff,
+documentos, critérios e provas. Aplique os achados pertinentes e peça nova
+revisão após correções. Informe impedimentos; não declare aprovação se essa
+revisão não ocorreu. Na entrega, o agente principal registra a decisão do
+revisor no JSON de `revisar-entrega`, após conferir o estado final.

package/.pbai4devs/skills/projeto/configurar-projeto/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: configurar-projeto
+description: Prepara um projeto e configura a tecnologia após decidir o produto.
+---
+
+# Configurar projeto
+
+Inspecione somente este repositório. Se a intenção for rodar ou reparar um
+projeto existente na máquina, use `preparar-dev`; não reinicie seu planejamento.
+Enquanto o usuário configurar apenas os agentes, mantenha modelos em
+`.pbai4devs/templates/`, sem criar produto, `docs/` ou aplicação.
+Antes das ferramentas, confira a seleção de clientes no pedido ou estado do kit.
+Se faltar, pergunte quais usa e aplique pela CLI com `--agents` ou `agents`.
+Não deduza pelo aplicativo, SO ou pastas; sem resposta disponível, use `all`.
+Depois, siga `instalar-ferramentas`: confira Node/npm antes dos scripts, prepare
+as ferramentas e rode o diagnóstico. Isso não escolhe a stack da aplicação.
+
+## Preparar o projeto
+
+Reúna dúvidas no início e aproveite decisões existentes. Quando o projeto
+começar, crie ou retome `.pbai4devs/estado/configuracao/ESTADO.md` pelo modelo.
+Combine os arquivos `prd`, `ux_ui`, `design`, `roadmap` e diretórios `releases`,
+`specs`, `tarefas` e documentos de apoio aplicáveis. Crie/evolua o README
+da raiz pelos [modelos da fase](../../../templates/README.md), preservando os
+fatos existentes; cada pasta de documentos terá seu README. Registre evidências
+da preparação e encaminhe a
+`criar-prd` → `criar-ux-ui` → `criar-design-doc` → roadmap → spec.
+Não escolha stack nem inicialize código antes dessas decisões.
+
+## Configurar a tecnologia
+
+Exija PRD, design e spec aprovados; UX/UI aprovado ou não aplicável com
+justificativa aprovada. Siga o plano aprovado em `implementar-spec`, respeitando
+aprovações já dadas.
+
+1. Use `executar-script` com `inspecionar-projeto` e `diagnosticar-ambiente`
+   para identificar estrutura, SO, arquitetura e ferramentas.
+   Reúna as perguntas do [modelo de ambiente][ambiente]
+   antes de instalar. Decisões materiais faltantes voltam ao design.
+2. Prepare as ferramentas definidas em `.pbai4devs/tools/<nome>/TOOL.json` com
+   `preparar-ferramentas`; confira versões e compatibilidade com SO/arquitetura.
+   Reutilize instalações e lockfiles; não repita init nem troque a stack.
+3. Aplique a [estrutura e o ambiente obrigatórios][estrutura],
+   preenchendo os modelos de Makefile, Compose e dockerignore. Configure os
+   serviços reais, healthchecks, portas, volumes e comandos da tecnologia.
+4. Configure VS Code e recomende EditorConfig, sem regras conflitantes.
+   Termine `.gitignore` com o modelo CUSTOM IGNORE e os padrões da tecnologia;
+   confirme que templates, scripts, testes e fixtures continuam versionáveis.
+5. Documente versões, estrutura, setup, comandos, origem do template/init e
+   decisões no README/estado. Use `atualizar-documentacao` para contribuição,
+   configuração e ADRs aplicáveis. Preserve arquivos e convenções existentes.
+6. Use `verificar-trabalho`: valide Compose, build, saúde dos serviços e testes
+   acordados; confira a estrutura com `inspecionar-projeto --check`.
+   Com aplicação, prove o fluxo real no navegador/desktop conforme
+   seu tipo; sem aplicação, registre a prova funcional pendente. Marque
+   `configuracao_tecnica: concluido` somente com evidência da configuração.
+
+Após alterações técnicas, conclua `revisar-entrega`. Sincronize apontamentos
+somente quando recursos dos agentes forem alterados.
+
+[ambiente]: ../../../templates/ambiente-local/TEMPLATE.md
+[estrutura]: ../../../rules/ambiente-local/RULE.md

package/.pbai4devs/skills/projeto/criar-agente/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: criar-agente
+description: Cria ou atualiza perfis compartilhados de agentes e apontamentos.
+---
+
+# Criar agente
+
+Defina papel, quando delegar, entrada, resultado, ferramentas e limites. Crie
+ou atualize `.pbai4devs/agents/<nome>/AGENT.md`, com metadados apropriados e perfil
+conciso. Preserve instruções e permissões existentes.
+
+Mapeie modo e permissões nos YAMLs nativos ao lado da fonte, registrados no
+manifesto; mantenha o cabeçalho compartilhado portátil. Quando houver suporte,
+valide-os e informe diferenças de descoberta. Quando o formato não for
+reconhecido, peça a leitura explícita da origem.
+Para Antigravity e Gemini, mantenha os YAMLs específicos junto ao `AGENT.md`
+e registre os destinos no manifesto. A sincronização gera apenas os apontamentos.
+
+Atualize índice/guia, siga as regras de estrutura e qualidade e finalize com
+`sincronizar-agentes`, inclusive após renomear ou remover perfis.

package/.pbai4devs/skills/projeto/criar-comando/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: criar-comando
+description: Cria ou atualiza comandos compartilhados e seus apontamentos.
+---
+
+# Criar comando
+
+Trate comandos como entradas de casos de uso. Crie ou atualize
+`.pbai4devs/commands/<nome>/COMMAND.md` pelo
+[modelo](../../../templates/comando/TEMPLATE.md): ajuste descrição e H1,
+remova `status: modelo` e defina entrada, padrões, pré-requisitos, execução e
+saída. Reúna dúvidas que alterem esses contratos antes de executar.
+
+Reutilize uma skill para decisões e fluxos completos. Indique os nomes e
+argumentos dos scripts `.mjs` e use `executar-script` com Node.js 24+.
+Referencie ferramentas e pastas necessárias; não copie código, binários ou
+instruções. Preserve os argumentos e documentos existentes.
+
+Registre o prompt nativo em `.github/prompts/` no manifesto quando aplicável;
+ele contém apenas metadados, H1 e o link para a origem. Não prometa importação
+ou execução automática pelo Markdown.
+
+Atualize índice/guia, siga as regras de estrutura e qualidade e finalize com
+`sincronizar-agentes`, inclusive após renomear ou remover comandos. Confira os
+argumentos e a descoberta; informe quando a leitura precisar ser explícita.

package/.pbai4devs/skills/projeto/criar-recurso/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: criar-recurso
+description: Encaminha criações e cria documentos, modelos ou novos recursos.
+---
+
+# Criar recurso
+
+Se o pedido for um modelo, trabalhe em `.pbai4devs/templates/` sem iniciar a
+definição do produto. Encaminhe documentos reais à skill correspondente.
+
+Confira se o recurso já existe e use a skill específica quando disponível:
+`criar-skill`, `criar-agente`, `criar-comando`, `criar-regra`, `criar-prd`,
+`criar-ux-ui`, `criar-design-doc` ou `criar-spec`. Preserve os pré-requisitos.
+Para conhecimento de fornecedores, consulte `usar-skills-externas` e reutilize
+o catálogo curado, mantendo downloads fora das instruções versionadas.
+
+Para os demais tipos, esclareça finalidade, público, saída e dúvidas que afetam
+as decisões. Crie só o necessário: `.pbai4devs/<tipo>/<nome>/<TIPO>.md` para
+recursos dos agentes; `.pbai4devs/templates/<nome>/TEMPLATE.md` para modelos;
+documentos reais no destino acordado, somente quando o projeto começar.
+Scripts e configurações usam seu formato próprio na mesma organização por nome.
+Scripts de suporte seguem `executar-script`: escreva `.mjs` para Node.js 24+,
+reutilizando o código comum, sem variantes por sistema operacional.
+Código da aplicação segue `implementar-spec`.
+
+Ferramentas usam `.pbai4devs/tools/<nome>/TOOL.json` e um `SCRIPT.mjs` fino que
+delegam a `preparar-ferramentas`. Defina origem oficial, método de download,
+atualização, plataformas e probe; não duplique o instalador. Só as definições,
+scripts e guias são versionados; pacotes e registros ficam em `.local/`.
+Use `envPaths` só para diretórios suportados pela aplicação, sem alterar `HOME`.
+
+Mantenha instruções curtas e use referências para detalhes opcionais. Use
+`verificar-trabalho` para escolher e executar as provas aplicáveis. Siga as
+regras de estrutura e qualidade; atualize os índices se mudar o inventário.
+Ao criar uma pasta de primeiro nível em `.pbai4devs`, inclua um README curto sobre
+finalidade, itens e momento de uso. Espelhe apenas skills, agentes, comandos e
+regras; modelos, scripts, ferramentas locais, estado e guias ficam em `.pbai4devs`.
+Confira se as novas fontes são permitidas pelos `.gitignore` locais. Para novos
+tipos ou arquivos nativos, atualize os [modelos](../../../templates/gitignore/TEMPLATE.md).
+Finalize com `sincronizar-agentes` e `--check`. Documentos e recursos auxiliares
+nunca são espelhados. Informe o arquivo e as pendências.

package/.pbai4devs/skills/projeto/criar-regra/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: criar-regra
+description: Cria ou atualiza regras compartilhadas e seus apontamentos.
+---
+
+# Criar regra
+
+Defina finalidade, contexto e ativação. Crie ou atualize
+`.pbai4devs/rules/<nome>/RULE.md` com `description` e ativação explícita.
+Preserve escopos e mapeie diferenças sem ampliar a ativação silenciosamente.
+Defina `trigger` como `always_on`, `model_decision`, `glob` ou `manual` para
+Antigravity; `model_decision` usa a descrição e `glob` exige `globs`.
+Mantenha adaptações de outros clientes em YAMLs ao lado da fonte, registrados
+no manifesto. Confira os valores na [compatibilidade](../../../COMPATIBILIDADE.md).
+Mantenha a referência nativa de `.github/instructions/` quando aplicável.
+
+Atualize índice/guia, siga a regra de qualidade e finalize com
+`sincronizar-agentes`, inclusive após renomear ou remover regras. Verifique
+ativação quando possível e informe quando a leitura precisar ser explícita.

package/.pbai4devs/skills/projeto/criar-skill/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: criar-skill
+description: Cria ou atualiza skills compartilhadas do projeto.
+---
+
+# Criar skill
+
+Crie ou atualize `.pbai4devs/skills/<grupo>/<nome>/SKILL.md`, com `name` e
+`description`. Use nome em minúsculas, números e hífens, igual ao da pasta.
+Consulte `usar-skills-externas` e os fluxos existentes antes de criar outra
+implementação. Mantenha no arquivo só decisões e ações essenciais.
+Detalhes opcionais ficam em referências carregadas quando necessários.
+
+Indique a verificação adequada: terminal para lógica/API, navegador para web,
+automação para desktop e renderização para artefatos. Diga o que abrir e provar;
+reutilize `executar-script` e `verificar-trabalho` em vez de repetir seus fluxos.
+Siga a regra de qualidade e informe limitações.
+
+Atualize as referências humanas em `AGENTS.md` e no guia quando mudarem.
+Finalize com `sincronizar-agentes` para gerar os JSON e confira `--check`;
+não edite índices derivados à mão nem replique instruções.
+Apresente a skill para revisão e respeite as aprovações já dadas pelo usuário.

package/.pbai4devs/skills/projeto/executar-script/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: executar-script
+description: Identifica ferramentas instaladas e executa scripts pelo interpretador compatível.
+---
+
+# Executar script
+
+No início, confira Node.js 24+ e npm. Com Node 18+, execute o
+[bootstrap JavaScript](../../../scripts/preparar-ferramentas/BOOTSTRAP.md)
+com `--runtime-only` para preparar o núcleo. Sem Node, instale-o primeiro
+pelo mecanismo nativo do SO. Preserve a operação originalmente solicitada.
+Faça o preparo pelo usuário e reutilize o caminho absoluto informado, sem
+depender de PATH global. Execute
+`diagnosticar-ambiente` pelo seletor de [scripts](../../../scripts/README.md).
+Reutilize a verificação enquanto o ambiente não mudar.
+
+Prefira scripts existentes a reconstruir automações na conversa. Use
+`--plan <nome-ou-caminho>` para consultar a execução e confira pré-requisitos,
+efeitos e autorização da tarefa. Depois execute com os argumentos originais.
+Após o preparo, automações usam `.mjs`, iguais em todos os sistemas. O seletor usa
+o Node atual, preserva argumentos e códigos de saída e não instala dependências.
+
+Se indicar `playwright-mcp`, use o conector conforme a
+[referência](../../../scripts/testar-navegador/REFERENCE.md). Não execute esse
+arquivo como Node. Sem o conector exigido, informe o pré-requisito.
+
+Versione automações reutilizáveis e seus testes; salve somente diagnósticos,
+relatórios e capturas em `.agent-tests/`. Resuma comando, resultado e falhas;
+leia saídas completas apenas para investigar problemas.

package/.pbai4devs/skills/projeto/preparar-dev/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: preparar-dev
+description: Prepara ou repara o ambiente local de um projeto existente.
+---
+
+# Preparar desenvolvimento
+
+Inspecione somente este repositório: README, regras, manifests, lockfiles,
+Makefile, Compose, Dockerfiles, exemplos de ambiente e comandos de CI/testes.
+Identifique tecnologia, versões e a forma real de executar; não presuma que a
+estrutura esteja correta nem que tenha sido criada por este agente.
+
+Antes de preparar ferramentas, reutilize a seleção de clientes do pedido ou
+estado do kit. Se faltar, pergunte quais agentes o usuário usa; aplique pela CLI
+com `--agents` ou `agents`, sem inferir pelo aplicativo, SO ou pastas.
+Sem resposta disponível, use `all`. Isso não autoriza recriar o projeto.
+
+1. Use `executar-script` com `inspecionar-projeto` e `diagnosticar-ambiente`
+   para descobrir estrutura, SO, arquitetura, Docker/Compose e runtimes.
+   Confira conectores. Reúna as dúvidas no início: intenção, erro observado,
+   serviços externos, credenciais, versões, porta e dados/volumes a preservar.
+   Use o [modelo de ambiente](../../../templates/ambiente-local/TEMPLATE.md)
+   para completar apenas o que faltar.
+2. Apresente os reparos necessários e execute os autorizados. Para apenas
+   desenvolver, não exija novos PRD/design/spec nem reorganize a aplicação.
+   Restrinja o reparo ao ambiente; alterações funcionais têm escopo próprio.
+   Mudanças de arquitetura, versões ou migração de dados exigem decisão própria;
+   melhorias de estrutura seguem `configurar-projeto` quando solicitadas.
+3. Rode `preparar-ferramentas setup` para instalar e validar ferramentas locais
+   dos agentes por seus `TOOL.json`, com SO/arquitetura corretos e downloads
+   em `.pbai4devs/tools/<nome>/.local/`. Instale dependências
+   do projeto pelos lockfiles e comandos existentes; evite instalações globais.
+4. Prepare os serviços pelo Docker Compose local, conforme a
+   [regra de ambiente][ambiente]. Se estiver ausente
+   ou quebrado, adapte os modelos ao projeto com o reparo autorizado. Preserve
+   bancos, volumes e segredos; não recrie dados nem execute limpeza destrutiva.
+5. Valide configuração, build, saúde, migrações acordadas e testes relevantes.
+   Use `verificar-trabalho` para provar o fluxo real quando houver aplicação.
+   Relate comandos para subir/parar, URL/porta, evidências e pendências.
+
+Registre resultados locais em `.agent-tests/`; atualize documentação somente
+quando necessário e sincronize seus apontamentos. Para implementar novas
+funcionalidades, encaminhe ao fluxo de specs com seus pré-requisitos.
+
+[ambiente]: ../../../rules/ambiente-local/RULE.md

package/.pbai4devs/skills/projeto/preparar-ferramentas/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: preparar-ferramentas
+description: Instala e atualiza ferramentas locais de agentes para o SO e arquitetura atuais.
+---
+
+# Preparar ferramentas
+
+Identifique a operação e a seleção pedidas. Confira Node.js 24+ e npm antes
+dos `.mjs`; reutilize o runtime disponível e seu caminho absoluto.
+Com Node 18+, o [bootstrap JavaScript][bootstrap] e `--runtime-only` preparam
+Node 24+; depois execute a operação original. Sem Node/npm, instale primeiro
+pelo mecanismo nativo do SO. Faça o preparo pelo usuário e reutilize o runtime.
+
+Em `instalar-ferramentas`, o bootstrap sem essa opção já executa
+`setup <seleção>`; não repita a instalação. Consultas e execução não devem
+acionar `setup`: `check`, `info` e `run` preservam sua operação e seleção.
+
+As definições ficam em `.pbai4devs/tools/<nome>/TOOL.json`: origem, download,
+plataformas, entrada e prova de funcionamento. Consulte o
+[índice](../../../tools/README.md) e use o script da ferramenta para operações
+individuais. Execute `SCRIPT.mjs` com o Node selecionado; ele delega ao
+instalador compartilhado.
+
+No preparo inicial, execute `preparar-ferramentas setup` pelo seletor:
+instala e verifica todas as ferramentas compatíveis, sem atualizar as saudáveis.
+Aceita seleção por nome/grupo; relate falhas e itens não aplicáveis.
+Para buscar versões novas, `update` consulta `latest` oficial.
+`install` reutiliza uma instalação saudável; `check` verifica sem rede;
+`info` mostra a configuração; `run <nome> [argumentos]` executa sem instalar.
+Sem ação, mostre ajuda. Não interprete ausência de argumentos como instalação.
+
+Use `update agent-desktop` quando houver tarefa desktop, ou outro nome definido.
+Nenhum modo baixa Chrome ou concede permissões automaticamente. Prefira o
+navegador instalado com `--executable-path`; se faltar, combine seu preparo.
+
+Escolha pelo caso de uso no [índice](../../../tools/README.md): `opensrc` para
+consultar fontes de dependências; `skills` para descoberta; `just-bash` para
+shell virtual; `webreel` para roteiro de vídeo; `portless` para URLs locais.
+Em `skills`, use `find` ou `add <origem> --list`; incorporações passam por
+`criar-skill` e `sincronizar-agentes`, sem instalador externo nos espelhos.
+O shell virtual não substitui testes reais. Só ative proxy, certificados,
+serviços ou gravação quando necessários à tarefa e com dependências preparadas.
+
+Antes de usar agent-desktop, leia `skills get desktop` e `skills get platform`
+da versão instalada e confira `status`. Para agent-browser, leia
+`skills get core` e `--help` da versão instalada e
+observe a página antes de agir. Use `verificar-trabalho` para provar resultados.
+
+Versione `TOOL.json`, `SCRIPT.mjs` e `README.md` de
+cada ferramenta. Pacotes e registros ficam em `<nome>/.local/`; cache e launchers
+em `.pbai4devs/tools/.cache/` e `bin/`, ignorados. O estado próprio da aplicação
+segue os caminhos suportados e documentados por ferramenta. Não espelhe tools.
+Preserve a instalação anterior se a atualização falhar; informe versões,
+resultado e limitações. Um probe de versão não prova um fluxo de interface.
+
+[bootstrap]: ../../../scripts/preparar-ferramentas/BOOTSTRAP.md

package/.pbai4devs/skills/projeto/proximos-passos/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: proximos-passos
+description: Identifica o estado atual e orienta a próxima ação útil do projeto.
+---
+
+# Próximos passos
+
+Leia o pedido, o estado salvo e os documentos existentes. Use o idioma de
+`.pbai4devs/estado/agentdevkit.json` ou português quando ainda não houver escolha.
+Se a CLI estiver disponível, consulte `agentdevkit next --target . --json`;
+caso contrário, use os arquivos e a inspeção local do projeto.
+
+Ao finalizar uma etapa, destaque: resultado, pendências/bloqueios e próxima
+ação com comando ou skill, no formato da
+[regra de próximos passos](../../../rules/proximos-passos/RULE.md).
+Faça apenas as perguntas que impedem avançar.
+Continue o trabalho já autorizado; não reinicie fases concluídas nem apresente
+suposições como aprovações.
+
+Projeto novo segue preparação → PRD → UX/design → configuração → specs →
+implementação → revisão. Projeto existente parte de suas evidências atuais;
+instalar o kit não autoriza recriar documentos ou substituir decisões.
+Se não houver pendências no escopo, diga isso claramente.

package/.pbai4devs/skills/projeto/sincronizar-agentes/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: sincronizar-agentes
+description: Atualiza catálogos e apontamentos dos recursos compartilhados.
+---
+
+# Sincronizar agentes
+
+Use Node.js 24+ em qualquer sistema:
+
+```sh
+node .pbai4devs/scripts/sincronizar-agentes/SCRIPT.mjs --force
+```
+
+Também pode usar `executar-script` com o nome `sincronizar-agentes`.
+
+Após criar, alterar, mover ou remover recursos, sincronize e use `--check`.
+Os principais `SKILL.md`, `COMMAND.md`, `AGENT.md` e `RULE.md` são fontes.
+O mesmo comando gera `catalog.json` com todos os tipos e os três registros
+auxiliares. Os JSON derivados não são editados à mão. `--check` compara arquivos
+com as fontes, detectando inclusões, alterações, remoções e links inválidos.
+Os `.gitignore` de `.pbai4devs` e dos clientes também são gerados dos
+[modelos](../../../templates/gitignore/TEMPLATE.md). Preserve regras próprias
+fora do bloco gerenciado; `--check` identifica blocos ausentes ou divergentes.
+`--force` repara os destinos gerenciados, sobrescreve conflitos e limpa extras
+nesses destinos, com backup local do conteúdo próprio em `.agent-tests/`.
+Não apague raízes inteiras: workflows, configurações nativas e a origem ficam
+fora da limpeza. `--check` só confere, sem corrigir nem criar backups.
+
+O manifesto `.pbai4devs/espelhos.conf` registra clientes e formatos nativos.
+Respeite a seleção salva em `estado/agentdevkit.json`; não reative clientes para
+reparar apontamentos. Para alterá-la, use `agents` na CLI. Pastas compartilhadas
+continuam quando necessárias; arquivos próprios dos clientes são preservados
+pela CLI, inclusive ao reduzir a seleção.
+Use `gitignore|pasta` para pastas como `.vscode`, sem espelhar recursos nelas.
+`plano` adapta os nomes à descoberta dos clientes; metadados próprios de SDK
+podem vir de um YAML ao lado da fonte. Antigravity e Gemini recebem seus
+apontamentos; o catálogo geral inclui comandos, tools, scripts e modelos.
+Não replique tools, scripts, templates, estado, testes, docs ou guias.
+Não use `--documento`; mantenha documentos fora dos espelhos.
+
+Confira a [compatibilidade](../../../COMPATIBILIDADE.md); um link não importa
+seu conteúdo. Sem Node, use o preparo automático das ferramentas.