@brunosps00/dev-workflow 0.0.5 → 0.0.7

package/bin/dev-workflow.js

@@ -18,16 +18,17 @@ const HELP_TEXT = `
 
   Usage:
     npx dev-workflow init [--force] [--lang=en|pt-br]
-    npx dev-workflow update [--force]
+    npx dev-workflow update [--lang=en|pt-br]
     npx dev-workflow help
 
   Commands:
-    init      Scaffold .dw/commands, templates, rules, and platform wrappers
-    update    Update commands and templates (preserves rules and tasks)
+    init      Scaffold .dw/ (commands, templates, references, scripts, skills, rules, MCPs)
+    update    Update managed files (commands, templates, references, scripts, skills, wrappers, MCPs)
+              Preserves: .dw/rules/, .dw/spec/, user data
     help      Show this help message
 
   Options:
-    --force        Overwrite existing files
+    --force        Overwrite existing files (init only; update always overwrites managed files)
     --lang=LANG    Set language without prompt (en or pt-br)
 
   Examples:
@@ -35,6 +36,7 @@ const HELP_TEXT = `
     npx dev-workflow init --lang=en        # English, no prompt
     npx dev-workflow init --lang=pt-br     # Portuguese, no prompt
     npx dev-workflow init --force          # Overwrite existing files
+    npx dev-workflow update --lang=en      # Update all managed files to latest version
 `;
 
 async function main() {

package/lib/constants.js

@@ -81,6 +81,17 @@ Source of truth: \`.dw/commands/${name}.md\`
 Read and follow the complete instructions in the command file above.
 This wrapper exists for tool discovery. All logic lives in .dw/commands/.
 </system_instructions>
+`,
+  },
+  opencode: {
+    dir: '.opencode/commands',
+    flat: true,
+    wrapperTemplate: (name, description) => `---
+description: ${description}
+---
+Follow ALL instructions in @.dw/commands/${name}.md
+
+$ARGUMENTS
 `,
   },
 };

package/lib/init.js

