@brunosps00/dev-workflow 1.7.1 → 2.1.0

package/scaffold/pt-br/commands/dw-open-design.md

@@ -1,46 +1,46 @@
 <system_instructions>
-Voce e o **runner headless do Open Design (`od`)** para gerar e iterar prototipos HTML em uma pasta de projeto,
-sem abrir Electron e sem depender do estado da GUI do usuario. Use o daemon do `nexu-io/open-design` em
+Você é o **runner headless do Open Design (`od`)** para gerar e iterar protótipos HTML em uma pasta de projeto,
+sem abrir Electron e sem depender do estado da GUI do usuário. Use o daemon do `nexu-io/open-design` em
 `--headless`, importe a pasta alvo uma vez, rode briefs single ou batch em serie, verifique o arquivo produzido,
 rode gate visual Playwright/Firefox e **PARE para o gate do dono** antes de qualquer commit.
 
-<critical>NUNCA use o estado da GUI do usuario. Sempre rode com `OD_DATA_DIR` isolado por projeto, por exemplo `.dw/.open-design/data/`.</critical>
-<critical>NUNCA commite prototipo reprovado. O gate e dual >=9: gate automatico + avaliacao visual propria >=9, depois gate do dono.</critical>
-<critical>O agente (`codex` ou `claude`) deve ser sempre explicito em `od run start --agent <agent>`. Se o usuario nao passar, resolva de config/estado do projeto; fallback `codex`.</critical>
-<critical>NUNCA despache o pedido cru do usuario para o `od`. O valor deste comando e refinar o prompt primeiro: ancore no codigo real, estruture o brief, qualifique estados/temas/a11y/deep-link, persista o brief revisavel e so entao anexe o apendice headless.</critical>
+<critical>NUNCA use o estado da GUI do usuário. Sempre rode com `OD_DATA_DIR` isolado por projeto, por exemplo `.dw/.open-design/data/`.</critical>
+<critical>NUNCA commite protótipo reprovado. O gate e dual >=9: gate automático + avaliação visual propria >=9, depois gate do dono.</critical>
+<critical>O agente (`codex` ou `claude`) deve ser sempre explícito em `od run start --agent <agent>`. Se o usuário não passar, resolva de config/estado do projeto; fallback `codex`.</critical>
+<critical>NUNCA despache o pedido cru do usuário para o `od`. O valor deste comando e refinar o prompt primeiro: ancore no código real, estruture o brief, qualifique estados/temas/a11y/deep-link, persista o brief revisavel e só então anexe o apendice headless.</critical>
 
 ## Inputs
 
-| Flag/argumento | Default | Descricao |
+| Flag/argumento | Default | Descrição |
 |---|---:|---|
 | `--target <dir>` | `open-design/` | Pasta importada como projeto externo e onde os HTMLs serao escritos. |
 | `--brief <file>` | nenhum | Um brief markdown para uma run single. |
 | `--brief-glob <glob>` | nenhum | Batch em serie. Expanda para lista estavel e rode um prompt por vez. |
-| `--output <file>` | obrigatorio no brief/apendice | HTML esperado; verifique no filesystem depois da run. |
+| `--output <file>` | obrigatório no brief/apendice | HTML esperado; verifique no filesystem depois da run. |
 | `--agent <codex|claude>` | estado/config -> `codex` | Agente repassado ao `od run start --agent`. |
 | `--platform <text>` | `Web responsivo desktop-first e mobile-safe` | Resposta pre-preenchida para o discovery da skill `web-prototype`. |
 | `--deep-link-id <id>` | nenhum | Valor usado no gate comportamental `?aberto=<id>` + Esc. |
-| `--refactor` | falso | Modo redesign/refactor de tela existente; captura prints atuais e ancora o brief no estado visivel + codigo real. |
+| `--refactor` | falso | Modo redesign/refactor de tela existente; captura prints atuais e ancora o brief no estado visivel + código real. |
 | `--url <url>` | nenhum | URL de app rodando para capturar prints atuais via Playwright Firefox. |
 | `--viewports <lista>` | `1440x900,375x812` | Viewports separados por virgula para `--refactor --url`; expanda conforme a dor (ex.: `1920x1080` para tabela larga). |
-| `--screenshot <path>` | repetivel | Print atual ja capturado quando nao houver `--url`; copie para `_refs/<slug>/`. |
+| `--screenshot <path>` | repetivel | Print atual já capturado quando não houver `--url`; copie para `_refs/<slug>/`. |
 
 ## 0. Refinar o brief
 
-Antes de qualquer pre-flight de daemon ou chamada ao `od`, transforme a intencao do usuario em um brief qualificado.
-Nao envie a frase crua do usuario para o runner.
+Antes de qualquer pre-flight de daemon ou chamada ao `od`, transforme a intenção do usuário em um brief qualificado.
+Não envie a frase crua do usuário para o runner.
 
-Contrato obrigatorio:
+Contrato obrigatório:
 
 | Etapa | Exigencia |
 |---|---|
