@pathbit/agentdevkit 0.0.14 → 0.0.16

package/.pbai4devs/INSTRUCTIONS.md

@@ -40,6 +40,19 @@ 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.
 
+## Trabalho com especialistas
+
+Quando tarefas independentes justificarem, use subagentes disponíveis e
+autorizados: divida contexto, dependências, arquivos exclusivos de escrita e
+provas esperadas. Integre e confira os resultados no agente principal. Sem esse
+recurso, trabalhe em sequência e informe os limites; não apresente a própria
+revisão como independente. Escolha perfis por necessidade, sem impor tecnologia:
+[arquitetura](agents/arquiteto/AGENT.md), [backend](agents/especialista-backend/AGENT.md),
+[frontend](agents/especialista-frontend/AGENT.md), [QA](agents/engenheiro-qa/AGENT.md),
+[segurança](agents/auditor-seguranca/AGENT.md) e
+[performance](agents/analista-performance/AGENT.md). Validação e revisão devem
+considerar falhas e cenários adversariais, além do caminho de sucesso.
+
 ## Criar e manter recursos
 
 Use `criar-recurso`; ele encaminha à skill específica ou cria um novo tipo.

package/.pbai4devs/agents/README.md

@@ -21,6 +21,11 @@ descoberta automaticamente, peça leitura explícita da fonte compartilhada.
 | --- | --- |
 | [Planejador](planejador/AGENT.md) | Dúvidas, escopo e plano verificável. |
 | [Implementador](implementador/AGENT.md) | Código, testes e documentação. |
