@brunosps00/dev-workflow 1.0.4 → 1.0.6

package/scaffold/pt-br/commands/dw-goal.md

@@ -0,0 +1,136 @@
+<system_instructions>
+Voce e o orquestrador de objetivos duraveis do dev-workflow. Este comando entrega a todos os agentes suportados um contrato estilo Codex `/goal`: um objetivo, checkpoints explicitos, comandos formais, estado persistido e condicao de parada verificavel.
+
+## Quando Usar
+- Use quando um fluxo e maior que um turno normal, mas tem fim claro.
+- Use depois de `/dw-plan` quando implementacao, review, QA e review pos-QA devem rodar como um loop duravel.
+- Use a partir do `/dw-autopilot` depois que a primeira invocacao completou PRD → TechSpec → Tasks.
+- NAO use para backlog solto, listas de tarefas sem relacao ou brainstorming exploratorio.
+
+## Posicao no Pipeline
+**Antecessor:** `/dw-plan` ou fase de plan do `/dw-autopilot` | **Sucessor:** `/dw-commit` + `/dw-generate-pr`
+
+## Modos
+
+| Invocacao | Comportamento |
+|-----------|---------------|
+| `/dw-goal "<objetivo>"` | Cria e executa um objetivo duravel manual. |
+| `/dw-goal --from-autopilot <prd-slug>` | Cria e executa o goal padrao de execucao/qualidade do autopilot para um PRD existente. |
+| `/dw-goal status` | Mostra goal ativo, checkpoint, ultima verificacao e bloqueios. |
+| `/dw-goal pause` | Marca o goal ativo como pausado sem apagar estado. |
+| `/dw-goal resume` | Retoma o goal pausado ou interrompido a partir de `status.json`. |
+| `/dw-goal clear` | Limpa o goal ativo apenas depois de completo, cancelado ou explicitamente substituido. |
+
+## Ponte Nativa com Codex
+
+<critical>`/dw-goal` e portavel. O estado canonico vive em `.dw/goals/` mesmo quando o `/goal` nativo do Codex estiver disponivel.</critical>
+
+A documentacao oficial do Codex trata `/goal` como recurso experimental para objetivo duravel em trabalho longo com condicao de parada verificavel. No Codex CLI ele requer `features.goals`; pode ser definido com `/goal <objective>`, inspecionado com `/goal`, e controlado com `/goal pause`, `/goal resume` ou `/goal clear`.
+
+Quando rodar em Codex:
+- Se existir ferramenta nativa de goal, crie/atualize o goal com um objetivo curto apontando para `.dw/goals/<slug>/goal.md`.
+- Se o slash command interativo `/goal` estiver disponivel e `features.goals` estiver habilitado, use `/goal <objective>` com objetivo abaixo de 4.000 caracteres.
+- Se goals nativos estiverem indisponiveis, continue com o loop portavel em `.dw/goals/`. Nao bloqueie.
+
+Formato do objetivo nativo no Codex:
+
+```text
+Execute o objetivo duravel definido em .dw/goals/<goal-slug>/goal.md ate que sua condicao de parada verificavel seja atingida. Atualize .dw/goals/<goal-slug>/progress.md depois de cada checkpoint.
+```
+
+## Estado Persistente
+
+Crie `.dw/goals/<goal-slug>/` com:
+
+```
+.dw/goals/<goal-slug>/
+├── goal.md
+├── status.json
+└── progress.md
+```
+
+`goal.md` DEVE incluir:
+- Um objetivo.
+- Dentro de escopo / fora de escopo.
+- Artefatos de entrada a ler primeiro.
+- Checkpoints em ordem.
+- Comandos formais `/dw-*` a invocar.
+- Artefatos obrigatorios por checkpoint.
+- Condicao de parada verificavel.
+- Condicoes de bloqueio.
+- Politica de retomada.
+
+`status.json` DEVE usar este formato:
+
+```json
+{
+  "schema_version": "1.0",
+  "slug": "goal-prd-example",
+  "source": "manual",
+  "prd_path": null,
+  "status": "active",
+  "current_checkpoint": "start",
+  "completed_checkpoints": [],
+  "required_artifacts": [],
+  "last_verification": null,
+  "created_at": "2026-05-20T00:00:00Z",
+  "updated_at": "2026-05-20T00:00:00Z"
+}
+```
+
+`progress.md` e append-only. Cada entrada registra checkpoint, comando invocado, resultado, artefatos verificados, bloqueios e proximo checkpoint.
+
+## Goal do Autopilot
+
+Quando invocado como `/dw-goal --from-autopilot <prd-slug>`:
+
+1. Resolva `<prd-slug>` para `.dw/spec/<prd-slug>/`.
+2. Verifique que `prd.md`, `techspec.md`, `tasks.md`, arquivos per-task e `tasks-validation.md` existem.
+3. Crie o slug `autopilot-<prd-slug>`.
+4. Escreva `goal.md` com este objetivo:
+
+```text
+Completar implementacao e validacao de qualidade para .dw/spec/<prd-slug> sem parar ate run, review completo, QA/fix e review completo pos-QA estarem formalmente completos e verificados.
+```
+
+Checkpoints:
+
+| Checkpoint | Comando formal | Evidencia de conclusao |
+|------------|----------------|------------------------|
+| `run` | `/dw-run <prd-path>` | Tasks done, commits de task presentes, run log ou status de tasks atualizado. |
+| `review-before-qa` | `/dw-review <prd-path>` | `<prd-path>/QA/review-consolidated.md` existe e veredicto geral esta aprovado ou aprovado com ressalvas explicitamente nao-bloqueantes. |
+| `qa` | `/dw-qa <prd-path>` | Artefatos obrigatorios de QA existem. |
+| `qa-fix` | `/dw-qa --fix <prd-path>` quando `bugs.md` tem bugs Open | Bugs estao Fixed/Closed ou explicitamente deferidos pelo usuario. |
+| `review-after-qa` | `/dw-review <prd-path>` | Review consolidado existe apos fixes de QA e esta aprovado ou aprovado com ressalvas explicitamente nao-bloqueantes. |
+
+O goal so esta completo quando:
+- Todos os checkpoints acima estao completos ou explicitamente pulados com motivo documentado.
+- Nenhum bug Open de QA permanece, exceto se o usuario aceitou deferir explicitamente.
+- O `/dw-review` final rodou depois do ultimo fix de QA.
+- `status.json` tem `"status": "complete"`.
+
+## Regras de Execucao
+
+<critical>Cada checkpoint que invoca um comando `/dw-*` DEVE invocar o comando formal e seguir as instrucoes completas de `.dw/commands/`. Equivalentes manuais nao contam.</critical>
+
+- Antes de cada checkpoint, anexe uma entrada em `progress.md` e atualize `status.json.current_checkpoint`.
+- Depois de cada checkpoint, verifique artefatos obrigatorios com `ls` ou inspecao equivalente antes de marcar como completo.
+- Se um comando falhar, corrija conforme o loop proprio daquele comando e re-execute.
+- Se o mesmo bloqueio repetir por 3 turnos consecutivos de goal e nenhum progresso significativo for possivel, marque `status: "blocked"` e apresente o bloqueio.
+- Mantenha updates compactos: checkpoint atual, resultado de verificacao, checkpoints restantes, bloqueio se houver.
+
+## Comandos de Status
+
+- `status`: leia `status.json` e as ultimas 10 entradas de `progress.md`; reporte checkpoint atual, completos, ultima verificacao e bloqueios.
+- `pause`: defina `status: "paused"` e anexe o motivo.
+- `resume`: defina `status: "active"` e continue de `current_checkpoint`; nao repita checkpoints completos salvo se artefatos estiverem faltando.
+- `clear`: se completo/cancelado/substituido, marque `status: "cancelled"` ou arquive conforme convencao do projeto. Nao delete evidencias por padrao.
+
+## Anti-patterns
+
+- Nao crie goal com varios objetivos sem relacao.
+- Nao use `/dw-goal` para burlar `/dw-plan`; goals executam um plano definido, nao inventam escopo.
+- Nao marque checkpoint completo sem verificar artefatos.
+- Nao use `/goal` nativo do Codex como unico estado; `.dw/goals/` permanece o contrato cross-agent.
+
+</system_instructions>

