@pathbit/agentdevkit 0.0.13 → 0.0.15

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/.pbai4devs/templates/gitignore/TEMPLATE.md

@@ -1,15 +1,15 @@
 ---
-description: Bloco customizado obrigatório ao final do gitignore.
+description: Exemplo opcional de regras de ignore para o projeto.
 ---
 
 # Custom ignore
 
-Ao criar ou atualizar `.gitignore`, mantenha este bloco no final. Preserve
-exceções existentes e acrescente os ignorados específicos da tecnologia aqui.
+O `.gitignore` da raiz pertence ao projeto; o kit não o cria nem o altera.
+O projeto pode adotar este exemplo e seus próprios padrões se desejar.
 Regras de artefatos locais vêm de [shared.ignore](shared.ignore) e
 [agents.ignore](agents.ignore). As saídas calculadas usam
-[local.ignore](local.ignore) em `.git/info/exclude`; sem Git, um bloco gerado
-na raiz protege os arquivos e migra para `exclude` após `git init` e `sync`.
+[local.ignore](local.ignore) em `.git/info/exclude`; sem Git, essa proteção
+fica pendente até `git init` e sincronização, antes de adicionar arquivos.
 O sincronizador mantém o bloco `BEGIN AGENT IGNORE` / `END AGENT IGNORE`;
 regras próprias ficam fora dele, com exceções depois do bloco. Para permitir
 novos arquivos compartilhados, ajuste as fontes e sincronize. Raízes dedicadas

package/CHANGELOG.md

@@ -4,6 +4,22 @@ description: Alterações verificáveis por versão do AgentDevKit.
 
 # Changelog
 
+## 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.
+- Exclusões locais ficam no Git e conflitos são informados antes da instalação.
+- Projetos sem Git recebem orientação para ativar a proteção após `git init`.
+- Negação ambígua, blocos antigos e artefatos rastreados recebem diagnóstico.
+
 ## 0.0.13 — 2026-11-12
 
 - Proteção de caches de agentes mesmo com negações genéricas no `.gitignore`.

package/README.en.md

@@ -43,7 +43,7 @@ Then open the project in your coding agent and ask:
 
 See [installation](docs/guides/installation.md) for runtime preparation, previews
 and updates. Both [package registries][packages] provide the same version;
-the [v0.0.12 release][release] retains artifacts and checksums for verification.
+the [latest release][release] retains artifacts and checksums for verification.
 No global installation is required.
 The CLI supports `pt`, `en` and `es`; it saves your selection per project.
 
@@ -90,7 +90,7 @@ forms. See [how to participate](docs/maintainers/community.md).
 agent to read `AGENTS.md`.
 
 [clients]: .pbai4devs/COMPATIBILIDADE.md
-[release]: https://github.com/pathbit/AgentDevKit/releases/tag/v0.0.12
+[release]: https://github.com/pathbit/AgentDevKit/releases/latest
 [npm-package]: https://www.npmjs.com/package/@pathbit/agentdevkit
 [npm-badge]: https://img.shields.io/npm/v/%40pathbit%2Fagentdevkit
 [license-badge]: https://img.shields.io/badge/license-MIT-blue

package/README.es.md

@@ -44,7 +44,7 @@ Después, abre el proyecto en tu agente y pide:
 La [guía de instalación](docs/guides/installation.md) incluye preparación del
 runtime, simulación y actualización. Los dos [registros][packages] ofrecen
 la misma versión;
-la [release v0.0.12][release] conserva artefactos y checksums para verificarlos.
+la [última release][release] conserva artefactos y checksums para verificarlos.
 No requiere instalación global.
 La CLI guarda el idioma `pt`, `en` o `es` por proyecto.
 
@@ -92,7 +92,7 @@ formularios. Consulta [cómo participar](docs/maintainers/community.md).
 al agente que lea `AGENTS.md`.
 
 [clients]: .pbai4devs/COMPATIBILIDADE.md
-[release]: https://github.com/pathbit/AgentDevKit/releases/tag/v0.0.12
+[release]: https://github.com/pathbit/AgentDevKit/releases/latest
 [npm-package]: https://www.npmjs.com/package/@pathbit/agentdevkit
 [npm-badge]: https://img.shields.io/npm/v/%40pathbit%2Fagentdevkit
 [license-badge]: https://img.shields.io/badge/license-MIT-blue

package/README.md

@@ -46,7 +46,7 @@ Depois, abra o projeto no seu agente e peça:
 
 Windows, instalação sem Node, simulação e atualização estão no
 [guia de instalação](https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/installation.md). A distribuição usa a