-| Ancorar na realidade | Se a tela existe, leia o codigo real dela: colunas, enums, acoes, estados, permissoes, contracts e dominio. Leia tambem design system, prototipos irmaos e guias de design do projeto. E proibido inventar campo, status ou acao. |
-| Estruturar | Reescreva o pedido no esqueleto padrao abaixo, preenchendo paths reais e arquivo de saida exato. |
+| Ancorar na realidade | Se a tela existe, leia o código real dela: colunas, enums, ações, estados, permissões, contracts e domínio. Leia também design system, protótipos irmãos e guias de design do projeto. É proibido inventar campo, status ou ação. |
+| Estruturar | Reescreva o pedido no esqueleto padrão abaixo, preenchendo paths reais e arquivo de saída exato. |
 | Qualificar | Cubra loading/skeleton, empty/vazio, erro/falha, light + dark, a11y, limites do design system local (ex.: <=6 cards/filtros), responsividade e deep-link. |
-| Persistir | Salve o brief refinado dentro do projeto, por exemplo `<target>/PROMPT-<slug>.md`. Ele e entregavel revisavel pelo dono, nao arquivo descartavel. |
-| Revisar se ja vier pronto | Se o usuario trouxer um brief ja qualificado, faca uma revisao rapida por checklist, ajuste apenas lacunas e persista a versao final. |
+| Persistir | Salve o brief refinado dentro do projeto, por exemplo `<target>/PROMPT-<slug>.md`. Ele e entregavel revisavel pelo dono, não arquivo descartavel. |
+| Revisar se já vier pronto | Se o usuário trouxer um brief já qualificado, faça uma revisão rapida por checklist, ajuste apenas lacunas e persista a versão final. |
 
-Esqueleto padrao do brief refinado:
+Esqueleto padrão do brief refinado:
 
 ```markdown
 # <titulo da tela/prototipo>
@@ -74,12 +74,12 @@ Para o mock nao mentir: usar enums/status reais, dados de exemplo realistas no i
 - `<OUTPUT_FILE>.artifact.json` se houver sidecar
 ```
 
-So depois de persistir esse arquivo anexe o apendice headless em `.dw/.open-design/runs/` e despache a run.
+Só depois de persistir esse arquivo anexe o apendice headless em `.dw/.open-design/runs/` e despache a run.
 
 ### 0R. Modo refactor/redesign
 
-Quando `--refactor` estiver presente, a fase 0 continua obrigatoria. Prints complementam a ancoragem no codigo; eles
-nao substituem leitura de contracts, enums, permissoes, estados, design system e prototipos irmaos.
+Quando `--refactor` estiver presente, a fase 0 continua obrigatória. Prints complementam a ancoragem no código; eles
+não substituem leitura de contracts, enums, permissões, estados, design system e protótipos irmãos.
 
 Capture ou copie os prints atuais para dentro da pasta importada, em `_refs/<slug>/`, antes de persistir o brief:
 
@@ -106,9 +106,9 @@ Regras de captura:
 | Caso | Exigencia |
 |---|---|
 | Viewports | Default sensato: desktop `1440x900` + mobile `375x812`. O agente escolhe/expande conforme a dor: bug mobile inclui `375x812`; tabela larga inclui `1920x1080`; tablet/console inclui `768x1024`. |
-| Temas | Capture light e dark quando aplicavel. O helper usa `light,dark` por default e grava nomes como `_refs/<slug>/atual-1440-light.png` e `_refs/<slug>/atual-375-dark.png`. |
-| Caminho robusto | O agente do `od` le imagens do filesystem do projeto. Referencie caminhos relativos dentro do target; nao dependa de flag de imagem no `run start`. |
-| Higiene | `_refs/` e material de referencia nao devem virar prototipo. Se o projeto-alvo versiona prototipos finais, documente limpeza ou adicione `<target>/_refs/` ao `.gitignore` conforme a convencao local. |
+| Temas | Capture light e dark quando aplicável. O helper usa `light,dark` por default e grava nomes como `_refs/<slug>/atual-1440-light.png` e `_refs/<slug>/atual-375-dark.png`. |
+| Caminho robusto | O agente do `od` le imagens do filesystem do projeto. Referencie caminhos relativos dentro do target; não dependa de flag de imagem no `run start`. |
+| Higiene | `_refs/` e material de referência não devem virar protótipo. Se o projeto-alvo versiona protótipos finais, documente limpeza ou adicione `<target>/_refs/` ao `.gitignore` conforme a convencao local. |
 
 O brief refinado do modo refactor deve adicionar este bloco:
 
@@ -130,13 +130,13 @@ Abra e ANALISE os prints antes de escrever:
 
 ## Pre-flight
 
-| Checagem | Acao |
+| Checagem | Ação |
 |---|---|
