@brunosps00/dev-workflow 2.0.0 → 2.1.0

package/scaffold/pt-br/commands/dw-skill-health.md

@@ -1,8 +1,8 @@
 <system_instructions>
-Voce e o auditor de saude de skills e agentes do dev-workflow.
+Você é o auditor de saúde de skills e agentes do dev-workflow.
 
 ## Quando Usar
-- Use depois de adicionar skills de catalogos externos.
+- Use depois de adicionar skills de catálogos externos.
 - Use quando o contexto estiver pesado ou skills se sobrepuserem.
 - Use antes de promover um aprendizado para skill reutilizavel.
 
@@ -11,21 +11,21 @@ Voce e o auditor de saude de skills e agentes do dev-workflow.
 2. Agrupe skills por `kind`: `protocol`, `domain-pack`, `recipe-pack`, `asset-pack`.
 3. Valide que toda skill tem trigger, output esperado, owner, load policy e limite de contexto.
 4. Valide que todo `SKILL.md` bundled tem contrato `## Structured Return` com `Status`, `Scope`, `Evidence`, `Artifacts`, `Decisions`, `Risks` e `Next Step`.
-5. Confirme que o vocabulario de `Status` esta explicito: `PASS`, `FINDINGS`, `BLOCKED`, `NOT_APPLICABLE`.
-6. Aponte nomes duplicados, `SKILL.md` ausente, frontmatter ausente, `SKILL.md` grande demais, metadata de output esperado desatualizada, e references/assets lidos sem trigger especifico.
+5. Confirme que o vocabulario de `Status` está explícito: `PASS`, `FINDINGS`, `BLOCKED`, `NOT_APPLICABLE`.
+6. Aponte nomes duplicados, `SKILL.md` ausente, frontmatter ausente, `SKILL.md` grande demais, metadata de output esperado desatualizada, e references/assets lidos sem trigger específico.
 7. Recomende manter, compactar entrypoint, mesclar, reclassificar, adicionar retorno estruturado, ou remover da visibilidade core.
 
 ## Taxonomia
 
-- `protocol`: workflow/gate/checklist acionavel que muda a execucao.
-- `domain-pack`: expertise de dominio usada so quando a tarefa entra naquele dominio.
+- `protocol`: workflow/gate/checklist acionavel que muda a execução.
+- `domain-pack`: expertise de domínio usada só quando a tarefa entra naquele domínio.
 - `recipe-pack`: receitas/snippets curados carregados por stack ou modo.
-- `asset-pack`: midia/exemplos/assets carregados so para tasks correspondentes.
+- `asset-pack`: mídia/exemplos/assets carregados só para tasks correspondentes.
 
-`SKILL.md` deve ser um roteador/protocolo curto. Regras longas, exemplos, paletas, receitas, services e assets ficam em references/assets/rules/recipes e sao carregados sob demanda.
+`SKILL.md` deve ser um roteador/protocolo curto. Regras longas, exemplos, paletas, receitas, services e assets ficam em references/assets/rules/recipes e são carregados sob demanda.
 
-## Saida
-Retorne um relatorio conciso com uma secao de retorno estruturado. Nao delete arquivos.
+## Saída
+Retorne um relatório conciso com uma seção de retorno estruturado. Não delete arquivos.
 
 Inclua:
 - Status geral: `PASS`, `FINDINGS` ou `BLOCKED`.

package/scaffold/pt-br/commands/dw-subtask-complete.md

@@ -1,10 +1,10 @@
 <system_instructions>
-Voce registra um handoff estruturado de subagente.
+Você registra um handoff estruturado de subagente.
 
 ## Quando Usar
-- Use dentro da sessao child/subagente quando a subtarefa atribuida estiver completa, bloqueada ou fora de budget.
+- Use dentro da sessão child/subagente quando a subtarefa atribuída estiver completa, bloqueada ou fora de budget.
 
-## Formato Obrigatorio
+## Formato Obrigatório
 
 ```markdown
 ## Objective
@@ -34,7 +34,7 @@ Voce registra um handoff estruturado de subagente.
 npx @brunosps00/dev-workflow subtask complete --slug=<slug> --file=<handoff.md>
 ```
 
-Retorne apenas evidencia resumida. Nao inclua logs completos nem dumps de transcript.
+Retorne apenas evidência resumida. Não inclua logs completos nem dumps de transcript.
 
 Final marker: `## SUBTASK HANDOFF RECORDED`
 </system_instructions>

package/scaffold/pt-br/commands/dw-subtask-start.md

@@ -1,13 +1,13 @@
 <system_instructions>
-Voce cria input packets minimos para subagentes.
+Você cria input packets minimos para subagentes.
 
 ## Quando Usar
 - Use quando uma subtarefa read-only, QA, review ou build-fix puder rodar separada do contexto principal.
-- Use quando o output seria volumoso: logs, grep amplo, evidencia de teste, QA em browser, review de seguranca.
+- Use quando o output seria volumoso: logs, grep amplo, evidência de teste, QA em browser, review de segurança.
 
 ## Processo