-versão publicada no [npm e GitHub Packages][packages] e na [release v0.0.12][release],
+versão publicada no [npm e GitHub Packages][packages] e na [release][release],
 sem instalação global. Instalação e atualização usam o pacote do registro;
 os arquivos da release servem para conferir os artefatos publicados.
 O idioma da CLI pode ser `pt`, `en` ou `es`.
@@ -60,6 +60,7 @@ O idioma da CLI pode ser `pt`, `en` ou `es`.
 | Planejar ou retomar um projeto | [Fluxo de trabalho](https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/workflow.md) |
 | Evoluir documentos existentes | [Inventário e complementos](https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/documentation.md) |
 | Criar uma skill ou comando | [Recursos](https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/resources.md) |
+| Entender agentes, skills e comandos | [Recursos na prática](https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/recursos-na-pratica.md) |
 | Instalar ferramentas e comprovar uma entrega | [Ferramentas e testes][tests] |
 | Revisar segurança sem serviços externos | [Segurança local](https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/security.md) |
 | Consultar opções ou resolver um erro | [CLI][cli] · [Soluções][help] |
@@ -106,7 +107,7 @@ ao seu agente para ler `AGENTS.md`.
 [help]: https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/troubleshooting.md
 [issues]: https://github.com/pathbit/AgentDevKit/issues/new/choose
 [packages]: https://github.com/pathbit/AgentDevKit/blob/master/docs/maintainers/packages.md
-[release]: https://github.com/pathbit/AgentDevKit/releases/tag/v0.0.12
+[release]: https://github.com/pathbit/AgentDevKit/releases/latest
 [npm-package]: https://www.npmjs.com/package/@pathbit/agentdevkit
 [npm-badge]: https://img.shields.io/npm/v/%40pathbit%2Fagentdevkit
 [license-badge]: https://img.shields.io/badge/license-MIT-blue

package/docs/README.md

@@ -27,6 +27,8 @@ pode trocar de agente sem manter várias cópias das mesmas instruções.
 | Projeto em andamento | [Instalar com simulação][install] → [retomar][flow] |
 | 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/README.md

@@ -10,6 +10,7 @@ description: Guias de instalação, uso e verificação do AgentDevKit.
 - [Fluxo de trabalho](workflow.md)
 - [Evoluir documentação existente](documentation.md)
 - [Recursos dos agentes](resources.md)
+- [Recursos na prática: do pedido à entrega](recursos-na-pratica.md)
 - [Segurança local](security.md)
 - [Ferramentas e testes](tools-and-testing.md)
 - [Solução de problemas](troubleshooting.md)

package/docs/guides/installation.md

@@ -105,20 +105,24 @@ identifica a licença dos recursos do AgentDevKit, sem redefinir a do projeto.
 Um `.gitignore` dentro de `.pbai4devs` só controla essa árvore. Para os
 apontamentos externos, o kit gera exclusões locais do Git, sem ignorar
 workflows, formulários de issues ou configurações humanas em `.github`.
-Sem Git, uma proteção no `.gitignore` da raiz evita incluir os derivados
-quando o repositório for iniciado.
+O kit não cria nem altera o `.gitignore` da raiz. Sem Git, a exclusão local
+fica pendente; execute `git init` e `npx @pathbit/agentdevkit sync` antes de
+usar `git add`. No GitHub Packages, use o prefixo de registry da instalação.
 
 O bloco local também protege `.agent-tests`, `tmp`, `temp`, `.playwright*`
 e relatórios de testes, inclusive com letras maiúsculas e em subpastas.
 O conteúdo do `.gitignore` existente e os arquivos rastreados são preservados.
-Quando há exceções no `.gitignore` da raiz, o kit pode acrescentar um bloco
-limitado ao estado privado dos clientes, sem criar pastas não selecionadas.
-Conflitos detectados nas demais proteções são informados para revisão.
+Uma exceção que reabra arquivo privado ou artefato é informada como conflito;
+o projeto decide como ajustar suas próprias regras.
+Negativas com curingas também podem ser recusadas preventivamente, mesmo antes
+de existir um arquivo correspondente. Examine a regra indicada no diagnóstico.
 Nomes próprios de artefatos e arquivos existentes também são conferidos;
 a validação fica restrita ao projeto e aos ignores de seus ancestrais.
 
 Arquivos já rastreados exigem migração do índice: apenas saídas identificadas
 do kit podem deixar de ser rastreadas, preservando seus bytes no disco.