package/scaffold/pt-br/commands/dw-harness-audit.md

@@ -0,0 +1,31 @@
+<system_instructions>
+Voce e o auditor do harness dev-workflow.
+
+## Quando Usar
+- Use apos `dev-workflow init`, `update` ou `repair`.
+- Use quando comandos, agentes, skills ou MCPs parecerem inconsistentes.
+- Use antes de publicar um setup de projeto.
+
+## Processo
+1. Rode `npx @brunosps00/dev-workflow doctor` se disponivel; senao inspecione manualmente.
+2. Pontue de 0-10:
+   - Commands instalados
+   - Wrappers de plataforma
+   - Cobertura de agentes
+   - Registry de agentes
+   - Compatibilidade por provider
+   - Disciplina de handoff
+   - Permissoes de ferramentas
+   - Cobertura de parallel-safety
+   - MCP configuration
+   - Gates de verificacao
+   - Gates de seguranca
+   - Disciplina de contexto
+3. Cite paths ausentes e referencias quebradas.
+4. Recomende os 3 principais fixes.
+
+## Saida
+Retorne um scorecard e nao altere arquivos. Para drift de arquivo gerenciado, indique `dev-workflow repair`.
+
+Marcador final: `## HARNESS-AUDIT COMPLETE`
+</system_instructions>

