@brunosps00/dev-workflow 0.15.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (136) hide show
  1. package/README.md +99 -119
  2. package/lib/constants.js +16 -36
  3. package/lib/migrate-skills.js +11 -4
  4. package/lib/removed-commands.js +30 -0
  5. package/package.json +1 -1
  6. package/scaffold/en/agent-instructions.md +31 -16
  7. package/scaffold/en/commands/dw-adr.md +2 -2
  8. package/scaffold/en/commands/dw-analyze-project.md +7 -7
  9. package/scaffold/en/commands/dw-autopilot.md +20 -20
  10. package/scaffold/en/commands/dw-brainstorm.md +315 -21
  11. package/scaffold/en/commands/dw-bugfix.md +5 -5
  12. package/scaffold/en/commands/dw-commit.md +1 -1
  13. package/scaffold/en/commands/dw-dockerize.md +9 -9
  14. package/scaffold/en/commands/dw-find-skills.md +4 -4
  15. package/scaffold/en/commands/dw-functional-doc.md +1 -1
  16. package/scaffold/en/commands/dw-generate-pr.md +4 -4
  17. package/scaffold/en/commands/dw-help.md +95 -351
  18. package/scaffold/en/commands/dw-intel.md +76 -12
  19. package/scaffold/en/commands/dw-new-project.md +9 -9
  20. package/scaffold/en/commands/dw-plan.md +175 -0
  21. package/scaffold/en/commands/dw-qa.md +166 -0
  22. package/scaffold/en/commands/dw-redesign-ui.md +6 -6
  23. package/scaffold/en/commands/dw-review.md +198 -0
  24. package/scaffold/en/commands/dw-run.md +176 -0
  25. package/scaffold/en/commands/dw-secure-audit.md +222 -0
  26. package/scaffold/en/commands/dw-update.md +1 -1
  27. package/scaffold/en/references/playwright-patterns.md +1 -1
  28. package/scaffold/en/references/refactoring-catalog.md +1 -1
  29. package/scaffold/en/templates/brainstorm-matrix.md +1 -1
  30. package/scaffold/en/templates/idea-onepager.md +3 -3
  31. package/scaffold/en/templates/project-onepager.md +5 -5
  32. package/scaffold/pt-br/agent-instructions.md +31 -16
  33. package/scaffold/pt-br/commands/dw-adr.md +2 -2
  34. package/scaffold/pt-br/commands/dw-analyze-project.md +7 -7
  35. package/scaffold/pt-br/commands/dw-autopilot.md +20 -20
  36. package/scaffold/pt-br/commands/dw-brainstorm.md +315 -21
  37. package/scaffold/pt-br/commands/dw-bugfix.md +8 -8
  38. package/scaffold/pt-br/commands/dw-commit.md +1 -1
  39. package/scaffold/pt-br/commands/dw-dockerize.md +9 -9
  40. package/scaffold/pt-br/commands/dw-find-skills.md +4 -4
  41. package/scaffold/pt-br/commands/dw-functional-doc.md +1 -1
  42. package/scaffold/pt-br/commands/dw-generate-pr.md +4 -4
  43. package/scaffold/pt-br/commands/dw-help.md +97 -300
  44. package/scaffold/pt-br/commands/dw-intel.md +77 -13
  45. package/scaffold/pt-br/commands/dw-new-project.md +9 -9
  46. package/scaffold/pt-br/commands/dw-plan.md +175 -0
  47. package/scaffold/pt-br/commands/dw-qa.md +166 -0
  48. package/scaffold/pt-br/commands/dw-redesign-ui.md +6 -6
  49. package/scaffold/pt-br/commands/dw-review.md +198 -0
  50. package/scaffold/pt-br/commands/dw-run.md +176 -0
  51. package/scaffold/pt-br/commands/dw-secure-audit.md +222 -0
  52. package/scaffold/pt-br/commands/dw-update.md +1 -1
  53. package/scaffold/pt-br/references/playwright-patterns.md +1 -1
  54. package/scaffold/pt-br/references/refactoring-catalog.md +1 -1
  55. package/scaffold/pt-br/templates/brainstorm-matrix.md +1 -1
  56. package/scaffold/pt-br/templates/idea-onepager.md +3 -3
  57. package/scaffold/pt-br/templates/project-onepager.md +5 -5
  58. package/scaffold/pt-br/templates/tasks-template.md +1 -1
  59. package/scaffold/skills/api-testing-recipes/SKILL.md +6 -6
  60. package/scaffold/skills/api-testing-recipes/references/auth-patterns.md +1 -1
  61. package/scaffold/skills/api-testing-recipes/references/matrix-conventions.md +1 -1
  62. package/scaffold/skills/api-testing-recipes/references/openapi-driven.md +3 -3
  63. package/scaffold/skills/docker-compose-recipes/SKILL.md +1 -1
  64. package/scaffold/skills/dw-codebase-intel/SKILL.md +9 -9
  65. package/scaffold/skills/dw-codebase-intel/agents/intel-updater.md +4 -4
  66. package/scaffold/skills/dw-codebase-intel/references/api-design-discipline.md +1 -1
  67. package/scaffold/skills/dw-codebase-intel/references/incremental-update.md +5 -5
  68. package/scaffold/skills/dw-codebase-intel/references/intel-format.md +1 -1
  69. package/scaffold/skills/dw-codebase-intel/references/query-patterns.md +3 -3
  70. package/scaffold/skills/dw-council/SKILL.md +2 -2
  71. package/scaffold/skills/dw-debug-protocol/SKILL.md +5 -3
  72. package/scaffold/skills/dw-execute-phase/SKILL.md +16 -16
  73. package/scaffold/skills/dw-execute-phase/agents/executor.md +5 -5
  74. package/scaffold/skills/dw-execute-phase/agents/plan-checker.md +4 -4
  75. package/scaffold/skills/dw-execute-phase/references/atomic-commits.md +1 -1
  76. package/scaffold/skills/dw-execute-phase/references/plan-verification.md +2 -2
  77. package/scaffold/skills/dw-execute-phase/references/wave-coordination.md +1 -1
  78. package/scaffold/skills/dw-git-discipline/SKILL.md +5 -2
  79. package/scaffold/skills/dw-incident-response/SKILL.md +5 -1
  80. package/scaffold/skills/dw-llm-eval/SKILL.md +10 -8
  81. package/scaffold/skills/dw-memory/SKILL.md +2 -2
  82. package/scaffold/skills/dw-review-rigor/SKILL.md +5 -5
  83. package/scaffold/skills/dw-simplification/SKILL.md +12 -7
  84. package/scaffold/skills/dw-simplification/references/deep-modules.md +105 -0
  85. package/scaffold/skills/dw-source-grounding/SKILL.md +1 -1
  86. package/scaffold/skills/dw-testing-discipline/SKILL.md +8 -6
  87. package/scaffold/skills/dw-testing-discipline/references/agent-guardrails.md +3 -3
  88. package/scaffold/skills/dw-testing-discipline/references/anti-patterns.md +2 -2
  89. package/scaffold/skills/dw-testing-discipline/references/core-rules.md +1 -1
  90. package/scaffold/skills/dw-testing-discipline/references/flaky-discipline.md +3 -3
  91. package/scaffold/skills/dw-testing-discipline/references/patterns.md +1 -1
  92. package/scaffold/skills/dw-testing-discipline/references/playwright-recipes.md +1 -1
  93. package/scaffold/skills/dw-ui-discipline/SKILL.md +8 -6
  94. package/scaffold/skills/dw-ui-discipline/references/accessibility-floor.md +2 -2
  95. package/scaffold/skills/dw-ui-discipline/references/hard-gate.md +1 -1
  96. package/scaffold/skills/dw-ui-discipline/references/state-matrix.md +1 -1
  97. package/scaffold/skills/dw-ui-discipline/references/visual-slop.md +2 -2
  98. package/scaffold/skills/dw-verify/SKILL.md +4 -4
  99. package/scaffold/skills/humanizer/SKILL.md +1 -7
  100. package/scaffold/skills/remotion-best-practices/SKILL.md +3 -1
  101. package/scaffold/skills/security-review/SKILL.md +1 -1
  102. package/scaffold/skills/security-review/languages/csharp.md +1 -1
  103. package/scaffold/skills/security-review/languages/rust.md +1 -1
  104. package/scaffold/skills/security-review/languages/typescript.md +1 -1
  105. package/scaffold/skills/vercel-react-best-practices/SKILL.md +3 -1
  106. package/scaffold/templates-overrides-readme.md +3 -3
  107. package/scaffold/en/commands/dw-code-review.md +0 -386
  108. package/scaffold/en/commands/dw-create-prd.md +0 -148
  109. package/scaffold/en/commands/dw-create-tasks.md +0 -201
  110. package/scaffold/en/commands/dw-create-techspec.md +0 -210
  111. package/scaffold/en/commands/dw-deep-research.md +0 -418
  112. package/scaffold/en/commands/dw-deps-audit.md +0 -327
  113. package/scaffold/en/commands/dw-fix-qa.md +0 -152
  114. package/scaffold/en/commands/dw-map-codebase.md +0 -125
  115. package/scaffold/en/commands/dw-refactoring-analysis.md +0 -340
  116. package/scaffold/en/commands/dw-revert-task.md +0 -114
  117. package/scaffold/en/commands/dw-review-implementation.md +0 -349
  118. package/scaffold/en/commands/dw-run-plan.md +0 -300
  119. package/scaffold/en/commands/dw-run-qa.md +0 -497
  120. package/scaffold/en/commands/dw-run-task.md +0 -209
  121. package/scaffold/en/commands/dw-security-check.md +0 -271
  122. package/scaffold/pt-br/commands/dw-code-review.md +0 -366
  123. package/scaffold/pt-br/commands/dw-create-prd.md +0 -148
  124. package/scaffold/pt-br/commands/dw-create-tasks.md +0 -201
  125. package/scaffold/pt-br/commands/dw-create-techspec.md +0 -208
  126. package/scaffold/pt-br/commands/dw-deep-research.md +0 -172
  127. package/scaffold/pt-br/commands/dw-deps-audit.md +0 -327
  128. package/scaffold/pt-br/commands/dw-fix-qa.md +0 -152
  129. package/scaffold/pt-br/commands/dw-map-codebase.md +0 -125
  130. package/scaffold/pt-br/commands/dw-refactoring-analysis.md +0 -340
  131. package/scaffold/pt-br/commands/dw-revert-task.md +0 -114
  132. package/scaffold/pt-br/commands/dw-review-implementation.md +0 -337
  133. package/scaffold/pt-br/commands/dw-run-plan.md +0 -296
  134. package/scaffold/pt-br/commands/dw-run-qa.md +0 -495
  135. package/scaffold/pt-br/commands/dw-run-task.md +0 -208
  136. package/scaffold/pt-br/commands/dw-security-check.md +0 -271