+| [Arquiteto de software](arquiteto/AGENT.md) | Decisões, contratos e riscos de arquitetura. |
+| [Especialista backend](especialista-backend/AGENT.md) | Implementação e contratos de serviços. |
+| [Especialista frontend](especialista-frontend/AGENT.md) | Implementação e fluxos de interface. |
+| [Engenheiro de QA](engenheiro-qa/AGENT.md) | Estratégia e provas funcionais e adversariais. |
+| [Analista de performance](analista-performance/AGENT.md) | Medições comparáveis e investigação de gargalos. |
 | [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. |

package/.pbai4devs/agents/analista-performance/AGENT.md

@@ -0,0 +1,12 @@
+---
+name: analista-performance
+description: Mede desempenho e investiga regressões com cargas e evidências comparáveis.
+---
+
+# Analista de performance
+
+Receba o escopo, ambiente, metas existentes e fluxos críticos. Use
+[avaliar-performance](../../skills/qualidade/avaliar-performance/SKILL.md).
+
+Entregue comandos, medições, limitações e hipóteses com evidências. Não edite
+fontes: encaminhe a mudança ao implementador e peça nova medição independente.

package/.pbai4devs/agents/analista-performance/antigravity.yaml

@@ -0,0 +1,8 @@
+---
+name: analista-performance
+description: Mede desempenho e investiga regressões com cargas e evidências comparáveis.
+tools: [view_file, grep_search, run_command]
+mainAgent: false
+subagent: true
+commandExecutionPolicy: "sandbox"
+---

package/.pbai4devs/agents/analista-performance/claude.yaml

@@ -0,0 +1,5 @@
+---
+name: analista-performance
+description: Mede desempenho e investiga regressões com cargas e evidências comparáveis.
+tools: Read, Grep, Glob, Bash
+---

package/.pbai4devs/agents/analista-performance/cursor.yaml

@@ -0,0 +1,5 @@
+---
+name: analista-performance
+description: Mede desempenho e investiga regressões com cargas e evidências comparáveis.
+readonly: false
+---

package/.pbai4devs/agents/analista-performance/gemini.yaml

@@ -0,0 +1,6 @@
+---
+name: analista-performance
+description: Mede desempenho e investiga regressões com cargas e evidências comparáveis.
+kind: local
+tools: [read_file, grep_search, run_shell_command]
+---

package/.pbai4devs/agents/analista-performance/github.yaml

@@ -0,0 +1,5 @@
+---
+name: analista-performance
+description: Mede desempenho e investiga regressões com cargas e evidências comparáveis.
+tools: [read, search, execute]
+---

package/.pbai4devs/agents/analista-performance/kimi-code.yaml

@@ -0,0 +1,5 @@
+---
+name: analista-performance
+description: Mede desempenho e investiga regressões com cargas e evidências comparáveis.
+tools: [Read, Grep, Glob, Bash]
+---

package/.pbai4devs/agents/analista-performance/mimocode.yaml

@@ -0,0 +1,8 @@
+---
+description: Mede desempenho e investiga regressões com cargas e evidências comparáveis.
+mode: subagent
+permission:
+  edit: deny
+  bash: ask
+  webfetch: deny
+---

package/.pbai4devs/agents/analista-performance/opencode.yaml

@@ -0,0 +1,11 @@
+---
+description: Mede desempenho e investiga regressões com cargas e evidências comparáveis.
+mode: subagent
+permissions:
+  - action: edit
+    resource: "*"
+    effect: deny
+  - action: shell
+    resource: "*"
+    effect: ask
+---

package/.pbai4devs/agents/arquiteto/AGENT.md

@@ -0,0 +1,14 @@
+---
+name: arquiteto
+description: Analisa decisões de arquitetura, contratos, riscos e impactos do escopo.
+---
+
+# Arquiteto de software
+
+Receba objetivos, decisões aprovadas, restrições e sistemas afetados. Use
+[avaliar-arquitetura](../../skills/arquitetura/avaliar-arquitetura/SKILL.md)
+e devolva perguntas essenciais ao agente principal.
+
+Entregue recomendações, contratos, riscos, evidências e verificações abertas;
+não altere arquivos nem aprove a própria proposta. Encaminhe segurança ao
+[auditor](../auditor-seguranca/AGENT.md) e revisão ao [revisor](../revisor/AGENT.md).

package/.pbai4devs/agents/arquiteto/antigravity.yaml

@@ -0,0 +1,8 @@
+---
+name: arquiteto
+description: Analisa decisões de arquitetura, contratos, riscos e impactos do escopo.
+tools: [view_file, grep_search]
+mainAgent: false
+subagent: true
+commandExecutionPolicy: "off"
+---

package/.pbai4devs/agents/arquiteto/claude.yaml

@@ -0,0 +1,5 @@
+---
+name: arquiteto
+description: Analisa decisões de arquitetura, contratos, riscos e impactos do escopo.
+tools: Read, Grep, Glob
+---

package/.pbai4devs/agents/arquiteto/cursor.yaml

@@ -0,0 +1,5 @@
+---
+name: arquiteto
+description: Analisa decisões de arquitetura, contratos, riscos e impactos do escopo.
+readonly: true
+---

package/.pbai4devs/agents/arquiteto/gemini.yaml

@@ -0,0 +1,6 @@
+---
+name: arquiteto
+description: Analisa decisões de arquitetura, contratos, riscos e impactos do escopo.
+kind: local
+tools: [read_file, grep_search]
+---

package/.pbai4devs/agents/arquiteto/github.yaml

@@ -0,0 +1,5 @@
+---
+name: arquiteto
+description: Analisa decisões de arquitetura, contratos, riscos e impactos do escopo.
+tools: [read, search]
+---

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

@@ -0,0 +1,5 @@
+---
+name: arquiteto
+description: Analisa decisões de arquitetura, contratos, riscos e impactos do escopo.
+tools: [Read, Grep, Glob]
+---

package/.pbai4devs/agents/arquiteto/mimocode.yaml

@@ -0,0 +1,8 @@
+---
+description: Analisa decisões de arquitetura, contratos, riscos e impactos do escopo.
+mode: subagent
+permission:
+  edit: deny
+  bash: deny
+  webfetch: deny
+---

package/.pbai4devs/agents/arquiteto/opencode.yaml

@@ -0,0 +1,11 @@
+---
+description: Analisa decisões de arquitetura, contratos, riscos e impactos do escopo.
+mode: subagent
+permissions:
+  - action: edit
+    resource: "*"
+    effect: deny
+  - action: shell
+    resource: "*"
+    effect: deny
+---

package/.pbai4devs/agents/engenheiro-qa/AGENT.md

@@ -0,0 +1,16 @@
+---
+name: engenheiro-qa
+description: Planeja e executa validações funcionais e adversariais com evidências.
+---
+
+# Engenheiro de QA
+
+Receba critérios de aceite, alterações e ambiente de teste autorizado. Use
+[planejar-qa](../../skills/qualidade/planejar-qa/SKILL.md) e
+[validar-adversarial](../../skills/qualidade/validar-adversarial/SKILL.md).
+
+Peça ao implementador testes versionados ausentes; não altere fontes para fazer
+uma verificação passar. Encaminhe segurança ao
+[auditor](../auditor-seguranca/AGENT.md).
+
+Entregue resultados por critério, comandos, evidências e limitações.

package/.pbai4devs/agents/engenheiro-qa/antigravity.yaml

@@ -0,0 +1,8 @@
+---
+name: engenheiro-qa
+description: Planeja e executa validações funcionais e adversariais com evidências.
+tools: [view_file, grep_search, run_command]
+mainAgent: false
+subagent: true
+commandExecutionPolicy: "sandbox"
+---

package/.pbai4devs/agents/engenheiro-qa/claude.yaml

@@ -0,0 +1,5 @@
+---
+name: engenheiro-qa
+description: Planeja e executa validações funcionais e adversariais com evidências.
+tools: Read, Grep, Glob, Bash
+---

package/.pbai4devs/agents/engenheiro-qa/cursor.yaml

@@ -0,0 +1,5 @@
+---
+name: engenheiro-qa
+description: Planeja e executa validações funcionais e adversariais com evidências.
+readonly: false
+---

package/.pbai4devs/agents/engenheiro-qa/gemini.yaml

@@ -0,0 +1,6 @@
+---
+name: engenheiro-qa
+description: Planeja e executa validações funcionais e adversariais com evidências.
+kind: local
+tools: [read_file, grep_search, run_shell_command]
+---

package/.pbai4devs/agents/engenheiro-qa/github.yaml

@@ -0,0 +1,5 @@
+---
+name: engenheiro-qa
+description: Planeja e executa validações funcionais e adversariais com evidências.
+tools: [read, search, execute]
+---

package/.pbai4devs/agents/engenheiro-qa/kimi-code.yaml

@@ -0,0 +1,5 @@
+---
+name: engenheiro-qa
+description: Planeja e executa validações funcionais e adversariais com evidências.
+tools: [Read, Grep, Glob, Bash]
+---

package/.pbai4devs/agents/engenheiro-qa/mimocode.yaml

@@ -0,0 +1,8 @@
+---
+description: Planeja e executa validações funcionais e adversariais com evidências.
+mode: subagent
+permission:
+  edit: deny
+  bash: ask
+  webfetch: deny
+---

package/.pbai4devs/agents/engenheiro-qa/opencode.yaml

@@ -0,0 +1,11 @@
+---
+description: Planeja e executa validações funcionais e adversariais com evidências.
+mode: subagent
+permissions:
+  - action: edit
+    resource: "*"
+    effect: deny
+  - action: shell
+    resource: "*"
+    effect: ask
+---

package/.pbai4devs/agents/especialista-backend/AGENT.md

@@ -0,0 +1,14 @@
+---
+name: especialista-backend
+description: Implementa e verifica o escopo backend aprovado e seus contratos.
+---
+
+# Especialista backend
+
+Receba spec e plano aprovados, contratos e arquivos atribuídos. Siga
+[implementar-backend](../../skills/desenvolvimento/implementar-backend/SKILL.md).
+Devolva incertezas ao agente principal e preserve alterações de outras pessoas.
+O agente principal coordena checkpoints, branches e integração.
+
+Entregue arquivos, evidências e limitações; solicite validação e revisão
+independentes, sem aprovar a própria mudança.

package/.pbai4devs/agents/especialista-backend/antigravity.yaml

@@ -0,0 +1,8 @@
+---
+name: especialista-backend
+description: Implementa e verifica o escopo backend aprovado e seus contratos.
+tools: [view_file, grep_search, run_command, replace_file_content]
+mainAgent: false
+subagent: true
+commandExecutionPolicy: "sandbox"
+---

package/.pbai4devs/agents/especialista-backend/claude.yaml

@@ -0,0 +1,5 @@
+---
+name: especialista-backend
+description: Implementa e verifica o escopo backend aprovado e seus contratos.
+tools: Read, Grep, Glob, Bash, Edit, Write
+---

package/.pbai4devs/agents/especialista-backend/cursor.yaml

@@ -0,0 +1,5 @@
+---
+name: especialista-backend
+description: Implementa e verifica o escopo backend aprovado e seus contratos.
+readonly: false
+---

package/.pbai4devs/agents/especialista-backend/gemini.yaml

@@ -0,0 +1,6 @@
+---
+name: especialista-backend
+description: Implementa e verifica o escopo backend aprovado e seus contratos.
+kind: local
+tools: [read_file, grep_search, run_shell_command, replace, write_file]
+---

package/.pbai4devs/agents/especialista-backend/github.yaml

@@ -0,0 +1,5 @@
+---
+name: especialista-backend
+description: Implementa e verifica o escopo backend aprovado e seus contratos.
+tools: [read, search, execute, edit]
+---

package/.pbai4devs/agents/especialista-backend/kimi-code.yaml

@@ -0,0 +1,5 @@
+---
+name: especialista-backend
+description: Implementa e verifica o escopo backend aprovado e seus contratos.
+tools: [Read, Grep, Glob, Bash, Edit, Write]
+---

package/.pbai4devs/agents/especialista-backend/mimocode.yaml

@@ -0,0 +1,8 @@
+---
+description: Implementa e verifica o escopo backend aprovado e seus contratos.
+mode: subagent
+permission:
+  edit: ask
+  bash: ask
+  webfetch: deny
+---

package/.pbai4devs/agents/especialista-backend/opencode.yaml

@@ -0,0 +1,11 @@
+---
+description: Implementa e verifica o escopo backend aprovado e seus contratos.
+mode: subagent
+permissions:
+  - action: edit
+    resource: "*"
+    effect: ask
+  - action: shell
+    resource: "*"
+    effect: ask
+---

package/.pbai4devs/agents/especialista-frontend/AGENT.md

@@ -0,0 +1,14 @@
+---
+name: especialista-frontend
+description: Implementa e verifica a interface aprovada e seus fluxos reais.
+---
+
+# Especialista frontend
+
+Receba spec, design e plano aprovados, contratos e arquivos atribuídos. Siga
+[implementar-frontend](../../skills/desenvolvimento/implementar-frontend/SKILL.md).
+Esclareça lacunas com o agente principal e preserve mudanças de outras pessoas.
+O agente principal coordena checkpoints, branches e integração.
+
+Entregue arquivos, evidências e limitações; solicite validação e revisão
+independentes, sem aprovar a própria mudança.

package/.pbai4devs/agents/especialista-frontend/antigravity.yaml

@@ -0,0 +1,8 @@
+---
+name: especialista-frontend
+description: Implementa e verifica a interface aprovada e seus fluxos reais.
+tools: [view_file, grep_search, run_command, replace_file_content]
+mainAgent: false
+subagent: true
+commandExecutionPolicy: "sandbox"
+---

package/.pbai4devs/agents/especialista-frontend/claude.yaml

@@ -0,0 +1,5 @@
+---
+name: especialista-frontend
+description: Implementa e verifica a interface aprovada e seus fluxos reais.
+tools: Read, Grep, Glob, Bash, Edit, Write
+---

package/.pbai4devs/agents/especialista-frontend/cursor.yaml

@@ -0,0 +1,5 @@
+---
+name: especialista-frontend
+description: Implementa e verifica a interface aprovada e seus fluxos reais.
+readonly: false
+---

package/.pbai4devs/agents/especialista-frontend/gemini.yaml

@@ -0,0 +1,6 @@
+---
+name: especialista-frontend
+description: Implementa e verifica a interface aprovada e seus fluxos reais.
+kind: local
+tools: [read_file, grep_search, run_shell_command, replace, write_file]
+---

package/.pbai4devs/agents/especialista-frontend/github.yaml

@@ -0,0 +1,5 @@
+---
+name: especialista-frontend
+description: Implementa e verifica a interface aprovada e seus fluxos reais.
+tools: [read, search, execute, edit]
+---

package/.pbai4devs/agents/especialista-frontend/kimi-code.yaml

@@ -0,0 +1,5 @@
+---
+name: especialista-frontend
+description: Implementa e verifica a interface aprovada e seus fluxos reais.
+tools: [Read, Grep, Glob, Bash, Edit, Write]
+---

package/.pbai4devs/agents/especialista-frontend/mimocode.yaml

@@ -0,0 +1,8 @@
+---
+description: Implementa e verifica a interface aprovada e seus fluxos reais.
+mode: subagent
+permission:
+  edit: ask
+  bash: ask
+  webfetch: deny
+---

package/.pbai4devs/agents/especialista-frontend/opencode.yaml

@@ -0,0 +1,11 @@
+---
+description: Implementa e verifica a interface aprovada e seus fluxos reais.
+mode: subagent
+permissions:
+  - action: edit
+    resource: "*"
+    effect: ask
+  - action: shell
+    resource: "*"
+    effect: ask
+---

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

@@ -6,11 +6,12 @@ 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;
+agente principal. Use [revisar-codigo](../../skills/qualidade/revisar-codigo/SKILL.md)
+para verificar 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
+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/opencode.yaml

@@ -1,7 +1,14 @@
 ---
 description: Revisa alterações e critérios de aceite em modo de leitura.
 mode: subagent
-permission:
-  edit: deny
-  bash: deny
+permissions:
+  - action: edit
+    resource: "*"
+    effect: deny
+  - action: shell
+    resource: "*"
+    effect: deny
+  - action: subagent
+    resource: "*"
+    effect: deny
 ---

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

@@ -9,7 +9,10 @@ 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.
+Use [planejar-qa](../../skills/qualidade/planejar-qa/SKILL.md) e
+[validar-adversarial](../../skills/qualidade/validar-adversarial/SKILL.md)
+para escolher cenários pertinentes. 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.
 

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

@@ -14,6 +14,13 @@ 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.
 
+Para tarefas independentes, distribua entre subagentes disponíveis e autorizados,
+como [backend](../../agents/especialista-backend/AGENT.md) e
+[frontend](../../agents/especialista-frontend/AGENT.md). Dê a cada um contexto,
+objetivo, dependências, arquivos exclusivos para escrita e provas esperadas.
+O agente principal integra as alterações, resolve interfaces e confere os resultados.
+Sem suporte à delegação, execute em sequência e informe essa limitação.
+
 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;

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

@@ -12,6 +12,12 @@ Acione o [planejador](../../agents/planejador/AGENT.md). Ele usa
 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.
+Quando o escopo justificar, consulte o [arquiteto](../../agents/arquiteto/AGENT.md)
+para fronteiras, alternativas, riscos e decisões de design. Identifique tarefas
+independentes, dependências, responsáveis por arquivos e provas necessárias;
+inclua backend, frontend, QA, segurança e performance quando aplicáveis.
+Planeje subagentes conforme a capacidade do cliente, sem antecipar fases do produto.
+
+Saída: escopo, dúvidas, tarefas, dependências, arquivos e provas por critério.
+O plano não autoriza mudanças por si só; respeite aprovações já registradas.
 Após o alinhamento, siga [implementar-entrega](../implementar-entrega/COMMAND.md).

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

@@ -14,9 +14,12 @@ urgente, defina critérios próprios AC-001 e registre o motivo.
    `--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`.
+3. Acione o [revisor](../../agents/revisor/AGENT.md) independente, em leitura,
+   para contestar premissas e procurar regressões, falhas e lacunas nas provas.
+   Registre achados com evidências e localização. Aplique os pertinentes; se
+   arquivos mudarem, gere novo snapshot, execute as verificações afetadas e
+   revise novamente antes de registrar `review.status: approved`. Sem revisão
+   independente disponível, informe a limitação e mantenha a revisão pendente.
 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.

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

@@ -12,7 +12,16 @@ Acione o [validador](../../agents/validador/AGENT.md) com
 Ele usa [executar-script](../../skills/projeto/executar-script/SKILL.md) e as
 verificações reais definidas no projeto. Não há comando universal de testes.
 
-Saída: resultado por critério, comandos e provas em `.agent-tests/`.
+Conforme o risco, envolva [QA](../../agents/engenheiro-qa/AGENT.md),
+[segurança](../../agents/auditor-seguranca/AGENT.md) e
+[performance](../../agents/analista-performance/AGENT.md). Cubra casos de sucesso,
+limite e falha, permissões e integração quando aplicáveis. Para backend, exercite
+contratos e dados; para interface, teste fluxos reais no navegador ou desktop.
+Em performance, registre ambiente, carga, métricas e comparação com a meta.
+Não invente metas nem marque como aprovado o que não foi executado.
+
+Saída: resultado por critério, comandos e provas em `.agent-tests/`. Código de
+teste e fixtures necessários são versionáveis; resultados não são versionados.
 O validador não corrige as fontes nem aprova a própria mudança. Entregue o
 resultado ao [revisor](../../agents/revisor/AGENT.md) pelo
 [gate de entrega](../revisar-entrega/COMMAND.md).

package/.pbai4devs/skills/README.md

@@ -13,6 +13,13 @@ as capacidades do cliente.
 - `projeto`: configuração, criação e manutenção dos recursos.
 - `produto`: PRD, experiência e design técnico.
 - `specs`: especificações, roadmap e implementação.
+- `arquitetura`: [avaliar decisões e riscos](arquitetura/avaliar-arquitetura/SKILL.md).
+- `desenvolvimento`: [backend](desenvolvimento/implementar-backend/SKILL.md) e
+  [frontend](desenvolvimento/implementar-frontend/SKILL.md).
+- `qualidade`: [QA](qualidade/planejar-qa/SKILL.md),
+  [validação adversarial](qualidade/validar-adversarial/SKILL.md),
+  [revisão de código](qualidade/revisar-codigo/SKILL.md) e
+  [performance](qualidade/avaliar-performance/SKILL.md).
 - `seguranca`: [revisão](seguranca/revisar-seguranca/SKILL.md),
   [autorização](seguranca/revisar-autorizacao/SKILL.md),
   [ameaças](seguranca/modelar-ameacas/SKILL.md) e

package/.pbai4devs/skills/arquitetura/avaliar-arquitetura/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: avaliar-arquitetura
+description: Avalia e orienta decisões de arquitetura conforme requisitos e restrições do software.
+---
+
+# Avaliar arquitetura
+
+Examine o produto, os fluxos, o design e o sistema existente. Reúna dúvidas
+que mudam decisões; quando faltar definição, encaminhe ao
+[design técnico](../../produto/criar-design-doc/SKILL.md). Não imponha stack.
+
+Identifique componentes, responsabilidades, contratos, dados e fronteiras de
+confiança. Avalie operação, evolução, falhas, segurança, desempenho e custos
+conforme o contexto. Compare alternativas e consequências; registre decisões,
+compensações e migração quando necessárias. Diagramas só quando esclarecerem.
+
+Questione acoplamento, perda de dados, dependências e falhas simultâneas com
+cenários concretos. Delegue uma análise independente quando disponível e
+permitido. Entregue decisão proposta, evidências, riscos e verificações abertas;
+não apresente hipóteses como fatos. Consulte [C4](https://c4model.com/diagrams)
+quando um diagrama ajudar.

package/.pbai4devs/skills/desenvolvimento/implementar-backend/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: implementar-backend
+description: Implementa mudanças de backend com contratos, dados e provas de comportamento.
+---
+
+# Implementar backend
+
+Siga a spec e o plano aprovados, os contratos e a stack existentes. Esclareça
+dúvidas sobre entradas, saídas, persistência,
+compatibilidade e falhas antes de decidir. Altere somente o escopo atribuído.
+
+Verifique validação de entrada, autorização por recurso e isolamento de dados.
+Considere limites, concorrência, repetição, timeout, migração e recuperação
+quando se aplicarem; não registre segredos. Reutilize convenções e ferramentas
+do projeto sem presumir banco, framework ou serviço externo.
+
+Prove casos normais e negativos por testes automatizados e, quando aplicável,
+por chamadas reais à API com dados isolados. Mocks não comprovam integrações
+que não foram executadas. Versione testes; mantenha resultados locais ignorados.
+Relate critérios, comandos, observações e dependências não verificadas.

package/.pbai4devs/skills/desenvolvimento/implementar-frontend/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: implementar-frontend
+description: Implementa interfaces web conforme a spec, o design e as provas de uso.
+---
+
+# Implementar frontend
+
+Siga a spec e o plano aprovados, o design e os componentes existentes.
+Esclareça comportamento, conteúdo e acessibilidade
+quando faltarem decisões; não escolha framework nem crie telas fora do escopo.
+
+Considere estados de carregamento, vazio, erro e sucesso; navegação por teclado,
+semântica acessível e diferentes tamanhos de tela. Preserve contratos com o
+backend e evite expor segredos ou dados de outras pessoas.
+
+Execute os testes apropriados e abra a interface real em navegador disponível.
+Percorra os fluxos alterados em desktop e celular quando aplicável; confira
+resultado, console e rede. Testes automáticos de acessibilidade são parciais:
+inclua inspeção por teclado e relate o que não foi verificado. Uma captura ou
+fixture isolada não prova o produto. Veja [Playwright](https://playwright.dev/docs/accessibility-testing).

package/.pbai4devs/skills/projeto/verificar-trabalho/SKILL.md

@@ -8,6 +8,9 @@ description: Verifica alterações com ferramentas reais e registra evidências
 Reúna os critérios e o impacto da alteração. Use `executar-script` para
 identificar ferramentas disponíveis e selecione os níveis aplicáveis. Use
 `usar-skills-externas` para referências pertinentes, sem adotar uma stack nova:
+[planejar-qa](../../qualidade/planejar-qa/SKILL.md) organiza casos por risco;
+[validar-adversarial](../../qualidade/validar-adversarial/SKILL.md) questiona
+as hipóteses e provas relevantes, no ambiente autorizado.
 
 1. **Estrutura:** para recursos dos agentes, execute `verificar-recursos`;
    ele confere espelhos, frontmatter/H1 e links, além do Markdown lint quando

package/.pbai4devs/skills/qualidade/avaliar-performance/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: avaliar-performance
+description: Mede e investiga desempenho com carga, comparação e limites explícitos.
+---
+
+# Avaliar performance
+
+Defina o fluxo, a métrica e o ambiente autorizados. Identifique meta existente
+ou registre sua ausência; não invente orçamento nem simule carga em produção
+sem autorização. Reúna volume de dados, concorrência e condições reproduzíveis.
+
+Meça uma linha de base e compare a mudança nas mesmas condições; registre
+comandos, repetições, latência, erros, throughput e recursos conforme o caso.
+Investigue o gargalo antes de otimizar e prove que o comportamento permanece.
+Para web, use métricas pertinentes como LCP, INP e CLS e distinga medições
+locais de dados reais de usuários: veja [Core Web Vitals](https://web.dev/articles/vitals).
+
+Informe variação, limitações e resultado em relação à meta. Sem ambiente,
+carga ou dados adequados, marque como não verificado; não extrapole uma medição
+local para produção. Salve relatórios em diretório ignorado.

package/.pbai4devs/skills/qualidade/planejar-qa/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: planejar-qa
+description: Planeja e executa verificações de QA orientadas a riscos e critérios de aceite.
+---
+
+# Planejar QA
+
+Para cada critério de aceite, identifique o comportamento observável, riscos,
+dados, pré-requisitos e ambiente. Se uma decisão impedir a prova, esclareça-a;
+não invente acesso, dados ou resultados.
+
+Escolha casos positivos, negativos, limites, transições e regressões relevantes.
+Combine testes unitários, integração, API, navegador ou desktop conforme o
+produto e o risco; use ferramentas existentes e fixtures isoladas. Testes de
+contrato ou mocks não substituem uma integração real não executada.
+
+Registre para cada critério comando ou ação, resultado observado e estado
+**passou**, **falhou** ou **não verificado**, com evidência e limitações.
+Versione o código dos testes e salve resultados em `.agent-tests/` ou diretório
+ignorado. Encaminhe hipóteses de falha à
+[validação adversarial](../validar-adversarial/SKILL.md).

package/.pbai4devs/skills/qualidade/revisar-codigo/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: revisar-codigo
+description: Revisa alterações de código em busca de defeitos, regressões e provas insuficientes.
+---
+
+# Revisar código
+
+Examine o diff, o contexto necessário, os critérios e as evidências; preserve
+as alterações de outras pessoas. Trabalhe em leitura quando atuar como
+[revisor](../../../agents/revisor/AGENT.md) e peça o que faltar.
+
+Investigue correção, contratos, dados, concorrência, falhas, segurança e efeitos
+de implantação pertinentes. Use [validação adversarial](../validar-adversarial/SKILL.md)
+para refutar suposições e identifique testes de regressão ausentes. Priorize
+defeitos reproduzíveis, não preferências de estilo ou mudanças fora do escopo.
+
+Para cada achado, informe arquivo, linha, cenário, impacto e evidência; distinga
+certeza de hipótese. Indique o que foi verificado e os limites. Se não houver
+achados, diga isso sem afirmar que o código está livre de defeitos.

package/.pbai4devs/skills/qualidade/validar-adversarial/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: validar-adversarial
+description: Busca e verifica falhas plausíveis em requisitos, mudanças e evidências autorizadas.
+---
+
+# Validar adversarialmente
+
+Leia o escopo, a mudança e as provas existentes. Formule hipóteses concretas
+que possam contrariar cada resultado relevante: dados inválidos, limites,
+permissões, estados ausentes, falhas de dependências ou concorrência aplicável.
+Priorize pelo impacto e pela chance, não pela quantidade de cenários.
+
+Tente reproduzir ou refutar cada hipótese em ambiente e dados autorizados,
+preferindo isolamento e verificações não destrutivas. Use uma revisão
+independente quando houver agente disponível e permitido; caso contrário,
+registre a limitação e faça uma segunda leitura crítica. Não acesse sistemas,
+segredos ou serviços externos sem autorização.
+
+Relate cenário, observação, impacto, localização e confiança; diferencie falha
+confirmada, hipótese e teste não executado. Para segurança, encaminhe à
+[revisão de segurança](../../seguranca/revisar-seguranca/SKILL.md); correções
+exigem nova prova. Não declare ausência de falhas a partir de uma amostra.

package/.pbai4devs/skills/seguranca/revisar-seguranca/SKILL.md

@@ -18,6 +18,8 @@ Revise também autenticação, autorização por recurso, isolamento de dados,
 segredos e entradas conforme o [guia](../REFERENCE.md).
 Use [revisar-autorizacao](../revisar-autorizacao/SKILL.md) para permissões e
 [modelar-ameacas](../modelar-ameacas/SKILL.md) quando houver novas fronteiras.
+Use [validação adversarial](../../qualidade/validar-adversarial/SKILL.md) para
+testar hipóteses de abuso dentro do escopo autorizado.
 
 Registre achado, evidência, impacto, confiança e estado da triagem, sem valores
 secretos. Diferencie vulnerabilidade confirmada, suspeita e falso positivo.

package/.pbai4devs/skills/specs/implementar-spec/SKILL.md

@@ -27,6 +27,11 @@ antes de implementar.
 5. Implemente só a spec. Em trabalho delegado, use worktrees e branches próprias;
    integre somente trabalho completo e verificado, sem sobrescrever alterações.
    Esclareça novos impedimentos antes de avançar na parte afetada.
+   Quando disponíveis e autorizados, divida tarefas independentes entre
+   especialistas com arquivos atribuídos e provas esperadas. Use as skills de
+   [backend](../../desenvolvimento/implementar-backend/SKILL.md) e
+   [frontend](../../desenvolvimento/implementar-frontend/SKILL.md) conforme o
+   escopo. Se não houver delegação, prossiga em sequência e informe o limite.
 6. Por tarefa concluída, atualize tarefas/release e a documentação afetada com
    `atualizar-documentacao`. Execute o comando `revisar-entrega`, incluindo
    provas e revisão independente. Só então crie o commit do checkpoint conforme

package/CHANGELOG.md

@@ -4,6 +4,21 @@ description: Alterações verificáveis por versão do AgentDevKit.
 
 # Changelog
 
+## 0.0.16 — 2026-11-13
+
+- Testes portáteis distribuídos entre jobs para Windows e macOS.
+- Diagnósticos de subprocessos e espera do CI melhorados para releases.
+- Instruções para recuperar o artefato da tentativa correta do CI.
+
+## 0.0.15 — 2026-11-13
+
+- Especialistas e skills para arquitetura, backend, frontend, QA e performance.
+- Revisão de código e validação adversarial orientadas por evidências.
+- Delegação de tarefas independentes com responsabilidades e limites claros.
+- Preservação de arquivos e configurações existentes coberta por integração.
+- Permissões de somente leitura do revisor compatíveis com OpenCode V2.
+- Testes portáveis com concorrência limitada e diagnóstico de falhas da CLI.
+
 ## 0.0.14 — 2026-11-12
 
 - O `.gitignore` da raiz pertence ao projeto e não é alterado pelo kit.

package/docs/README.md

@@ -28,6 +28,7 @@ pode trocar de agente sem manter várias cópias das mesmas instruções.
 | Evoluir documentação existente | [Inventariar e complementar](guides/documentation.md) |
 | Personalizar agentes | [Recursos][resources] → [compatibilidade][clients] |
 | Entender cada peça com um exemplo | [Recursos na prática](guides/recursos-na-pratica.md) |
+| Escolher especialistas e distribuir trabalho | [Perfis e colaboração](guides/resources.md#especialistas-e-colaboração) |
 | Revisar segurança | [Scanners locais e controles](guides/security.md) |
 | Executar ou verificar algo | [CLI](guides/cli.md) → [ferramentas e testes][tests] |
 | Corrigir uma dificuldade | [Soluções e recuperação](guides/troubleshooting.md) |

package/docs/guides/recursos-na-pratica.md

@@ -43,6 +43,17 @@ conforme suas capacidades e permissões. Consulte a
 6. Atualize a documentação afetada e encaminhe a mudança à
    [revisão independente][review]. A equipe decide quando integrar a entrega.
 
+Quando houver trabalho independente, o agente principal pode distribuí-lo
+entre os [especialistas][specialists] disponíveis, com responsáveis por arquivos,
+dependências e provas. Se o cliente não oferecer subagentes, o trabalho segue
+em sequência e a ausência de revisão independente fica explícita.
+
+Escolha provas pelo escopo: contratos, validação e dados no backend; interação,
+acessibilidade, estados de erro e navegador ou desktop no frontend. QA inclui
+casos de limite e falha; segurança considera ameaças e permissões; performance
+compara medições com metas e carga definidas. Registre ambiente, comandos e
+resultados por critério, inclusive falhas e verificações não executadas.
+
 Para um projeto existente, comece pelo inventário e preserve suas decisões;
 consulte o [fluxo de trabalho][workflow] e a
 [instalação em projetos existentes][install].
@@ -89,3 +100,4 @@ sincronize e verifique os apontamentos. Para dúvidas de operação, consulte
 [install]: installation.md
 [cli]: cli.md
 [resources]: resources.md
+[specialists]: resources.md#especialistas-e-colaboração

package/docs/guides/resources.md

@@ -56,6 +56,24 @@ O agente principal reúne resultados e mantém o contexto. Quando um cliente
 não permite delegação aninhada, o especialista devolve o próximo passo ao
 principal. Markdown e links não criam processos nem executam código sozinhos.
 
+## Especialistas e colaboração
+
+| Perfil | Quando contribui |
+| --- | --- |
+| [Arquiteto][architect] | Fronteiras, alternativas, riscos e decisões técnicas. |
+| [Backend][backend] | Contratos, dados, integrações e falhas do servidor. |
+| [Frontend][frontend] | Interação, acessibilidade, estados e experiência real. |
+| [QA][qa] e [validador][validator] | Casos, critérios e evidências executadas. |
+| [Auditor de segurança][auditor] | Ameaças e controles no contexto da mudança. |
+| [Performance][performance] | Carga, métricas e comparação com metas definidas. |
+| [Revisor][reviewer] | Revisão independente da mudança e das provas. |
+
+Use apenas os perfis relevantes à tarefa e à fase do projeto. Quando o cliente
+permitir, distribua tarefas independentes entre subagentes com arquivos de
+escrita exclusivos, dependências explícitas e evidências esperadas. O principal
+integra os resultados. Sem delegação, execute sequencialmente e informe o que
+não teve revisão independente; links não garantem execução automática.
+
 ## Três fluxos completos
 
 | Etapa | Comando | Resultado |
@@ -170,3 +188,11 @@ Para provas reais, consulte [ferramentas e testes](tools-and-testing.md).
 [compatibilidade]: ../../.pbai4devs/COMPATIBILIDADE.md
 [externas]: ../../.pbai4devs/external-skills/README.md
 [ignore]: ../../.pbai4devs/templates/gitignore/TEMPLATE.md
+[architect]: ../../.pbai4devs/agents/arquiteto/AGENT.md
+[backend]: ../../.pbai4devs/agents/especialista-backend/AGENT.md
+[frontend]: ../../.pbai4devs/agents/especialista-frontend/AGENT.md
+[qa]: ../../.pbai4devs/agents/engenheiro-qa/AGENT.md
+[validator]: ../../.pbai4devs/agents/validador/AGENT.md
+[auditor]: ../../.pbai4devs/agents/auditor-seguranca/AGENT.md
+[performance]: ../../.pbai4devs/agents/analista-performance/AGENT.md
+[reviewer]: ../../.pbai4devs/agents/revisor/AGENT.md

package/docs/maintainers/maintenance.md

@@ -19,22 +19,26 @@ Resultados e capturas de verificação permanecem ignorados.
 
 ## Verificar sem desperdiçar CI
 
-O CI tem quatro perfis:
+O CI verifica Linux e distribui a portabilidade em grupos independentes:
 
 | Perfil | Responsabilidade |
 | --- | --- |
 | Linux / Node 24 | Fontes, produto, infraestrutura, lint e pacote real. |
-| Windows / Node 24 | Portabilidade da CLI, arquivos e runtime. |
-| macOS / Node 24 | Portabilidade da CLI, arquivos e runtime. |
+| Windows / Node 24 | CLI, projetos, recursos e layout em jobs separados. |
+| macOS / Node 24 | Os mesmos grupos de portabilidade em jobs separados. |
 | Linux / Node 26 | Smoke de compatibilidade. |
 
 O perfil macOS usa o runner padrão `macos-15-intel`. O label `macos-latest`
 usa ARM64 e pode ter filas diferentes; confira os [runners disponíveis][runners]
 antes de mudar a arquitetura. Provas locais devem informar a arquitetura usada.
 
-A distribuição real é testada uma vez no perfil completo. Os outros perfis
-validam seus riscos específicos. Execuções antigas da mesma referência podem
+A distribuição real é testada uma vez no perfil completo. Todos os grupos de
+Windows e macOS precisam passar para aprovar o CI. Cada grupo tem seu próprio
+log e limite, o que facilita identificar o teste que falhou. Execuções antigas
+da mesma referência podem
 ser canceladas quando substituídas, sem cancelar uma publicação em andamento.
+Novas suítes devem integrar um grupo portátil ou registrar uma justificativa
+explícita para executar somente no perfil completo.
 
 O workflow [Security tools smoke][security-ci] instala os três scanners com
 pins revisados em Linux, macOS e Windows. Depois analisa fixtures locais sem
@@ -81,7 +85,10 @@ Também envia o mesmo pacote ao [npm público e GitHub Packages](packages.md),
 confere a integridade nos dois destinos e testa versão, instalação, diagnóstico
 e sincronização. O consumo pelo npm é anônimo; pelo GitHub, autenticado.
 
-Se o artifact expirou, reexecute o CI original do push e depois a release.
+Se o artifact expirou ou um job do CI falhou, use **Re-run all jobs** no CI
+original do push e aguarde todos os jobs. **Re-run failed jobs** pode manter o
+pacote de uma tentativa anterior, que a release não aceita. Depois reexecute
+a release.
 Uma execução manual de CI serve para diagnóstico, mas não substitui essa
 procedência. Uma release existente não é sobrescrita.
 

package/docs/specs/README.md

@@ -17,6 +17,9 @@ description: Incrementos verificáveis do AgentDevKit.
 - [Dois registries](dual-registry/SPEC.md): versão e bytes iguais no npm e GitHub.
 - [v0.0.10](v0.0.10/SPEC.md): release com instalação pelos dois registries e pré-requisitos.
 - [Ecossistema de segurança](security-ecosystem/SPEC.md): fluxos e scanners locais.
+- [Ecossistema de desenvolvimento](development-ecosystem/SPEC.md):
+  especialistas, colaboração e provas.
+- [Confiabilidade da pipeline](ci-resilience/SPEC.md): testes e releases.
 - [Integração sem substituição][additive]: acréscimos em arquivos existentes.
 - [Compatibilidade com projetos reais][oss]: projetos públicos e exemplos reproduzíveis.
 - [Ignore do projeto](project-ignore/SPEC.md): preservar o arquivo da raiz.

package/docs/specs/ci-resilience/SPEC.md

@@ -0,0 +1,30 @@
+---
+description: Execução portátil e publicação confiáveis após falhas do CI.
+---
+
+# Confiabilidade da pipeline
+
+As verificações devem identificar a causa das falhas e oferecer margem para
+runners de velocidades diferentes, sem reduzir a cobertura nem liberar um
+pacote antes da aprovação de todos os jobs.
+
+## Critérios de aceite
+
+- AC-001: Os testes portáteis executam em grupos independentes no Windows e
+  no macOS; uma falha em qualquer grupo reprova o CI. O comando local continua
+  executando todos os grupos e as suítes críticas permanecem cobertas.
+- AC-002: Processos de teste e publicação reportam erros e sinais úteis sem
+  expor credenciais. Tempo esgotado continua sendo falha.
+- AC-003: A release aguarda o CI pelo período configurado com margem para a
+  duração e a fila; continua exigindo o artefato do commit e da tentativa
+  aprovados e não aceita CI falho ou de outra origem.
+- AC-004: Linux, Windows e macOS executam as verificações do CI real; os dois
+  registros recebem e verificam o mesmo pacote aprovado, se houver release.
+- AC-005: A documentação explica os perfis e como repetir todos os jobs ao
+  recuperar o artefato de uma tentativa anterior.
+
+## Verificação
+
+Execute testes de regressão dos limites, falhas, grupos e publicação, além do
+perfil completo local. Acompanhe os runners reais e a release até a conclusão;
+registre resultados e revisão independente no gate de entrega.

package/docs/specs/development-ecosystem/SPEC.md

@@ -0,0 +1,32 @@
+---
+description: Especialistas, colaboração e provas para desenvolvimento de software.
+---
+
+# Ecossistema de desenvolvimento
+
+O kit orienta equipes e agentes em arquitetura, backend, frontend, QA,
+segurança, revisão e performance, sem determinar a tecnologia do projeto.
+Os recursos são instruções: sua existência não executa agentes ou ferramentas.
+
+## Critérios de aceite
+
+- AC-001: Skills e perfis especializados são descobertos pelos clientes
+  selecionados e apontam para as fontes compartilhadas.
+- AC-002: O fluxo distribui tarefas independentes quando há subagentes
+  permitidos e disponíveis, define responsabilidades e integra os resultados.
+  Sem delegação ou revisão independente, informa a limitação.
+- AC-003: As orientações selecionam provas reais por risco e critério,
+  incluindo falhas, acessibilidade e análise adversarial quando aplicáveis;
+  distinguem resultados observados e verificações não executadas.
+- AC-004: A instalação preserva configurações, conteúdo existente, o índice
+  Git e o `.gitignore` da raiz do projeto.
+- AC-005: Documentação e catálogos explicam o uso dos recursos e seus limites;
+  as verificações de fontes, integração e distribuição são executadas.
+- AC-006: O perfil de revisão do OpenCode V2 nega edição, shell e delegação
+  no frontmatter gerado.
+
+## Verificação
+
+Execute os testes de integração e a pipeline local completa. Verifique os
+adaptadores gerados, a preservação de conteúdo e o resultado da revisão
+independente. Registre provas e pendências conforme o gate de entrega.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pathbit/agentdevkit",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "description": "Shared skills, specifications and workflows for AI coding agents.",
   "type": "module",
   "license": "MIT",