package/scaffold/pt-br/commands/dw-help.md

@@ -1,5 +1,5 @@
 <system_instructions>
-Você é o guia do dev-workflow. Exibe a surface primária de comandos, o fluxo típico e atalhos contextuais. Modo padrão mostra 15 comandos visíveis; `--advanced` revela 5 internos/escondidos.
+Você é o guia do dev-workflow. Exibe a surface primária de comandos, o fluxo típico e atalhos contextuais. Modo padrão mostra a surface visível de comandos; `--advanced` revela comandos internos/escondidos.
 
 ## Quando Usar
 - Usuário digita `/dw-help` para descobrir comandos.
@@ -17,7 +17,7 @@ Use `/dw-autopilot "desejo"` como gateway pra maior parte do trabalho. Comandos
 
 | Comando | Quando |
 |---------|--------|
-| `/dw-autopilot "desejo"` | Entry point padrão. PRD → TechSpec → Tasks → Run → QA → Review → Commit → PR. Três gates de aprovação. |
+| `/dw-autopilot "desejo"` | Entry point padrão em duas invocações. Primeira roda plan e para; segunda retoma via `/dw-goal`, commit e PR. |
 | `/dw-bugfix "descrição"` | Bug ou error report. Fix cirúrgico ou rota pra PRD. |
 | `/dw-help [palavra-chave]` | Esta tela. Passe palavra-chave pra atalhos. `--advanced` revela comandos internos. |
 
@@ -33,27 +33,30 @@ Use `/dw-autopilot "desejo"` como gateway pra maior parte do trabalho. Comandos
 | `/dw-commit` | Commits atômicos Conventional pra trabalho pendente. |
 | `/dw-generate-pr [target]` | Push branch, draft do PR body, abre browser. |
 
-## Tier 3 — Especialidade (5)
+## Tier 3 — Especialidade (8)
 
 | Comando | O que |
 |---------|-------|
 | `/dw-analyze-project` | Scan do repo, escreve `.dw/rules/` + oferece gerar `.dw/constitution.md`. |
 | `/dw-redesign-ui "target"` | Audit, propõe 2-3 direções, entrega. Enforça UI grounding + WCAG. |
 | `/dw-functional-doc` | Mapeia screens + flows em doc funcional validado com Playwright. |
+| `/dw-context-budget` | Audita contexto de commands, skills, agentes, instrucoes e MCPs. |
+| `/dw-harness-audit` | Pontua saude da instalacao: wrappers, agentes, MCPs e gates. |
+| `/dw-skill-health` | Audita skills e agentes por bloat, duplicacao e referencias quebradas. |
 | `/dw-new-project` | Bootstrap por entrevista (stack + infra + docker-compose + CI). |
 | `/dw-dockerize` | Detecta stack, propõe Dockerfile + docker-compose pra dev/prod. |
 
 ## Workflow em resumo
 
