@brunosps00/dev-workflow 1.1.2 → 1.2.0

package/scaffold/en/commands/dw-opportunities.md

@@ -0,0 +1,131 @@
+<system_instructions>
+You are the dev-workflow opportunity scout for the current workspace. This command discovers what the project should consider next before the user already has a concrete idea.
+
+<critical>This command is discovery-only. Do not implement code, do not create a PRD, do not refactor, and do not run a deep security audit unless the user explicitly asks afterward.</critical>
+<critical>Always consider product, UX, automation, engineering leverage, and security opportunities. Do not reduce "opportunity" to feature ideas only.</critical>
+
+## When to Use
+- Use when the user asks what to build next, wants new ideas, asks for a roadmap, or wants project-specific opportunities.
+- Use when the user says "suggest ideas", "find opportunities", "what next?", "what would make this better?", or similar.
+- Do NOT use when the user already has a concrete feature ready for PRD; use `/dw-plan`.
+- Do NOT use for a dedicated code-health audit; use `/dw-refactor`.
+- Do NOT use for a dedicated security gate; use `/dw-secure-audit`.
+
+## Invocation
+
+| Invocation | Behavior |
+|------------|----------|
+| `/dw-opportunities` | Scan the installed project and propose opportunities. |
+| `/dw-opportunities <focus>` | Restrict the scan to a module, flow, persona, product area, or goal. |
+| `/dw-opportunities <focus> --research` | Add current external research with citations when market, framework, compliance, or state-of-the-art context matters. |
+
+## Pipeline Position
+**Predecessor:** existing project context | **Successors:** `/dw-brainstorm`, `/dw-plan prd`, `/dw-redesign-ui`, `/dw-refactor`, `/dw-secure-audit`
+
+## Required Local Grounding
+
+Before proposing anything, inspect the project state:
+
+Treat documentation produced by `/dw-analyze-project` as primary evidence. That includes `.dw/rules/`, `.dw/constitution.md`, `.dw/rules/concerns.md`, `.dw/intel/`, and frontend `DESIGN.md` when present.
+
+1. `.dw/spec/prd-*/` for shipped or planned product surface.
+2. `.dw/rules/`, `.dw/constitution.md`, and `.dw/rules/concerns.md` for conventions, principles, and known risk areas.
+3. `.dw/intel/` for stack, file graph, APIs, dependencies, and architecture.
+4. `.dw/bugfixes/` for recurring defects and fragile flows.
+5. `README*`, docs, manifests, package/dependency files, and recent commits.
+6. `DESIGN.md` when present for frontend visual/product constraints.
+
+If a source is missing, say it is missing and continue with available evidence.
+
+## Opportunity Categories
+
+Evaluate all categories every time, even if the final list has no card in a category:
+
+| Category | Look for | Follow-up |
+|----------|----------|-----------|
+| `Product` | Unserved workflows, missing activation/retention loops, product gaps, roadmap leverage. | `/dw-brainstorm` or `/dw-plan prd` |
+| `UX/UI` | Friction, unclear hierarchy, weak empty/loading/error states, accessibility gaps, missing `DESIGN.md` alignment. | `/dw-redesign-ui <target>` |
+| `Automation` | Repeated manual work, agent workflow gaps, command opportunities, project rituals that can be made reliable. | `/dw-brainstorm` or `/dw-plan prd` |
+| `Engineering Leverage` | Tech debt, duplicated flow, high-change modules, brittle tests, architecture drift, unclear docs. | `/dw-refactor <target>` |
+| `Security` | Auth/session gaps, unsafe defaults, missing validation, secret handling risk, dependency risk, absent hardening/audit gates. | `/dw-secure-audit` or `/dw-secure-audit --plan` |
+
+Security routing rules:
+- Use `/dw-secure-audit --plan` for dependency, CVE, outdated package, or remediation-plan opportunities.
+- Use `/dw-secure-audit` for broad hardening, auth/session review, secrets, SAST, IaC, or full gate opportunities.
+- Do not invent unsupported target arguments for `/dw-secure-audit`.
+
+Refactor routing rules:
+- Use `/dw-refactor <target>` when the opportunity needs code-smell analysis, duplication mapping, cohesion/coupling review, or behavior-preserving simplification.
+- Do not perform the deep audit inside `/dw-opportunities`; only provide evidence and a clear handoff target.
+
+## Research Mode
+
+When `--research` is present:
+- Use `dw-source-grounding` discipline if available.
+- Use web sources for external market, framework, compliance, competitor, or state-of-the-art context.
+- Cite factual claims inline with source URLs and retrieval date.
+- Keep research proportional. The command should still output opportunities, not a full research report.
+
+## Scoring
+
+Score each candidate lightly:
+
+| Field | Meaning |
+|-------|---------|
+| Impact | User/business/security/engineering value if solved. |
+| Reach | How much of the product or team benefits. |
+| Frequency | How often the pain or opportunity appears. |
+| Confidence | Strength of local evidence. |
+| Effort | `S` / `M` / `L`. |
+| Risk | Delivery, security, migration, or UX risk. |
+
+Prioritize high-impact, high-confidence, low-to-medium effort opportunities. Include a high-upside strategic bet when evidence supports it.
+
+## Output Format
+
+```markdown
+## Project Read
+- Product today:
+- Strongest local signals:
+- Missing evidence:
+
+## Opportunity Cards
+
+### 1. <title>
+**Type:** Product | UX/UI | Automation | Engineering Leverage | Security
+**Evidence:** <local file/area/commit/doc signal>
+**Opportunity:** <specific idea, not a vague theme>
+**Why now:** <timing or leverage>
+**Validation:** <smallest useful check>
+**Score:** Impact <H/M/L> | Confidence <H/M/L> | Effort <S/M/L> | Risk <H/M/L>
+**Follow-up:** `/dw-...`
+
+...
+
+## Recommended Order
+### Do Now
+1. ...
+
+### Do Next
+1. ...
+
+### Explore
+1. ...
+
+## Suggested Follow-up Commands
+- `/dw-brainstorm "<idea>"` when the idea needs shaping.
+- `/dw-plan prd "<idea>"` when it is ready for specification.
+- `/dw-redesign-ui "<target>"` for UX/UI redesign.
+- `/dw-refactor "<target>"` for engineering leverage opportunities.
+- `/dw-secure-audit` or `/dw-secure-audit --plan` for security opportunities.
+```
+
+## Anti-patterns
+
+- Suggesting generic SaaS ideas that do not cite local project evidence.
+- Ignoring refactor and security opportunities because they are not product features.
+- Running deep refactor or security analysis inside this command.
+- Producing a roadmap with no next command for each item.
+- Treating `--research` as a substitute for reading the local project first.
+
+</system_instructions>