+Artefatos já rastreados são informados por `doctor` e `sync --check` para
+revisão; não são removidos automaticamente do índice.
 Revise o plano e os conflitos em um projeto existente; use `--dry-run` antes
 de aplicar. Conteúdo humano não deve ser classificado como saída do gerador.
 

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

@@ -0,0 +1,103 @@
+---
+description: Como usar os recursos do AgentDevKit no desenvolvimento de software.
+language: pt
+---
+
+# Recursos na prática
+
+O AgentDevKit organiza o trabalho de desenvolvimento de software com agentes
+que você escolhe. O kit reúne instruções e ferramentas; decisões de produto,
+revisão humana e testes continuam necessários no projeto atendido.
+
+## Qual recurso usar?
+
+| Recurso | Para que serve | Exemplo concreto |
+| --- | --- | --- |
+| [Skill][skills] | Orienta decisões e passos de uma tarefa recorrente. | [Criar uma spec][spec] com dúvidas e critérios. |
+| [Comando][commands] | Dá entrada a um caso de uso e encaminha o trabalho. | [Validar entrega][validar] com provas. |
+| [Agente][agents] | Define responsabilidades e limites de um papel. | [Revisor][reviewer] examina a mudança em leitura. |
+| [Regra][rules] | Registra uma convenção aplicável a um contexto. | [Qualidade][quality] orienta os cuidados da entrega. |
+| [Template][templates] | Oferece uma estrutura para registrar decisões. | Preencher a [spec][spec-template] de um incremento. |
+| [Script][scripts] | Executa uma automação reutilizável. | [Sincronizar][sync] os apontamentos. |
+| [Ferramenta][tools] | Fornece uma capacidade técnica verificável. | [agent-browser][browser] exercita uma interface web. |
+| [Testes e evidências][tests] | Comprovam comportamento e registram resultados. | Versionar o teste e manter relatório local. |
+
+Os links levam às fontes e aos catálogos. Uma instrução em Markdown não inicia
+um processo sozinha; o cliente de IA decide como descobrir e executar recursos
+conforme suas capacidades e permissões. Consulte a
+[compatibilidade por cliente][compat] antes de depender de um atalho.
+
+## Exemplo: entregar uma funcionalidade
+
+1. Peça ao agente para ler `AGENTS.md` e usar
+   [proximos-passos][next]. Ele identifica a fase e as pendências do projeto.
+2. Defina produto, experiência quando aplicável e design técnico com o usuário.
+   Os [templates][templates] são pontos de partida, não decisões prontas.
+3. Use [criar-spec][spec] para esclarecer dúvidas, limitar o incremento e
+   registrar critérios verificáveis. Planeje e obtenha a aprovação necessária.
+4. Use [implementar-entrega][implement] com a spec e o plano. O perfil
+   [implementador][developer] segue a skill e respeita o escopo aprovado.
+5. Execute as verificações adequadas: testes automatizados, navegador para um
+   fluxo web ou desktop para uma aplicação desktop, quando aplicáveis. Registre
+   o resultado de cada critério, incluindo o que não pôde ser executado.
+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].
+
+## Onde ficam os arquivos?
+
+`.pbai4devs/` contém as fontes compartilhadas. Pastas como `.claude/` ou
+`.codex/` recebem apenas os recursos de integração dos clientes selecionados;
+os arquivos humanos existentes continuam pertencendo ao projeto. A seleção pode
+ser consultada ou alterada pela [CLI][cli].
+
+O código dos testes e as fixtures necessárias são versionáveis. Relatórios,
+capturas, downloads e resultados locais ficam fora do versionamento. O
+`.gitignore` da raiz pertence ao projeto; com Git inicializado, o kit mantém
+suas exclusões locais em `.git/info/exclude` e informa conflitos. Sem Git,
+execute a sincronização após `git init`, antes de adicionar arquivos ao índice.
+Veja [instalação][install] e [ferramentas e testes][tests].
+
+Para criar ou mudar um recurso, use o [guia de recursos][resources] e depois
+sincronize e verifique os apontamentos. Para dúvidas de operação, consulte
+[solução de problemas](troubleshooting.md).
+
+[skills]: ../../.pbai4devs/skills/README.md
+[commands]: ../../.pbai4devs/commands/README.md
+[agents]: ../../.pbai4devs/agents/README.md
+[rules]: ../../.pbai4devs/rules/README.md
+[templates]: ../../.pbai4devs/templates/README.md
+[scripts]: ../../.pbai4devs/scripts/README.md
+[tools]: ../../.pbai4devs/tools/README.md
+[spec]: ../../.pbai4devs/skills/specs/criar-spec/SKILL.md
+[spec-template]: ../../.pbai4devs/templates/spec/TEMPLATE.md
+[validar]: ../../.pbai4devs/commands/validar-entrega/COMMAND.md
+[reviewer]: ../../.pbai4devs/agents/revisor/AGENT.md
+[developer]: ../../.pbai4devs/agents/implementador/AGENT.md
+[quality]: ../../.pbai4devs/rules/qualidade/RULE.md
+[sync]: ../../.pbai4devs/scripts/sincronizar-agentes/README.md
+[browser]: ../../.pbai4devs/tools/agent-browser/README.md
+[tests]: tools-and-testing.md
+[compat]: ../../.pbai4devs/COMPATIBILIDADE.md
+[next]: ../../.pbai4devs/skills/projeto/proximos-passos/SKILL.md
+[implement]: ../../.pbai4devs/commands/implementar-entrega/COMMAND.md
+[review]: ../../.pbai4devs/commands/revisar-entrega/COMMAND.md
+[workflow]: workflow.md
+[install]: installation.md
+[cli]: cli.md
+[resources]: resources.md
+[specialists]: resources.md#especialistas-e-colaboração

