@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.
- package/README.md +99 -119
- package/lib/constants.js +16 -36
- package/lib/migrate-skills.js +11 -4
- package/lib/removed-commands.js +30 -0
- package/package.json +1 -1
- package/scaffold/en/agent-instructions.md +31 -16
- package/scaffold/en/commands/dw-adr.md +2 -2
- package/scaffold/en/commands/dw-analyze-project.md +7 -7
- package/scaffold/en/commands/dw-autopilot.md +20 -20
- package/scaffold/en/commands/dw-brainstorm.md +315 -21
- package/scaffold/en/commands/dw-bugfix.md +5 -5
- package/scaffold/en/commands/dw-commit.md +1 -1
- package/scaffold/en/commands/dw-dockerize.md +9 -9
- package/scaffold/en/commands/dw-find-skills.md +4 -4
- package/scaffold/en/commands/dw-functional-doc.md +1 -1
- package/scaffold/en/commands/dw-generate-pr.md +4 -4
- package/scaffold/en/commands/dw-help.md +95 -351
- package/scaffold/en/commands/dw-intel.md +76 -12
- package/scaffold/en/commands/dw-new-project.md +9 -9
- package/scaffold/en/commands/dw-plan.md +175 -0
- package/scaffold/en/commands/dw-qa.md +166 -0
- package/scaffold/en/commands/dw-redesign-ui.md +6 -6
- package/scaffold/en/commands/dw-review.md +198 -0
- package/scaffold/en/commands/dw-run.md +176 -0
- package/scaffold/en/commands/dw-secure-audit.md +222 -0
- package/scaffold/en/commands/dw-update.md +1 -1
- package/scaffold/en/references/playwright-patterns.md +1 -1
- package/scaffold/en/references/refactoring-catalog.md +1 -1
- package/scaffold/en/templates/brainstorm-matrix.md +1 -1
- package/scaffold/en/templates/idea-onepager.md +3 -3
- package/scaffold/en/templates/project-onepager.md +5 -5
- package/scaffold/pt-br/agent-instructions.md +31 -16
- package/scaffold/pt-br/commands/dw-adr.md +2 -2
- package/scaffold/pt-br/commands/dw-analyze-project.md +7 -7
- package/scaffold/pt-br/commands/dw-autopilot.md +20 -20
- package/scaffold/pt-br/commands/dw-brainstorm.md +315 -21
- package/scaffold/pt-br/commands/dw-bugfix.md +8 -8
- package/scaffold/pt-br/commands/dw-commit.md +1 -1
- package/scaffold/pt-br/commands/dw-dockerize.md +9 -9
- package/scaffold/pt-br/commands/dw-find-skills.md +4 -4
- package/scaffold/pt-br/commands/dw-functional-doc.md +1 -1
- package/scaffold/pt-br/commands/dw-generate-pr.md +4 -4
- package/scaffold/pt-br/commands/dw-help.md +97 -300
- package/scaffold/pt-br/commands/dw-intel.md +77 -13
- package/scaffold/pt-br/commands/dw-new-project.md +9 -9
- package/scaffold/pt-br/commands/dw-plan.md +175 -0
- package/scaffold/pt-br/commands/dw-qa.md +166 -0
- package/scaffold/pt-br/commands/dw-redesign-ui.md +6 -6
- package/scaffold/pt-br/commands/dw-review.md +198 -0
- package/scaffold/pt-br/commands/dw-run.md +176 -0
- package/scaffold/pt-br/commands/dw-secure-audit.md +222 -0
- package/scaffold/pt-br/commands/dw-update.md +1 -1
- package/scaffold/pt-br/references/playwright-patterns.md +1 -1
- package/scaffold/pt-br/references/refactoring-catalog.md +1 -1
- package/scaffold/pt-br/templates/brainstorm-matrix.md +1 -1
- package/scaffold/pt-br/templates/idea-onepager.md +3 -3
- package/scaffold/pt-br/templates/project-onepager.md +5 -5
- package/scaffold/pt-br/templates/tasks-template.md +1 -1
- package/scaffold/skills/api-testing-recipes/SKILL.md +6 -6
- package/scaffold/skills/api-testing-recipes/references/auth-patterns.md +1 -1
- package/scaffold/skills/api-testing-recipes/references/matrix-conventions.md +1 -1
- package/scaffold/skills/api-testing-recipes/references/openapi-driven.md +3 -3
- package/scaffold/skills/docker-compose-recipes/SKILL.md +1 -1
- package/scaffold/skills/dw-codebase-intel/SKILL.md +9 -9
- package/scaffold/skills/dw-codebase-intel/agents/intel-updater.md +4 -4
- package/scaffold/skills/dw-codebase-intel/references/api-design-discipline.md +1 -1
- package/scaffold/skills/dw-codebase-intel/references/incremental-update.md +5 -5
- package/scaffold/skills/dw-codebase-intel/references/intel-format.md +1 -1
- package/scaffold/skills/dw-codebase-intel/references/query-patterns.md +3 -3
- package/scaffold/skills/dw-council/SKILL.md +2 -2
- package/scaffold/skills/dw-debug-protocol/SKILL.md +5 -3
- package/scaffold/skills/dw-execute-phase/SKILL.md +16 -16
- package/scaffold/skills/dw-execute-phase/agents/executor.md +5 -5
- package/scaffold/skills/dw-execute-phase/agents/plan-checker.md +4 -4
- package/scaffold/skills/dw-execute-phase/references/atomic-commits.md +1 -1
- package/scaffold/skills/dw-execute-phase/references/plan-verification.md +2 -2
- package/scaffold/skills/dw-execute-phase/references/wave-coordination.md +1 -1
- package/scaffold/skills/dw-git-discipline/SKILL.md +5 -2
- package/scaffold/skills/dw-incident-response/SKILL.md +5 -1
- package/scaffold/skills/dw-llm-eval/SKILL.md +10 -8
- package/scaffold/skills/dw-memory/SKILL.md +2 -2
- package/scaffold/skills/dw-review-rigor/SKILL.md +5 -5
- package/scaffold/skills/dw-simplification/SKILL.md +12 -7
- package/scaffold/skills/dw-simplification/references/deep-modules.md +105 -0
- package/scaffold/skills/dw-source-grounding/SKILL.md +1 -1
- package/scaffold/skills/dw-testing-discipline/SKILL.md +8 -6
- package/scaffold/skills/dw-testing-discipline/references/agent-guardrails.md +3 -3
- package/scaffold/skills/dw-testing-discipline/references/anti-patterns.md +2 -2
- package/scaffold/skills/dw-testing-discipline/references/core-rules.md +1 -1
- package/scaffold/skills/dw-testing-discipline/references/flaky-discipline.md +3 -3
- package/scaffold/skills/dw-testing-discipline/references/patterns.md +1 -1
- package/scaffold/skills/dw-testing-discipline/references/playwright-recipes.md +1 -1
- package/scaffold/skills/dw-ui-discipline/SKILL.md +8 -6
- package/scaffold/skills/dw-ui-discipline/references/accessibility-floor.md +2 -2
- package/scaffold/skills/dw-ui-discipline/references/hard-gate.md +1 -1
- package/scaffold/skills/dw-ui-discipline/references/state-matrix.md +1 -1
- package/scaffold/skills/dw-ui-discipline/references/visual-slop.md +2 -2
- package/scaffold/skills/dw-verify/SKILL.md +4 -4
- package/scaffold/skills/humanizer/SKILL.md +1 -7
- package/scaffold/skills/remotion-best-practices/SKILL.md +3 -1
- package/scaffold/skills/security-review/SKILL.md +1 -1
- package/scaffold/skills/security-review/languages/csharp.md +1 -1
- package/scaffold/skills/security-review/languages/rust.md +1 -1
- package/scaffold/skills/security-review/languages/typescript.md +1 -1
- package/scaffold/skills/vercel-react-best-practices/SKILL.md +3 -1
- package/scaffold/templates-overrides-readme.md +3 -3
- package/scaffold/en/commands/dw-code-review.md +0 -386
- package/scaffold/en/commands/dw-create-prd.md +0 -148
- package/scaffold/en/commands/dw-create-tasks.md +0 -201
- package/scaffold/en/commands/dw-create-techspec.md +0 -210
- package/scaffold/en/commands/dw-deep-research.md +0 -418
- package/scaffold/en/commands/dw-deps-audit.md +0 -327
- package/scaffold/en/commands/dw-fix-qa.md +0 -152
- package/scaffold/en/commands/dw-map-codebase.md +0 -125
- package/scaffold/en/commands/dw-refactoring-analysis.md +0 -340
- package/scaffold/en/commands/dw-revert-task.md +0 -114
- package/scaffold/en/commands/dw-review-implementation.md +0 -349
- package/scaffold/en/commands/dw-run-plan.md +0 -300
- package/scaffold/en/commands/dw-run-qa.md +0 -497
- package/scaffold/en/commands/dw-run-task.md +0 -209
- package/scaffold/en/commands/dw-security-check.md +0 -271
- package/scaffold/pt-br/commands/dw-code-review.md +0 -366
- package/scaffold/pt-br/commands/dw-create-prd.md +0 -148
- package/scaffold/pt-br/commands/dw-create-tasks.md +0 -201
- package/scaffold/pt-br/commands/dw-create-techspec.md +0 -208
- package/scaffold/pt-br/commands/dw-deep-research.md +0 -172
- package/scaffold/pt-br/commands/dw-deps-audit.md +0 -327
- package/scaffold/pt-br/commands/dw-fix-qa.md +0 -152
- package/scaffold/pt-br/commands/dw-map-codebase.md +0 -125
- package/scaffold/pt-br/commands/dw-refactoring-analysis.md +0 -340
- package/scaffold/pt-br/commands/dw-revert-task.md +0 -114
- package/scaffold/pt-br/commands/dw-review-implementation.md +0 -337
- package/scaffold/pt-br/commands/dw-run-plan.md +0 -296
- package/scaffold/pt-br/commands/dw-run-qa.md +0 -495
- package/scaffold/pt-br/commands/dw-run-task.md +0 -208
- 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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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
|
-
| "
|
|
15
|
-
| "
|
|
16
|
-
| "
|
|
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
|
-
| "
|
|
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
|
-
| "
|
|
24
|
-
| "
|
|
25
|
-
| "
|
|
26
|
-
| "
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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
|
|
28
|
-
- `/dw-code-
|
|
29
|
-
- `/dw-
|
|
30
|
-
- `/dw-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
19
|
-
| "A implementacao esta obviamente correta" | `/dw-review-
|
|
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-
|
|
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-
|
|
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
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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
|
|
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
|
|
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-
|
|
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-
|
|
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-
|
|
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
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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
|
|