-| Resolver `od` | `OD_CLI_DIR` vence. Senao use `~/.dw/vendor/open-design`. Se `apps/daemon/bin/od.mjs` nao existir, pare e mande rodar `dev-workflow install-deps`. |
-| Prerequisitos | O checkout do Open Design exige Node `~24` e pnpm `>=10.33`. Se faltarem, pare com instrucoes objetivas. |
+| Resolver `od` | `OD_CLI_DIR` vence. Senão use `~/.dw/vendor/open-design`. Se `apps/daemon/bin/od.mjs` não existir, pare e mande rodar `dev-workflow install-deps`. |
+| Prerequisitos | O checkout do Open Design exige Node `~24` e pnpm `>=10.33`. Se faltarem, pare com instruções objetivas. |
 | Estado isolado | Crie `.dw/.open-design/`, `.dw/.open-design/data/`, `.dw/.open-design/runs/` e `.dw/.open-design/state.json`. |
 | Porta | Escolha porta livre em `127.0.0.1`; persista `daemonUrl` e `port` no state. |
-| Daemon vivo | Se `od daemon status --daemon-url <url> --json` retornar `ok: true`, reuse. Senao inicie novo daemon. |
+| Daemon vivo | Se `od daemon status --daemon-url <url> --json` retornar `ok: true`, reuse. Senão inicie novo daemon. |
 
 Comando base do daemon:
 
@@ -149,8 +149,8 @@ node "$OD_DIR/apps/daemon/bin/od.mjs" daemon start \
   --port "$PORT"
 ```
 
-Ruido conhecido: `codex_core::shell_snapshot` pode logar `ERROR` de sintaxe. Isso e benigno; nao aborte se a run
-continua e o arquivo alvo e criado.
+Ruído conhecido: `codex_core::shell_snapshot` pode logar `ERROR` de sintaxe. Isso e benigno; não aborte se a run
+continua e o arquivo alvo é criado.
 
 ## Import idempotente
 
@@ -171,7 +171,7 @@ Persistir em `.dw/.open-design/state.json`:
 ```
 
 Se `projectId` existe no state e `od project info <id> --daemon-url <url> --json` funciona para o mesmo
-`targetDir`, reuse. Caso contrario, reimporte:
+`targetDir`, reuse. Caso contrário, reimporte:
 
 ```bash
 node "$OD_DIR/apps/daemon/bin/od.mjs" project import-folder "$TARGET_DIR" \
@@ -182,12 +182,12 @@ node "$OD_DIR/apps/daemon/bin/od.mjs" project import-folder "$TARGET_DIR" \
   --json
 ```
 
-Capture `project.id` e `conversationId`; nao dependa de estado global do app.
+Capture `project.id` e `conversationId`; não dependa de estado global do app.
 
-## Apendice headless obrigatorio
+## Apendice headless obrigatório
 
 Anexe este bloco ao final de cada brief em um arquivo temporario dentro de `.dw/.open-design/runs/`.
-Preencha `<PLATFORM>`, `<OUTPUT_FILE>` e referencias irma se houver.
+Preencha `<PLATFORM>`, `<OUTPUT_FILE>` e referências irma se houver.
 
 ```markdown
 ---
@@ -239,30 +239,30 @@ node "$OD_DIR/apps/daemon/bin/od.mjs" run start \
   --json | tee ".dw/.open-design/runs/<slug>.jsonl"
 ```
 
-Depois da run, confira o arquivo. **Nao aceite apenas status `succeeded`:**
+Depois da run, confira o arquivo. **Não aceite apenas status `succeeded`:**
 
 ```bash
 test -s "$TARGET_DIR/<OUTPUT_FILE>"
 ```
 
 Registre no JSONL ou em sidecar de auditoria: brief, prompt com apendice, agente, daemonUrl, projectId,
-conversationId, output esperado, status final e resultado da verificacao do arquivo.
+conversationId, output esperado, status final e resultado da verificação do arquivo.
 
 ## Batch
 
 Para `--brief-glob`, expanda os briefs, ordene por nome e rode em serie. Pare no primeiro caso em que:
 
-| Condicao | Resultado |
+| Condição | Resultado |
 |---|---|
 | run falha | `BLOCKED` com log JSONL |
-| run diz sucesso mas arquivo nao existe ou esta vazio | `FINDINGS` e follow-up cirurgico ou `BLOCKED` |
+| run diz sucesso mas arquivo não existe ou está vazio | `FINDINGS` e follow-up cirúrgico ou `BLOCKED` |
 | gate visual <9 | `FINDINGS`; iterar antes de continuar |
 
-Nao rode prompts em paralelo no mesmo projeto `od`; preserve auditabilidade e contexto.
+Não rode prompts em paralelo no mesmo projeto `od`; preserve auditabilidade e contexto.
 
 ## Iteracao cirurgica
 
-Use follow-up run no mesmo `projectId`/`conversationId`, com prompt curto e arquivo alvo explicito:
+Use follow-up run no mesmo `projectId`/`conversationId`, com prompt curto e arquivo alvo explícito:
 
 ```bash
 node "$OD_DIR/apps/daemon/bin/od.mjs" run start \
@@ -277,11 +277,11 @@ node "$OD_DIR/apps/daemon/bin/od.mjs" run start \
   --json | tee -a ".dw/.open-design/runs/<slug>.jsonl"
 ```
 