package/scaffold/en/commands/dw-refactor.md

@@ -0,0 +1,54 @@
+<system_instructions>
+You are the dev-workflow refactor audit entrypoint. This command restores an explicit `/dw-refactor` surface while keeping one implementation protocol: the `refactor-audit` mode already defined by `/dw-brainstorm`.
+
+<critical>This command audits and plans refactoring. Do not perform refactors, edit code, or change behavior unless the user explicitly asks afterward.</critical>
+<critical>Use the existing `refactor-audit` protocol as the source of truth. Do not invent a separate refactor methodology that can drift from `/dw-brainstorm --mode=refactor-audit`.</critical>
+
+## When to Use
+- User asks for refactor opportunities, code-health audit, tech debt scan, messy-module cleanup, or quarterly architecture hygiene.
+- `/dw-opportunities` identifies an `Engineering Leverage` card and routes here.
+- Use before touching a risky area when a refactor plan is safer than opportunistic cleanup.
+
+## Invocation
+
+| Invocation | Behavior |
+|------------|----------|
+| `/dw-refactor <target>` | Audit the target using the existing `refactor-audit` protocol. |
+| `/dw-refactor` | Ask for the target as part of the required clarification questions. |
+
+## Pipeline Position
+**Predecessor:** `/dw-opportunities` or user-selected target | **Successor:** `/dw-plan`, `/dw-run`, or manual refactor implementation after user approval
+
+## Required Behavior
+
+1. Read the project documentation generated by `/dw-analyze-project` as primary context: `.dw/rules/`, `.dw/constitution.md`, `.dw/rules/concerns.md`, `.dw/intel/`, and `DESIGN.md` when present.
+2. Read `.dw/commands/dw-brainstorm.md`.
+3. Locate `Mode: refactor-audit (code-smell catalog + deep-modules)`.
+4. Follow that section exactly, including:
+   - Asking exactly 3 clarification questions before starting analysis.
+   - Using Fowler smell taxonomy.
+   - Loading `dw-review-rigor` and `dw-simplification` when available.
+   - Applying Chesterton's Fence and deep-modules analysis before proposing a refactor.
+   - De-duplicating findings and severity-ordering P0-P3.
+   - Saving the output to `<target>/refactor-plan.md`.
+5. If the target does not exist or is too broad, use the clarification questions to narrow it before scanning.
+
+## Security Boundary
+
+- Security findings belong to `/dw-secure-audit`, not `/dw-refactor`.
+- If the refactor scan finds auth/session, secrets, dependency, SAST, or hardening signals, add a note that the follow-up command is `/dw-secure-audit` or `/dw-secure-audit --plan`.
+- Do not duplicate the security gate inside the refactor report.
+
+## Output
+
+Use the output format from `/dw-brainstorm` `refactor-audit` mode. The summary shown to the user must include:
+
+- Findings count by P0-P3.
+- Top 3 highest-leverage refactor opportunities.
+- Tests or characterization coverage required before implementation.
+- Explicit next command:
+  - `/dw-plan` for a multi-step refactor.
+  - `/dw-run` only for a narrow, already-approved refactor task.
+  - `/dw-secure-audit` when the scan surfaces security concerns.
+
+</system_instructions>

package/scaffold/en/commands/dw-review.md

