@pathbit/agentdevkit 0.0.13 → 0.0.15

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.
@@ -79,7 +92,9 @@ 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.
+O `.gitignore` da raiz pertence ao projeto e não é alterado pelo kit.
+Sem Git, a proteção local fica pendente; após `git init`, sincronize antes
+de adicionar arquivos ao índice.
 Documentos de produto também ficam fora dos espelhos. O comando `sincronizar`
 reconstrói apontamentos com `--force`; `--check` verifica sem alterações.
 

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/rules/qualidade/RULE.md

@@ -20,12 +20,11 @@ H1; preserve os metadados exigidos pela ferramenta. Em documentos humanos
 existentes, mantenha o formato e o conteúdo: não os reformate apenas para
 impor esse padrão.
 
-Ao criar ou atualizar `.gitignore`, mantenha o bloco do
-[modelo de gitignore](../../templates/gitignore/TEMPLATE.md)
-como última seção CUSTOM IGNORE e acrescente os padrões específicos ali.
-As políticas vêm desse modelo. `.pbai4devs/.gitignore` controla o hub; o gerador
-protege os derivados externos no Git local. Sem Git, uma proteção temporária
-na raiz evita versioná-los ao iniciar o repositório.
+O `.gitignore` da raiz pertence ao projeto e não é alterado pelo kit. O
+[modelo de gitignore](../../templates/gitignore/TEMPLATE.md) é opcional para
+regras do projeto. `.pbai4devs/.gitignore` controla o hub; o gerador protege
+os derivados externos no Git local. Sem Git, essa proteção fica pendente até
+`git init` e sincronização, antes de adicionar arquivos ao índice.
 Confira com Git tanto os arquivos permitidos quanto os artefatos ignorados.
 Scripts compartilhados devem ser versionados; resultados locais, ignorados.
 Ignore o conteúdo baixado de tools, preservando `TOOL.json`, scripts próprios

package/.pbai4devs/scripts/lib/README.md

@@ -12,6 +12,5 @@ Também procura executáveis opcionais no PATH sem iniciar um shell.
 `managed-toml.mjs` aplica o mesmo contrato ao `prompt` de comandos Gemini.
 Texto externo, nomes existentes e metadados humanos permanecem preservados.
 
-`gitignore.mjs` planeja exclusões locais e detecta regras conflitantes. Com
-exceções na raiz, pode acrescentar um bloco limitado ao estado privado dos
-clientes; alterações no bloco gerenciado impedem sua substituição.
+`gitignore.mjs` planeja exclusões locais e detecta regras conflitantes. Ele não
+altera o `.gitignore` da raiz; conflitos são informados para revisão humana.