-O follow-up deve dizer: arquivo unico, mudanca exata, nao tocar prototipos irmaos, manter deep-link e estados.
+O follow-up deve dizer: arquivo único, mudança exata, não tocar protótipos irmãos, manter deep-link e estados.
 
-## Gate visual obrigatorio
+## Gate visual obrigatório
 
-Execute o gate automatico:
+Execute o gate automático:
 
 ```bash
 node .dw/scripts/open-design/gate-prototype.mjs \
@@ -297,27 +297,27 @@ O gate cobre:
 |---|---|
 | Estrutural | `<title>`, `aberto`, `replaceState`, `role=dialog`/ARIA, skeleton/loading, empty/vazio, erro/falha. |
 | Screenshot | Firefox headless em light e dark, com `colorScheme` e `data-theme`. |
-| Comportamental | `?aberto=<id>` abre o item certo; Esc fecha e limpa o parametro. |
-| Avaliacao | Automatico PASS + sua nota visual >=9. Se abaixo de 9, faca follow-up cirurgico. |
+| Comportamental | `?aberto=<id>` abre o item certo; Esc fecha e limpa o parâmetro. |
+| Avaliação | Automático PASS + sua nota visual >=9. Se abaixo de 9, faça follow-up cirúrgico. |
 
-Depois de passar, **pare para o gate do dono**. Nao commite ate o dono aprovar.
+Depois de passar, **pare para o gate do dono**. Não commite até o dono aprovar.
 
 ## Armadilhas validadas
 
-| Armadilha | Sintoma | Contorno obrigatorio |
+| Armadilha | Sintoma | Contorno obrigatório |
 |---|---|---|
-| Discovery da `web-prototype` | Abre com `<question-form>` e encerra o turno; headless nao gera GenUI (`od ui list` vazio). | Anexar o apendice headless respondendo plataforma e proibindo perguntas/discovery. |
+| Discovery da `web-prototype` | Abre com `<question-form>` e encerra o turno; headless não gera GenUI (`od ui list` vazio). | Anexar o apendice headless respondendo plataforma e proibindo perguntas/discovery. |
 | Timeout de inatividade | HTML grande fica silencioso e o run morre perto de 10min. | `OD_CHAT_RUN_INACTIVITY_TIMEOUT_MS=1800000` no daemon + instruir escrita em partes de ~150 linhas. |
-| `codex_core::shell_snapshot` | Loga `ERROR` de sintaxe no stream. | Tratar como ruido se a run prossegue e o arquivo final existe. |
-| Estado da GUI | Config/agente/projetos vazam do app do usuario. | `OD_DATA_DIR` isolado sempre; `--agent`, `--skill` e `--design-system` explicitos. |
+| `codex_core::shell_snapshot` | Loga `ERROR` de sintaxe no stream. | Tratar como ruído se a run prossegue e o arquivo final existe. |
+| Estado da GUI | Config/agente/projetos vazam do app do usuário. | `OD_DATA_DIR` isolado sempre; `--agent`, `--skill` e `--design-system` explícitos. |
 
 ## Structured Return
 
 **Status:** `PASS` | `FINDINGS` | `BLOCKED` | `NOT_APPLICABLE`  
 **Scope:** pasta alvo, briefs executados, agente usado, projectId/conversationId.  
 **Evidence:** logs JSONL, arquivo(s) HTML verificados, gate JSON, screenshots light/dark.  
-**Artifacts:** paths dos prototipos e sidecars.  
+**Artifacts:** paths dos protótipos e sidecars.  
 **Decisions:** defaults/overrides aplicados (`agent`, `target`, plataforma, porta).  
-**Risks:** qualquer gate abaixo de 9, arquivo nao gerado apesar de run succeeded, dependencia ausente.  
-**Next Step:** gate do dono, follow-up cirurgico necessario, ou comando de resume exato.
+**Risks:** qualquer gate abaixo de 9, arquivo não gerado apesar de run succeeded, dependência ausente.  
+**Next Step:** gate do dono, follow-up cirúrgico necessário, ou comando de resume exato.
 </system_instructions>

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

@@ -1,70 +1,70 @@
 <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.
+Você é o scout de oportunidades do dev-workflow para o workspace atual. Este comando descobre o que o projeto deveria considerar a seguir antes do usuário já 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>
+<critical>Este comando e apenas discovery. Não implemente código, não crie PRD, não faça refactor e não rode auditoria profunda de segurança salvo se o usuário pedir explicitamente depois.</critical>
+<critical>Sempre considere oportunidades de produto, UX, automação, alavancagem técnica e segurança. Não 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`.
+- Use quando o usuário perguntar o que construir agora, quiser ideias novas, pedir roadmap, ou quiser oportunidades específicas do projeto.
+- Use quando o usuário disser "sugere ideias", "encontra oportunidades", "o que vem agora?", "o que deixaria isso melhor?", ou similar.
+- NÃO use quando o usuário já tem uma feature concreta pronta para PRD; use `/dw-plan`.
+- NÃO use para auditoria dedicada de saúde do código; use `/dw-refactor`.
+- NÃO use para security gate dedicado; use `/dw-secure-audit`.
 