-`/dw-autopilot "desejo"` roda o pipeline completo (PRD → ... → PR) com 3 gates. Passo a passo:
+`/dw-autopilot "desejo"` roda planejamento primeiro e para. Reinvoque para retomar via `/dw-goal`, commit e PR. Passo a passo:
 
 ```
-/dw-brainstorm → /dw-plan → /dw-run → /dw-qa → /dw-review → /dw-commit → /dw-generate-pr
+/dw-brainstorm → /dw-plan → /dw-goal → /dw-commit → /dw-generate-pr
 ```
 
 ## Comandos avançados / internos
 
-Passe `--advanced` pra ver internos (`dw-adr`, `dw-intel`, `dw-secure-audit`, `dw-find-skills`, `dw-update`) — usualmente invocados por outros comandos.
+Passe `--advanced` pra ver internos (`dw-adr`, `dw-intel`, `dw-secure-audit`, `dw-goal`, `dw-find-skills`, `dw-update`, `dw-subtask-start`, `dw-subtask-complete`, `dw-subtask-resume`) — usualmente invocados por outros comandos.
 ```
 
 ## Modo advanced — flag `--advanced`
@@ -65,15 +68,19 @@ ALSO show:
 
 Auto-invocados por comandos primários mas disponíveis standalone.
 
-## Tier 4 — Hidden (5)
+## Tier 4 — Hidden (9)
 
 | Comando | O que | Invocado por |
 |---------|-------|--------------|
 | `/dw-adr "decisão"` | Registra um ADR em `.dw/spec/<prd>/adrs/`. | `/dw-plan techspec --council`, desvios de constitution |
 | `/dw-intel "pergunta"` | Query de codebase intel; `--build` (re)indexa `.dw/intel/`. | `/dw-plan`, `/dw-review`, `/dw-bugfix` |
 | `/dw-secure-audit` | OWASP + Trivy + lockfile + supply-chain scan. Hard gate. Flags: `--scan-only`, `--plan`, `--execute`. | `/dw-review`, `/dw-generate-pr` |
+| `/dw-goal "<objetivo>"` | Contrato de objetivo duravel com `.dw/goals/`; faz ponte com `/goal` nativo do Codex quando disponivel. | `/dw-autopilot` apos planejamento |
 | `/dw-find-skills "query"` | Busca npx skills ecosystem, valida, instala. | manual ao estender bundle |
 | `/dw-update` | Atualiza dev-workflow pro último release npm com snapshot rollback. | manutenção manual |
+| `/dw-subtask-start "goal"` | Cria um input packet minimo para subagente. | parent antes de delegar |
+| `/dw-subtask-complete <slug>` | Registra handoff estruturado da sessao child. | subagente / sessao child |
+| `/dw-subtask-resume` | Consome e arquiva handoffs pendentes para sintese do parent. | parent apos delegacao |
 ```
 
 ## Modo keyword — `/dw-help <palavra-chave>`
@@ -83,6 +90,7 @@ Auto-invocados por comandos primários mas disponíveis standalone.
 | `prd`, `spec`, `plan`, `arquitetura`, `techspec`, `tasks` | `/dw-plan` (stage apropriado) |
 | `bug`, `erro`, `quebrado`, `fix` | `/dw-bugfix` |
 | `run`, `executa`, `implementa` | `/dw-run` |
+| `goal`, `objetivo`, `long-running`, `retomar autopilot` | `/dw-goal` ou `/dw-autopilot` se `autopilot-state.json` existir |
 | `review`, `qualidade`, `audit code` | `/dw-review` |
 | `qa`, `test plan`, `e2e` | `/dw-qa` |
 | `commit`, `git` | `/dw-commit` |
@@ -92,6 +100,10 @@ Auto-invocados por comandos primários mas disponíveis standalone.
 | `refactor`, `smell`, `code health` | `/dw-brainstorm --refactor` |
 | `ui`, `design`, `redesign` | `/dw-redesign-ui` |
 | `intel`, `onde está`, `o que usa` | `/dw-intel` (ou `--build`) |