package/docs/guides/resources.md

@@ -14,6 +14,9 @@ O hub permanece completo mesmo com poucos clientes selecionados. Apenas os
 apontamentos necessários são gerados; consulte ou altere a seleção com `agents`
 na [CLI](cli.md). Pastas compartilhadas podem atender mais de um cliente.
 
+Para um exemplo de cada tipo aplicado ao desenvolvimento de software, veja
+[recursos na prática](recursos-na-pratica.md).
+
 ## Escolher o tipo certo
 
 Os caminhos abaixo são relativos a `.pbai4devs/`.
@@ -53,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 |
@@ -167,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

@@ -91,7 +91,7 @@ existente, mesmo em rascunho. Remova somente o rascunho incompleto dessa
 tentativa após conferir a origem; nunca apague uma release publicada para
 repetir o fluxo.
 
-Para reiniciar uma publicação que falhou, use **Re-run failed jobs** ou
+Se a release ainda não existe, use **Re-run failed jobs** ou
 `gh workflow run release.yml --ref vX.Y.Z` com a tag real. A publicação prioriza
 o secret `NPMJS_TOKEN` do repositório; sem ele, usa OIDC, conforme
 [publicação](packages.md).

package/docs/maintainers/packages.md

@@ -103,7 +103,8 @@ publicados. Assim, a verificação comprova o acesso de um usuário comum.
 Confirme também que `latest` aponta para a versão estável e que o tarball é
 baixável; metadados visíveis sozinhos não comprovam uma instalação funcional.
 Se o registro ainda não disponibilizar o pacote, aguarde a verificação sem
-republicar automaticamente a mesma versão.
+republicar automaticamente a mesma versão. Durante a propagação, `E404` e
+`ETARGET` do download do tarball são repetidos dentro da mesma janela limitada.
 
 O GitHub Packages verifica os mesmos comandos com autenticação. Metadados
 devem indicar visibilidade pública e associação ao repositório correto.

package/docs/specs/README.md