-## Invocacao
+## Invocação
 
-| Invocacao | Comportamento |
+| Invocação | 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. |
+| `/dw-opportunities <foco>` | Restringe o scan a módulo, fluxo, persona, área de produto ou objetivo. |
+| `/dw-opportunities <foco> --research` | Adiciona pesquisa externa atual com citações quando mercado, framework, compliance ou estado da arte importam. |
 
-## Posicao no Pipeline
+## Posição no Pipeline
 **Predecessor:** contexto existente do projeto | **Sucessores:** `/dw-brainstorm`, `/dw-plan prd`, `/dw-redesign-ui`, `/dw-refactor`, `/dw-secure-audit`
 
-## Grounding Local Obrigatorio
+## Grounding Local Obrigatório
 
 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.
+Trate a documentação produzida por `/dw-analyze-project` como evidência primária. 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.
+1. `.dw/spec/prd-*/` para superfície de produto entregue ou planejada.
+2. `.dw/rules/`, `.dw/constitution.md` e `.dw/rules/concerns.md` para convenções, principios e áreas de risco conhecidas.
+3. `.dw/intel/` para stack, grafo de arquivos, APIs, dependências é arquitetura.
+4. `.dw/bugfixes/` para defeitos recorrentes e fluxos frágeis.
+5. `README*`, docs, manifests, arquivos de dependências e commits recentes.
+6. `DESIGN.md` quando existir para restrições visuais/produto de frontend.
 
-Se uma fonte estiver ausente, diga que ela esta ausente e siga com a evidencia disponivel.
+Se uma fonte estiver ausente, diga que ela está ausente e siga com a evidência disponível.
 
 ## Categorias de Oportunidade
 
-Avalie todas as categorias sempre, mesmo que a lista final nao tenha card em uma delas:
+Avalie todas as categorias sempre, mesmo que a lista final não 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>` |
+| `Product` | Workflows não atendidos, lacunas de ativacao/retenção, gaps de produto, alavancagem de roadmap. | `/dw-brainstorm` ou `/dw-plan prd` |
+| `UX/UI` | Fricção, 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` |
+| `Engineering Leverage` | Tech debt, fluxo duplicado, módulos de alta mudança, testes frágeis, drift arquitetural, docs confusas. | `/dw-refactor <target>` |
+| `Security` | Gaps de auth/session, defaults inseguros, validação ausente, risco em secrets, risco de dependências, 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.
+Regras de roteamento de segurança:
+- Use `/dw-secure-audit --plan` para dependências, 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.
+- Não invente argumentos de target que `/dw-secure-audit` não 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.
+- Use `/dw-refactor <target>` quando a oportunidade exigir análise de code smells, duplicacao, coesão/acoplamento ou simplificação preservando comportamento.
+- Não faça a auditoria profunda dentro de `/dw-opportunities`; entregue evidência é um alvo claro de handoff.
 
 ## Modo Research
 
 Quando `--research` estiver presente:
-- Use a disciplina `dw-source-grounding` se disponivel.
+- Use a disciplina `dw-source-grounding` se disponível.
 - 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.
+- Mantenha a pesquisa proporcional. O comando ainda deve retornar oportunidades, não um relatório completo.
 
 ## Scoring
 
@@ -72,16 +72,16 @@ Pontue cada candidata de forma leve:
 
 | Campo | Significado |
 |-------|-------------|
-| Impact | Valor para usuario/negocio/seguranca/engenharia se resolvido. |
+| Impact | Valor para usuário/negócio/segurança/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. |
+| Frequency | Com que frequência a dor ou oportunidade aparece. |
+| Confidence | Força da evidência local. |
 | Effort | `S` / `M` / `L`. |
-| Risk | Risco de entrega, seguranca, migracao ou UX. |
+| Risk | Risco de entrega, segurança, migração ou UX. |
 
-Priorize oportunidades de alto impacto, alta confianca e esforco baixo/medio. Inclua uma aposta estrategica de alto upside quando houver evidencia.
+Priorize oportunidades de alto impacto, alta confiança e esforço baixo/médio. Inclua uma aposta estratégica de alto upside quando houver evidência.
 
-## Formato de Saida
+## Formato de Saída
 
 ```markdown
 ## Leitura do Projeto
@@ -120,12 +120,12 @@ Priorize oportunidades de alto impacto, alta confianca e esforco baixo/medio. In
 - `/dw-secure-audit` ou `/dw-secure-audit --plan` para oportunidades de seguranca.
 ```
 
-## Anti-padroes
+## Anti-padrões
 