-1. Escolha o agente instalado mais especifico em `.agents/agents/README.md` ou `scaffold/agent-registry.json`.
-2. Escreva objetivo estreito, arquivos/fontes permitidos, constraints, output esperado, budget de contexto e criterio de parada.
+1. Escolha o agente instalado mais específico em `.agents/agents/README.md` ou `scaffold/agent-registry.json`.
+2. Escreva objetivo estreito, arquivos/fontes permitidos, constraints, output esperado, budget de contexto e critério de parada.
 3. Rode:
 
 ```bash

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

@@ -0,0 +1,220 @@
+<system_instructions>
+Você é a borda de triagem de intake do workspace atual. Sua função é receber pedidos externos, verificá-los contra o codebase, decidir o desfecho com o dono, persistir o estado de triagem em `.dw/`, e só então rotear para o pipeline dev-workflow existente.
+
+<critical>`/dw-triage` fica ANTES de `/dw-bugfix`, `/dw-brainstorm`, `/dw-plan` e `/dw-run`. Ele não substitui nenhum deles.</critical>
+<critical>Local-first: `.dw/triage/**` é a fonte durável da verdade. Acesso ao GitHub via `gh` é apenas enriquecimento opcional.</critical>
+<critical>Nunca escreva um brief downstream a partir de uma alegação não verificada. Verificação é o ponto deste comando.</critical>
+
+## Quando Usar
+- Use quando um bug report, feature request, escalonamento de suporte, issue ou PR externo chega e precisa de uma decisão de intake antes do planejamento ou da execução normal
+- Use quando o pedido pode ser redundante, já rejeitado, subespecificado, ou precisa de decisão humana antes de entrar no pipeline
+- NÃO use para corrigir diretamente um bug já aceito; use `/dw-bugfix`
+- NÃO use para planejar diretamente uma melhoria já aceita; use `/dw-plan prd`
+- NÃO use para ideação vaga sem item de intake; use `/dw-brainstorm`
+
+## Posição no Pipeline
+**Antecessor:** pedido externo (paste, arquivo, issue, PR) | **Sucessor:** `/dw-brainstorm --mode=grill`, `/dw-bugfix`, `/dw-plan prd`, `/dw-run`, ou nenhuma ação downstream
+
+## Entradas
+
+| Variável | Descrição | Exemplo |
+|----------|-----------|---------|
+| `{{SOURCE}}` | Fonte do pedido: texto colado, caminho local, URL de issue/PR, número de issue/PR, ou branch/ref | `.dw/inbox/relato.md`, `#123`, `https://github.com/org/repo/pull/42` |
+| `{{MODE}}` | Intenção opcional do dono | `--bug`, `--enhancement`, `--pr`, `--offline`, `--no-github-write` |
+
+## Localização dos Arquivos
+
+**Registro de triagem — sempre criado depois do desfecho aprovado pelo dono:**
+
+- `.dw/triage/NNN-<slug>.md`
+- `NNN` tem 3 dígitos, sequencial entre todos os registros de triagem já criados
+- `<slug>` vem em kebab-case do conceito de domínio, não apenas da redação do pedido
+- Use `.dw/templates/triage-record-template.md`
+
+Isto segue o precedente de índice de `.dw/bugfixes/NNN-<slug>/`: registros de intake são registros cronológicos de workflow, então precisam de ordenação estável. Um único arquivo markdown basta porque a triagem tem um documento de estado; o trabalho downstream possui seus próprios diretórios.
+
+**Notas de needs-info:**
+
+- Guardadas no mesmo registro `.dw/triage/NNN-<slug>.md`, sob `## Needs Info`
+- Use `.dw/templates/triage-needs-info-template.md` como corpo da seção quando houver perguntas em aberto
+
+**Memória de out-of-scope — apenas para conceitos rejeitados:**
+
+- `.dw/out-of-scope/<concept>.md`
+- `<concept>` é um slug estável do conceito de domínio, não uma citação do pedido
+- Use `.dw/templates/triage-out-of-scope-template.md`
+- NÃO escreva `.dw/out-of-scope/**` para "já implementado"; aponte para a implementação existente
+
+**Descoberta do próximo NNN:** liste `.dw/triage/`, parseie o prefixo inicial de 3 dígitos de cada `*.md`, tome `max + 1` ou `1` se estiver vazio.
+
+## Modelo de Estado
+
+Todo item de triagem carrega exatamente uma categoria e exatamente um estado.
+
+Categorias:
+- `bug`
+- `enhancement`
+
+Estados:
+- `needs-triage`
+- `needs-info`
+- `ready-for-work`
+- `needs-human`
+- `wontfix`
+
+Transições:
+- `needs-triage` -> `needs-info`
+- `needs-triage` -> `ready-for-work`
+- `needs-triage` -> `needs-human`
+- `needs-triage` -> `wontfix`
+- `needs-info` -> `needs-triage` quando o autor responde
+
+Se o registro atual, labels da fonte ou input do dono indicarem estados conflitantes, PARE e pergunte ao dono qual estado único é autoritativo antes de escrever ou rotear.
+
+Nota de vocabulário: o upstream usa `ready-for-agent` / `ready-for-human`. No dev-workflow, a via de implementação aceita é `/dw-run`, alimentada por `/dw-bugfix` ou `/dw-plan`, então este comando usa `ready-for-work` para "pronto para o pipeline" e `needs-human` para trabalho que não pode ser delegado com segurança.
+
+## Integração com GitHub
+
+`gh` é permitido porque este repo já o usa em `/dw-generate-pr`, mas nunca é obrigatório.
+
+1. Se `{{SOURCE}}` for uma URL ou número de issue/PR do GitHub, verifique se `gh` existe e se `git remote -v` aponta para GitHub.
+2. Se os dois checks passarem, você pode ler a issue/PR com `gh issue view` ou `gh pr view`, e para PRs ler o diff com `gh pr diff`.
+3. Se `gh` estiver ausente, sem autenticação, offline, ou o remote não for GitHub, continue a partir do texto colado, arquivo local ou argumento explícito. Se o texto necessário da issue ou o diff do PR não estiver disponível localmente, peça ao dono para colar ou fornecer um caminho de arquivo.
+4. Não mencione Linear, Jira, GitLab ou qualquer comportamento específico de tracker como integração suportada. A fonte pode ser plugável depois; este comando define apenas arquivos locais mais leitura opcional do GitHub.
+5. Nunca comente, feche, rotule ou escreva de volta no GitHub sem opt-in explícito do dono para aquela escrita exata. A persistência em `.dw/triage/**` é a saída padrão e suficiente.
+
+## Fluxo de Trabalho
+
+### 1. Ler o Pedido Completo
+
+- Leia o texto colado ou arquivo local por inteiro.
+- Se a fonte for uma issue e `gh` estiver disponível, leia título, corpo, comentários, labels, autor e URL.
+- Se a fonte for um PR e `gh` estiver disponível, leia título, corpo, comentários, arquivos alterados e diff.
+- Preserve a origem no registro de triagem: `source_type`, `source_ref`, `author`, `reported_at` e método de recuperação.
+
+### 2. Checar Redundância Antes de Recomendar
+
+Procure por conceito de domínio, não por redação:
+
+- `.dw/domain/**` quando existir
+- `.dw/spec/**`
+- `.dw/bugfixes/**`
+- `.dw/rules/**`
+- caminhos de código provavelmente donos do conceito
+- docs e testes que nomeiam o comportamento
+
+Se comportamento equivalente já existir, recomende `wontfix` com motivo `already implemented`, reporte exatamente onde procurou e onde a implementação vive, escreva o registro de triagem, e NÃO escreva `.dw/out-of-scope/**`.
+
+### 3. Checar Rejeições Anteriores
+
+Leia `.dw/out-of-scope/**` quando existir. Traga qualquer conceito de domínio parecido antes de recomendar um estado:
+
+```
+## Prior Rejection Found
+
+- Concept: `<concept>`
+- Record: `.dw/out-of-scope/<concept>.md`
+- Why it matters: <comparação em uma linha>
+```
+
+Se a rejeição anterior claramente se aplicar, recomende `wontfix` a menos que o dono reabra explicitamente a decisão.
+
+### 4. Recomendar Categoria e Estado, Depois Esperar
+
+Apresente:
+
+- resumo conciso do pedido
+- resumo da busca no codebase, incluindo onde a redundância foi checada
+- resumo de rejeição anterior
+- categoria recomendada: `bug` ou `enhancement`
+- estado recomendado: `needs-info`, `ready-for-work`, `needs-human` ou `wontfix`
+- raciocínio e próximo roteamento
+
+Então peça ao dono para aprovar ou corrigir categoria/estado. Não escreva arquivos nem roteie downstream até o dono responder, exceto ao retomar um registro de triagem já aprovado.
+
+### 5. Verificar Antes do Brief
+
+Depois da aprovação do dono e antes de qualquer brief downstream:
+
+**Para bugs:**
+- Reproduza a partir dos passos do autor quando possível.
+- Registre o comando exato, ambiente, fixture ou caminho manual usado.
+- Reporte um resultado: `confirmed`, `failed-to-reproduce` ou `insufficient-detail`.
+- Trate `insufficient-detail` como sinal forte de `needs-info`.
+
+**Para PRs:**
+- Confirme que o diff faz o que o PR afirma.
+- Rode testes ou checks relevantes para a área tocada.
+- Registre os arquivos alterados inspecionados e comandos rodados.
+- Se a alegação e o diff divergirem, pare e recomende `needs-human` ou `needs-info`.
+
+**Para enhancements:**
+- Verifique que a capacidade ainda não existe e que o pedido tem forma de produto suficiente para intake de PRD.
+- Se o vocabulário de produto ou o resultado desejado estiver instável, roteie para `/dw-brainstorm --mode=grill` em vez de inventar uma entrevista aqui.
+
+### 6. Aplicar o Desfecho
+
+Use `.dw/templates/triage-record-template.md` para todo item de triagem escrito. Registre entradas de histórico como `YYYY-MM-DD — <from> -> <to> — <actor> — <reason>`.
+
+Desfechos:
+
+- `ready-for-work` + `bug` -> escreva `.dw/triage/NNN-<slug>.md`, depois roteie para `/dw-bugfix` com o resumo de reprodução verificada e o caminho do registro de triagem
+- `ready-for-work` + `enhancement` -> escreva `.dw/triage/NNN-<slug>.md`, depois roteie para `/dw-plan prd` com o resumo de produto verificado e o caminho do registro de triagem
+- `needs-human` -> escreva `.dw/triage/NNN-<slug>.md` e registre por que delegar é inseguro: decisão de design, acesso externo, julgamento, teste manual ou ownership indefinido
+- `needs-info` -> escreva `.dw/triage/NNN-<slug>.md` e inclua a seção de `.dw/templates/triage-needs-info-template.md` com perguntas em aberto
+- `wontfix` rejeitado -> escreva `.dw/triage/NNN-<slug>.md`, depois escreva ou atualize `.dw/out-of-scope/<concept>.md` com motivo, evidência e condição de reabertura
+- `wontfix` already implemented -> escreva `.dw/triage/NNN-<slug>.md`, aponte para a implementação, e NÃO escreva `.dw/out-of-scope/**`
+
+### 7. Grill Para Pedidos Malformados
+
+Se o pedido não tiver problema, ator, conceito de domínio, resultado desejado ou fronteira de aceite estáveis, não reimplemente uma entrevista dentro de `/dw-triage`.
+
+Recomende:
+
+```
+Este item de intake não está pronto para categorização. Roteie para `/dw-brainstorm --mode=grill` para estabilizar vocabulário e fronteiras de produto, depois retorne para `/dw-triage` quando o autor responder.
+```
+
+Se o dono aprovar o roteamento, persista o registro de triagem como `needs-info`, a menos que exista motivo mais claro para `needs-human`.
+
+## Formato Preferido de Resposta
+
+### Resumo de Intake
+- Fonte:
+- Pedido:
+- Autor:
+- Recuperação:
+
+### Checks do Codebase
+- Busca de redundância:
+- Busca de rejeição anterior:
+- Evidência:
+
+### Recomendação
+- Categoria: `bug` | `enhancement`
+- Estado: `needs-info` | `ready-for-work` | `needs-human` | `wontfix`
+- Motivo:
+- Roteamento proposto:
+
+### Checkpoint do Dono
+- Peça ao dono para aprovar ou corrigir categoria/estado antes de escrever e rotear.
+
+### Resultado da Verificação
+- Status: `confirmed` | `failed-to-reproduce` | `insufficient-detail`
+- Comandos/arquivos inspecionados:
+- O que isso prova:
+
+### Desfecho Persistido
+- Registro de triagem:
+- Registro out-of-scope, se houver:
+- Próximo comando:
+
+## Anti-patterns
+
+- Tratar labels ou comentários do GitHub como fonte da verdade
+- Criar `.dw/out-of-scope/**` para um pedido já implementado
+- Comparar redundância apenas pela redação do pedido
+- Rotear para `/dw-bugfix` ou `/dw-plan prd` antes da aprovação do dono
+- Escrever bugfix ou PRD brief a partir de alegação não verificada
+- Prometer integrações com trackers que este comando não consegue ler ou escrever
+</system_instructions>

package/scaffold/pt-br/templates/bugfix-summary-template.md

@@ -9,28 +9,28 @@ related_concerns: []
 
 # Bugfix Summary — {{NNN}}-{{slug}}
 
-Registro de uma pagina de um bugfix. Arquivos irmaos neste diretorio:
+Registro de uma página de um bugfix. Arquivos irmãos neste diretório:
 
-- `TASK.md` — a triagem original, respostas das perguntas de clarificacao e o plano de fix que rodou
-- `fix-report.md` — evidencia de verificacao (saida do `dw-verify` PASS, prova de reproducao, execucao do teste de regressao)
+- `TASK.md` — a triagem original, respostas das perguntas de clarificação e o plano de fix que rodou
+- `fix-report.md` — evidência de verificação (saída do `dw-verify` PASS, prova de reprodução, execução do teste de regressão)
 - `review/` — populado por `/dw-review --bugfix {{NNN}}-{{slug}}`
-- `QA/` — populado por `/dw-qa --bugfix {{NNN}}-{{slug}}` (quando aplicavel)
+- `QA/` — populado por `/dw-qa --bugfix {{NNN}}-{{slug}}` (quando aplicável)
 
 ## Sintoma
 
-O que o usuario observou. Cite a descricao original do bug verbatim; nao parafraseie.
+O que o usuário observou. Cite a descrição original do bug verbatim; não parafraseie.
 
 > _"…"_
 
 ## Causa Raiz
 
-O que estava de fato quebrado, em uma frase. Nao o sintoma — a causa.
+O que estava de fato quebrado, em uma frase. Não o sintoma — a causa.
 
 _…_
 
-## Resolucao
+## Resolução
 
-O que mudou, em 2-4 bullets. Paths de arquivos, nao snippets.
+O que mudou, em 2-4 bullets. Paths de arquivos, não snippets.
 
 - _mudanca 1_
 - _mudanca 2_
@@ -39,28 +39,28 @@ O que mudou, em 2-4 bullets. Paths de arquivos, nao snippets.
 
 Lista completa, incluindo testes. <=5 — se mais, o safety valve deveria ter escalado para `/dw-plan`.
 
-| Path | Mudanca |
+| Path | Mudança |
 |------|---------|
-| `src/foo/bar.ts` | _fix cirurgico em X_ |
-| `src/foo/bar.test.ts` | _teste de regressao adicionado_ |
+| `src/foo/bar.ts` | _fix cirúrgico em X_ |
+| `src/foo/bar.test.ts` | _teste de regressão adicionado_ |
 
-## Verificacao
+## Verificação
 
-Como o fix foi provado, alem de "os testes passam".
+Como o fix foi provado, além de "os testes passam".
 
-- **Reproducao antes do fix:** _passo que disparava o bug, capturado_
-- **Reproducao depois do fix:** _mesmo passo, agora passa_
-- **Teste de regressao:** _nome + path_
-- **Relatorio de verify:** `fix-report.md`
+- **Reprodução antes do fix:** _passo que disparava o bug, capturado_
+- **Reprodução depois do fix:** _mesmo passo, agora passa_
+- **Teste de regressão:** _nome + path_
+- **Relatório de verify:** `fix-report.md`
 
 ## Relacionado
 
-- **Concerns tocados:** _refs de `.dw/rules/concerns.md` se o fix caiu em area flagada_
-- **Bugfixes adjacentes:** _slugs de fixes anteriores no mesmo modulo, se houver_
+- **Concerns tocados:** _refs de `.dw/rules/concerns.md` se o fix caiu em área flagada_
+- **Bugfixes adjacentes:** _slugs de fixes anteriores no mesmo módulo, se houver_
 - **Contexto de PRD:** _se o bug apareceu dentro de uma feature em andamento, link para o path do PRD_
 
 ## Followups
 
-Pontas soltas que este fix descobriu mas nao resolveu. Adicione ao `.dw/STATE.md` Open-Loops ao fechar.
+Pontas soltas que este fix descobriu mas não resolveu. Adicione ao `.dw/STATE.md` Open-Loops ao fechar.
 
 - _nenhum_

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

@@ -6,54 +6,54 @@ last_refreshed: ""
 
 # Concerns — Mapa de Riscos
 
-Mapa de riscos deste codebase. Nao sao convencoes ("como fazemos as coisas" — isso e `.dw/rules/`), nao e arquitetura ("como esta construido" — isso e `.dw/intel/arch.md`). Este arquivo responde uma unica pergunta: **onde e perigoso mexer?**
+Mapa de riscos deste codebase. Não são convenções ("como fazemos as coisas" — isso e `.dw/rules/`), não é arquitetura ("como está construído" — isso e `.dw/intel/arch.md`). Este arquivo responde uma única pergunta: **onde é perigoso mexer?**
 
-Carregado on-demand por `/dw-plan`, `/dw-run` e `/dw-bugfix` quando o alvo deles toca uma entrada abaixo. Auto-instalado pelo `/dw-analyze-project` Step 9; nunca bloqueia (ausencia = nenhuma area flagada ainda).
+Carregado on-demand por `/dw-plan`, `/dw-run` e `/dw-bugfix` quando o alvo deles toca uma entrada abaixo. Auto-instalado pelo `/dw-analyze-project` Step 9; nunca bloqueia (ausência = nenhuma área flagada ainda).
 
 ## Hot Spots
 
-Arquivos ou modulos com churn alto, reports frequentes de bug ou historico repetido de "mexi aqui e quebrou algo". Mencione em PRDs que toquem a mesma area; adicione revisor extra ou passada extra de teste.
+Arquivos ou módulos com churn alto, reports frequentes de bug ou histórico repetido de "mexi aqui e quebrou algo". Mencione em PRDs que toquem a mesma área; adicione revisor extra ou passada extra de teste.
 
-| Path | Por que e quente | Primeiro flag | Ultimo incidente |
+| Path | Por que é quente | Primeiro flag | Último incidente |
 |------|------------------|---------------|------------------|
 | _ex. `src/auth/session.ts`_ | _3 fixes de token em 60d_ | _YYYY-MM-DD_ | _YYYY-MM-DD_ |
 
-## Integracoes Fragis
+## Integrações Fragis
 
-Sistemas externos (APIs, filas, vendors, bancos legados) com historico de falhas silenciosas, drift de schema, surpresas de rate-limit ou comportamento nao-documentado. Codigo novo que toque eles precisa de tratamento explicito de retry/timeout/idempotencia.
+Sistemas externos (APIs, filas, vendors, bancos legados) com histórico de falhas silenciosas, drift de schema, surpresas de rate-limit ou comportamento não-documentado. Código novo que toque eles precisa de tratamento explícito de retry/timeout/idempotência.
 
-| Integracao | Modo de falha | Mitigacao esperada |
+| Integração | Modo de falha | Mitigação esperada |
 |------------|---------------|--------------------|
-| _ex. export SAP legado_ | _200 OK silencioso com body vazio quando source esta lockado_ | _checar tamanho do body; logar e alertar_ |
+| _ex. export SAP legado_ | _200 OK silencioso com body vazio quando source está lockado_ | _checar tamanho do body; logar e alertar_ |
 
-## Codigo Hostil
+## Código Hostil
 
-Funcoes especificas, regexes, parsers ou algoritmos dificeis de raciocinar — quem toca precisa entender 100% primeiro (ou reescrever, nao remendar). Suspeitos comuns: regex artesanal, parsers de string ad-hoc, serializadores custom, async com race condition, codigo de transacao manual.
+Funções específicas, regexes, parsers ou algoritmos difíceis de raciocinar — quem toca precisa entender 100% primeiro (ou reescrever, não remendar). Suspeitos comuns: regex artesanal, parsers de string ad-hoc, serializadores custom, async com race condition, código de transação manual.
 
-| Path / funcao | Por que e hostil | Owner / contexto |
+| Path / função | Por que é hostil | Owner / contexto |
 |---------------|------------------|------------------|
 | _ex. `src/billing/parseInvoice.ts:parseLine`_ | _regex de 900 chars com 12 alternativas, sem comentarios_ | _Bruno escreveu em 2024; reescrever se quebrar_ |
 
-## Historico de Bugs Conhecidos
+## Histórico de Bugs Conhecidos
 
-Agregado de `.dw/bugfixes/*/SUMMARY.md` pelo `/dw-intel --build`. Lista modulos com >=2 fixes historicos. Leia junto com Hot Spots ao planejar trabalho relacionado.
+Agregado de `.dw/bugfixes/*/SUMMARY.md` pelo `/dw-intel --build`. Lista módulos com >=2 fixes historicos. Leia junto com Hot Spots ao planejar trabalho relacionado.
 
-| Modulo | Contagem de bugs | Slugs recentes |
+| Módulo | Contagem de bugs | Slugs recentes |
 |--------|------------------|----------------|
 | _ex. `src/payments/`_ | _4_ | _002-stripe-webhook-retry, 007-refund-rounding_ |
 
 ## Tech Debt — Reconhecida
 
-Pedacos de debt que o time concorda que existem. Nao sao para limpar oportunisticamente sem coordenacao — podem ser load-bearing de formas nao obvias.
+Pedaços de debt que o time concorda que existem. Não são para limpar oportunisticamente sem coordenação — podem ser load-bearing de formas não óbvias.
 
-| Area | Descricao do debt | Por que fica | Trigger de cleanup |
+| Área | Descrição do debt | Por que fica | Trigger de cleanup |
 |------|-------------------|--------------|--------------------|
-| _ex. `src/legacy/userMapper.ts`_ | _Dois codepaths paralelos de field-mapping_ | _Esperando migracao v3 da API_ | _Q3 2026 apos cutover do vendor_ |
+| _ex. `src/legacy/userMapper.ts`_ | _Dois codepaths paralelos de field-mapping_ | _Esperando migração v3 da API_ | _Q3 2026 após cutover do vendor_ |
 
 ---
 
 **Como manter este arquivo:**
 
-- `/dw-analyze-project` reescreve a cada execucao. Entradas escritas a mao entre `<!-- preserved:start -->` e `<!-- preserved:end -->` sao mantidas.
-- Quando um bugfix descobrir uma nova area perigosa, adicione manualmente em Hot Spots e deixe a proxima analise confirmar.
-- Promova entradas para `.dw/constitution.md` quando virarem regras nao-negociaveis ("nunca toque X sem ADR").
+- `/dw-analyze-project` reescreve a cada execução. Entradas escritas a mão entre `<!-- preserved:start -->` e `<!-- preserved:end -->` são mantidas.
+- Quando um bugfix descobrir uma nova área perigosa, adicione manualmente em Hot Spots e deixe a próxima análise confirmar.
+- Promova entradas para `.dw/constitution.md` quando virarem regras não-negociáveis ("nunca toque X sem ADR").

package/scaffold/pt-br/templates/idea-onepager.md

@@ -93,6 +93,34 @@ Idealmente 2-4 stories. Se são mais de 5, provavelmente não é MVP.]
 
 _(schema 1.1 — preenchido por uma sessão de grill do `/dw-brainstorm`; consumido pelo `/dw-plan`, que NÃO re-pergunta decisões resolvidas. Deixe vazio para um one-pager sem grill.)_
 
+### Decision Map
+
+[Árvore durável do Grill. Registra apenas estrutura e estado de retomada; mantenha resultado da decisão,
+recomendação, alternativa e evidência em **Resolved Decisions** abaixo.]
+
+**Frontier:** [IDs de nós com `State: open-ready`, separados por vírgula, ou `none`]
+
+| ID | Nó de decisão | State | Depends on: | Frontier? | Notas |
+|----|---------------|-------|-------------|-----------|-------|
+| D1 | [decisão upstream] | resolved | none | no | [nota estrutural; resultado fica em Resolved Decisions] |
+| D2 | [decisão aberta que pode ser perguntada agora] | open-ready | D1 | yes | [por que está pronta] |
+| D3 | [decisão aberta ainda bloqueada] | open-blocked | D2 | no | [o que bloqueia] |
+
+`State` é a fonte da verdade. `Frontier?` e a linha `**Frontier:**` são derivados dele por
+legibilidade — se algum dia discordarem do `State`, o `State` vence e os derivados são reescritos.
+
+Valores permitidos de `State`:
+- `resolved` — o usuário resolveu o nó; detalhes ficam em **Resolved Decisions**.
+- `open-ready` — aberto e decidível agora; este nó está na **Frontier**.
+- `open-blocked` — aberto, mas aguardando um ou mais nós em `Depends on:`.
+
+#### Decision Fog
+
+[Áreas conhecidas não resolvidas que ainda não estão nítidas o suficiente para virar nós de decisão. Mantenha
+curto; cada item gradua para **Decision Map** quando virar uma decisão concreta.]
+
+- [área desconhecida] — [por que ainda não dá para formular como decisão]
+
 ### Resolved Decisions
 
 | Decisão | Recomendado | Escolhido | Alternativa rejeitada | Evidência |

package/scaffold/pt-br/templates/project-onepager.md

@@ -13,40 +13,40 @@ services: []
 
 # Projeto: [Nome do projeto]
 
-## Proposito
+## Propósito
 
-[Um paragrafo em linguagem de produto. Quem vai usar, qual problema resolve, como o sucesso se parece em 6-12 semanas. Evite linguagem de implementacao.]
+[Um parágrafo em linguagem de produto. Quem vai usar, qual problema resolve, como o sucesso se parece em 6-12 semanas. Evite linguagem de implementação.]
 
 ## Stack Selecionado
 
 | Camada | Escolha | Justificativa |
 |--------|---------|---------------|
-| Forma | frontend / backend / fullstack | [por que essa forma — superficie unica, API para parceiros, etc.] |
+| Forma | frontend / backend / fullstack | [por que essa forma — superfície única, API para parceiros, etc.] |
 | Frontend | Next.js / Vite+React / n/a | [por que esse framework — SSR, simplicidade SPA, etc.] |
-| Backend | NestJS / Fastify / FastAPI / ASP.NET Core minimal / Axum / n/a | [por que — expertise do time, ecosystem, alvo de latencia] |
-| Database | Postgres / MySQL / SQLite / MongoDB / nenhum | [por que esse DB — relacional, transacional, etc. Busca vetorial nao tem recipe bundled; nomeie a imagem revisada ou servico gerenciado se o projeto precisar] |
-| Cache | Redis / Memcached / nenhum | [por que ou por que nao] |
-| Fila | pg-boss / BullMQ / Celery / RabbitMQ / LocalStack SQS / nenhum | [por que ou nao + sync vs async workers] |
+| Backend | NestJS / Fastify / FastAPI / ASP.NET Core minimal / Axum / n/a | [por que — expertise do time, ecosystem, alvo de latência] |
+| Database | Postgres / MySQL / SQLite / MongoDB / nenhum | [por que esse DB — relacional, transacional, etc. Busca vetorial não tem recipe bundled; nomeie a imagem revisada ou serviço gerenciado se o projeto precisar] |
+| Cache | Redis / Memcached / nenhum | [por que ou por que não] |
+| Fila | pg-boss / BullMQ / Celery / RabbitMQ / LocalStack SQS / nenhum | [por que ou não + sync vs async workers] |
 | Email — dev | Mailpit (default) / smtp4dev / nenhum | [normalmente Mailpit — captura only, nunca envia real] |
 | Email — prod | SMTP / SendGrid / Resend / Postmark / SES / nenhum | [por que esse provider — volume, deliverability, custo] |
-| Object storage | S3 / MinIO (dev) / GCS / nenhum | [por que ou nao] |
+| Object storage | S3 / MinIO (dev) / GCS / nenhum | [por que ou não] |
 | Search | Meilisearch / Typesense / Elasticsearch / nenhum | [por que esse engine — features, escala, simplicidade] |
-| Observability | Sentry / OTel + Jaeger / nenhum | [por que essa abordagem — so error tracking, tracing completo, etc.] |
-| Reverse proxy | Traefik / Caddy / nenhum | [normalmente so multi-host dev ou prod] |
-| Auth | Auth.js / OIDC generico / Clerk / fastapi-users / dotnet Identity / JWT custom / nenhum | [por que — social login, B2B, etc.] |
-| Linter / formatter | Biome / ESLint+Prettier / Ruff+Black / dotnet format / cargo fmt+clippy | [preferencia do time] |
-| Package manager | pnpm / npm / yarn / poetry / uv / cargo / dotnet | [preferencia do time] |
-| Workspace + task runner | pnpm workspaces + Turborepo / npm workspaces / Nx / n/a | [so para fullstack — caching/build] |
+| Observability | Sentry / OTel + Jaeger / nenhum | [por que essa abordagem — só error tracking, tracing completo, etc.] |
+| Reverse proxy | Traefik / Caddy / nenhum | [normalmente só multi-host dev ou prod] |
+| Auth | Auth.js / OIDC genérico / Clerk / fastapi-users / dotnet Identity / JWT custom / nenhum | [por que — social login, B2B, etc.] |
+| Linter / formatter | Biome / ESLint+Prettier / Ruff+Black / dotnet format / cargo fmt+clippy | [preferência do time] |
+| Package manager | pnpm / npm / yarn / poetry / uv / cargo / dotnet | [preferência do time] |
+| Workspace + task runner | pnpm workspaces + Turborepo / npm workspaces / Nx / n/a | [só para fullstack — caching/build] |
 | Topologia de dev | apps no host / tudo no Compose | [trade-off de hot reload e paridade] |
-| CI | GitHub Actions / nenhum | [normalmente GitHub Actions; pular so para repos nao-publicos] |
+| CI | GitHub Actions / nenhum | [normalmente GitHub Actions; pular só para repos não-públicos] |
 
-## Servicos & Infra
+## Serviços & Infra
 
-[Servicos gerados a partir da skill docker-compose-recipes. Preenchido pelo /dw-new-project.]
+[Serviços gerados a partir da skill docker-compose-recipes. Preenchido pelo /dw-new-project.]
 
-| Servico | Porta (host) | UI | Credenciais |
+| Serviço | Porta (host) | UI | Credenciais |
 |---------|--------------|----|-------------|
-| postgres | 127.0.0.1:5432 | — | POSTGRES_USER=app, POSTGRES_PASSWORD obrigatoria no `.env` (sem default), POSTGRES_DB=app |
+| postgres | 127.0.0.1:5432 | — | POSTGRES_USER=app, POSTGRES_PASSWORD obrigatória no `.env` (sem default), POSTGRES_DB=app |
 | redis | 6379 | — | (sem auth em dev) |
 | mailpit | 1025 (smtp), 8025 (UI) | http://localhost:8025 | (sem auth) |
 | ... | ... | ... | ... |
@@ -71,7 +71,7 @@ services: []
 
 ## Arquivos Gerados
 
-[Preenchido pelo /dw-new-project apos Fase 3 — lista de arquivos criados com origem.]
+[Preenchido pelo /dw-new-project após Fase 3 — lista de arquivos criados com origem.]
 
 ```
 {{TARGET_DIR}}/
@@ -96,16 +96,16 @@ services: []
 
 ## Escopo MVP
 
-[A primeira feature menor que voce vai entregar. Pensada como user stories — vai dirigir a primeira rodada de /dw-plan prd.]
+[A primeira feature menor que você vai entregar. Pensada como user stories — vai dirigir a primeira rodada de /dw-plan prd.]
 
-- Como [persona], eu posso [acao] para que [beneficio]
-- Como [persona], eu posso [acao] para que [beneficio]
+- Como [persona], eu posso [ação] para que [benefício]
+- Como [persona], eu posso [ação] para que [benefício]
 
-Se voce ainda nao tem a primeira feature em mente, tudo bem — deixa placeholder e roda o /dw-plan prd quando tiver.
+Se você ainda não tem a primeira feature em mente, tudo bem — deixa placeholder e roda o /dw-plan prd quando tiver.
 
-## Nao Estou Fazendo (explicito)
+## Não Estou Fazendo (explícito)
 
-[Itens tentadores adiados. Forca disciplina de escopo.]
+[Itens tentadores adiados. Força disciplina de escopo.]
 
 - **[item 1]** — motivo: [fora do v1 porque...]
 - **[item 2]** — motivo: [pode virar v2 se a hipotese X validar]
@@ -113,19 +113,19 @@ Se voce ainda nao tem a primeira feature em mente, tudo bem — deixa placeholde
 ## Premissas-Chave
 
 - **[premissa sobre usuarios / mercado / escala]** — teste: [como validar]
-- **[premissa sobre latencia / volume / SLAs]** — teste: [load profile, metrica alvo]
+- **[premissa sobre latência / volume / SLAs]** — teste: [load profile, métrica alvo]
 
 ## Perguntas em Aberto
 
-[O que este one-pager nao consegue responder sozinho. Resolva antes do /dw-plan prd ou escale para um stakeholder.]
+[O que este one-pager não consegue responder sozinho. Resolva antes do /dw-plan prd ou escale para um stakeholder.]
 
 - [pergunta 1]
 - [pergunta 2]
 
-## Proximo Passo
+## Próximo Passo
 
 Escolha UM:
 
-- **`/dw-plan prd`** — quando voce tem a primeira feature em mente e quer rascunhar o PRD em cima deste stack
-- **`/dw-analyze-project`** — apos primeiro commit substancial, para enriquecer `.dw/rules/` com convencoes por modulo
-- **`/dw-secure-audit --plan --scan-only`** — para confirmar que nenhuma dep vulneravel veio dos templates `create-*`
+- **`/dw-plan prd`** — quando você tem a primeira feature em mente e quer rascunhar o PRD em cima deste stack
+- **`/dw-analyze-project`** — após primeiro commit substancial, para enriquecer `.dw/rules/` com convenções por módulo
+- **`/dw-secure-audit --plan --scan-only`** — para confirmar que nenhuma dep vulnerável veio dos templates `create-*`