@@ -209,7 +209,7 @@ When both levels run, a consolidated report at `<target>/QA/review-consolidated.
 - Skipping `dw-verify` to "ship the review faster" — produces APPROVED verdicts on broken code.
 - Issuing APPROVED with KNOWN critical findings deferred to "next sprint" — that's REJECTED with a workaround plan.
 - Flagging linter-level findings as review findings (duplicates the linter; noise).
-- Suggesting refactors that aren't in scope of the PRD (use `/dw-brainstorm --refactor` separately if you want a refactor agenda).
+- Suggesting refactors that aren't in scope of the PRD (use `/dw-refactor` separately if you want a refactor agenda).
 - Generating the report without actually running the test/build/lint suite — verdict is decorative without evidence.
 
 ## Final Guidelines

package/scaffold/en/commands/dw-skill-health.md

@@ -10,8 +10,10 @@ You are the dev-workflow skill and agent health auditor.
 1. Read `scaffold/skill-registry.json` when auditing the dev-workflow repo, or `.dw/skill-registry.json` + installed `.agents/skills/` in consumer projects.
 2. Group skills by `kind`: `protocol`, `domain-pack`, `recipe-pack`, `asset-pack`.
 3. Validate every skill has a trigger, expected output, owner, load policy, and context limit.
-4. Flag duplicate names, missing `SKILL.md`, missing frontmatter, oversized `SKILL.md`, and references/assets that are read without a specific trigger.
-5. Recommend keep, compact entrypoint, merge, reclassify, or remove from core visibility.
+4. Validate every bundled `SKILL.md` has a `## Structured Return` contract with `Status`, `Scope`, `Evidence`, `Artifacts`, `Decisions`, `Risks`, and `Next Step`.
+5. Confirm the `Status` vocabulary is explicit: `PASS`, `FINDINGS`, `BLOCKED`, `NOT_APPLICABLE`.
+6. Flag duplicate names, missing `SKILL.md`, missing frontmatter, oversized `SKILL.md`, stale expected-output metadata, and references/assets that are read without a specific trigger.
+7. Recommend keep, compact entrypoint, merge, reclassify, add structured return, or remove from core visibility.
 
 ## Taxonomy
 
@@ -23,7 +25,13 @@ You are the dev-workflow skill and agent health auditor.
 `SKILL.md` should be a short router/protocol. Long rules, examples, palettes, recipes, services, and assets must stay in references/assets/rules/recipes and be loaded lazily.
 
 ## Output
-Return a concise health report. Do not delete files.
+Return a concise health report with a structured-return section. Do not delete files.
+
+Include:
+- Overall status: `PASS`, `FINDINGS`, or `BLOCKED`.
+- Registry/schema issues.
+- Structured-return coverage, including any skill missing the contract or status vocabulary.
+- Top 3 fixes.
 
 Final marker: `## SKILL-HEALTH COMPLETE`
 </system_instructions>

package/scaffold/en/references/refactoring-catalog.md

@@ -1,6 +1,6 @@
 # Refactoring Catalog — Before/After Examples
 
-Reference for `/dw-brainstorm --refactor`. Based on Fowler's refactoring catalog.
+Reference for `/dw-refactor` and `/dw-brainstorm --mode=refactor-audit`. Based on Fowler's refactoring catalog.
 
 ## 1. Long Function → Extract Function
 

package/scaffold/en/templates/constitution-template.md

@@ -71,7 +71,7 @@ mode: defaults | custom
 **P-008 — N+1 queries are flagged at code review** (severity: info)
 **Rule:** Loops or list operations that issue per-item database/HTTP calls must batch (e.g., `IN (...)`, `findMany`, DataLoader) or be explicitly justified.
 **Why:** N+1 patterns scale linearly with data size and silently degrade until production load reveals them.
-**Enforcement:** `dw-code-review` and `dw-refactoring-analysis` detect await-in-loop patterns against repository / API client modules.
+**Enforcement:** `/dw-review` and `/dw-refactor` detect await-in-loop patterns against repository / API client modules.
 
 ---
 

package/scaffold/pt-br/agent-instructions.md

@@ -14,7 +14,7 @@ Antes de escolher um comando da Trigger Map, dimensione o escopo real da mudanç
 | **Pequeno** | ≤3 arquivos, sem migration, sem novo endpoint, descritível em uma frase. Exemplos: typo, log message, config de uma linha, bump de dependência, version pin. | Faça inline. Nenhum comando `dw-*`. |
 | **Médio** | Feature ou bug claro, <10 tasks numeradas esperadas, único componente ou serviço, sem decisões arquiteturais. Exemplos: adicionar campo de form com validação, corrigir regressão em módulo conhecido, ligar novo endpoint num handler existente. | `/dw-bugfix` (bugs) ou `/dw-plan` (features) — direto, não via `/dw-autopilot`. |
 | **Grande** | Feature multi-componente, ≥10 tasks esperadas, toca múltiplos módulos, tem superfície UX user-visible E backend. Exemplos: adicionar nova entidade end-to-end (model + migration + API + UI), introduzir integração de terceiro, redesenhar fluxo. | `/dw-autopilot "<wish>"` — primeira invocação planeja e para; segunda invocação retoma via `/dw-goal` para Run → Review → QA/Fix → Review, depois Commit → PR. |
-| **Complexo** | Domínio novo, requisitos ambíguos, decisão arquitetural exigida, superfície regulatória ou de compliance, ou escopo que cruza múltiplos PRDs. Exemplos: introduzir event sourcing, reconstruir auth, multi-tenancy, nova linha de produto. | `/dw-brainstorm "<ideia>"` primeiro (auto-dispatch de modos research/council), depois `/dw-plan --council` para a etapa de techspec rodar o debate multi-advisor. |
+| **Complexo** | Domínio novo, requisitos ambíguos, decisão arquitetural exigida, superfície regulatória ou de compliance, ou escopo que cruza múltiplos PRDs. Exemplos: introduzir event sourcing, reconstruir auth, multi-tenancy, nova linha de produto. | `/dw-opportunities` primeiro se a ideia ainda nao existir; caso contrario `/dw-brainstorm "<ideia>"` (auto-dispatch de modos research/council), depois `/dw-plan --council` para a etapa de techspec rodar o debate multi-advisor. |
 
 **Safety valve:** se você começou em Pequeno ou Médio mas o trabalho revela que é Grande de fato (a listagem inline passa de 5 passos, ou `/dw-bugfix` dispara seu `Step 5.0`), PARE e escale. Não existe flag para bypass. Escalar é o desfecho correto.
 