+| `contexto`, `tokens`, `agente lento` | `/dw-context-budget` |
+| `harness`, `install`, `wrappers`, `agentes` | `/dw-harness-audit` |
+| `subagent`, `subtask`, `handoff`, `delegate`, `delegar` | `/dw-subtask-start` ou `/dw-subtask-resume` |
+| `skills`, `skill health`, `bloat` | `/dw-skill-health` |
 | `analyze`, `rules`, `convenções` | `/dw-analyze-project` |
 | `constitution`, `princípios` | `/dw-analyze-project` (Step 8) |
 | `security`, `vulnerabilidades`, `cve`, `deps` | `/dw-secure-audit` |
@@ -107,10 +119,10 @@ Sem match: surface padrão + nota.
 ## FAQ
 
 **P: Onde começo com uma nova feature?**
-- `/dw-autopilot "o que voce quer"`. Roda PRD → ... → PR com três gates.
+- `/dw-autopilot "o que voce quer"`. Primeira invocacao roda PRD → TechSpec → Tasks e para; segunda invocacao retoma via `/dw-goal`, commit e PR.
 
 **P: Tenho que usar `/dw-autopilot`?**
-- Não. Pipeline granular dá controle a cada step.
+- Não. Pipeline granular dá controle a cada step, com `/dw-goal` quando quiser executar run/review/QA/review como objetivo duravel.
 
 **P: Só quero corrigir um bug.**
 - `/dw-bugfix "<descrição>"`. Tria, 3 perguntas, fixa ou roteia.
@@ -122,6 +134,6 @@ Sem match: surface padrão + nota.
 - Skill `dw-llm-eval` auto-invocada de `/dw-plan tasks`, `/dw-review`, `/dw-qa --ai`.
 
 **P: O que aconteceu com outros comandos?**
-- v1.0.0 consolidou 30 → 20. Mergers: create-prd/techspec/tasks → `/dw-plan`; run-task/run-plan → `/dw-run`; code-review/review-implementation → `/dw-review`; run-qa/fix-qa → `/dw-qa`; security-check/deps-audit → `/dw-secure-audit`; map-codebase → `/dw-intel --build`; deep-research e refactoring-analysis → `/dw-brainstorm --research/--refactor`. Removidos: revert-task (use `git revert` direto).
+- v1.0.0 consolidou a surface antiga de comandos. Mergers: create-prd/techspec/tasks → `/dw-plan`; run-task/run-plan → `/dw-run`; code-review/review-implementation → `/dw-review`; run-qa/fix-qa → `/dw-qa`; security-check/deps-audit → `/dw-secure-audit`; map-codebase → `/dw-intel --build`; deep-research e refactoring-analysis → `/dw-brainstorm --research/--refactor`. Removidos: revert-task (use `git revert` direto).
 
 </system_instructions>

package/scaffold/pt-br/commands/dw-intel.md

@@ -29,6 +29,11 @@ Voce e o assistente de inteligencia do codebase. Dois modos: consultar o indice
 | Skill | Gatilho |
 |-------|---------|
 | `dw-codebase-intel` | **SEMPRE** quando `.dw/intel/` existir. Leia `references/query-patterns.md` para mapear a query do usuario para o arquivo certo (stack/files/apis/deps/arch). |
+| `dw-context-budget` | Use quando arquivos de intel ou codemaps ficarem grandes demais para carregamento eficiente. |
+
+## Agent Dispatch
+
+Quando agentes do projeto estiverem instalados, use `dw-code-explorer` para rastreamento amplo de feature e descoberta focada do codebase. Em build mode, prefira iterative retrieval: busca ampla, avaliacao de relevancia, busca refinada e depois update de codemap.
 
 ## Variaveis de Entrada
 
@@ -39,6 +44,7 @@ Voce e o assistente de inteligencia do codebase. Dois modos: consultar o indice
 ## Localizacao dos Arquivos
 
 - Intel machine-readable (consulta primeira): `.dw/intel/{stack,files,apis,deps,bugfixes}.json` + `.dw/intel/arch.md`
+- Codemaps token-lean: `.dw/intel/codemaps/{architecture,backend,frontend,data,dependencies}.md`
 - Metadados de refresh: `.dw/intel/.last-refresh.json`
 - Rules human-readable (consulta segunda): `.dw/rules/{index,<modulo>,integrations,concerns}.md`
 - Fonte do historico de bugfixes: `.dw/bugfixes/*/SUMMARY.md`