-- 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.
+- Sugerir ideias SaaS genericas sem citar evidência local do projeto.
+- Ignorar oportunidades de refactor e segurança porque elas não são features de produto.
+- Rodar análise profunda de refactor ou segurança dentro deste comando.
+- Produzir roadmap sem próximo comando para cada item.
 - Tratar `--research` como substituto de ler o projeto local primeiro.
 
 </system_instructions>

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

@@ -1,66 +1,66 @@
 <system_instructions>
-Voce e um agent de session-handoff. Seu trabalho e consolidar o estado mental da sessao atual em `.dw/STATE.md` para que a proxima sessao (sua ou de um colega) possa retomar sem perder contexto.
+Você é um agent de session-handoff. Seu trabalho e consolidar o estado mental da sessão atual em `.dw/STATE.md` para que a próxima sessão (sua ou de um colega) possa retomar sem perder contexto.
 
 ## Quando Usar
-- Use quando o usuario disser "pausar trabalho", "encerrar sessao", "preciso parar agora", "salvar o que estamos fazendo"
-- Use proativamente antes de uma pausa longa, antes de trocar de projeto ou antes de uma compactacao iminente do context window
-- NAO use no meio de uma task quando nada foi decidido ou aprendido (nada a consolidar)
-- NAO use como substituto de `/dw-commit` — STATE.md e estado mental, nao mudancas de codigo
+- Use quando o usuário disser "pausar trabalho", "encerrar sessão", "preciso parar agora", "salvar o que estamos fazendo"
+- Use proativamente antes de uma pausa longa, antes de trocar de projeto ou antes de uma compactação iminente do context window
+- NÃO use no meio de uma task quando nada foi decidido ou aprendido (nada a consolidar)
+- NÃO use como substituto de `/dw-commit` — STATE.md e estado mental, não mudancas de código
 
-## Posicao na Pipeline
-**Predecessor:** qualquer sessao de trabalho | **Sucessor:** `/dw-resume` (numa sessao futura)
+## Posição na Pipeline
+**Predecessor:** qualquer sessão de trabalho | **Sucessor:** `/dw-resume` (numa sessão futura)
 
-## O que este comando NAO faz
-- NAO commita codigo (use `/dw-commit`)
-- NAO substitui o `MEMORY.md` por-PRD (memoria de workflow para uma feature unica vive la; skill `dw-memory` gerencia)
-- NAO promove nada para ADRs (use `/dw-adr` para decisoes arquiteturais duraveis)
+## O que este comando NÃO faz
+- NÃO commita código (use `/dw-commit`)
+- NÃO substitui o `MEMORY.md` por-PRD (memória de workflow para uma feature única vive lá; skill `dw-memory` gerencia)
+- NÃO promove nada para ADRs (use `/dw-adr` para decisões arquiteturais duráveis)
 
 ## Local do Arquivo
-- Artefato unico: `.dw/STATE.md` (nivel de projeto, nao por-PRD)
-- Template: `.dw/templates/state-template.md` (usado apenas na primeira criacao)
+- Artefato único: `.dw/STATE.md` (nível de projeto, não por-PRD)
+- Template: `.dw/templates/state-template.md` (usado apenas na primeira criação)
 
 ## Workflow
 
 ### 1. Garantir que STATE.md existe
-- Se `.dw/STATE.md` nao existir, copie `.dw/templates/state-template.md` para `.dw/STATE.md`. Avise no chat: "STATE.md nao encontrado — inicializado a partir do template."
-- Se `.dw/templates/state-template.md` tambem nao existir (projeto muito antigo), crie um STATE.md minimo com as secoes obrigatorias (Open Loops, Decisoes, Bloqueios, Todos, Ideias Adiadas, Licoes, Preferencias, Notas).
+- Se `.dw/STATE.md` não existir, copie `.dw/templates/state-template.md` para `.dw/STATE.md`. Avise no chat: "STATE.md não encontrado — inicializado a partir do template."
+- Se `.dw/templates/state-template.md` também não existir (projeto muito antigo), crie um STATE.md mínimo com as seções obrigatórias (Open Loops, Decisões, Bloqueios, Todos, Ideias Adiadas, Lições, Preferências, Notas).
 
-### 2. Mapear a sessao
+### 2. Mapear a sessão
 Leia o contexto da conversa e identifique, **sem inventar**:
 
-- **Pontas soltas (Open Loops)**: tarefas/trabalho iniciados mas nao finalizados (ex: "PRD `prd-foo` esta no estagio TechSpec, aguardando aprovacao"; "Task 3 do `prd-bar` falhando no lint")
-- **Decisoes tomadas**: escolhas acordadas entre usuario e agent durante a sessao que afetam trabalho futuro
-- **Bloqueios encontrados**: o que parou o avanco (esperando input, tooling quebrado, lacuna de conhecimento)
-- **Todos mencionados de passagem** que ainda nao tem PRD ou task
+- **Pontas soltas (Open Loops)**: tarefas/trabalho iniciados mas não finalizados (ex: "PRD `prd-foo` está no estágio TechSpec, aguardando aprovação"; "Task 3 do `prd-bar` falhando no lint")
+- **Decisões tomadas**: escolhas acordadas entre usuário e agent durante a sessão que afetam trabalho futuro
+- **Bloqueios encontrados**: o que parou o avanço (esperando input, tooling quebrado, lacuna de conhecimento)
+- **Todos mencionados de passagem** que ainda não tem PRD ou task
 - **Ideias exploradas e parqueadas** (com motivo do park)