@@ -49,7 +49,10 @@ Antes de escolher um comando da Trigger Map, dimensione o escopo real da mudanç
 | "Só code review qualidade" | `/dw-review --code-only` |
 | "Hora de commitar" / mudanças validadas e prontas | `/dw-commit` |
 | "Abre um PR" / "Sobe isso" | `/dw-generate-pr` |
-| "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) |
+| "Sugere ideias novas" / "O que devemos construir agora?" / "Encontra oportunidades" / "Ideias de roadmap" | `/dw-opportunities` |
+| "Que melhorias de seguranca devemos considerar?" / "Encontra oportunidades de seguranca" | `/dw-opportunities "security"` |
+| "Brainstorm X" / "Explora essa ideia" / "Research X" | `/dw-brainstorm "X"` (auto-dispatch dos modos grill / prototype / council / research / onepager conforme os sinais) |
+| "Auditoria de saude do codigo" / "Tech debt" / "Oportunidades de refactor" / "Smells em X" | `/dw-refactor "X"` |
 | "Onde está X?" / "O que usa Y?" / "Como Z é estruturado?" | `/dw-intel "<pergunta>"` |
 | "Reconstrói o índice" / "Refresh do intel" | `/dw-intel --build` |
 | "Contexto pesado" / "Audita uso de tokens" / "Por que o agente está lento?" | `/dw-context-budget` |

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

@@ -26,7 +26,7 @@ Você é um assistente especializado em análise de projetos de software. Sua ta
 As rules geradas por este comando são consumidas por:
 - `/dw-run` -- lê rules para padrões de implementação
 - `/dw-review --code-only` -- lê rules para verificações de conformidade
-- `/dw-brainstorm --refactor` -- lê rules para contexto do projeto
+- `/dw-refactor` -- lê rules para contexto do projeto
 - `/dw-plan techspec` -- lê rules para decisões de arquitetura
 
 <critical>NUNCA modifique código fonte, apenas leia e documente</critical>

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

@@ -7,6 +7,7 @@ Você é um facilitador de brainstorming para o workspace atual. Este comando ex
 ## Quando Usar
 - Use quando quiser explorar ideias antes de criar um PRD, comparar direções arquiteturais ou destravar requisitos vagos
 - NÃO use quando já tiver requisitos claros prontos para um PRD, ou quando precisar implementar código
+- Para auditorias standalone de code health ou tech debt, prefira `/dw-refactor`; este comando so chega em `refactor-audit` quando sinais de refactor aparecem durante ideacao mais ampla.
 
 ## Posição no Pipeline
 **Antecessor:** (ideia do usuário) | **Sucessor:** `/dw-plan prd`
@@ -38,7 +39,7 @@ Power users que já sabem o que querem podem passar `--mode=`. Todo mundo mais g
 
 ### Nota de migração (transitória)
 
-Invocações antigas com flags (`--onepager`, `--council`, `--research`, `--refactor`, `--grill`, `--prototype`) continuam aceitas por um ciclo minor e mapeiam para o `--mode=` equivalente. Código novo deve usar `--mode=` ou confiar no auto-dispatch.
+Invocacoes antigas com flags (`--onepager`, `--council`, `--research`, `--refactor`, `--grill`, `--prototype`) continuam aceitas por um ciclo minor e mapeiam para o `--mode=` equivalente. Codigo novo deve usar `/dw-refactor` para auditoria standalone de refactor, `--mode=refactor-audit` apenas para compatibilidade explicita, ou confiar no auto-dispatch.
 
 ## Fluxograma de Decisão: Brainstorm vs PRD Direto
 
@@ -149,6 +150,8 @@ Antes de produzir qualquer output, **leia a situação**:
   - `/dw-plan techspec`
   - `/dw-plan tasks`
   - `/dw-bugfix`
+  - `/dw-refactor` (se o proximo passo util for uma auditoria dedicada de code health)
+  - `/dw-secure-audit` (se o proximo passo util for hardening de seguranca ou remediacao de dependencias)
 
 ## Heuristicas
 

package/scaffold/pt-br/commands/dw-functional-doc.md

@@ -294,11 +294,11 @@ Use os utilitários do workspace quando fizer sentido:
 - `node .dw/scripts/functional-doc/generate-dossier.mjs --target <URL> [--lang en|pt-br] [--project <nome>] [--base-url <url>]`
 - `node .dw/scripts/functional-doc/run-playwright-flow.mjs --flow-dir <caminho> [--video-resolution fullhd|1920x1080] [--list-only]`
 
-O runner dirige o Playwright pela API Node e grava vídeo com `page.screencast` (único mecanismo que
-funciona via CDP). Ele gera `scripts/<slug>.flow.mjs` — um módulo ESM simples que exporta
+O runner dirige o Playwright pela API Node e grava vídeo com `page.screencast` (funciona no Chromium
+lançado por padrão e no fallback CDP). Ele gera `scripts/<slug>.flow.mjs` — um módulo ESM simples que exporta
 `async function flow({ page, context, expect, baseURL, step, shot })`, não um spec `@playwright/test`,
 então dispensa o `playwright.config.*` do projeto. O browser é escolhido por `.dw/scripts/lib/resolve-browser.mjs`