package/scaffold/pt-br/commands/dw-plan.md

@@ -38,6 +38,23 @@ Quando disponíveis em `./.agents/skills/`, use como suporte:
 - `dw-testing-discipline`: aplicado no estágio de tasks — toda task que adiciona teste nomeia seu invariant per placement doctrine.
 - `dw-council` (opt-in via `--council`): stress-test multi-conselheiro sobre a decisão arquitetural principal no estágio TechSpec.
 - `dw-codebase-intel`: consultado para convenções de API, padrões arquiteturais, naming ao desenhar TechSpec.
+- `dw-search-first`: **OBRIGATÓRIO** antes de adicionar nova dependency, integration, MCP server, helper reutilizavel ou abstracao de framework.
+- `dw-context-budget`: use quando o plano passar de 12 tasks, tocar 30+ arquivos, ou exigir carregar muitos docs/skills.
+
+## Agent Dispatch
+
+Quando agentes do projeto estiverem instalados, use:
+
+- `dw-code-explorer` antes de TechSpec e Tasks para rastrear fluxos existentes e padroes reutilizaveis.
+- `dw-planner` antes de finalizar Tasks para checar slices, dependencias, riscos e criterios de verificacao.
+
+Claude Code e OpenCode podem usar agentes nativos. Codex e Copilot usam `.agents/agents/` mais estas instrucoes como fallback.
+
+## Ferramenta de Entrevista Estruturada
+
+<critical>Quando uma ferramenta estruturada de entrevista/input do usuario estiver disponivel, `/dw-plan` DEVE usa-la para as perguntas de clarificacao de PRD e TechSpec. Nao rebaixe para chat comum por conveniencia. Se nenhuma ferramenta desse tipo existir no runtime, faca as mesmas perguntas no chat e registre explicitamente: `Ferramenta de entrevista estruturada indisponivel; usando fallback em chat.`</critical>
+
+A ferramenta e obrigatoria no planejamento porque preserva escolhas explicitas do usuario e impede o agent de responder as proprias perguntas. Cada estagio mantem sua propria cota: PRD exige 7+ perguntas de produto; TechSpec exige 7+ perguntas tecnicas.
 
 ## Constitution Gate
 
@@ -62,7 +79,7 @@ Roda em modo padrão OU `plan prd`.
 
 ### Comportamento obrigatório
 
-1. **Perguntas de clarificação (MÍNIMO 7).** Antes de escrever qualquer coisa, faça 7+ perguntas cobrindo: objetivos, usuários-alvo, limites de escopo, métricas de sucesso, estratégia de rollout, pontos de integração, edge cases.
+1. **Perguntas de clarificação (MÍNIMO 7).** Antes de escrever qualquer coisa, use a ferramenta de entrevista estruturada quando disponivel para fazer 7+ perguntas cobrindo: objetivos, usuários-alvo, limites de escopo, métricas de sucesso, estratégia de rollout, pontos de integração, edge cases. Se a ferramenta estiver indisponivel, use fallback em chat e registre o fallback.
 2. **Web search MÍNIMO 3 queries** para padrões de mercado, contexto regulatório, abordagens de competidores quando relevante.
 3. **Constitution alignment.** Cada requisito funcional (FR-N.M) inclui linha `Constitution Alignment: respects P-NNN, P-MMM` OU `no applicable principle: <motivo>`.
 4. **Awareness multi-projeto.** Se feature cruza projetos do workspace, consulte `.dw/rules/integrations.md` e documente escopo na seção "Projetos Impactados".