@@ -17,8 +17,11 @@ 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.
 - [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.
 
 Cada incremento vincula requisitos, critérios, testes e evidências locais.
 

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/docs/specs/project-ignore/SPEC.md

@@ -0,0 +1,26 @@
+---
+description: Preservar o ignore do projeto ao instalar o AgentDevKit.
+---
+
+# Ignore do projeto
+
+O arquivo `.gitignore` da raiz pertence ao projeto. Instalação, atualização e
+sincronização preservam seus bytes, permissões e estado no índice Git, inclusive
+quando um estado antigo do kit registra esse arquivo.
+
+## Critérios de aceite
+
+- AC-001: O kit não cria, altera, remove ou desindexa o `.gitignore` da raiz.
+- AC-002: Derivados e artefatos locais são protegidos via `.git/info/exclude`.
+- AC-003: Conflitos com regras humanas são informados antes das alterações; exceções
+  ambíguas não são consideradas seguras apenas por ausência do arquivo.
+- AC-004: Sem Git, a instalação informa a pendência e orienta a executar a
+  sincronização depois de `git init` e antes de `git add`.
+- AC-005: Arquivos humanos e configurações existentes são preservados.
+- AC-006: Instalação e atualização são verificadas em projetos pelo pacote.
+
+## Verificação
+
+Os testes de exclusão local cobrem negações, migração, arquivos rastreados,
+permissões e worktrees. Os testes de instalação e compatibilidade conferem a
+preservação do projeto e o comportamento com e sem Git.

package/package.json

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

package/src/cli.mjs

@@ -59,6 +59,7 @@ export function parseArgs(argv) {
 function print(result, options, output) {
   if (options.json) { output.write(`${JSON.stringify(result)}\n`); return; }
   output.write(`${result.message}\n`);
+  if (result.warnings?.length) for (const warning of result.warnings) output.write(`${warning}\n`);
   if (result.clients) output.write(`${text(result.language, 'clientsCurrent')}: ${result.clients.join(', ')}\n`);
   if (result.availableClients) output.write(`${text(result.language, 'clientsAvailable')}: ${result.availableClients.map(client => client.id).join(', ')}\n`);
   if (result.toolOutput) output.write(`${result.toolOutput.trimEnd()}\n`);
@@ -125,9 +126,11 @@ export async function main(argv = process.argv.slice(2), context = {}) {
       if (found.installed && !found.issues.length) {
         const plan = planInstallation({ target, language, mode: 'sync' });
         result.preserved = plan.preserved;
+        if (plan.localIgnore.status === 'no-git') { found.issues.push({ code: 'git-pending', path: '.git/info/exclude' }); result.warnings = [text(language, 'gitPending')]; }
         found.issues.push(...plan.changes.map(change => ({ code: 'outdated', path: change.path })));
         found.issues.push(...plan.localIgnoreCheck.missing.map(path => ({ code: 'unignored', path })));
-        if (plan.localIgnore.edits.length || plan.untrack?.paths.length) found.issues.push({ code: 'local-ignore', path: '.gitignore / Git info/exclude' });
+        found.issues.push(...plan.localIgnoreCheck.trackedOutputs.map(path => ({ code: 'tracked-local-output', path })));
+        if (plan.localIgnore.edits.length || plan.untrack?.paths.length) found.issues.push({ code: 'local-ignore', path: 'Git info/exclude' });
       }
       result.issues = found.issues; result.ok = found.installed && found.issues.length === 0;
       result.message = text(language, result.ok ? 'healthy' : found.installed ? 'unhealthy' : 'missing'); exitCode = result.ok ? 0 : 1;
@@ -149,13 +152,15 @@ export async function main(argv = process.argv.slice(2), context = {}) {
       result.preserved = plan.preserved;
       result.plan = plan.changes.map(({ path, action }) => ({ path, action, conflict: plan.conflicts.includes(path) }));
       result.untrackedPaths = [...(plan.untrack?.paths || [])];
-      result.localIgnore = { status: plan.localIgnore.status, edits: plan.localIgnore.edits.map(({ path, before }) => ({ path, action: before === null ? 'create' : 'update' })), missing: plan.localIgnoreCheck.missing };
-      if (plan.localIgnore.edits.length) result.plan.push({ path: '.gitignore / Git info/exclude', action: 'update', conflict: false });
+      result.localIgnore = { status: plan.localIgnore.status, edits: plan.localIgnore.edits.map(({ path, before }) => ({ path, action: before === null ? 'create' : 'update' })), missing: plan.localIgnoreCheck.missing, trackedOutputs: plan.localIgnoreCheck.trackedOutputs };
+      if (plan.localIgnore.status === 'no-git') result.warnings = [text(language, 'gitPending')];
+      if (plan.localIgnoreCheck.trackedOutputs.length) (result.warnings ||= []).push(`${text(language, 'trackedLocal')} ${plan.localIgnoreCheck.trackedOutputs.join(', ')}`);
+      if (plan.localIgnore.edits.length) result.plan.push({ path: 'Git info/exclude', action: 'update', conflict: false });
       if (plan.untrack?.paths.length) result.plan.push({ path: 'Git index (generated files)', action: 'update', conflict: false });
       result.conflicts = plan.conflicts;
       const preview = options.dryRun || (options.command === 'sync' && options.check);
       if (!plan.canApply || preview) {
-        result.ok = plan.canApply && (!options.check || result.plan.length === 0);
+        result.ok = plan.canApply && (!options.check || result.plan.length === 0 && plan.localIgnore.status !== 'no-git' && !plan.localIgnoreCheck.trackedOutputs.length);
         result.message = text(language, plan.canApply ? 'plan' : 'conflict'); exitCode = result.ok ? 0 : 1;
       } else {
         Object.assign(result, applyPlan(plan)); result.message = text(language, result.changed ? options.command : 'unchanged');