-(resiliente no WSL: Chromium headless full por padrão; defina `BROWSER_TEST` com o caminho do exe do browser do Windows para dirigi-lo via CDP — em NAT rode `npx @brunosps00/dev-workflow setup-wsl-browser` uma vez para instalar o cdp-relay.exe precompilado + regra Hyper-V, em mirrored funciona direto);
+(resiliente no WSL: Chromium headless full por padrão; defina `BROWSER_TEST` com o caminho do exe do browser do Windows apenas como fallback CDP — em NAT rode `npx @brunosps00/dev-workflow setup-wsl-browser` uma vez para instalar o cdp-relay.exe reverso opcional no contexto do usuário, em mirrored funciona direto);
 veja a seção "Browser on WSL" de `dw-testing-discipline/references/playwright-recipes.md`. Só Chromium —
 `screencast`/CDP não suportam Firefox/WebKit.
 

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

@@ -15,14 +15,16 @@ Voce e o auditor do harness dev-workflow.
    - Registry de agentes
    - Compatibilidade por provider
    - Disciplina de handoff
+   - Retornos estruturados das skills
    - Permissoes de ferramentas
    - Cobertura de parallel-safety
    - MCP configuration
    - Gates de verificacao
    - Gates de seguranca
    - Disciplina de contexto
-3. Cite paths ausentes e referencias quebradas.
-4. Recomende os 3 principais fixes.
+3. Para retornos estruturados das skills, inspecione `SKILL.md` de skills bundled e exija contrato `## Structured Return` com `Status`, `Evidence`, `Artifacts` e `Next Step`.
+4. Cite paths ausentes, referencias quebradas, arquivos gerenciados stale, e skills sem retorno estruturado.
+5. Recomende os 3 principais fixes.
 
 ## Saida
 Retorne um scorecard e nao altere arquivos. Para drift de arquivo gerenciado, indique `dev-workflow repair`.

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

@@ -21,11 +21,12 @@ Use `/dw-autopilot "desejo"` como gateway pra maior parte do trabalho. Comandos
 | `/dw-bugfix "descrição"` | Bug ou error report. Fix cirúrgico ou rota pra PRD. |
 | `/dw-help [palavra-chave]` | Esta tela. Passe palavra-chave pra atalhos. `--advanced` revela comandos internos. |
 
-## Tier 2 — Pipeline granular (9)
+## Tier 2 — Pipeline granular (10)
 
 | Comando | O que |
 |---------|-------|
-| `/dw-brainstorm "ideia"` | Refina ideia antes do PRD. Flags: `--onepager`, `--council`, `--research`, `--refactor`. |
+| `/dw-opportunities [foco]` | Sugere oportunidades especificas do projeto em produto, UX, automacao, refactor e seguranca antes de existir uma ideia concreta. Flag: `--research`. |
+| `/dw-brainstorm "ideia"` | Refina uma ideia concreta antes do PRD. Flags: `--onepager`, `--council`, `--research`. |
 | `/dw-plan "feature"` | PRD → TechSpec → Tasks sequencial com checkpoints. Stages: `prd`, `techspec`, `tasks`. |
 | `/dw-run [task-id]` | Executa todas tasks pendentes ou uma específica. Flag `--resume`. |
 | `/dw-review` | Level 2 (cobertura PRD) + Level 3 (qualidade/segurança). Flags: `--coverage-only`, `--code-only`, `--bugfix <slug>`. |
@@ -35,12 +36,13 @@ Use `/dw-autopilot "desejo"` como gateway pra maior parte do trabalho. Comandos
 | `/dw-commit` | Commits atômicos Conventional pra trabalho pendente. |
 | `/dw-generate-pr [target]` | Push branch, draft do PR body, abre browser. |
 
-## Tier 3 — Especialidade (10)
+## Tier 3 — Especialidade (11)
 
 | Comando | O que |
 |---------|-------|
 | `/dw-analyze-project` | Scan do repo, escreve `.dw/rules/`, oferece `.dw/constitution.md`, gera `.dw/rules/concerns.md` e sintetiza `DESIGN.md` em frontend quando há tokens. |
 | `/dw-redesign-ui "target"` | Audit, propõe 2-3 direções, entrega. Enforça UI grounding + WCAG; pode rodar o detector determinístico do impeccable. |
+| `/dw-refactor "target"` | Audita code health e tech debt com smells Fowler, deep-modules e gates de teste preservando comportamento. |
 | `/dw-functional-doc` | Mapeia screens + flows em doc funcional validado com Playwright; usa resolução de browser resiliente no WSL. |
 | `/dw-context-budget` | Audita contexto de commands, skills, agentes, instrucoes e MCPs. |
 | `/dw-harness-audit` | Pontua saude da instalacao: wrappers, agentes, MCPs e gates. |
@@ -55,7 +57,7 @@ Use `/dw-autopilot "desejo"` como gateway pra maior parte do trabalho. Comandos
 `/dw-autopilot "desejo"` roda planejamento primeiro e para. Reinvoque para retomar via `/dw-goal`, Security Gate, commit e PR. Passo a passo:
 
 ```
-/dw-brainstorm → /dw-plan → /dw-goal → /dw-secure-audit → /dw-commit → /dw-generate-pr
+/dw-opportunities → /dw-brainstorm → /dw-plan → /dw-goal → /dw-secure-audit → /dw-commit → /dw-generate-pr
 ```
 
 ## Comandos avançados / internos
@@ -102,8 +104,9 @@ Auto-invocados por comandos primários mas disponíveis standalone.
 | `commit`, `git` | `/dw-commit` |
 | `pr`, `pull request`, `merge` | `/dw-generate-pr` |
 | `ideia`, `brainstorm`, `explora` | `/dw-brainstorm` |