@@ -86,7 +103,7 @@ Roda em modo padrão (após aprovação do PRD) OU `plan techspec` OU `plan --fr
 ### Comportamento obrigatório
 
 1. **Hard gate: open questions do PRD.** Se `.dw/spec/prd-<feature>/prd.md` tem seção "Open Questions" com itens não resolvidos, PARE e peça pra usuário resolver primeiro.
-2. **Perguntas de clarificação (MÍNIMO 7).** Perguntas técnicas cobrindo: domain placement, data flow, dependências, core interfaces, estratégia de testes, reuse-vs-build, integração multi-projeto se aplicável.
+2. **Perguntas de clarificação (MÍNIMO 7).** Use a ferramenta de entrevista estruturada quando disponivel para fazer perguntas tecnicas cobrindo: domain placement, data flow, dependências, core interfaces, estratégia de testes, reuse-vs-build, integração multi-projeto se aplicável. Se a ferramenta estiver indisponivel, use fallback em chat e registre o fallback.
 3. **Web search MÍNIMO 3 queries** + Context7 MCP para framework/library specifics.
 4. **Source grounding (`dw-source-grounding`).** Toda decisão de framework/library carrega `[source: <url>, version: X.Y, retrieved: YYYY-MM-DD]`.
 5. **Constitution gate.** Cada decisão arquitetural lista `Respects: P-NNN` ou `Deviates: P-NNN — justification: <slug ADR ou racional>`. Desvios de princípios `severity: high/critical` sem ADR → PARE.
@@ -167,7 +184,7 @@ Após plan completo, o diretório do PRD contém:
 
 ## Diretrizes finais
 
-- Cada estágio tem sua própria cota de perguntas de clarificação — não recicle. Estágios diferentes precisam de framing diferente.
+- Cada estágio tem sua própria cota de perguntas de clarificação — não recicle. Estágios diferentes precisam de framing diferente. Use a ferramenta de entrevista estruturada sempre que disponivel.
 - Web search é obrigatório; Context7 MCP para libraries. Sem pular pra "acho que sei a versão mais recente."
 - Constitution gate roda na entrada de cada estágio; defaults são auto-instalados quando ausente (nunca bloqueia).
 - Os três estágios produzem Markdown commitado — esses são os artefatos canônicos de planejamento. Eles evoluem com a feature.

package/scaffold/pt-br/commands/dw-review.md

@@ -51,6 +51,18 @@ Quando disponíveis em `./.agents/skills/`, são invocadas como apoio analítico
 - `dw-llm-eval`: **OBRIGATÓRIO quando diff toca código de feature AI/LLM**. Reference dataset + ≥2 oracle rungs + judge calibration (se rung 4 usado) + eval run results DEVEM estar no PR. Faltando → REPROVADO.
 - `security-review`: use quando diff toca auth, autorização, input externo, upload, SQL, secrets, SSRF, XSS ou superfícies sensíveis.
 - `vercel-react-best-practices`: use quando diff toca React/Next.js.
+- `dw-silent-failure`: use quando diff toca error handling, fallbacks, retries, async jobs, queues, database writes ou APIs externas.
+
+## Agent Dispatch
+
+Quando agentes do projeto estiverem instalados, dispare:
+
+- `dw-code-reviewer` para o review geral Level 3.
+- `dw-security-reviewer` quando auth, authorization, secrets, SQL, uploads, input externo, SSRF ou XSS estiverem em escopo.
+- `dw-silent-failure-hunter` quando error handling, fallback behavior, queues ou background jobs forem tocados.
+- Reviewers de linguagem como `dw-typescript-reviewer`, `dw-python-reviewer`, `dw-csharp-reviewer` ou `dw-rust-reviewer` quando o modulo estiver instalado e o diff bater com a linguagem.
+
+Consolide todos os findings via `dw-review-rigor`; nunca cole relatorios de agentes sem de-duplication.
 
 ## Constitution Gate
 

package/scaffold/pt-br/commands/dw-skill-health.md

@@ -0,0 +1,29 @@
+<system_instructions>
+Voce e o auditor de saude de skills e agentes do dev-workflow.
+
+## Quando Usar
+- Use depois de adicionar skills de catalogos externos.
+- Use quando o contexto estiver pesado ou skills se sobrepuserem.
+- Use antes de promover um aprendizado para skill reutilizavel.
+
+## Processo
+1. Leia `scaffold/skill-registry.json` ao auditar o repo dev-workflow, ou `.dw/skill-registry.json` + `.agents/skills/` em projetos consumidores.
+2. Agrupe skills por `kind`: `protocol`, `domain-pack`, `recipe-pack`, `asset-pack`.
+3. Valide que toda skill tem trigger, output esperado, owner, load policy e limite de contexto.
+4. Aponte nomes duplicados, `SKILL.md` ausente, frontmatter ausente, `SKILL.md` grande demais, e references/assets lidos sem trigger especifico.
+5. Recomende manter, compactar entrypoint, mesclar, reclassificar, ou remover da visibilidade core.
+
+## Taxonomia
+
+- `protocol`: workflow/gate/checklist acionavel que muda a execucao.
+- `domain-pack`: expertise de dominio usada so quando a tarefa entra naquele dominio.
+- `recipe-pack`: receitas/snippets curados carregados por stack ou modo.
+- `asset-pack`: midia/exemplos/assets carregados so para tasks correspondentes.
+
+`SKILL.md` deve ser um roteador/protocolo curto. Regras longas, exemplos, paletas, receitas, services e assets ficam em references/assets/rules/recipes e sao carregados sob demanda.
+
+## Saida
+Retorne um relatorio conciso. Nao delete arquivos.
+
+Marcador final: `## SKILL-HEALTH COMPLETE`
+</system_instructions>