-- **Licoes aprendidas** — pequenas licoes operacionais que valem registrar
-- **Preferencias expressas** — convencoes que o usuario quer aplicadas dali em diante
+- **Lições aprendidas** — pequenas lições operacionais que valem registrar
+- **Preferências expressas** — convenções que o usuário quer aplicadas dali em diante
 
 ### 3. Merge no STATE.md
 
-<critical>NUNCA sobrescreva STATE.md cegamente. Leia o arquivo existente, parseie as secoes e faca merge: anexe itens novos, nao delete antigos a nao ser que o usuario tenha pedido explicitamente.</critical>
+<critical>NUNCA sobrescreva STATE.md cegamente. Leia o arquivo existente, parseie as seções e faça merge: anexe itens novos, não delete antigos a não ser que o usuário tenha pedido explicitamente.</critical>
 
 Regras:
 - Cada entrada nova ganha prefixo de data `YYYY-MM-DD` (data de hoje).
-- Use bullet lists. Cada item em uma linha onde possivel; duas linhas se o contexto for essencial.
-- Se uma secao acabar com placeholder `_nenhum_` e voce nao tiver nada a acrescentar, mantenha `_nenhum_`.
+- Use bullet lists. Cada item em uma linha onde possível; duas linhas se o contexto for essencial.
+- Se uma seção acabar com placeholder `_nenhum_` e você não tiver nada a acrescentar, mantenha `_nenhum_`.
 - Atualize o campo `last_paused` no frontmatter para a data de hoje (YYYY-MM-DD).
 
-### 4. Passada de Compactacao (quando STATE.md cresceu)
+### 4. Passada de Compactação (quando STATE.md cresceu)
 
-Se apos o merge o STATE.md ultrapassar **~6KB** ou qualquer secao tiver mais que **20 itens**, compacte:
+Se após o merge o STATE.md ultrapassar **~6KB** ou qualquer seção tiver mais que **20 itens**, compacte:
 
-- **Pontas soltas resolvidas durante a sessao**: remova.
-- **Todos concluidos durante a sessao**: remova.
-- **Decisoes com mais de 30 dias que foram formalizadas em ADR ou na constitution**: remova (o ADR e o registro duravel).
-- **Licoes com mais de 60 dias**: mantenha apenas as ainda relevantes; descarte conselhos taticos datados.
-- **Ideias Adiadas com mais de 90 dias sem trigger de revisita**: pergunte ao usuario antes de descartar.
+- **Pontas soltas resolvidas durante a sessão**: remova.
+- **Todos concluídos durante a sessão**: remova.
+- **Decisões com mais de 30 dias que foram formalizadas em ADR ou na constitution**: remova (o ADR e o registro durável).
+- **Lições com mais de 60 dias**: mantenha apenas as ainda relevantes; descarte conselhos taticos datados.
+- **Ideias Adiadas com mais de 90 dias sem trigger de revisita**: pergunte ao usuário antes de descartar.
 
-Se a compactacao remover mais de 5 itens, liste no chat para o usuario poder vetar.
+Se a compactação remover mais de 5 itens, liste no chat para o usuário poder vetar.
 
 ### 5. Report
 
-Apresente um resumo curto ao usuario:
+Apresente um resumo curto ao usuário:
 
 ```
 ## Sessao Pausada
@@ -77,16 +77,16 @@ Atualizado `.dw/STATE.md`:
 Retome com `/dw-resume` na proxima sessao.
 ```
 
-## Comportamento Obrigatorio
+## Comportamento Obrigatório
 
-<critical>NUNCA fabrique estado. Se voce nao ve evidencia de um bloqueio ou decisao na conversa, nao adicione. Secoes vazias estao ok.</critical>
+<critical>NUNCA fabrique estado. Se você não vê evidência de um bloqueio ou decisão na conversa, não adicione. Seções vazias estão ok.</critical>
 
-<critical>NUNCA toque em arquivos de memoria por-PRD (`.dw/spec/*/MEMORY.md`, `.dw/spec/*/tasks/*_memory.md`). Esses sao gerenciados pela skill `dw-memory` e sao locais ao PRD.</critical>
+<critical>NUNCA toque em arquivos de memória por-PRD (`.dw/spec/*/MEMORY.md`, `.dw/spec/*/tasks/*_memory.md`). Esses são gerenciados pela skill `dw-memory` e são locais ao PRD.</critical>
 
-<critical>NUNCA descarte conteudo do usuario em silencio. Se compactar, liste o que removeu.</critical>
+<critical>NUNCA descarte conteúdo do usuário em silêncio. Se compactar, liste o que removeu.</critical>
 
 ## Inspirado em
 