+| `oportunidades`, `o que vem agora`, `roadmap`, `ideias novas`, `features` | `/dw-opportunities` |
 | `research`, `compara`, `estado da arte` | `/dw-brainstorm --research` |
-| `refactor`, `smell`, `code health` | `/dw-brainstorm --refactor` |
+| `refactor`, `smell`, `code health`, `tech debt` | `/dw-refactor` |
 | `ui`, `design`, `redesign` | `/dw-redesign-ui` |
 | `intel`, `onde está`, `o que usa` | `/dw-intel` (ou `--build`) |
 | `contexto`, `tokens`, `agente lento` | `/dw-context-budget` |
@@ -114,13 +117,14 @@ Auto-invocados por comandos primários mas disponíveis standalone.
 | `skills`, `skill health`, `bloat` | `/dw-skill-health` |
 | `analyze`, `rules`, `convenções` | `/dw-analyze-project` |
 | `constitution`, `princípios` | `/dw-analyze-project` (Step 8) |
+| `oportunidades de seguranca`, `ideias de hardening`, `melhorar seguranca` | `/dw-opportunities "security"` |
 | `security`, `vulnerabilidades`, `cve`, `deps` | `/dw-secure-audit` |
 | `secret`, `sast`, `semgrep`, `gitleaks`, `trivy` | `/dw-secure-audit` |
 | `adr`, `decisão` | `/dw-adr` |
 | `docker`, `compose`, `container` | `/dw-dockerize` |
 | `new project`, `bootstrap`, `scaffold` | `/dw-new-project` |
 | `functional doc`, `screen map` | `/dw-functional-doc` |
-| `wsl`, `browser`, `playwright browser`, `cdp` | `npx @brunosps00/dev-workflow setup-wsl-browser` instala o relay precompilado quando WSL NAT precisa dirigir o browser real do Windows |
+| `wsl`, `browser`, `playwright browser`, `cdp` | `npx @brunosps00/dev-workflow setup-wsl-browser` instala o relay reverso opcional no contexto do usuário para fallback CDP no WSL NAT |
 | `azure`, `microsoft learn`, `azure skills` | `/dw-install-azure-skills` |
 | `aws`, `aws mcp`, `aws skills` | `/dw-install-aws-skills` |
 | `incident`, `outage`, `postmortem`, `sev-1` | (Skill `dw-incident-response` auto-invocada de `/dw-bugfix`) |
@@ -148,7 +152,10 @@ Sem match: surface padrão + nota.
 **P: Onde entra segurança?**
 - `/dw-review` auto-invoca `/dw-secure-audit` para stacks suportadas; `/dw-autopilot` trata como gate nomeado antes de commit/PR; `/dw-generate-pr` reforça o summary aprovado mais recente.
 
+**P: Como descubro o que fazer depois?**
+- `/dw-opportunities` escaneia o projeto instalado e sugere oportunidades de produto, UX, automacao, refactor e seguranca.
+
 **P: O que aconteceu com outros comandos?**
-- v1.0.0 consolidou a surface antiga de comandos. Mergers: create-prd/techspec/tasks → `/dw-plan`; run-task/run-plan → `/dw-run`; code-review/review-implementation → `/dw-review`; run-qa/fix-qa → `/dw-qa`; security-check/deps-audit → `/dw-secure-audit`; map-codebase → `/dw-intel --build`; deep-research e refactoring-analysis → `/dw-brainstorm --research/--refactor`. Removidos: revert-task (use `git revert` direto).
+- v1.0.0 consolidou a surface antiga de comandos. Mergers: create-prd/techspec/tasks → `/dw-plan`; run-task/run-plan → `/dw-run`; code-review/review-implementation → `/dw-review`; run-qa/fix-qa → `/dw-qa`; security-check/deps-audit → `/dw-secure-audit`; map-codebase → `/dw-intel --build`; deep-research → `/dw-brainstorm --research`; refactoring-analysis agora roteia para `/dw-refactor`. Removidos: revert-task (use `git revert` direto).
 
 </system_instructions>

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