@@ -11,6 +11,10 @@ async function run({ force = false, lang = null, mode = 'init' }) {
   const projectRoot = process.cwd();
   const isUpdate = mode === 'update';
 
+  // In update mode, always overwrite managed files (commands, templates, references, scripts, skills)
+  // but never touch user files (rules, spec, MCPs)
+  const managedForce = isUpdate ? true : force;
+
   console.log(`\n  dev-workflow ${isUpdate ? 'update' : 'init'}`);
   console.log(`  ${'='.repeat(40)}\n`);
 
@@ -31,7 +35,7 @@ async function run({ force = false, lang = null, mode = 'init' }) {
   const cmdResults = copyDir(
     path.join(langDir, 'commands'),
     path.join(projectRoot, '.dw', 'commands'),
-    force
+    managedForce
   );
   totalCreated += cmdResults.created;
   totalSkipped += cmdResults.skipped;
@@ -43,7 +47,7 @@ async function run({ force = false, lang = null, mode = 'init' }) {
   const tplResults = copyDir(
     path.join(langDir, 'templates'),
     path.join(projectRoot, '.dw', 'templates'),
-    force
+    managedForce
   );
   totalCreated += tplResults.created;
   totalSkipped += tplResults.skipped;
@@ -57,7 +61,7 @@ async function run({ force = false, lang = null, mode = 'init' }) {
     const refsResults = copyDir(
       refsSrcDir,
       path.join(projectRoot, '.dw', 'references'),
-      force
+      managedForce
     );
     totalCreated += refsResults.created;
     totalSkipped += refsResults.skipped;
@@ -72,7 +76,7 @@ async function run({ force = false, lang = null, mode = 'init' }) {
     const scriptsResults = copyDir(
       scriptsSrcDir,
       path.join(projectRoot, '.dw', 'scripts'),
-      force
+      managedForce
     );
     totalCreated += scriptsResults.created;
     totalSkipped += scriptsResults.skipped;
@@ -102,20 +106,40 @@ async function run({ force = false, lang = null, mode = 'init' }) {
     ensureDir(path.join(projectRoot, '.dw', 'spec'));
   }
 
-  // 6-8. Generate platform wrappers
+  // 5.5. Copy bundled skills to .agents/skills/
+  const skillsSrcDir = path.join(SCAFFOLD_DIR, 'skills');
+  if (require('fs').existsSync(skillsSrcDir)) {
+    console.log('  Bundled skills:');
+    const skillsResults = copyDir(
+      skillsSrcDir,
+      path.join(projectRoot, '.agents', 'skills'),
+      managedForce
+    );
+    totalCreated += skillsResults.created;
+    totalSkipped += skillsResults.skipped;
+    totalOverwritten += skillsResults.overwritten;
+    console.log(`    ${skillsResults.created} created, ${skillsResults.skipped} skipped, ${skillsResults.overwritten} overwritten\n`);
+  }
+
+  // 6. Create .opencode/package.json
+  const opencodePackageJson = path.join(projectRoot, '.opencode', 'package.json');
+  const opencodeContent = JSON.stringify({ dependencies: { '@opencode-ai/plugin': '1.2.17' } }, null, 2) + '\n';
+  const opcStatus = writeFile(opencodePackageJson, opencodeContent, false);
+  if (opcStatus === 'created') totalCreated++;
+  else totalSkipped++;
+
+  // 7. Generate platform wrappers
   console.log('  Platform wrappers:');
-  const wrapperResults = generateWrappers(projectRoot, commands, force);
+  const wrapperResults = generateWrappers(projectRoot, commands, managedForce);
   totalCreated += wrapperResults.created;
   totalSkipped += wrapperResults.skipped;
   totalOverwritten += wrapperResults.overwritten;
   console.log();
 
-  // 9. Install MCPs
-  if (!isUpdate) {
-    console.log('  MCP Servers:');
-    const mcpResults = installMCPs(projectRoot);
-    console.log(`    ${mcpResults.added} configured, ${mcpResults.skipped} already present\n`);
-  }
+  // 9. Install MCPs (always, including updates)
+  console.log('  MCP Servers:');
+  const mcpResults = installMCPs(projectRoot);
+  console.log(`    ${mcpResults.added} configured, ${mcpResults.skipped} already present\n`);
 
   // 10. Summary
   console.log(`  ${'='.repeat(40)}`);

package/lib/wrappers.js

@@ -7,8 +7,14 @@ function generateWrappers(projectRoot, commands, force = false) {
 
   for (const [platformName, platform] of Object.entries(PLATFORMS)) {
     for (const cmd of commands) {
-      const skillDir = path.join(projectRoot, platform.dir, cmd.name);
-      const skillFile = path.join(skillDir, 'SKILL.md');
+      let skillFile;
+      if (platform.flat) {
+        // Flat format: .opencode/commands/dw-brainstorm.md
+        skillFile = path.join(projectRoot, platform.dir, `${cmd.name}.md`);
+      } else {
+        // Directory format: .claude/skills/dw-brainstorm/SKILL.md
+        skillFile = path.join(projectRoot, platform.dir, cmd.name, 'SKILL.md');
+      }
       const content = platform.wrapperTemplate(cmd.name, cmd.description);
       const status = writeFile(skillFile, content, force);
       results[status]++;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brunosps00/dev-workflow",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "AI-driven development workflow commands for any project. Scaffolds a complete PRD-to-PR pipeline with multi-platform AI assistant support.",
   "bin": {
     "dev-workflow": "./bin/dev-workflow.js"

package/scaffold/pt-br/commands/dw-analyze-project.md

@@ -39,7 +39,7 @@ Analisar o repositório atual e gerar automaticamente:
 - `.dw/rules/index.md` - Visão geral do ecossistema/projeto
 - `.dw/rules/[projeto].md` - Rules detalhadas por projeto/módulo
 
-Estes arquivos serão utilizados por todos os outros comandos do workflow (criar-prd, criar-techspec, executar-task, code-review, etc.).
+Estes arquivos serão utilizados por todos os outros comandos do workflow (dw-create-prd, dw-create-techspec, dw-run-task, code-review, etc.).
 
 ## Variáveis de Entrada
 
@@ -445,7 +445,7 @@ Gerar este arquivo quando 2+ projetos forem detectados.
 ```markdown
 # Integrações — [Nome do Workspace]
 
-> Auto-gerado por /analisar-projeto em [data]
+> Auto-gerado por /dw-analyze-project em [data]
 
 ## Grafo de Dependências
 
@@ -663,7 +663,7 @@ packages/auth → packages/db
 ## Exemplo de Uso
 
 ```
-/analisar-projeto
+/dw-analyze-project
 ```
 
 Isso escaneará o repositório atual e gerará os arquivos de rules automaticamente.

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

@@ -46,9 +46,9 @@
     Neste modo:
     1. Segue o fluxo normal de perguntas e análise
     2. Em vez de executar, gera documento em `.dw/spec/dw-bugfix-[nome]/prd.md`
-    3. O arquivo é nomeado `prd.md` para manter compatibilidade com o pipeline criar-techspec/criar-tasks
-    4. Depois o usuário pode rodar `/criar-techspec .dw/spec/dw-bugfix-[nome]`
-    5. E então `/criar-tasks .dw/spec/dw-bugfix-[nome]`
+    3. O arquivo é nomeado `prd.md` para manter compatibilidade com o pipeline dw-create-techspec/dw-create-tasks
+    4. Depois o usuário pode rodar `/dw-create-techspec .dw/spec/dw-bugfix-[nome]`
+    5. E então `/dw-create-tasks .dw/spec/dw-bugfix-[nome]`
 
     ## Fluxo de Trabalho
 
@@ -107,7 +107,7 @@
     ---
 
     **Deseja que eu inicie o fluxo de criação de PRD?**
-    - `sim` - Vou seguir `.dw/commands/criar-prd.md` para esta feature
+    - `sim` - Vou seguir `.dw/commands/dw-create-prd.md` para esta feature
     - `não, é bug` - Me explique melhor por que considera um bug
     - `não, cancelar` - Encerrar
     ```
@@ -234,7 +234,7 @@
     3. Salvar como: `.dw/spec/dw-bugfix-[nome-do-bug]/prd.md` (usa nome `prd.md` para compatibilidade com pipeline)
 
     **IMPORTANTE:** O arquivo deve ser nomeado `prd.md` para que os comandos
-    `/criar-techspec` e `/criar-tasks` funcionem sem modificação.
+    `/dw-create-techspec` e `/dw-create-tasks` funcionem sem modificação.
 
     ## Tipos de Tarefa (permitidos em bugfix)
 
@@ -300,7 +300,7 @@
 
     <critical>
     PRIMEIRO: Avalie se é bug ou feature (Passo 0).
-    Se for feature: Redirecione para criar-prd.md.
+    Se for feature: Redirecione para dw-create-prd.md.
     NUNCA pule as 3 perguntas.
     NUNCA execute tarefas sem aprovação.
     SEMPRE numere as tarefas sequencialmente (1, 2, 3...).

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

@@ -36,8 +36,8 @@ Este é o **Nível 3 de Revisão**:
 
 | Nível | Comando | Quando | Relatório |
 |-------|---------|--------|-----------|
-| 1 | *(embutido no /executar-task)* | Após cada task | Não |
-| 2 | `/revisar-implementacao` | Após todas tasks | Output terminal |
+| 1 | *(embutido no /dw-run-task)* | Após cada task | Não |
+| 2 | `/dw-review-implementation` | Após todas tasks | Output terminal |
 | **3** | **`/dw-code-review`** | **Antes do PR** | **`code-review.md`** |
 
 O Nível 3 inclui TUDO do Nível 2 (PRD compliance) mais análise de qualidade de código.

package/scaffold/pt-br/commands/dw-create-tasks.md

@@ -57,7 +57,7 @@
     - Definir escopo e entregáveis claros para cada tarefa
     - **Incluir testes unitários como subtarefas OBRIGATÓRIAS** dentro de cada tarefa de backend
     - Cada task deve listar explicitamente os RFs que cobre (ex: "Cobre: RF1.1, RF1.2")
-    - **Cada task termina com commit** (sem push, push apenas no /gerar-pr)
+    - **Cada task termina com commit** (sem push, push apenas no /dw-generate-pr)
 
     ## Cobertura End-to-End (OBRIGATÓRIO)
 
@@ -92,10 +92,10 @@
     ## Workflow por Task
 
     Cada task segue o fluxo:
-    1. `/executar-task` - Implementa a task
+    1. `/dw-run-task` - Implementa a task
     2. Testes unitários incluídos na implementação
     3. Commit automático ao final da task (sem push)
-    4. Próxima task ou `/gerar-pr [branch-alvo]` quando todas concluídas
+    4. Próxima task ou `/dw-generate-pr [branch-alvo]` quando todas concluídas
 
     ## Especificações de Saída
 
@@ -134,7 +134,7 @@
     ## Workflow
     1. Implementar task + testes unitários
     2. Commit ao final de cada task
-    3. /gerar-pr [branch-alvo] quando todas tasks concluídas
+    3. /dw-generate-pr [branch-alvo] quando todas tasks concluídas
     ```
 
     Após completar a análise e gerar todos os arquivos necessários, apresente os resultados ao usuário e aguarde confirmação para prosseguir com a implementação.

package/scaffold/pt-br/commands/dw-generate-pr.md

@@ -12,12 +12,12 @@
     ## Uso
 
     ```
-    /gerar-pr [branch-alvo]
+    /dw-generate-pr [branch-alvo]
     ```
 
     Exemplos:
-    - `/gerar-pr main`
-    - `/gerar-pr develop`
+    - `/dw-generate-pr main`
+    - `/dw-generate-pr develop`
 
     ## Objetivo
 

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

@@ -10,8 +10,8 @@ Você é um assistente de ajuda do workspace. Quando invocado, apresente ao usu
 
 ## Comportamento
 
-- Se invocado sem argumentos (`/ajuda`): mostre o guia completo abaixo
-- Se invocado com argumento (`/ajuda criar-prd`): mostre apenas a seção detalhada daquele comando
+- Se invocado sem argumentos (`/dw-help`): mostre o guia completo abaixo
+- Se invocado com argumento (`/dw-help dw-create-prd`): mostre apenas a seção detalhada daquele comando
 
 ---
 
@@ -25,14 +25,14 @@ Este workspace utiliza um sistema de comandos AI que automatiza o ciclo completo
 
 ```
 ┌─────────────┐     ┌────────────────┐     ┌──────────────┐
-│ /criar-prd  │────>│/criar-techspec │────>│ /criar-tasks │
+│ /dw-create-prd  │────>│/dw-create-techspec │────>│ /dw-create-tasks │
 │ (O QUÊ)     │     │ (COMO)         │     │ (QUANDO)     │
 └─────────────┘     └────────────────┘     └──────┬───────┘
                                                    │
                                      ┌─────────────┴─────────────┐
                                      ▼                           ▼
                             ┌────────────────┐         ┌─────────────────┐
-                            │ /executar-task  │         │ /executar-plano │
+                            │ /dw-run-task  │         │ /dw-run-plan │
                             │ (uma por vez)   │         │ (todas auto)    │
                             └───────┬────────┘         └────────┬────────┘
                                     │                           │
@@ -56,7 +56,7 @@ Este workspace utiliza um sistema de comandos AI que automatiza o ciclo completo
                               ┌──────────────┼──────────────┐
                               ▼              ▼              ▼
                     ┌──────────────┐ ┌──────────────┐ ┌─────────────────────┐
-                    │/executar-qa  │ │/revisar-impl.│ │ /dw-code-review        │
+                    │/dw-run-qa  │ │/dw-review-impl.│ │ /dw-code-review        │
                     │(QA visual)   │ │(PRD compliance│ │ (code review formal)│
                     └──────────────┘ │ Nível 2)     │ │ (Nível 3)           │
                                      └──────────────┘ └─────────────────────┘
@@ -64,7 +64,7 @@ Este workspace utiliza um sistema de comandos AI que automatiza o ciclo completo
                               ┌───────────────┴───────────────┐
                               ▼                               ▼
                     ┌──────────────┐                 ┌────────────────┐
-                    │ /dw-commit      │                 │ /gerar-pr      │
+                    │ /dw-commit      │                 │ /dw-generate-pr      │
                     │ (um projeto) │                 │ (push + PR)    │
                     └──────────────┘                 └────────────────┘
 ```
@@ -76,24 +76,24 @@ Este workspace utiliza um sistema de comandos AI que automatiza o ciclo completo
 | Comando | O que faz | Input | Output |
 |---------|-----------|-------|--------|
 | `/dw-brainstorm` | Facilita ideação estruturada antes do PRD ou da implementação | Problema, ideia ou contexto | Opções + trade-offs + recomendação |
-| `/criar-prd` | Cria PRD com min. 7 perguntas de clarificação | Descrição da feature | `.dw/spec/prd-[nome]/prd.md` |
-| `/criar-techspec` | Cria especificação técnica a partir do PRD | Path do PRD | `.dw/spec/prd-[nome]/techspec.md` |
-| `/criar-tasks` | Quebra PRD+TechSpec em tasks (max 2 FRs/task) | Path do PRD | `.dw/spec/prd-[nome]/tasks.md` + `*_task.md` |
+| `/dw-create-prd` | Cria PRD com min. 7 perguntas de clarificação | Descrição da feature | `.dw/spec/prd-[nome]/prd.md` |
+| `/dw-create-techspec` | Cria especificação técnica a partir do PRD | Path do PRD | `.dw/spec/prd-[nome]/techspec.md` |
+| `/dw-create-tasks` | Quebra PRD+TechSpec em tasks (max 2 FRs/task) | Path do PRD | `.dw/spec/prd-[nome]/tasks.md` + `*_task.md` |
 
 ### Execução
 
 | Comando | O que faz | Input | Output |
 |---------|-----------|-------|--------|
-| `/executar-task` | Implementa UMA task + validação Nível 1 + commit | Path do PRD | Código + commit |
-| `/executar-plano` | Executa TODAS tasks + revisão final Nível 2 | Path do PRD | Código + commits + relatório |
+| `/dw-run-task` | Implementa UMA task + validação Nível 1 + commit | Path do PRD | Código + commit |
+| `/dw-run-plan` | Executa TODAS tasks + revisão final Nível 2 | Path do PRD | Código + commits + relatório |
 | `/dw-bugfix` | Analisa e corrige bugs (triagem bug vs feature) | Target + descrição | Fix + commit OU PRD (se feature) |
-| `/corrigir-qa` | Corrige bugs documentados no QA e retesta com evidências | Path do PRD | Código + `QA/bugs.md` + `QA/qa-report.md` atualizados |
+| `/dw-fix-qa` | Corrige bugs documentados no QA e retesta com evidências | Path do PRD | Código + `QA/bugs.md` + `QA/qa-report.md` atualizados |
 
 ### Análise e Pesquisa
 
 | Comando | O que faz | Input | Output |
 |---------|-----------|-------|--------|
-| `/analisar-projeto` | Escaneia o repo e gera rules do projeto automaticamente | (nenhum) | `.dw/rules/index.md` + `.dw/rules/[projeto].md` |
+| `/dw-analyze-project` | Escaneia o repo e gera rules do projeto automaticamente | (nenhum) | `.dw/rules/index.md` + `.dw/rules/[projeto].md` |
 | `/dw-deep-research` | Pesquisa profunda com citações e verificação multi-fonte | Tópico ou pergunta | Relatório com citações em Markdown/HTML |
 | `/dw-functional-doc` | Mapeia telas, fluxos e módulos em dossiê funcional com cobertura E2E | URL/rota alvo + projeto | `.dw/flows/<projeto>/<slug>/` com docs, scripts, evidências |
 
@@ -101,14 +101,14 @@ Este workspace utiliza um sistema de comandos AI que automatiza o ciclo completo
 
 | Nível | Comando | Quando | Gera Relatório? |
 |-------|---------|--------|-----------------|
-| **1** | *(embutido no /executar-task)* | Após cada task | Não (output no terminal) |
-| **2** | `/revisar-implementacao` | Após todas tasks / manual | Sim (output formatado) |
+| **1** | *(embutido no /dw-run-task)* | Após cada task | Não (output no terminal) |
+| **2** | `/dw-review-implementation` | Após todas tasks / manual | Sim (output formatado) |
 | **3** | `/dw-code-review` | Antes do PR / manual | Sim (`code-review.md`) |
 
 | Comando | O que faz | Input | Output |
 |---------|-----------|-------|--------|
-| `/executar-qa` | QA visual com Playwright MCP + acessibilidade | Path do PRD | `QA/qa-report.md` + `QA/screenshots/` |
-| `/revisar-implementacao` | Compara PRD vs código (FRs, endpoints, tasks) | Path do PRD | Relatório de gaps |
+| `/dw-run-qa` | QA visual com Playwright MCP + acessibilidade | Path do PRD | `QA/qa-report.md` + `QA/screenshots/` |
+| `/dw-review-implementation` | Compara PRD vs código (FRs, endpoints, tasks) | Path do PRD | Relatório de gaps |
 | `/dw-code-review` | Code review formal (qualidade, rules, testes) | Path do PRD | `code-review.md` |
 | `/dw-refactoring-analysis` | Auditoria de code smells e oportunidades de refatoração (catálogo Fowler) | Path do PRD | `refactoring-analysis.md` |
 
@@ -117,68 +117,68 @@ Este workspace utiliza um sistema de comandos AI que automatiza o ciclo completo
 | Comando | O que faz | Input | Output |
 |---------|-----------|-------|--------|
 | `/dw-commit` | Commit semântico (Conventional Commits) | - | Commit |
-| `/gerar-pr` | Push + cria PR + copia body + abre URL | Branch alvo | PR no GitHub |
+| `/dw-generate-pr` | Push + cria PR + copia body + abre URL | Branch alvo | PR no GitHub |
 
 ### Utilitários
 
 | Comando | O que faz | Input | Output |
 |---------|-----------|-------|--------|
-| `/ajuda` | Este guia de comandos | (opcional) comando | Este documento |
+| `/dw-help` | Este guia de comandos | (opcional) comando | Este documento |
 
 ## Fluxos Comuns
 
 ### Nova Feature (Completo)
 ```bash
 /dw-brainstorm "ideia inicial"                    # 0. Explora opções e trade-offs
-/criar-prd                                    # 1. Descreve a funcionalidade
-/criar-techspec .dw/spec/prd-nome             # 2. Gera spec técnica
-/criar-tasks .dw/spec/prd-nome                # 3. Quebra em tasks
-/executar-plano .dw/spec/prd-nome             # 4. Executa todas (inclui Nível 1+2)
+/dw-create-prd                                    # 1. Descreve a funcionalidade
+/dw-create-techspec .dw/spec/prd-nome             # 2. Gera spec técnica
+/dw-create-tasks .dw/spec/prd-nome                # 3. Quebra em tasks
+/dw-run-plan .dw/spec/prd-nome             # 4. Executa todas (inclui Nível 1+2)
 /dw-refactoring-analysis .dw/spec/prd-nome        # 5. Auditoria de code smells (opcional)
 /dw-code-review .dw/spec/prd-nome               # 6. Code review formal (Nível 3)
-/gerar-pr main                                # 7. Cria PR
+/dw-generate-pr main                                # 7. Cria PR
 ```
 
 ### Nova Feature (Incremental)
 ```bash
-/criar-prd                                    # 1. PRD
-/criar-techspec .dw/spec/prd-nome             # 2. TechSpec
-/criar-tasks .dw/spec/prd-nome                # 3. Tasks
-/executar-task .dw/spec/prd-nome              # 4. Task 1 (com Nível 1)
-/executar-task .dw/spec/prd-nome              # 5. Task 2 (com Nível 1)
+/dw-create-prd                                    # 1. PRD
+/dw-create-techspec .dw/spec/prd-nome             # 2. TechSpec
+/dw-create-tasks .dw/spec/prd-nome                # 3. Tasks
+/dw-run-task .dw/spec/prd-nome              # 4. Task 1 (com Nível 1)
+/dw-run-task .dw/spec/prd-nome              # 5. Task 2 (com Nível 1)
 # ... repete para cada task
-/revisar-implementacao .dw/spec/prd-nome      # 6. Revisão PRD (Nível 2)
+/dw-review-implementation .dw/spec/prd-nome      # 6. Revisão PRD (Nível 2)
 /dw-code-review .dw/spec/prd-nome               # 7. Code review (Nível 3)
-/gerar-pr main                                # 8. PR
+/dw-generate-pr main                                # 8. PR
 ```
 
 ### Bug Simples
 ```bash
 /dw-bugfix meu-projeto "descrição do bug"        # Analisa e corrige
 /dw-commit                                       # Commit da correção
-/gerar-pr main                                # PR
+/dw-generate-pr main                                # PR
 ```
 
 ### Bug Complexo
 ```bash
 /dw-bugfix meu-projeto "descrição" --análise     # Gera documento de análise
-/criar-techspec .dw/spec/dw-bugfix-nome          # TechSpec do fix
-/criar-tasks .dw/spec/dw-bugfix-nome             # Tasks do fix
-/executar-plano .dw/spec/dw-bugfix-nome          # Executa tudo
-/gerar-pr main                                # PR
+/dw-create-techspec .dw/spec/dw-bugfix-nome          # TechSpec do fix
+/dw-create-tasks .dw/spec/dw-bugfix-nome             # Tasks do fix
+/dw-run-plan .dw/spec/dw-bugfix-nome          # Executa tudo
+/dw-generate-pr main                                # PR
 ```
 
 ### QA Visual (Frontend)
 ```bash
-/executar-qa .dw/spec/prd-nome                # QA com Playwright MCP
+/dw-run-qa .dw/spec/prd-nome                # QA com Playwright MCP
 # Se encontrar bugs:
-/corrigir-qa .dw/spec/prd-nome               # Corrige + retesta ciclo completo
+/dw-fix-qa .dw/spec/prd-nome               # Corrige + retesta ciclo completo
 ```
 
 ### Onboarding em Projeto Novo
 ```bash
-/analisar-projeto                             # Escaneia e gera rules automaticamente
-/ajuda                                        # Mostra comandos disponíveis
+/dw-analyze-project                             # Escaneia e gera rules automaticamente
+/dw-help                                        # Mostra comandos disponíveis
 ```
 
 ## Estrutura de Arquivos
@@ -215,7 +215,7 @@ workspace/
 │   ├── scripts/               # Scripts utilitários
 │   │   └── functional-doc/    # Geração de dossiê & runner Playwright
 │   ├── references/            # Materiais de referência e documentos externos
-│   ├── rules/                 # Regras por projeto (gerado por /analisar-projeto)
+│   ├── rules/                 # Regras por projeto (gerado por /dw-analyze-project)
 │   │   ├── index.md
 │   │   └── [projeto].md
 │   └── tasks/                 # PRDs e tasks em andamento
@@ -228,21 +228,21 @@ workspace/
 
 ## Dúvidas Frequentes
 
-**Q: Qual a diferença entre `/executar-task` e `/executar-plano`?**
-- `/executar-task` executa UMA task com controle manual entre cada uma
-- `/executar-plano` executa TODAS automaticamente com revisão final
+**Q: Qual a diferença entre `/dw-run-task` e `/dw-run-plan`?**
+- `/dw-run-task` executa UMA task com controle manual entre cada uma
+- `/dw-run-plan` executa TODAS automaticamente com revisão final
 
-**Q: Preciso rodar `/revisar-implementacao` manualmente?**
-- Não se usar `/executar-plano` (já inclui). Sim se usar `/executar-task` incremental.
+**Q: Preciso rodar `/dw-review-implementation` manualmente?**
+- Não se usar `/dw-run-plan` (já inclui). Sim se usar `/dw-run-task` incremental.
 
-**Q: Quando usar `/dw-code-review` vs `/revisar-implementacao`?**
-- `/revisar-implementacao` (Nível 2): Verifica se os FRs do PRD foram implementados
+**Q: Quando usar `/dw-code-review` vs `/dw-review-implementation`?**
+- `/dw-review-implementation` (Nível 2): Verifica se os FRs do PRD foram implementados
 - `/dw-code-review` (Nível 3): Além disso, analisa qualidade de código e gera relatório formal
 
 **Q: O `/dw-bugfix` sempre corrige direto?**
-- Não. Ele faz triagem. Se for feature (não bug), redireciona para `/criar-prd`. Se for bug complexo, pode gerar documento de análise com `--análise`.
+- Não. Ele faz triagem. Se for feature (não bug), redireciona para `/dw-create-prd`. Se for bug complexo, pode gerar documento de análise com `--análise`.
 
-**Q: Preciso rodar `/analisar-projeto` antes de tudo?**
+**Q: Preciso rodar `/dw-analyze-project` antes de tudo?**
 - Sim, é recomendado para projetos novos. Ele gera as rules em `.dw/rules/` que todos os outros comandos utilizam.
 
 </system_instructions>

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

@@ -17,11 +17,11 @@
 
     | Nível | Comando | Quando | Relatório |
     |-------|---------|--------|-----------|
-    | 1 | *(embutido no /executar-task)* | Após cada task | Não |
-    | **2** | **`/revisar-implementacao`** | **Após todas tasks** | **Output formatado** |
+    | 1 | *(embutido no /dw-run-task)* | Após cada task | Não |
+    | **2** | **`/dw-review-implementation`** | **Após todas tasks** | **Output formatado** |
     | 3 | `/dw-code-review` | Antes do PR | `code-review.md` |
 
-    Este comando é chamado automaticamente pelo `/executar-plano` ao final de todas as tasks, mas também pode ser executado manualmente.
+    Este comando é chamado automaticamente pelo `/dw-run-plan` ao final de todas as tasks, mas também pode ser executado manualmente.
 
     ## Variáveis de Entrada
 

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

@@ -19,7 +19,7 @@ Executar TODAS as tarefas pendentes de um projeto de forma sequencial e automát
 - Task Individual: `.dw/spec/prd-[nome-funcionalidade]/[num]_task.md`
 - PRD: `.dw/spec/prd-[nome-funcionalidade]/prd.md`
 - Tech Spec: `.dw/spec/prd-[nome-funcionalidade]/techspec.md`
-- Comando de Revisão: `.dw/commands/revisar-implementacao.md`
+- Comando de Revisão: `.dw/commands/dw-review-implementation.md`
 
 ## Processo de Execução
 
@@ -48,10 +48,10 @@ Para cada tarefa pendente (em ordem sequencial):
    - Ler o arquivo da task individual `[num]_task.md`
 
 2. **Executar a task**
-   - Seguir TODAS as instruções em `.dw/commands/executar-task.md`
+   - Seguir TODAS as instruções em `.dw/commands/dw-run-task.md`
    - Implementar a tarefa completamente
    - Garantir que todos os critérios de sucesso sejam atendidos
-   - A validação Nível 1 (critérios + testes + padrões) já está embutida no `executar-task.md`
+   - A validação Nível 1 (critérios + testes + padrões) já está embutida no `dw-run-task.md`
 
 3. **Marcar como concluída**
    - Atualizar `tasks.md` mudando `- [ ]` para `- [x]`
@@ -67,7 +67,7 @@ Para cada tarefa pendente (em ordem sequencial):
 Quando todas as tarefas estiverem concluídas:
 
 1. **Executar Revisão Geral**
-   - Seguir `.dw/commands/revisar-implementacao.md` para TODAS as tasks
+   - Seguir `.dw/commands/dw-review-implementation.md` para TODAS as tasks
    - Gerar relatório completo de gaps e recomendações
    - **Se 0 gaps e 100% implementado**: Pular para o Relatório Final com status "PLANO COMPLETO". NÃO entrar em plan mode, NÃO criar tasks adicionais.
 
@@ -136,7 +136,7 @@ Se uma tarefa FALHAR durante a execução:
 
 ## Regras Importantes
 
-<critical>SEMPRE leia e siga as instruções completas em `.dw/commands/executar-task.md` para CADA tarefa</critical>
+<critical>SEMPRE leia e siga as instruções completas em `.dw/commands/dw-run-task.md` para CADA tarefa</critical>
 
 <critical>NUNCA pule uma tarefa - execute-as SEQUENCIALMENTE na ordem definida</critical>
 
@@ -146,7 +146,7 @@ Se uma tarefa FALHAR durante a execução:
 
 <critical>Utilize o Context7 MCP para analisar a documentação da linguagem, frameworks e bibliotecas envolvidas na implementação</critical>
 
-<critical>A validação pós-task (Nível 1) já está embutida no `.dw/commands/executar-task.md` - NÃO execute revisão separada por task</critical>
+<critical>A validação pós-task (Nível 1) já está embutida no `.dw/commands/dw-run-task.md` - NÃO execute revisão separada por task</critical>
 
 <critical>Na revisão final, PERGUNTE ao usuário sobre CADA recomendação individualmente antes de implementar</critical>
 
@@ -229,7 +229,7 @@ Task concluída, commitada e marcada no tasks.md
 ## Exemplo de Uso
 
 ```
-/executar-plano .dw/spec/prd-minha-feature
+/dw-run-plan .dw/spec/prd-minha-feature
 ```
 
 Isso executará TODAS as tarefas pendentes do projeto, uma após a outra, com revisão após cada task e ciclo de revisão final interativo.
@@ -237,7 +237,7 @@ Isso executará TODAS as tarefas pendentes do projeto, uma após a outra, com re
 ## Notas Importantes
 
 - Este comando é ideal para execução automatizada de planos completos
-- Use `/executar-task` para executar apenas uma task de cada vez
+- Use `/dw-run-task` para executar apenas uma task de cada vez
 - Use `list-tasks` para ver o progresso sem executar
 - Sempre revise o plano antes de iniciar execução automática completa
 - Mantenha backups antes de executar planos grandes

package/scaffold/pt-br/commands/dw-run-task.md

@@ -172,12 +172,12 @@ git commit -m "feat([modulo]): [descrição concisa]
 - Add unit tests"
 ```
 
-**Nota**: O push será feito apenas no `/gerar-pr` ao final de todas as tasks.
+**Nota**: O push será feito apenas no `/dw-generate-pr` ao final de todas as tasks.
 
 <critical>Após completar a tarefa, marque como completa em tasks.md</critical>
 
 ## Próximos Passos
 
-- Se há mais tasks: `/executar-task [próxima-task]`
-- Se última task: `/gerar-pr [branch-alvo]` (ex: `/gerar-pr main`)
+- Se há mais tasks: `/dw-run-task [próxima-task]`
+- Se última task: `/dw-generate-pr [branch-alvo]` (ex: `/dw-generate-pr main`)
 </system_instructions>

package/scaffold/pt-br/templates/tasks-template.md

@@ -28,7 +28,7 @@ feat/prd-[nome-funcionalidade]
 ## Workflow
 
 Cada task segue o fluxo:
-1. `/executar-task [N]_task.md` - Implementa a task
+1. `/dw-run-task [N]_task.md` - Implementa a task
 2. Testes unitários incluídos na implementação
 3. Commit ao final da task (sem push)
-4. Próxima task ou `/gerar-pr [branch-alvo]` quando todas concluídas
+4. Próxima task ou `/dw-generate-pr [branch-alvo]` quando todas concluídas