@@ -94,12 +94,12 @@ services: []
94
94
 
95
95
  ## MVP Scope
96
96
 
97
- [The smallest first feature you'll ship. Thought as user stories — this should drive the first /dw-create-prd run.]
97
+ [The smallest first feature you'll ship. Thought as user stories — this should drive the first /dw-plan prd run.]
98
98
 
99
99
  - As a [persona], I can [action] so that [benefit]
100
100
  - As a [persona], I can [action] so that [benefit]
101
101
 
102
- If you don't have a first feature in mind yet, that's OK — leave a placeholder and run /dw-create-prd when ready.
102
+ If you don't have a first feature in mind yet, that's OK — leave a placeholder and run /dw-plan prd when ready.
103
103
 
104
104
  ## Not Doing (explicit)
105
105
 
@@ -115,7 +115,7 @@ If you don't have a first feature in mind yet, that's OK — leave a placeholder
115
115
 
116
116
  ## Open Questions
117
117
 
118
- [Things this one-pager cannot answer alone. Resolve before /dw-create-prd or escalate to a stakeholder.]
118
+ [Things this one-pager cannot answer alone. Resolve before /dw-plan prd or escalate to a stakeholder.]
119
119
 
120
120
  - [question 1]
121
121
  - [question 2]
@@ -124,6 +124,6 @@ If you don't have a first feature in mind yet, that's OK — leave a placeholder
124
124
 
125
125
  Pick ONE:
126
126
 
127
- - **`/dw-create-prd`** — when you have a first feature in mind and want to draft the PRD on top of this stack
127
+ - **`/dw-plan prd`** — when you have a first feature in mind and want to draft the PRD on top of this stack
128
128
  - **`/dw-analyze-project`** — after the first substantial commit, to enrich `.dw/rules/` with module-level conventions
129
- - **`/dw-deps-audit --scan-only`** — to confirm no vulnerable deps shipped from the `create-*` templates
129
+ - **`/dw-secure-audit --plan --scan-only`** — to confirm no vulnerable deps shipped from the `create-*` templates
@@ -11,28 +11,40 @@ Este projeto usa [`@brunosps00/dev-workflow`](https://www.npmjs.com/package/@bru
11
11
  |------------------------------------------------|--------------|
12
12
  | "Implementa X" / "Cria Y" / "Adiciona feature Z" / "Preciso de..." | `/dw-autopilot "X"` |
13
13
  | Erro colado / "X está quebrado" / "Bug em Y" / screenshot de teste falhando | `/dw-bugfix "X"` |
14
- | "Roda essa task" (com ID da task) | `/dw-run-task <ID>` |
15
- | "Roda todas as tasks pendentes" / "Executa o plano" | `/dw-run-plan` |
16
- | "Revisa meu PR" / "Checa qualidade do código" / "Tá pronto pra subir?" | `/dw-code-review` |
14
+ | "Planeja essa feature" / "Escreve PRD + techspec + tasks" | `/dw-plan "X"` |
15
+ | "Escreve PRD pra X" / "Especifica Y" | `/dw-plan prd "X"` |
16
+ | "Desenha a arquitetura" / "Faz o techspec" | `/dw-plan techspec` |
17
+ | "Quebra em tasks" | `/dw-plan tasks` |
18
+ | "Roda essa task" (com ID da task) | `/dw-run <ID>` |
19
+ | "Roda todas as tasks pendentes" / "Executa o plano" | `/dw-run` |
20
+ | "Continue de onde parei" | `/dw-run --resume` |
21
+ | "QA dessa feature" / "Roda o test plan" | `/dw-qa` |
22
+ | "Corrige os bugs do QA" | `/dw-qa --fix` |
23
+ | "Avalia a feature AI" / "Testa o RAG / classifier" | `/dw-qa --ai` |
24
+ | "Revisa meu PR" / "Checa qualidade" / "Tá pronto pra subir?" | `/dw-review` |
25
+ | "Só checagem de cobertura PRD" | `/dw-review --coverage-only` |
26
+ | "Só code review qualidade" | `/dw-review --code-only` |
17
27
  | "Hora de commitar" / mudanças validadas e prontas | `/dw-commit` |
18
28
  | "Abre um PR" / "Sobe isso" | `/dw-generate-pr` |
19
- | "Escreve PRD pra X" / "Especifica Y" | `/dw-create-prd` |
20
- | "Desenha a arquitetura" / "Faz o techspec" | `/dw-create-techspec` |
21
- | "Quebra em tasks" | `/dw-create-tasks` |
29
+ | "Brainstorm X" / "Explora ideias" / "Research X" / "Auditoria de saúde do código" / "Tech debt" | `/dw-brainstorm "X"` (auto-dispatch dos modos grill / prototype / council / research / refactor-audit / onepager conforme os sinais) |
22
30
  | "Onde está X?" / "O que usa Y?" / "Como Z é estruturado?" | `/dw-intel "<pergunta>"` |
23
- | "Audita nossas dependências" / "Estamos atrasados em pacotes?" | `/dw-deps-audit` |
24
- | "Scan de vulnerabilidades" / "Check de segurança" | `/dw-security-check` |
25
- | "QA dessa feature" / "Roda o test plan" | `/dw-run-qa` |
26
- | "Corrige os bugs do QA" | `/dw-fix-qa` |
31
+ | "Reconstrói o índice" / "Refresh do intel" | `/dw-intel --build` |
32
+ | "Redesign dessa UI" / "Audita e entrega novo design" | `/dw-redesign-ui "<target>"` |
33
+ | "Audita dependências" / "Estamos atrasados em pacotes?" | `/dw-secure-audit --plan` |
34
+ | "Scan de vulnerabilidades" / "Check de segurança" | `/dw-secure-audit` |
35
+ | "Analisa esse projeto" / "Gera rules" | `/dw-analyze-project` |
36
+ | "Abre um novo projeto" / "Bootstrap de stack" | `/dw-new-project` |
37
+ | "Dockeriza isso" / "Adiciona docker-compose" | `/dw-dockerize` |
38
+ | "Functional doc" / "Mapeia screens e flows" | `/dw-functional-doc` |
27
39
 
28
40
  **Prioridade:** na dúvida entre dois comandos, `/dw-autopilot` é o default mais seguro pra qualquer pedido de feature não-trivial — ele compõe os demais.
29
41
 
30
42
  ## Hard Gates (os comandos enforçam — não burle)
31
43
 
32
44
  - **`.dw/constitution.md`**: princípios com `severity: high` ou `critical` bloqueiam PRs / techspecs sem um ADR justificando o desvio. Constitution ausente? Os comandos auto-instalam defaults em `severity: info` (não-bloqueante) e seguem — ausência nunca bloqueia.
33
- - **`.dw/spec/<prd>/tasks-validation.md`**: auto-gerado no fim do `/dw-create-tasks`. Qualquer dimensão FAIL bloqueia approval do usuário até resolver ou override explícito.
45
+ - **`.dw/spec/<prd>/tasks-validation.md`**: auto-gerado no fim do `/dw-plan tasks`. Qualquer dimensão FAIL bloqueia approval do usuário até resolver ou override explícito.
34
46
  - **Verification**: `/dw-generate-pr` exige `dw-verify` PASS fresco (testes + lint + build) depois do último edit.
35
- - **Segurança**: projetos TS / Python / C# / Rust precisam passar `/dw-security-check` (Trivy + OWASP + lockfile audit) antes do PR abrir.
47
+ - **Segurança**: projetos TS / Python / C# / Rust precisam passar `/dw-secure-audit` (Trivy + OWASP + lockfile audit) antes do PR abrir.
36
48
 
37
49
  ## Escape Hatches — NÃO auto-trigger
38
50
 
@@ -44,6 +56,12 @@ Quando qualquer destes se aplica, responda direto e **não** invoque comando `dw
44
56
  - Usuário diz explicitamente "faz direto" / "pula autopilot" / "não precisa de PRD" — honre.
45
57
  - A conversa já está dentro de um fluxo `dw-*` (você já está executando tasks; não inicie pipeline novo).
46
58
 
59
+ ## Padrão zoom-out (para áreas desconhecidas do código)
60
+
61
+ Quando você cai numa área do codebase que não conhece e a orientação custa mais que a tarefa em si, **não mergulhe nos arquivos primeiro** — peça a um agente de exploração que produza um mapa. Passe o glossário de domínio do projeto (`.dw/rules/index.md`) e diga: "zoom out de um nível — me mostra os módulos relevantes, suas superfícies públicas, quem chama, e o fluxo de dados entre eles, usando o vocabulário do glossário de domínio." Pegue a visão geral, e só então mergulhe. Isso evita a armadilha de ler o arquivo mais profundo primeiro e reconstruir a arquitetura das folhas pra cima.
62
+
63
+ Adaptado de [`mattpocock/skills/zoom-out`](https://github.com/mattpocock/skills/tree/main/zoom-out) (MIT).
64
+
47
65
  ## Referência de Workflow
48
66
 
49
67
  ```
@@ -52,10 +70,7 @@ Quando qualquer destes se aplica, responda direto e **não** invoque comando `dw
52
70
 
53
71
  --- OU passo a passo ---
54
72
 
55
- /dw-brainstorm ─► /dw-create-prd ─► /dw-create-techspec ─► /dw-create-tasks
56
-
57
-
58
- /dw-commit + /dw-generate-pr ◄──── /dw-code-review ◄──── /dw-run-plan
73
+ /dw-brainstorm ─► /dw-plan ─► /dw-run ─► /dw-qa ─► /dw-review ─► /dw-commit ─► /dw-generate-pr
59
74
  ```
60
75
 
61
76
  Lista completa e ajuda contextual: `/dw-help`.
@@ -3,12 +3,12 @@ Você é um registrador de decisões arquiteturais. Sua função é criar um **A
3
3
 
4
4
  ## Quando Usar
5
5
  - Use quando uma decisão arquitetural ou de design foi tomada e precisa ser registrada para referência futura (escolha de biblioteca, padrão de comunicação, tradeoff de performance, restrição imposta por compliance, etc.)
6
- - Use durante `/dw-create-techspec` ou `/dw-run-task` quando a justificativa da decisão não cabe no techspec nem no task file
6
+ - Use durante `/dw-plan techspec` ou `/dw-run` quando a justificativa da decisão não cabe no techspec nem no task file
7
7
  - NÃO use para decisões triviais ou reversíveis sem custo (escolha de nome de variável, ordem de import)
8
8
  - NÃO use para registrar bugs ou incidents (use `/dw-bugfix` ou notas operacionais)
9
9
 
10
10
  ## Posição no Pipeline
11
- **Antecessor:** qualquer ponto do pipeline após `/dw-create-prd` | **Sucessor:** continua o fluxo anterior (techspec, task, review)
11
+ **Antecessor:** qualquer ponto do pipeline após `/dw-plan prd` | **Sucessor:** continua o fluxo anterior (techspec, task, review)
12
12
 
13
13
  O ADR é **aditivo**: ele não substitui nenhuma etapa do pipeline. Qualquer command existente pode invocar `/dw-adr` quando uma decisão não-trivial precisar de registro permanente.
14
14
 
@@ -24,10 +24,10 @@ Você é um assistente especializado em análise de projetos de software. Sua ta
24
24
 
25
25
  ## Consumidores da Saída
26
26
  As rules geradas por este comando são consumidas por:
27
- - `/dw-run-task` -- lê rules para padrões de implementação
28
- - `/dw-code-review` -- lê rules para verificações de conformidade
29
- - `/dw-refactoring-analysis` -- lê rules para contexto do projeto
30
- - `/dw-create-techspec` -- lê rules para decisões de arquitetura
27
+ - `/dw-run` -- lê rules para padrões de implementação
28
+ - `/dw-review --code-only` -- lê rules para verificações de conformidade
29
+ - `/dw-brainstorm --refactor` -- lê rules para contexto do projeto
30
+ - `/dw-plan techspec` -- lê rules para decisões de arquitetura
31
31
 
32
32
  <critical>NUNCA modifique código fonte, apenas leia e documente</critical>
33
33
  <critical>Gere os arquivos de rules em .dw/rules/ na raiz do workspace</critical>
@@ -218,13 +218,13 @@ Para cada projeto/módulo detectado, identificar:
218
218
  Quando React for detectado, execute `npx react-doctor@latest --verbose` e inclua o health score nas rules geradas como métrica baseline.
219
219
  Para projetos Angular, execute `ng lint` e documente warnings como baseline.
220
220
 
221
- <critical>A execução do /dw-map-codebase para gerar o índice queryable em .dw/intel/ é OBRIGATÓRIA. O comando NÃO pode ser considerado completo sem ela.</critical>
221
+ <critical>A execução do /dw-intel --build para gerar o índice queryable em .dw/intel/ é OBRIGATÓRIA. O comando NÃO pode ser considerado completo sem ela.</critical>
222
222
 
223
223
  #### Inteligência do Codebase (nativo)
224
224
 
225
- Após gerar as rules em `.dw/rules/`, delegue para `/dw-map-codebase` para criar o índice queryable em `.dw/intel/`:
225
+ Após gerar as rules em `.dw/rules/`, delegue para `/dw-intel --build` para criar o índice queryable em `.dw/intel/`:
226
226
  - O índice inclui: stack (`stack.json`), grafo de arquivos (`files.json`), superfície de API (`apis.json`), dependências (`deps.json`), overview de arquitetura (`arch.md`)
227
- - O índice é incremental — `/dw-map-codebase --files <list>` atualiza só os entries tocados; full scan só quando preciso
227
+ - O índice é incremental — `/dw-intel --build --files <list>` atualiza só os entries tocados; full scan só quando preciso
228
228
  - Outros comandos dw-* consultam o índice via `/dw-intel` (veja a skill bundled `dw-codebase-intel` para schemas)
229
229
 
230
230
  ### Passo 4: Ler Arquivos Fonte Representativos (Obrigatório)
@@ -15,18 +15,18 @@ Uma etapa que invoca um comando `/dw-xxx` SO e considerada completa quando os ar
15
15
  | Pensamento | Realidade |
16
16
  |------------|-----------|
17
17
  | "Ja rodei os testes manualmente" | O comando produz artefatos estruturados. Rode o comando. |
18
- | "Validei via Playwright ad-hoc" | `/dw-run-qa` exige matriz por RF, bugs.md, screenshots, scripts, logs, checklist. Rode o comando. |
19
- | "A implementacao esta obviamente correta" | `/dw-review-implementation` exige matriz de compliance por RF/endpoint/task. Rode o comando. |
18
+ | "Validei via Playwright ad-hoc" | `/dw-qa` exige matriz por RF, bugs.md, screenshots, scripts, logs, checklist. Rode o comando. |
19
+ | "A implementacao esta obviamente correta" | `/dw-review --coverage-only` exige matriz de compliance por RF/endpoint/task. Rode o comando. |
20
20
  | "Validacao manual forte ja basta" | NAO. Equivalencia tecnica NAO substitui a execucao formal. |
21
21
  | "Ja conferi build e lint, e suficiente" | Build/lint NAO substituem review nem QA. Rode os comandos. |
22
- | "Gerei um qa-report.md resumido a mao" | Um arquivo solto NAO e execucao de `/dw-run-qa`. A arvore `QA/` completa e obrigatoria. |
22
+ | "Gerei um qa-report.md resumido a mao" | Um arquivo solto NAO e execucao de `/dw-qa`. A arvore `QA/` completa e obrigatoria. |
23
23
  | "O autopilot ja avancou, nao preciso voltar" | Se o artefato nao existe, a etapa nao rodou. Volte e execute. |
24
- | "Corrigi bugs no caminho, entao o QA ja esta ok" | Corrigir bugs nao substitui rodar o QA formal. Rode `/dw-run-qa`. |</critical>
24
+ | "Corrigi bugs no caminho, entao o QA ja esta ok" | Corrigir bugs nao substitui rodar o QA formal. Rode `/dw-qa`. |</critical>
25
25
 
26
26
  ## Quando Usar
27
27
  - Use quando quiser ir de uma ideia ate um PR com minima intervencao manual
28
28
  - Use para features completas que passam por todo o pipeline (pesquisa, planejamento, execucao, qualidade)
29
- - NAO use para tasks pequenas e bem-escopadas — use `/dw-run-task` direto com um PRD curto
29
+ - NAO use para tasks pequenas e bem-escopadas — use `/dw-run` direto com um PRD curto
30
30
  - NAO use para corrigir bugs (use `/dw-bugfix`)
31
31
  - NAO use quando quiser controle manual entre cada fase (use os comandos individuais)
32
32
 
@@ -72,12 +72,12 @@ Se este comando for re-invocado no mesmo PRD apos interrupcao:
72
72
 
73
73
  - Consulte `.dw/intel/` via `/dw-intel` para entender o contexto do projeto
74
74
  - Identifique: stack tecnologica, padroes existentes, features relacionadas
75
- - Se `.dw/intel/` esta ausente, sugira rodar `/dw-map-codebase` primeiro para contexto downstream mais rico
75
+ - Se `.dw/intel/` esta ausente, sugira rodar `/dw-intel --build` primeiro para contexto downstream mais rico
76
76
 
77
77
  ### Etapa 2: Pesquisa (Condicional)
78
78
 
79
79
  Avalie se o topico necessita de pesquisa profunda:
80
- - **SIM** (execute `/dw-deep-research`): tecnologia nova para o projeto, dominio desconhecido, integracoes com APIs externas, decisoes arquiteturais criticas
80
+ - **SIM** (execute `/dw-brainstorm --research`): tecnologia nova para o projeto, dominio desconhecido, integracoes com APIs externas, decisoes arquiteturais criticas
81
81
  - **NAO** (pule para etapa 3): feature simples no dominio ja mapeado, refatoracao de algo existente, CRUD basico
82
82
  - Se pular, DOCUMENTE o motivo no bloco de progresso. Ex: "Pesquisa pulada — dominio ja mapeado em .dw/rules/[arquivo].md". O usuario deve ver a justificativa.
83
83
 
@@ -94,7 +94,7 @@ Execute `/dw-brainstorm` com o contexto acumulado (intel + pesquisa).
94
94
 
95
95
  <critical>O PRD DEVE incluir entrevista interativa com o usuario. Faca NO MINIMO 7 perguntas de esclarecimento ANTES de redigir o PRD. NAO responda as perguntas automaticamente com base no contexto — o usuario DEVE responder.</critical>
96
96
 
97
- Execute `/dw-create-prd` usando os findings do brainstorm.
97
+ Execute `/dw-plan prd` usando os findings do brainstorm.
98
98
  - Siga TODAS as instrucoes do comando, especialmente a secao de perguntas de esclarecimento
99
99
  - Faca pelo menos 7 perguntas ao usuario sobre: problema, usuarios-alvo, funcionalidades criticas, escopo, restricoes, design, integracao
100
100
  - Em cada pergunta, apresente uma recomendacao embasada nos findings do brainstorm e do deep-research (se executado). Ex: "Com base na pesquisa, recomendo X porque [evidencia]. Concorda ou prefere outra direcao?"
@@ -115,7 +115,7 @@ Apresente ao usuario:
115
115
 
116
116
  <critical>O TechSpec DEVE incluir entrevista interativa com o usuario. Faca NO MINIMO 7 perguntas de esclarecimento tecnico ANTES de redigir o TechSpec. NAO responda as perguntas automaticamente — o usuario DEVE responder.</critical>
117
117
 
118
- Execute `/dw-create-techspec` a partir do PRD aprovado.
118
+ Execute `/dw-plan techspec` a partir do PRD aprovado.
119
119
  - Siga TODAS as instrucoes do comando, especialmente a secao de perguntas de esclarecimento
120
120
  - Faca pelo menos 7 perguntas ao usuario sobre: arquitetura preferida, libs existentes vs novas, estrategia de testes, integracao com sistemas existentes, restricoes de infraestrutura, performance, seguranca
121
121
  - Em cada pergunta, apresente uma recomendacao tecnica embasada nos findings do brainstorm, deep-research e PRD aprovado. Ex: "A pesquisa indicou que a lib X tem melhor performance para este caso [fonte]. Quer usar X ou tem outra preferencia?"
@@ -125,7 +125,7 @@ Execute `/dw-create-techspec` a partir do PRD aprovado.
125
125
 
126
126
  ### Etapa 6: Tasks
127
127
 
128
- Execute `/dw-create-tasks` a partir do PRD + TechSpec.
128
+ Execute `/dw-plan tasks` a partir do PRD + TechSpec.
129
129
  - Siga todas as instrucoes do comando
130
130
  - Gere tasks individuais em `.dw/spec/prd-[nome]/`
131
131
 
@@ -148,9 +148,9 @@ Avalie se as tasks envolvem frontend:
148
148
 
149
149
  ### Etapa 8: Execucao
150
150
 
151
- Execute `/dw-run-plan` com o path do PRD.
151
+ Execute `/dw-run` com o path do PRD.
152
152
  - Siga TODAS as instrucoes do comando, incluindo o gate nativo do plan-checker (PASS obrigatorio) e execucao paralela em waves via os agentes da skill bundled `dw-execute-phase`
153
- - Cada task segue `/dw-run-task` com validacao Level 1
153
+ - Cada task segue `/dw-run` com validacao Level 1
154
154
 
155
155
  ### Etapa 9: Review de Implementacao (Loop)
156
156
 
@@ -164,7 +164,7 @@ Execute build e lint do projeto:
164
164
  5. Repita ate que build E lint passem sem erros
165
165
  6. So entao prossiga para o review
166
166
 
167
- Execute `/dw-review-implementation` para verificar PRD compliance (Level 2).
167
+ Execute `/dw-review --coverage-only` para verificar PRD compliance (Level 2).
168
168
  - Se encontrar gaps: corrija automaticamente e re-execute o review
169
169
  - Maximo 3 ciclos de correcao
170
170
  - NAO avance para QA ate que o review passe
@@ -177,7 +177,7 @@ Um review textual curto, um "parece ok" ou conclusao "implementacao correta" SEM
177
177
 
178
178
  ### Etapa 10: QA Visual
179
179
 
180
- Execute `/dw-run-qa` com Playwright MCP.
180
+ Execute `/dw-qa` com Playwright MCP.
181
181
  - Teste happy paths, edge cases, fluxos negativos, acessibilidade
182
182
  - Documente bugs com screenshots
183
183
 
@@ -188,12 +188,12 @@ Execute `/dw-run-qa` com Playwright MCP.
188
188
  - `{{PRD_PATH}}/QA/screenshots/` — diretorio existe e contem pelo menos 1 PNG por RF testado (formato `RF-XX-[slug]-PASS.png` ou `-FAIL.png`)
189
189
  - `{{PRD_PATH}}/QA/scripts/` — diretorio existe e contem scripts Playwright `.spec.ts`/`.spec.js` por RF
190
190
  - `{{PRD_PATH}}/QA/logs/` — diretorio existe com logs de console/rede capturados
191
- Rodar Playwright ad-hoc, tirar algumas screenshots soltas ou escrever um qa-report.md curto a mao NAO substitui esta estrutura. Se qualquer artefato estiver ausente ou incompleto, o comando NAO rodou — invoque `/dw-run-qa` formalmente e siga o fluxo dele ate o fim.</critical>
191
+ Rodar Playwright ad-hoc, tirar algumas screenshots soltas ou escrever um qa-report.md curto a mao NAO substitui esta estrutura. Se qualquer artefato estiver ausente ou incompleto, o comando NAO rodou — invoque `/dw-qa` formalmente e siga o fluxo dele ate o fim.</critical>
192
192
 
193
193
  ### Etapa 11: Fix QA (Condicional)
194
194
 
195
195
  Se o QA encontrou bugs:
196
- - Execute `/dw-fix-qa` para corrigir e retestar
196
+ - Execute `/dw-qa --fix` para corrigir e retestar
197
197
  - Loop ate estabilizar (maximo 5 ciclos). Apos 5 ciclos, PARE e pergunte ao usuario como deseja prosseguir.
198
198
 
199
199
  ### Etapa 12: Review de Implementacao (Pos-QA)
@@ -205,7 +205,7 @@ Execute build e lint do projeto (mesma sequencia da Etapa 9):
205
205
  2. Build
206
206
  3. Se falhar: corrija e re-execute ate passar
207
207
 
208
- Execute `/dw-review-implementation` novamente para confirmar que as correcoes do QA nao quebraram PRD compliance.
208
+ Execute `/dw-review --coverage-only` novamente para confirmar que as correcoes do QA nao quebraram PRD compliance.
209
209
  - Se encontrar gaps: corrija e re-execute
210
210
  - Maximo 3 ciclos
211
211
 
@@ -213,7 +213,7 @@ Execute `/dw-review-implementation` novamente para confirmar que as correcoes do
213
213
 
214
214
  ### Etapa 13: Code Review
215
215
 
216
- Execute `/dw-code-review` (Level 3) para review formal.
216
+ Execute `/dw-review --code-only` (Level 3) para review formal.
217
217
  - Gere relatorio persistido
218
218
 
219
219
  ### Etapa 14: Commit
@@ -227,7 +227,7 @@ Rode `ls` em cada caminho abaixo e confirme existencia. Se QUALQUER um faltar, N
227
227
  - `{{PRD_PATH}}/QA/screenshots/` (nao vazio)
228
228
  - `{{PRD_PATH}}/QA/scripts/` (nao vazio com arquivos `.spec.*`)
229
229
  - `{{PRD_PATH}}/QA/logs/`
230
- - Evidencia do ultimo `/dw-review-implementation` com matriz RF-by-RF (output da sessao ou referencia em `autopilot-state.json`)
230
+ - Evidencia do ultimo `/dw-review --coverage-only` com matriz RF-by-RF (output da sessao ou referencia em `autopilot-state.json`)
231
231
 
232
232
  Verifique tambem `autopilot-state.json`:
233
233
  - Toda etapa de 1 a 13 que NAO esta em `skipped_steps` deve estar em `completed_steps`
@@ -250,7 +250,7 @@ Pergunte ao usuario: **"Commits realizados. Deseja gerar o Pull Request?"**
250
250
 
251
251
  ## Engine Nativo
252
252
 
253
- O autopilot depende de infraestrutura dev-workflow-native para inteligencia de codebase (`/dw-map-codebase` + `/dw-intel`) e dos agentes bundled de execucao de fase (plan-checker + executor em `.agents/skills/dw-execute-phase/agents/`). Tudo bundled, sem dependencias externas. Veja as skills bundled `dw-codebase-intel` e `dw-execute-phase` em `.agents/skills/` para detalhes.
253
+ O autopilot depende de infraestrutura dev-workflow-native para inteligencia de codebase (`/dw-intel --build` + `/dw-intel`) e dos agentes bundled de execucao de fase (plan-checker + executor em `.agents/skills/dw-execute-phase/agents/`). Tudo bundled, sem dependencias externas. Veja as skills bundled `dw-codebase-intel` e `dw-execute-phase` em `.agents/skills/` para detalhes.
254
254
 
255
255
  ## Persistencia de Estado
256
256