package/scaffold/pt-br/commands/dw-subtask-complete.md

@@ -0,0 +1,40 @@
+<system_instructions>
+Voce registra um handoff estruturado de subagente.
+
+## Quando Usar
+- Use dentro da sessao child/subagente quando a subtarefa atribuida estiver completa, bloqueada ou fora de budget.
+
+## Formato Obrigatorio
+
+```markdown
+## Objective
+
+## Result
+
+## Files Read
+
+## Files Changed
+
+## Decisions
+
+## Risks
+
+## Verification
+
+## Next Steps
+
+## Blocked Or Not Done
+```
+
+## Processo
+1. Escreva o handoff em um arquivo markdown local.
+2. Rode:
+
+```bash
+npx @brunosps00/dev-workflow subtask complete --slug=<slug> --file=<handoff.md>
+```
+
+Retorne apenas evidencia resumida. Nao inclua logs completos nem dumps de transcript.
+
+Final marker: `## SUBTASK HANDOFF RECORDED`
+</system_instructions>

package/scaffold/pt-br/commands/dw-subtask-resume.md

@@ -0,0 +1,21 @@
+<system_instructions>
+Voce consome handoffs completos de subagentes para a sessao parent.
+
+## Quando Usar
+- Use depois que uma ou mais sessoes child registraram `.dw/subtasks/pending/*/HANDOFF.md`.
+- Use antes de sintetizar decisoes finais do parent a partir de trabalho delegado.
+
+## Processo
+1. Rode:
+
+```bash
+npx @brunosps00/dev-workflow subtask consume
+```
+
+2. Leia o resumo impresso e, somente quando houver aprendizado duravel, promova manualmente para `.dw/STATE.md`, `.dw/rules/`, `.dw/intel/`, resumo de bugfix ou artefato de spec.
+3. Continue o workstream principal a partir dos return packets resumidos.
+
+Nao cole transcripts child no contexto principal. O parent continua sendo o unico sintetizador final.
+
+Final marker: `## SUBTASKS RESUMED`
+</system_instructions>

package/scaffold/pt-br/commands/dw-subtask-start.md

@@ -0,0 +1,22 @@
+<system_instructions>
+Voce cria input packets minimos para subagentes.
+
+## Quando Usar
+- Use quando uma subtarefa read-only, QA, review ou build-fix puder rodar separada do contexto principal.
+- Use quando o output seria volumoso: logs, grep amplo, evidencia de teste, QA em browser, review de seguranca.
+
+## Processo
+1. Escolha o agente instalado mais especifico em `.agents/agents/README.md` ou `scaffold/agent-registry.json`.
+2. Escreva objetivo estreito, arquivos/fontes permitidos, constraints, output esperado, budget de contexto e criterio de parada.
+3. Rode:
+
+```bash
+npx @brunosps00/dev-workflow subtask create --agent=<name> --goal="<goal>"
+```
+
+4. Preencha qualquer fronteira faltante no `.dw/subtasks/pending/<slug>/TASK.md` antes do dispatch.
+
+Nunca cole o transcript bruto do parent no task packet.
+
+Final marker: `## SUBTASK PACKET READY`
+</system_instructions>