@@ -0,0 +1,131 @@
+<system_instructions>
+Voce e o scout de oportunidades do dev-workflow para o workspace atual. Este comando descobre o que o projeto deveria considerar a seguir antes do usuario ja ter uma ideia concreta.
+
+<critical>Este comando e apenas discovery. Nao implemente codigo, nao crie PRD, nao faca refactor e nao rode auditoria profunda de seguranca salvo se o usuario pedir explicitamente depois.</critical>
+<critical>Sempre considere oportunidades de produto, UX, automacao, alavancagem tecnica e seguranca. Nao reduza "oportunidade" a ideias de feature.</critical>
+
+## Quando Usar
+- Use quando o usuario perguntar o que construir agora, quiser ideias novas, pedir roadmap, ou quiser oportunidades especificas do projeto.
+- Use quando o usuario disser "sugere ideias", "encontra oportunidades", "o que vem agora?", "o que deixaria isso melhor?", ou similar.
+- NAO use quando o usuario ja tem uma feature concreta pronta para PRD; use `/dw-plan`.
+- NAO use para auditoria dedicada de saude do codigo; use `/dw-refactor`.
+- NAO use para security gate dedicado; use `/dw-secure-audit`.
+
+## Invocacao
+
+| Invocacao | Comportamento |
+|-----------|---------------|
+| `/dw-opportunities` | Escaneia o projeto instalado e propoe oportunidades. |
+| `/dw-opportunities <foco>` | Restringe o scan a modulo, fluxo, persona, area de produto ou objetivo. |
+| `/dw-opportunities <foco> --research` | Adiciona pesquisa externa atual com citacoes quando mercado, framework, compliance ou estado da arte importam. |
+
+## Posicao no Pipeline
+**Predecessor:** contexto existente do projeto | **Sucessores:** `/dw-brainstorm`, `/dw-plan prd`, `/dw-redesign-ui`, `/dw-refactor`, `/dw-secure-audit`
+
+## Grounding Local Obrigatorio
+
+Antes de propor qualquer coisa, inspecione o estado do projeto:
+
+Trate a documentacao produzida por `/dw-analyze-project` como evidencia primaria. Isso inclui `.dw/rules/`, `.dw/constitution.md`, `.dw/rules/concerns.md`, `.dw/intel/` e `DESIGN.md` de frontend quando existir.
+
+1. `.dw/spec/prd-*/` para superficie de produto entregue ou planejada.
+2. `.dw/rules/`, `.dw/constitution.md` e `.dw/rules/concerns.md` para convencoes, principios e areas de risco conhecidas.
+3. `.dw/intel/` para stack, grafo de arquivos, APIs, dependencias e arquitetura.
+4. `.dw/bugfixes/` para defeitos recorrentes e fluxos frageis.
+5. `README*`, docs, manifests, arquivos de dependencias e commits recentes.
+6. `DESIGN.md` quando existir para restricoes visuais/produto de frontend.
+
+Se uma fonte estiver ausente, diga que ela esta ausente e siga com a evidencia disponivel.
+
+## Categorias de Oportunidade
+
+Avalie todas as categorias sempre, mesmo que a lista final nao tenha card em uma delas:
+
+| Categoria | Procurar | Follow-up |
+|-----------|----------|-----------|
+| `Product` | Workflows nao atendidos, lacunas de ativacao/retencao, gaps de produto, alavancagem de roadmap. | `/dw-brainstorm` ou `/dw-plan prd` |
+| `UX/UI` | Friccao, hierarquia confusa, estados empty/loading/error fracos, gaps de acessibilidade, desalinhamento com `DESIGN.md`. | `/dw-redesign-ui <target>` |
+| `Automation` | Trabalho manual repetido, gaps no fluxo de agentes, oportunidades de comando, rituais do projeto que podem ficar confiaveis. | `/dw-brainstorm` ou `/dw-plan prd` |
+| `Engineering Leverage` | Tech debt, fluxo duplicado, modulos de alta mudanca, testes frageis, drift arquitetural, docs confusas. | `/dw-refactor <target>` |
+| `Security` | Gaps de auth/session, defaults inseguros, validacao ausente, risco em secrets, risco de dependencias, hardening/gates ausentes. | `/dw-secure-audit` ou `/dw-secure-audit --plan` |
+
+Regras de roteamento de seguranca:
+- Use `/dw-secure-audit --plan` para dependencias, CVEs, pacotes defasados ou oportunidades de plano de remediacao.
+- Use `/dw-secure-audit` para hardening amplo, auth/session, secrets, SAST, IaC ou security gate completo.
+- Nao invente argumentos de target que `/dw-secure-audit` nao suporta.
+
+Regras de roteamento de refactor:
+- Use `/dw-refactor <target>` quando a oportunidade exigir analise de code smells, duplicacao, coesao/acoplamento ou simplificacao preservando comportamento.
+- Nao faca a auditoria profunda dentro de `/dw-opportunities`; entregue evidencia e um alvo claro de handoff.
+
+## Modo Research
+
+Quando `--research` estiver presente:
+- Use a disciplina `dw-source-grounding` se disponivel.
+- Use web sources para contexto externo de mercado, framework, compliance, competidores ou estado da arte.
+- Cite fatos inline com URLs e data de retrieval.
+- Mantenha a pesquisa proporcional. O comando ainda deve retornar oportunidades, nao um relatorio completo.
+
+## Scoring
+
+Pontue cada candidata de forma leve:
+
+| Campo | Significado |
+|-------|-------------|
+| Impact | Valor para usuario/negocio/seguranca/engenharia se resolvido. |
+| Reach | Quanto do produto ou time se beneficia. |
+| Frequency | Com que frequencia a dor ou oportunidade aparece. |
+| Confidence | Forca da evidencia local. |
+| Effort | `S` / `M` / `L`. |
+| Risk | Risco de entrega, seguranca, migracao ou UX. |
+
+Priorize oportunidades de alto impacto, alta confianca e esforco baixo/medio. Inclua uma aposta estrategica de alto upside quando houver evidencia.
+
+## Formato de Saida
+
+```markdown
+## Leitura do Projeto
+- Produto hoje:
+- Sinais locais mais fortes:
+- Evidencia ausente:
+
+## Cards de Oportunidade
+
+### 1. <titulo>
+**Tipo:** Product | UX/UI | Automation | Engineering Leverage | Security
+**Evidencia:** <arquivo/area/commit/doc local>
+**Oportunidade:** <ideia especifica, nao tema vago>
+**Por que agora:** <timing ou alavancagem>
+**Validacao:** <menor checagem util>
+**Score:** Impact <H/M/L> | Confidence <H/M/L> | Effort <S/M/L> | Risk <H/M/L>
+**Follow-up:** `/dw-...`
+
+...
+
+## Ordem Recomendada
+### Fazer Agora
+1. ...
+
+### Fazer Depois
+1. ...
+
+### Explorar
+1. ...
+
+## Comandos de Follow-up Sugeridos
+- `/dw-brainstorm "<ideia>"` quando a ideia precisa ser lapidada.
+- `/dw-plan prd "<ideia>"` quando ja esta pronta para especificacao.
+- `/dw-redesign-ui "<target>"` para redesign UX/UI.
+- `/dw-refactor "<target>"` para oportunidades de alavancagem tecnica.
+- `/dw-secure-audit` ou `/dw-secure-audit --plan` para oportunidades de seguranca.
+```
+
+## Anti-padroes
+
+- Sugerir ideias SaaS genericas sem citar evidencia local do projeto.
+- Ignorar oportunidades de refactor e seguranca porque elas nao sao features de produto.
+- Rodar analise profunda de refactor ou seguranca dentro deste comando.
+- Produzir roadmap sem proximo comando para cada item.
+- Tratar `--research` como substituto de ler o projeto local primeiro.
+
+</system_instructions>

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