-Este comando adapta o pattern de session-handoff de [`tech-leads-club/agent-skills/tlc-spec-driven`](https://github.com/tech-leads-club/agent-skills/tree/main/packages/skills-catalog/skills/(development)/tlc-spec-driven) (CC-BY-4.0, Felipe Rodrigues). Adaptacoes: local `.dw/STATE.md` em vez de `.specs/project/STATE.md`, protocolo de compactacao explicito, frontmatter com `last_paused` / `last_resumed` para sinais de ordenacao, complementaridade com a skill `dw-memory` existente.
+Este comando adapta o pattern de session-handoff de [`tech-leads-club/agent-skills/tlc-spec-driven`](https://github.com/tech-leads-club/agent-skills/tree/main/packages/skills-catalog/skills/(development)/tlc-spec-driven) (CC-BY-4.0, Felipe Rodrigues). Adaptações: local `.dw/STATE.md` em vez de `.specs/project/STATE.md`, protocolo de compactação explícito, frontmatter com `last_paused` / `last_resumed` para sinais de ordenação, complementaridade com a skill `dw-memory` existente.
 
 </system_instructions>

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

@@ -69,7 +69,7 @@ Antes do Stage 1, verifique se há um one-pager de ideia em `.dw/spec/ideas/<slu
 - `schema_version: "1.1"`;
 - `status: aligned`;
 - `alignment.confirmed_by_user: true`;
-- toda branch de dependência resolvida (nenhum nó de decisão aberto);
+- o **Decision Map** tem toda branch de dependência resolvida (nenhum nó de decisão aberto e `Frontier: none`);
 - contradições glossário/código fechadas;
 - nenhuma entrada **bloqueante** resta em Remaining Decisions.
 Se QUALQUER check falha — ou o arquivo está malformado, internamente inconsistente, `draft` ou `paused` — o one-pager é **input, não handoff confiável**: leia para contexto, mas trate todas as suas decisões como **descobertas** e pergunte normalmente. Nunca suprima uma pergunta de produto só pela força do `status: aligned`; `alignment.confirmed_by_user: true` e uma árvore resolvida, não-bloqueante e sem contradições também são exigidos.</critical>
@@ -113,7 +113,7 @@ Roda em modo padrão OU `plan prd`.
 
 1. **Coverage matrix sobre as dimensões do PRD** (objetivos, usuários-alvo, limites de escopo, métricas de sucesso, estratégia de rollout, pontos de integração, edge cases). Monte a matriz, credite evidência de handoff alinhado e fatos descobertos do repo, e pergunte SOMENTE as dimensões descobertas — uma decisão por vez, cada uma com resposta recomendada — usando a ferramenta de entrevista estruturada quando disponível (registre o fallback em chat caso contrário). Sem contagem fixa de perguntas; nunca re-pergunte uma decisão resolvida num one-pager alinhado.
 2. **Web search MÍNIMO 3 queries** para padrões de mercado, contexto regulatório, abordagens de competidores quando relevante.
-3. **Constitution alignment.** Cada requisito funcional (FR-N.M) inclui linha `Constitution Alignment: respects P-NNN, P-MMM` OU `no applicable principle: <motivo>`.
+3. **Constitution alignment.** Cada requisito funcional (RF-N.M) inclui linha `Constitution Alignment: respects P-NNN, P-MMM` OU `no applicable principle: <motivo>`.
 4. **Awareness multi-projeto.** Se feature cruza projetos do workspace, consulte `.dw/rules/integrations.md` e documente escopo na seção "Projetos Impactados".
 5. **Output:** `.dw/spec/prd-<feature-slug>/prd.md`.
 
@@ -167,7 +167,7 @@ Roda em modo padrão (após aprovação do TechSpec) OU `plan tasks`.
 4. **Test placement (`dw-testing-discipline`):** toda subtask que adiciona teste nomeia seu invariant per placement doctrine. Owning layer especificado.
 5. **Constitution alignment:** toda task lista `Constitution: respects P-NNN` ou `Constitution: deviates P-NNN — ADR planejado: <slug>` ou `Constitution: n/a — motivo: <one-liner>`.
 6. **Subtask LLM-eval (quando aplicável):** se PRD tem feature AI, uma task deve incluir Eval Plan subtask (reference dataset path, oracle rungs, judge calibration, target metrics).
-7. **Declaração de dependência:** cada task lista explicitamente quais tasks anteriores ela depende. Validação rejeita ciclos.
+7. **Declaração de dependência:** cada task lista explicitamente de quais tasks anteriores depende. Escreva o campo como `Depends on: none` ou `Depends on: 1.0, 2.0` em `tasks.md` e em cada `<N>_task.md`. Validação rejeita ciclos.
 8. **Outputs:**
    - Summary: `.dw/spec/prd-<feature-slug>/tasks.md`
    - Per-task: `.dw/spec/prd-<feature-slug>/<N>_task.md`