@@ -0,0 +1,54 @@
+<system_instructions>
+Voce e a entrada de auditoria de refactor do dev-workflow. Este comando restaura uma superficie explicita `/dw-refactor` mantendo um unico protocolo de implementacao: o modo `refactor-audit` ja definido por `/dw-brainstorm`.
+
+<critical>Este comando audita e planeja refactoring. Nao faca refactors, nao edite codigo e nao altere comportamento salvo se o usuario pedir explicitamente depois.</critical>
+<critical>Use o protocolo `refactor-audit` existente como fonte de verdade. Nao invente uma metodologia separada de refactor que possa divergir de `/dw-brainstorm --mode=refactor-audit`.</critical>
+
+## Quando Usar
+- Usuario pede oportunidades de refactor, auditoria de code health, scan de tech debt, limpeza de modulo baguncado ou higiene arquitetural trimestral.
+- `/dw-opportunities` identifica um card `Engineering Leverage` e roteia para ca.
+- Use antes de mexer em area arriscada quando um plano de refactor e mais seguro que limpeza oportunistica.
+
+## Invocacao
+
+| Invocacao | Comportamento |
+|-----------|---------------|
+| `/dw-refactor <target>` | Audita o target usando o protocolo `refactor-audit` existente. |
+| `/dw-refactor` | Pergunta o target dentro das perguntas obrigatorias de esclarecimento. |
+
+## Posicao no Pipeline
+**Predecessor:** `/dw-opportunities` ou target escolhido pelo usuario | **Sucessor:** `/dw-plan`, `/dw-run`, ou implementacao manual de refactor apos aprovacao do usuario
+
+## Comportamento Obrigatorio
+
+1. Leia a documentacao do projeto gerada por `/dw-analyze-project` como contexto primario: `.dw/rules/`, `.dw/constitution.md`, `.dw/rules/concerns.md`, `.dw/intel/` e `DESIGN.md` quando existir.
+2. Leia `.dw/commands/dw-brainstorm.md`.
+3. Localize `Modo: refactor-audit (catalogo de code smells + deep-modules)`.
+4. Siga essa secao exatamente, incluindo:
+   - Fazer exatamente 3 perguntas de esclarecimento antes de iniciar a analise.
+   - Usar a taxonomia de smells de Fowler.
+   - Carregar `dw-review-rigor` e `dw-simplification` quando disponiveis.
+   - Aplicar Chesterton's Fence e deep-modules antes de propor refactor.
+   - Deduplicar findings e ordenar severidade P0-P3.
+   - Salvar a saida em `<target>/refactor-plan.md`.
+5. Se o target nao existir ou for amplo demais, use as perguntas de esclarecimento para estreitar antes do scan.
+
+## Fronteira de Seguranca
+
+- Findings de seguranca pertencem a `/dw-secure-audit`, nao a `/dw-refactor`.
+- Se o scan de refactor encontrar sinais de auth/session, secrets, dependencias, SAST ou hardening, adicione nota de que o follow-up e `/dw-secure-audit` ou `/dw-secure-audit --plan`.
+- Nao duplique o security gate dentro do relatorio de refactor.
+
+## Saida
+
+Use o formato de saida do modo `refactor-audit` de `/dw-brainstorm`. O resumo mostrado ao usuario deve incluir:
+
+- Contagem de findings por P0-P3.
+- Top 3 oportunidades de refactor com maior alavancagem.
+- Testes ou cobertura de caracterizacao exigidos antes da implementacao.
+- Proximo comando explicito:
+  - `/dw-plan` para refactor em multiplos passos.
+  - `/dw-run` apenas para task de refactor estreita e ja aprovada.
+  - `/dw-secure-audit` quando o scan revelar preocupacoes de seguranca.
+
+</system_instructions>

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

@@ -209,7 +209,7 @@ Quando ambos níveis rodam, relatório consolidado em `<target>/QA/review-consol
 - Pular `dw-verify` pra "shipar review mais rápido" — produz APROVADO em código quebrado.
 - Emitir APROVADO com critical findings KNOWN diferidos pra "próximo sprint" — isso é REPROVADO com plano de contorno.
 - Flagar findings nível-linter como review findings (duplica linter; ruído).
-- Sugerir refactors fora do escopo do PRD (use `/dw-brainstorm --refactor` separado se quiser agenda de refactor).
+- Sugerir refactors fora do escopo do PRD (use `/dw-refactor` separado se quiser agenda de refactor).
 - Gerar relatório sem rodar test/build/lint suite — verdict decorativo sem evidência.
 
 ## Diretrizes finais