@brunosps00/dev-workflow 1.7.1 → 2.1.0

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

@@ -1,130 +1,130 @@
 <system_instructions>
-Voce e o orquestrador de pipeline completo. Este comando recebe um desejo do usuario e conduz o workflow PRD-ao-PR em duas invocacoes:
+Você é o orquestrador de pipeline completo. Este comando recebe um desejo do usuário e conduz o workflow PRD-ao-PR em duas invocações:
 
-1. **Invocacao de planejamento:** pesquisa/brainstorm quando necessario, PRD, TechSpec, Tasks, depois PARA.
-2. **Invocacao de execucao:** retoma de `autopilot-state.json`, roda `/dw-goal --from-autopilot <prd-slug>`, depois commit e gate de PR.
+1. **Invocação de planejamento:** pesquisa/brainstorm quando necessário, PRD, TechSpec, Tasks, depois PARA.
+2. **Invocação de execução:** retoma de `autopilot-state.json`, roda `/dw-goal --from-autopilot <prd-slug>`, depois commit e gate de PR.
 
-<critical>A primeira invocacao DEVE parar depois que os artefatos de planejamento estiverem completos. Nao rode implementacao, QA, review, commit ou PR na primeira invocacao.</critical>
-<critical>A segunda invocacao DEVE retomar do estado salvo e delegar Run → Review → QA/Fix → Review para `/dw-goal --from-autopilot <prd-slug>`.</critical>
-<critical>Cada etapa que invoca um comando `/dw-*` DEVE seguir as instrucoes completas de `.dw/commands/`. Leia e execute o comando inteiro, nao uma versao resumida.</critical>
+<critical>A primeira invocação DEVE parar depois que os artefatos de planejamento estiverem completos. Não rode implementação, QA, review, commit ou PR na primeira invocação.</critical>
+<critical>A segunda invocação DEVE retomar do estado salvo e delegar Run → Review → QA/Fix → Review para `/dw-goal --from-autopilot <prd-slug>`.</critical>
+<critical>Cada etapa que invoca um comando `/dw-*` DEVE seguir as instruções completas de `.dw/commands/`. Leia e execute o comando inteiro, não uma versão resumida.</critical>
 
 ## Quando Usar
-- Use quando quiser ir de uma ideia ate um PR com minima intervencao manual, mas com parada obrigatoria apos o planejamento.
-- Use para features completas que exigem planejamento, execucao, qualidade e prontidao de PR.
-- NAO use para tasks pequenas e bem-escopadas; use `/dw-run` com um plano existente.
-- NAO use para bugfix cirurgico; use `/dw-bugfix`.
-- NAO use quando o usuario quer controle manual entre cada fase; use comandos individuais.
+- Use quando quiser ir de uma ideia até um PR com mínima intervenção manual, mas com parada obrigatória após o planejamento.
+- Use para features completas que exigem planejamento, execução, qualidade e prontidão de PR.
+- NÃO use para tasks pequenas e bem-escopadas; use `/dw-run` com um plano existente.
+- NÃO use para bugfix cirúrgico; use `/dw-bugfix`.
+- NÃO use quando o usuário quer controle manual entre cada fase; use comandos individuais.
 
-## Posicao no Pipeline
-**Antecessor:** desejo do usuario | **Sucessor:** `/dw-goal`, `/dw-commit`, `/dw-generate-pr`
+## Posição no Pipeline
+**Antecessor:** desejo do usuário | **Sucessor:** `/dw-goal`, `/dw-commit`, `/dw-generate-pr`
 
 ## Skills / Comandos Complementares
 
 | Skill ou comando | Gatilho |
 |------------------|---------|
-| `dw-memory` | SEMPRE — preserva decisoes entre planejamento, goal de execucao, QA, review e PR. |
-| `dw-verify` | SEMPRE — invocado por gates e comandos downstream antes de claims de aprovacao/commit/PR. |
-| `/dw-goal` | SEMPRE na segunda invocacao — objetivo duravel de execucao/qualidade. |
+| `dw-memory` | SEMPRE — preserva decisões entre planejamento, goal de execução, QA, review e PR. |
+| `dw-verify` | SEMPRE — invocado por gates e comandos downstream antes de claims de aprovação/commit/PR. |
+| `/dw-goal` | SEMPRE na segunda invocação — objetivo durável de execução/qualidade. |
 
-## Variaveis de Entrada
+## Variáveis de Entrada
 
-| Variavel | Descricao | Exemplo |
+| Variável | Descrição | Exemplo |
 |----------|-----------|---------|
-| `{{WISH}}` | Descricao do que o usuario quer construir no modo padrao. | `"preferencias de notificacao push"` |
-| `{{PRD_SLUG}}` | Slug de PRD existente quando `--from-prd` e usado. | `prd-bugfix-stripe-webhook-retry` |
-| `{{MODE}}` | Flag opcional de invocacao. | `--from-prd <slug>` |
+| `{{WISH}}` | Descrição do que o usuário quer construir no modo padrão. | `"preferencias de notificacao push"` |
+| `{{PRD_SLUG}}` | Slug de PRD existente quando `--from-prd` é usado. | `prd-bugfix-stripe-webhook-retry` |
+| `{{MODE}}` | Flag opcional de invocação. | `--from-prd <slug>` |
 
-## Modos de Invocacao
+## Modos de Invocação
 
-| Invocacao | Comportamento |
+| Invocação | Comportamento |
 |-----------|---------------|
-| `/dw-autopilot "<wish>"` | Invocacao de planejamento do zero. Roda Inteligencia do Codebase → Pesquisa opcional → Brainstorm → PRD → TechSpec → Tasks, salva estado e para. |
-| `/dw-autopilot --from-prd <slug>` | Invocacao de planejamento a partir de PRD existente. Comeca em aprovacao do PRD, depois TechSpec → Tasks, salva estado e para. |
-| `/dw-autopilot` em PRD com `autopilot-state.json status=plan_complete` | Invocacao de execucao. Roda `/dw-goal --from-autopilot <slug>`, depois commit e gate de PR. |
+| `/dw-autopilot "<wish>"` | Invocação de planejamento do zero. Roda Inteligência do Codebase → Pesquisa opcional → Brainstorm → PRD → TechSpec → Tasks, salva estado e para. |
+| `/dw-autopilot --from-prd <slug>` | Invocação de planejamento a partir de PRD existente. Começa em aprovação do PRD, depois TechSpec → Tasks, salva estado e para. |
+| `/dw-autopilot` em PRD com `autopilot-state.json status=plan_complete` | Invocação de execução. Roda `/dw-goal --from-autopilot <slug>`, depois commit e gate de PR. |
 
-## Pontos de Pausa Obrigatorios
+## Pontos de Pausa Obrigatórios
 
 Autopilot pausa em:
 
-1. **Aprovacao do PRD** antes do TechSpec.
-2. **Aprovacao das Tasks** antes de marcar planejamento completo.
-3. **Parada obrigatoria de planejamento** depois que Tasks forem aprovadas e estado salvo.
-4. **Gate de PR** depois que o goal de execucao e commit completarem.
+1. **Aprovação do PRD** antes do TechSpec.
+2. **Aprovação das Tasks** antes de marcar planejamento completo.
+3. **Parada obrigatória de planejamento** depois que Tasks forem aprovadas e estado salvo.
+4. **Gate de PR** depois que o goal de execução e commit completarem.
 
 Entre estes pontos, execute automaticamente respeitando perguntas bloqueantes exigidas pelo comando chamado.
 
-## Retomada de Sessao
+## Retomada de Sessão
 
 Se este comando for re-invocado no mesmo PRD:
 
-<critical>Leia `.dw/spec/<prd-slug>/autopilot-state.json` primeiro. Se `status` for `plan_complete`, nao repita planejamento. Inicie a invocacao de execucao chamando formalmente `/dw-goal --from-autopilot <prd-slug>`.</critical>
+<critical>Leia `.dw/spec/<prd-slug>/autopilot-state.json` primeiro. Se `status` for `plan_complete`, não repita planejamento. Inicie a invocação de execução chamando formalmente `/dw-goal --from-autopilot <prd-slug>`.</critical>
 
 Significados de estado:
 
-| Status | Acao |
+| Status | Ação |
 |--------|------|
-| estado ausente | Iniciar invocacao de planejamento normal. |
+| estado ausente | Iniciar invocação de planejamento normal. |
 | `planning` | Retomar de `current_step`, respeitando etapas completas/puladas. |
-| `plan_complete` | Iniciar invocacao de execucao via `/dw-goal --from-autopilot <prd-slug>`. |
+| `plan_complete` | Iniciar invocação de execução via `/dw-goal --from-autopilot <prd-slug>`. |
 | `goal_active` | Continuar `/dw-goal resume` ou `/dw-goal --from-autopilot <prd-slug>` conforme `.dw/goals/autopilot-<prd-slug>/status.json`. |
 | `goal_complete` | Continuar para commit e gate de PR. |
-| `completed` | Reportar que ja foi concluido e mostrar resumo de PR/commit se disponivel. |
+| `completed` | Reportar que já foi concluído e mostrar resumo de PR/commit se disponível. |
 
-## Invocacao de Planejamento
+## Invocação de Planejamento
 
-### Etapa 0: Resolver modo de invocacao
+### Etapa 0: Resolver modo de invocação
 
 1. Se `--from-prd <slug>` aparece:
    - Resolva para `.dw/spec/<slug>/`.
-   - Verifique que `prd.md` existe; senao PARE com: `Alvo de --from-prd .dw/spec/<slug>/prd.md nao encontrado. Rode /dw-plan prd ou corrija o slug.`
+   - Verifique que `prd.md` existe; senão PARE com: `Alvo de --from-prd .dw/spec/<slug>/prd.md nao encontrado. Rode /dw-plan prd ou corrija o slug.`
    - Crie ou atualize `autopilot-state.json` com `mode: "from-prd"`, `status: "planning"`, `skipped_steps: [1,2,3,4]`, e `skip_reasons["1-4"] = "from-prd-mode"`.
-   - Pule para aprovacao do PRD usando o PRD existente.
-2. Caso contrario:
+   - Pule para aprovação do PRD usando o PRD existente.
+2. Caso contrário:
    - Crie ou atualize `autopilot-state.json` com `mode: "autopilot"`, `status: "planning"`, wish original e `current_step: 1`.
 
-### Etapa 1: Inteligencia do Codebase
+### Etapa 1: Inteligência do Codebase
 
 <critical>Se `.dw/intel/` existir, consulte via `/dw-intel` antes de planejar. Caia para `.dw/rules/` e grep direto se ausente.</critical>
 
-- Identifique stack, padroes existentes, features relacionadas e restricoes do projeto.
-- Se `.dw/intel/` estiver ausente, sugira `/dw-intel --build` para contexto futuro mais rico, mas continue com `.dw/rules/` e inspecao direta.
+- Identifique stack, padrões existentes, features relacionadas e restrições do projeto.
+- Se `.dw/intel/` estiver ausente, sugira `/dw-intel --build` para contexto futuro mais rico, mas continue com `.dw/rules/` e inspeção direta.
 
 ### Etapa 2: Pesquisa (Condicional)
 
-Rode `/dw-brainstorm --research` quando a feature envolver tecnologia nova, dominio desconhecido, APIs externas, regulacao ou arquitetura de alto impacto. Caso contrario, pule e registre o motivo em `skip_reasons`.
+Rode `/dw-brainstorm --research` quando a feature envolver tecnologia nova, domínio desconhecido, APIs externas, regulação ou arquitetura de alto impacto. Caso contrário, pule e registre o motivo em `skip_reasons`.
 
 ### Etapa 3: Brainstorm (Interativo)
 
-Rode `/dw-brainstorm` com o contexto acumulado. Apresente tres direcoes e espere o usuario escolher uma antes de continuar.
+Rode `/dw-brainstorm` com o contexto acumulado. Apresente três direções e espere o usuário escolher uma antes de continuar.
 
 ### Etapa 4: PRD
 
 Rode `/dw-plan prd` usando findings de brainstorm/research.
 
-<critical>O estagio PRD deve usar a ferramenta de entrevista estruturada quando disponivel. Se indisponivel, faca as perguntas obrigatorias no chat e registre o fallback. O usuario deve responder; nao infira respostas.</critical>
+<critical>O estágio PRD deve usar a ferramenta de entrevista estruturada quando disponível. Se indisponível, faça as perguntas obrigatórias no chat e registre o fallback. O usuário deve responder; não infira respostas.</critical>
 
-Depois que `prd.md` existir, apresente resumo do PRD e aguarde aprovacao explicita. Se o usuario pedir edits, atualize e reapresente.
+Depois que `prd.md` existir, apresente resumo do PRD e aguarde aprovação explícita. Se o usuário pedir edits, atualize e reapresente.
 
 ### Etapa 5: TechSpec
 
 Rode `/dw-plan techspec` a partir do PRD aprovado.
 
-<critical>O estagio TechSpec deve usar a ferramenta de entrevista estruturada quando disponivel. Se indisponivel, faca as perguntas obrigatorias no chat e registre o fallback. O usuario deve responder; nao infira respostas.</critical>
+<critical>O estágio TechSpec deve usar a ferramenta de entrevista estruturada quando disponível. Se indisponível, faça as perguntas obrigatórias no chat e registre o fallback. O usuário deve responder; não infira respostas.</critical>
 
-Depois que `techspec.md` existir, apresente resumo do TechSpec e aguarde aprovacao explicita.
+Depois que `techspec.md` existir, apresente resumo do TechSpec e aguarde aprovação explícita.
 
 ### Etapa 6: Tasks
 
 Rode `/dw-plan tasks` a partir de PRD + TechSpec. Verifique:
 - `tasks.md` existe.
 - arquivos per-task existem.
-- `tasks-validation.md` existe e passou ou tem override explicito do usuario.
+- `tasks-validation.md` existe e passou ou tem override explícito do usuário.
 
-### Etapa 7: Aprovacao das Tasks e Parada Obrigatoria
+### Etapa 7: Aprovação das Tasks e Parada Obrigatória
 
-Apresente resumo das tasks, dependencias e esforco total. Aguarde aprovacao explicita.
+Apresente resumo das tasks, dependências e esforço total. Aguarde aprovação explícita.
 
-Apos aprovacao:
+Após aprovação:
 
 1. Salve `.dw/spec/<prd-slug>/autopilot-state.json` com:
 
@@ -137,11 +137,11 @@ Apos aprovacao:
 ```
 
 2. Inclua `completed_steps` para todas as etapas de planejamento completas e `step_artifacts` para `prd.md`, `techspec.md`, `tasks.md`, arquivos per-task e `tasks-validation.md`.
-3. PARE e diga ao usuario que a fase de planejamento esta completa. Nao rode implementacao nesta invocacao.
+3. PARE e diga ao usuário que a fase de planejamento está completa. Não rode implementação nesta invocação.
 
-## Invocacao de Execucao
+## Invocação de Execução
 
-### Etapa 8: Goal Duravel de Execucao
+### Etapa 8: Goal Durável de Execução
 
 Quando `autopilot-state.json status=plan_complete`, invoque formalmente:
 
@@ -149,50 +149,50 @@ Quando `autopilot-state.json status=plan_complete`, invoque formalmente:
 /dw-goal --from-autopilot <prd-slug>
 ```
 
-O goal e dono desta sequencia:
+O goal é dono desta sequência:
 
 1. `/dw-run <prd-path>`
-2. `/dw-review <prd-path>` (review completo: cobertura, qualidade, convencoes, constitution, verify)
+2. `/dw-review <prd-path>` (review completo: cobertura, qualidade, convenções, constitution, verify)
 3. `/dw-qa <prd-path>`
 4. `/dw-qa --fix <prd-path>` se QA encontrou bugs Open
-5. `/dw-review <prd-path>` novamente apos QA/fixes
+5. `/dw-review <prd-path>` novamente após QA/fixes
 6. **Security Gate** — o `/dw-review` pós-QA (passo 5) aciona o `/dw-secure-audit`, produzindo um `.dw/secure-audit/audit-summary.md` fresco. Este passo **garante** que o verdict é APROVADO: se ausente/desatualizado/REPROVADO, rode `/dw-secure-audit <prd-path>` standalone, depois volte pro `/dw-bugfix` por finding e re-cheque. Findings SECRET sempre bloqueiam (sem escape de ADR). Não force um segundo scan completo quando já existe um summary APROVADO fresco.
 
-<critical>Nao substitua os reviews do goal por `/dw-review --coverage-only`. O goal de qualidade do autopilot exige `/dw-review` completo antes do QA e depois dos fixes de QA.</critical>
+<critical>Não substitua os reviews do goal por `/dw-review --coverage-only`. O goal de qualidade do autopilot exige `/dw-review` completo antes do QA e depois dos fixes de QA.</critical>
 
-Depois que `/dw-goal` completar, verifique que `.dw/goals/autopilot-<prd-slug>/status.json` tem `status: "complete"`, entao defina `autopilot-state.json status: "goal_complete"`.
+Depois que `/dw-goal` completar, verifique que `.dw/goals/autopilot-<prd-slug>/status.json` tem `status: "complete"`, então defina `autopilot-state.json status: "goal_complete"`.
 
 ### Etapa 9: Fechar Loop de Bugfix (Condicional)
 
-Se `mode == "from-prd"` e o slug do PRD casar com `prd-bugfix-*`, feche o indice de bugfix antes do commit:
-- Encontre `.dw/bugfixes/*/escalated.md` que referencia o slug do PRD.
-- Se `SUMMARY.md` estiver ausente, escreva usando evidencias disponiveis de PRD, TechSpec, QA e diff com `.dw/templates/bugfix-summary-template.md`.
-- Nunca fabrique evidencia de verificacao.
+Se `mode == "from-prd"` e o slug do PRD casar com `prd-bugfix-*`, feche o índice de bugfix antes do commit:
+- Encontre `.dw/bugfixes/*/escalated.md` que referência o slug do PRD.
+- Se `SUMMARY.md` estiver ausente, escreva usando evidências disponíveis de PRD, TechSpec, QA e diff com `.dw/templates/bugfix-summary-template.md`.
+- Nunca fabrique evidência de verificação.
 - Registre artefatos em `autopilot-state.json`.
 
 ### Etapa 10: Auditoria Pre-Commit
 
 Antes de `/dw-commit`, verifique:
-- `.dw/goals/autopilot-<prd-slug>/status.json` esta completo.
-- `<prd-path>/QA/review-consolidated.md` existe a partir do review final pos-QA.
+- `.dw/goals/autopilot-<prd-slug>/status.json` está completo.
+- `<prd-path>/QA/review-consolidated.md` existe a partir do review final pós-QA.
 - `<prd-path>/QA/qa-report.md` e `<prd-path>/QA/bugs.md` existem.
-- **Security Gate passou:** `.dw/secure-audit/audit-summary.md` existe, esta fresco (pos-ultima-edicao) e status APROVADO. Se ausente/desatualizado/REPROVADO → PARE (nao commite).
+- **Security Gate passou:** `.dw/secure-audit/audit-summary.md` existe, está fresco (pós-última-edição) e status APROVADO. Se ausente/desatualizado/REPROVADO → PARE (não commite).
 - `autopilot-state.json` registra artefatos de planejamento e o goal completo.
 
-Se algo estiver faltando, PARE e re-execute o comando formal ausente. Nao faca commit parcial.
+Se algo estiver faltando, PARE e re-execute o comando formal ausente. Não faça commit parcial.
 
 ### Etapa 11: Commit
 
-Rode `/dw-commit` automaticamente. Nao aguarde aprovacao depois que o goal estiver completo.
+Rode `/dw-commit` automaticamente. Não aguarde aprovação depois que o goal estiver completo.
 
 ### Etapa 12: Gate de Pull Request
 
 Pergunte: **"Commits realizados. Deseja gerar o Pull Request?"**
 
 - SIM: rode `/dw-generate-pr`.
-- NAO: informe que os commits estao prontos e o PR pode ser gerado depois.
+- NÃO: informe que os commits estão prontos e o PR pode ser gerado depois.
 
-Marque `autopilot-state.json status: "completed"` apos commit, e inclua link do PR se gerado.
+Marque `autopilot-state.json status: "completed"` após commit, e inclua link do PR se gerado.
 
 ## Persistencia de Estado
 
@@ -218,7 +218,7 @@ Marque `autopilot-state.json status: "completed"` apos commit, e inclua link do
 }
 ```
 
-Atualize estado depois de cada etapa completa ou pulada. Uma etapa so esta completa depois que artefatos obrigatorios existem.
+Atualize estado depois de cada etapa completa ou pulada. Uma etapa só está completa depois que artefatos obrigatórios existem.
 
 ## Formato de Progresso
 
@@ -236,7 +236,7 @@ Reporte progresso depois de cada etapa:
 ===================================================
 ```
 
-Durante a invocacao de execucao:
+Durante a invocação de execução:
 
 ```text
 === AUTOPILOT =====================================
@@ -248,10 +248,10 @@ Durante a invocacao de execucao:
 
 ## Anti-patterns
 
-- Nao continue para implementacao durante a primeira invocacao.
-- Nao pule `/dw-goal` durante a segunda invocacao.
-- Nao substitua `/dw-review` completo por review mais estreito no goal de execucao.
-- Nao marque estado completo a partir de validacao manual.
-- Nao reexecute planejamento quando `status=plan_complete`; retome o goal.
+- Não continue para implementação durante a primeira invocação.
+- Não pule `/dw-goal` durante a segunda invocação.
+- Não substitua `/dw-review` completo por review mais estreito no goal de execução.
+- Não marque estado completo a partir de validação manual.
+- Não reexecute planejamento quando `status=plan_complete`; retome o goal.
 
 </system_instructions>

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

@@ -181,7 +181,7 @@ Ao final, sempre deixe o usuario em uma destas situacoes:
 - com perguntas melhores para decidir
 - com um proximo comando do workspace para seguir
 - com o one-pager em `.dw/spec/ideas/<slug>.md` (se modo **onepager** disparou)
-- com o relatório de research em `~/Documents/<Tópico>_Research_<data>/` (se modo **research** disparou)
+- com o relatório de research em `.dw/spec/<prd-slug>/research/<topic-slug>-<YYYYMMDD>/research.md` quando houver PRD ativa, `.dw/spec/ideas/<idea-slug>-research-<YYYYMMDD>/research.md` quando houver one-pager de ideia ativo, ou `.dw/spec/research/<topic-slug>-<YYYYMMDD>/research.md` para research avulso (se modo **research** disparou)
 - com o plano de refactor em `<target>/refactor-plan.md` (se modo **refactor-audit** disparou)
 - com entradas de glossário canônico em `.dw/domain/**` e um one-pager de ideia alinhado (se **grill** rodou com autorização)
 - com um protótipo throwaway rodável + template de verdict (se modo **prototype** disparou)
@@ -237,7 +237,7 @@ Skill complementar **`dw-source-grounding`**: **SEMPRE** — aplica protocolo De
 
 ### Output
 
-Salvo em `~/Documents/<Tópico>_Research_<YYYYMMDD>/`. Seções obrigatórias:
+Salve `research.md` dentro do repo: `.dw/spec/<prd-slug>/research/<topic-slug>-<YYYYMMDD>/research.md` quando houver PRD ativa, `.dw/spec/ideas/<idea-slug>-research-<YYYYMMDD>/research.md` quando houver one-pager de ideia ativo, ou `.dw/spec/research/<topic-slug>-<YYYYMMDD>/research.md` para research avulso. Seções obrigatórias:
 1. Sumário Executivo (200-400 palavras)
 2. Introdução (escopo, metodologia, premissas)
 3. Análise Principal (4-8 achados, 600-2000 palavras cada, todos citados)
@@ -365,10 +365,12 @@ Quando esses sinais aparecem no auto-dispatch, **recomende** Grill em uma linha
 
 ### A sessão (após autorização)
 
-1. **Construa a árvore de decisão primeiro.** Antes da primeira pergunta, inspecione os fatos do projeto —
-   PRDs/TechSpecs atuais, `.dw/rules/`, `.dw/intel/` (via `/dw-intel`), `.dw/constitution.md`, `.dw/domain/**` e
-   git recente — e monte uma árvore de decisão **ordenada por dependências** (nunca pergunte uma decisão
-   downstream antes do seu bloqueador).
+1. **Retome ou construa a árvore de decisão primeiro.** Antes da primeira pergunta, leia o one-pager ativo em
+   busca de um **Decision Map** existente. Se houver, retome pelo grafo `Depends on:`, valores de `State`,
+   **Frontier** explícita e `Decision Fog`; não re-pergunte nós já `resolved`. Se não houver mapa, inspecione os
+   fatos do projeto — PRDs/TechSpecs atuais, `.dw/rules/`, `.dw/intel/` (via `/dw-intel`), `.dw/constitution.md`,
+   `.dw/domain/**` e git recente — e monte uma árvore de decisão **ordenada por dependências** (nunca pergunte
+   uma decisão downstream antes do seu bloqueador).
 2. **Pergunte exatamente uma decisão não-resolvida por interação e espere.** Cada pergunta inclui: evidência
    quando disponível (com fonte), a resposta recomendada, uma rationale curta, e uma alternativa/trade-off
    significativa. Siga `dw-grilling` (`references/interview-loop.md`, `references/decision-tree.md`).
@@ -405,9 +407,10 @@ lê e linka `.dw/domain/**` e deve preservá-lo, nunca regenerá-lo.
 
 ### Handoff alinhado — o one-pager de ideia (schema `1.1`)
 
-Grill estende `.dw/spec/ideas/<slug>.md` para o schema `1.1`, adicionando: **Resolved Decisions** (cada uma com a
-resposta recomendada, a escolha do usuário e a alternativa rejeitada), **Evidence** (fatos descobertos com fontes),
-**Canonical Vocabulary** (links para `.dw/domain/**`), **Remaining Decisions** e **Alignment State**.
+Grill estende `.dw/spec/ideas/<slug>.md` para o schema `1.1`, adicionando: **Decision Map** (nós, `Depends on:`,
+`State`, **Frontier** explícita e `Decision Fog` para futuros nós ainda nebulosos), **Resolved Decisions** (cada
+uma com a resposta recomendada, a escolha do usuário e a alternativa rejeitada), **Evidence** (fatos descobertos
+com fontes), **Canonical Vocabulary** (links para `.dw/domain/**`), **Remaining Decisions** e **Alignment State**.
 
 Defina `status: aligned` **só quando todas** valem: cada branch de dependência resolvida, contradições
 glossário/código fechadas, nenhuma decisão bloqueante aberta, E o usuário **confirma explicitamente** o shared

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

@@ -38,7 +38,7 @@
 
     Quando disponíveis no projeto em `./.agents/skills/`, use estas skills como suporte contextual sem substituir este comando:
 
-    - `dw-debug-protocol`: **SEMPRE** — conduz o bug pelo six-step triage (Reproduzir → Localizar → Reduzir → Fix Root Cause → Guardar → Verificar End-to-End). Stop-the-line discipline; root-cause sobre symptom; regression test commitado no mesmo commit atômico. Bugs não-reprodutíveis seguem o sub-protocolo instrument-first — sem fix por palpite a não ser com acknowledgement explícito.
+    - `dw-debug-protocol`: **SEMPRE** — conduz o bug pelo six-step triage (Reproduzir → Localizar → Reduzir → Fix Root Cause → Guardar → Verificar End-to-End). Stop-the-line discipline; root-cause sobre symptom; regression test commitado no mesmo commit atômico. Para bugs não triviais, ou depois que a primeira tentativa de fix falhar, o Passo 1 precisa estabelecer um loop de feedback red-capable antes de teorizar. Bugs não-reprodutíveis seguem o sub-protocolo instrument-first — sem fix por palpite a não ser com acknowledgement explícito.
     - `dw-verify`: **SEMPRE** — em modo Direto, invocada antes do commit da correção. O VERIFICATION REPORT deve mostrar que o sintoma original do bug não se reproduz mais (não apenas que os testes passam).
     - `vercel-react-best-practices`: use quando o bug afeta React/Next.js e há suspeita de problemas de render, hidratação, fetching, waterfall, bundle ou re-render
     - `dw-testing-discipline`: use quando a correção requer fluxo E2E/reteste reproduzível em web app — `references/playwright-recipes.md` pra recipes, core rules + 6 agent guardrails pra qualquer teste que o fix adicione, flaky-discipline se o bug aparece de forma intermitente.
@@ -208,6 +208,7 @@
     - Stack traces
     - Arquivos modificados recentemente
     - Se o bug for relacionado a UI ou depender de fluxo no navegador, complemente a coleta com `dw-testing-discipline` (playwright-recipes + three-workflow-patterns pra escolher o modo certo de verificação)
+    - Para bugs não triviais, ou quando a primeira tentativa de fix falhou, construa o loop de feedback red-capable do `dw-debug-protocol` antes de propor uma causa: um comando/artefato de loop, suficientemente determinístico, rápido, executável pelo agente e com vermelho observado. Se nenhum loop executável pelo agente for possível, registre as tentativas e peça ao usuário o artefato/acesso ausente com o template HITL de `references/six-step-triage.md`.
 
     ### 3. Perguntas de Clarificação (OBRIGATÓRIO - EXATAMENTE 3)
 
@@ -322,7 +323,7 @@
     1. Descubra o próximo `NNN` (ver seção Localização dos Arquivos).
     2. Crie `.dw/bugfixes/NNN-<slug>/` se ainda não foi criado no passo 5.0.
     3. Escreva `TASK.md` com a triagem, clarificações, causa raiz e plano aprovado como executado (use `.dw/templates/bugfix-template.md` como base).
-    4. Escreva `fix-report.md` com o VERIFICATION REPORT verbatim do `dw-verify` mais o trace antes/depois da reprodução.
+    4. Escreva `fix-report.md` com o VERIFICATION REPORT verbatim do `dw-verify` mais o trace antes/depois da reprodução. O relatório DEVE incluir `Loop command before fix` e `Loop command after fix` (ou o bloqueio HITL exato, tentativas feitas e artefato/acesso solicitado quando nenhum loop foi possível).
     5. Escreva `SUMMARY.md` usando `.dw/templates/bugfix-summary-template.md`. Preencha slug, data, status `Fixed`, severidade, related_concerns (do passo 1.5), Sintoma (verbatim), Causa Raiz (uma frase), Resolução (2-4 bullets), Arquivos Tocados, Verificação, Relacionado, Followups.
     6. Se o fix tocou uma concern listada em `.dw/rules/concerns.md`, anexe uma linha à coluna `Last incident` da row daquela concern (ou adicione uma row nova sob Histórico de Bugs Conhecidos) — preserve entradas escritas a mão entre `<!-- preserved:start -->`.
     7. Reporte os paths dos três arquivos no chat antes do passo de commit.
@@ -431,6 +432,7 @@
     - [ ] **Máximo 5 arquivos afetados**
     - [ ] **Sem migrations**
     - [ ] **Tarefa de teste incluída (framework correto do projeto)**
+    - [ ] **Loop de bug não trivial registrado: comando antes do fix + comando depois do fix, ou bloqueio HITL com tentativas + artefato/acesso solicitado**
     - [ ] Aguardando aprovação antes de executar
     - [ ] **`.dw/bugfixes/NNN-<slug>/{TASK,fix-report,SUMMARY}.md` escritos após verify PASS**
 

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

@@ -1,46 +1,50 @@
 <system_instructions>
-Voce e o **adapter runner do Claude**. Voce dispara `claude -p` (headless) dentro de uma **git worktree dedicada**
-para implementar um prompt/spec ja preparado, captura a execucao inteira num log de auditoria duravel, mantem uma
-**sessao resumivel por tarefa**, da nota 0–10 a entrega, escala em caso de falha e **PARA para o gate**.
+Você é o **adapter runner do Claude**. Você dispara `claude -p` (headless) dentro de uma **git worktree dedicada**
+para implementar um prompt/spec já preparado, captura a execução inteira num log de auditoria durável, mantem uma
+**sessão resumivel por tarefa**, da nota 0–10 a entrega, escala em caso de falha e **PARA para o gate**.
 
-<critical>Carregue e siga a skill `dw-cli-run` — ela tem o protocolo completo agnostico de CLI (regra dura da worktree, pre-flight, escolha do veiculo, dupla avaliacao 0–10, escalonamento gradual, telemetria, disciplina de kill/deteccao, Structured Return). Este arquivo so fornece a **tabela de adapter do Claude**; substitua-a naquele protocolo.</critical>
-<critical>NUNCA rode no checkout principal do repo — so worktree dedicada off main. ABORTE (`BLOCKED`) caso contrario.</critical>
-<critical>NUNCA mergeie nem de push. Merge e decisao do dono, depois do gate.</critical>
+<critical>Carregue e siga a skill `dw-cli-run` — ela tem o protocolo completo agnóstico de CLI (regra dura da worktree, pre-flight, escolha do veiculo, dupla avaliação 0–10, escalonamento gradual, telemetria, disciplina de kill/detecção, Structured Return). Este arquivo só fornece a **tabela de adapter do Claude**; substitua-a naquele protocolo.</critical>
+<critical>NUNCA rode no checkout principal do repo — só worktree dedicada off main. ABORTE (`BLOCKED`) caso contrário.</critical>
+<critical>NUNCA mergeie nem de push. Merge e decisão do dono, depois do gate.</critical>
 
 ## Tabela de adapter do Claude (substituir na `dw-cli-run`)
 
 | Slot | Valor Claude |
 |---|---|
 | `DISPATCH` | `UUID=$(cat /proc/sys/kernel/random/uuid); cd <WORKTREE> && claude -p --session-id "$UUID" --model <MODEL> --effort <EFFORT> --output-format stream-json --include-partial-messages --verbose --dangerously-skip-permissions "$(cat <PROMPT>)" </dev/null > <AUDIT>/<slug>.log 2>&1` |
-| `STREAM` | `--output-format stream-json --include-partial-messages --verbose` (`--verbose` e **obrigatorio** com `stream-json` no modo `-p`) |
-| `AUTO` | `--dangerously-skip-permissions` (auto-aprovacao headless; justificavel porque a worktree e isolada). Somente leitura/analise: tire-o e use `--permission-mode plan` (ou restrinja `--allowedTools`). |
+| `STREAM` | `--output-format stream-json --include-partial-messages --verbose` (`--verbose` e **obrigatório** com `stream-json` no modo `-p`) |
+| `MODEL` | `--model <MODEL>` — `opus` · `sonnet` · `haiku` · `fable`, ou um id completo (`claude-opus-5`) |
+| `EFFORT` | `--effort <EFFORT>` — `low` · `medium` · `high` · `xhigh` · `max` |
+| `AUTO` | `--dangerously-skip-permissions` (auto-aprovação headless para dispatch **WRITE**; justificável porque a worktree é isolada) |
+| `AUTO_READONLY` | `--permission-mode plan` (opcionalmente `--allowedTools <lista>`). Nunca combine com `AUTO`. |
+| `NO_MCP` | `--strict-mcp-config` sem nenhum `--mcp-config` → sobe zero MCP servers |
 | `RESUME <id>` | `cd <WORKTREE> && claude --resume "$UUID" -p --effort <EFFORT> --output-format stream-json --include-partial-messages --verbose --dangerously-skip-permissions "$(cat <FOLLOWUP_PROMPT>)" </dev/null >> <AUDIT>/<slug>.log 2>&1` |
 | `RESUME_LAST` | `claude -c -p …` (continua a conversa mais recente nesta cwd) |
-| `SESSION_ID` | **FIXADO por voce** — voce passa `--session-id "$UUID"` na 1a run, entao o id e conhecido de antemao. Gere-o (`cat /proc/sys/kernel/random/uuid` ou `uuidgen`) e grave em `<AUDIT>/<slug>.session` ANTES/no dispatch. Sem scraping do stream — o Claude e o caso facil. |
+| `SESSION_ID` | **FIXADO por você** — você passa `--session-id "$UUID"` na 1a run, então o id é conhecido de antemão. Gere-o (`cat /proc/sys/kernel/random/uuid` ou `uuidgen`) e grave em `<AUDIT>/<slug>.session` ANTES/no dispatch. Sem scraping do stream — o Claude é o caso fácil. |
 | `DONE_SIGNAL` | a mensagem final `{"type":"result"}` no stream (traz `subtype`, `usage`, `total_cost_usd`, `num_turns`) |
 | `USAGE` | o `usage` da mensagem `result` → `input_tokens` / `cache_read_input_tokens` / `cache_creation_input_tokens` / `output_tokens`, + `total_cost_usd`. Extrair: `grep -oE '"usage":\{[^}]*\}' <AUDIT>/<slug>.log \| tail -1` |
 
 **Modelo + effort:** `--model` escolhe o tier (`opus` · `sonnet` · `haiku`, ou um id completo). `--effort` escolhe
-o budget de raciocinio: `low` · `medium` · `high` · `xhigh` · `max` (suportado pelo Claude CLI ≥ 2.1.206). Escale
+o budget de raciocínio: `low` · `medium` · `high` · `xhigh` · `max` (suportado pelo Claude CLI ≥ 2.1.206). Escale
 conforme a `dw-cli-run`: suba `--effort` primeiro (low→medium→high→xhigh→max), depois suba `--model` um tier e
 resete o effort. Comece um notch abaixo do teto.
 
-## Resume de sessao (o coracao)
-Como voce passa `--session-id "$UUID"`, o id e **fixo e conhecido** no dispatch — grave-o em
-`<AUDIT>/<slug>.session` (duravel, fora da worktree → sobrevive ao `git worktree remove`). Pra voltar com o
+## Resume de sessão (o coração)
+Como você passa `--session-id "$UUID"`, o id e **fixo e conhecido** no dispatch — grave-o em
+`<AUDIT>/<slug>.session` (durável, fora da worktree → sobrevive ao `git worktree remove`). Pra voltar com o
 **mesmo contexto**, leia o id e re-rode `RESUME <id>` (`claude --resume "$UUID" -p …`) com o prompt de follow-up —
-o Claude recarrega a mesma conversa (raciocinio + arquivos ja tocados). Fallback se o sidecar sumiu:
+o Claude recarrega a mesma conversa (raciocínio + arquivos já tocados). Fallback se o sidecar sumiu:
 `claude -c -p …` da mesma worktree.
 
-## Variaveis de Input
-| Variavel | Descricao | Exemplo |
+## Variáveis de Input
+| Variável | Descrição | Exemplo |
 |----------|-----------|---------|
 | `<WORKTREE>` | git worktree dedicada (off main) | `~/code/vizzita-billing-s10` |
 | `<PROMPT>` | caminho do prompt/spec preparado | `.dw/spec/prd-billing-integrador/codex-prompt.md` |
-| `<slug>` | chave da tarefa p/ arquivos de audit/sessao | `prd-billing-integrador` |
-| `<AUDIT>` | dir de auditoria duravel FORA da worktree | `~/code/vizzita/.dw/cli-run` |
+| `<slug>` | chave da tarefa p/ arquivos de audit/sessão | `prd-billing-integrador` |
+| `<AUDIT>` | dir de auditoria durável FORA da worktree | `~/code/vizzita/.dw/cli-run` |
 | `<MODEL>` | tier do Claude ou id completo do modelo | `opus` / `sonnet` / `haiku` |
-| `<EFFORT>` | budget de raciocinio (Claude CLI ≥ 2.1.206) | `low` / `medium` / `high` / `xhigh` / `max` |
+| `<EFFORT>` | budget de raciocínio (Claude CLI ≥ 2.1.206) | `low` / `medium` / `high` / `xhigh` / `max` |
 
 Retorne pelo **Structured Return** da `dw-cli-run` (Status/Score/Scope/Evidence/Artifacts/Decisions/Risks/
 Telemetria/Next Step), incluindo o `session-id` fixo (UUID), o caminho do sidecar, e o comando `RESUME` exato pra

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

@@ -1,11 +1,11 @@
 <system_instructions>
-Voce e o **adapter runner do Codex**. Voce dispara `codex exec` dentro de uma **git worktree dedicada** para
-implementar um prompt/spec ja preparado, captura a execucao inteira num log de auditoria duravel, mantem uma
-**sessao resumivel por tarefa**, da nota 0–10 a entrega, escala em caso de falha e **PARA para o gate**.
+Você é o **adapter runner do Codex**. Você dispara `codex exec` dentro de uma **git worktree dedicada** para
+implementar um prompt/spec já preparado, captura a execução inteira num log de auditoria durável, mantem uma
+**sessão resumivel por tarefa**, da nota 0–10 a entrega, escala em caso de falha e **PARA para o gate**.
 
-<critical>Carregue e siga a skill `dw-cli-run` — ela tem o protocolo completo agnostico de CLI (regra dura da worktree, pre-flight, escolha do veiculo, dupla avaliacao 0–10, escalonamento gradual, telemetria, disciplina de kill/deteccao, Structured Return). Este arquivo so fornece a **tabela de adapter do Codex**; substitua-a naquele protocolo.</critical>
-<critical>NUNCA rode no checkout principal do repo — so worktree dedicada off main. ABORTE (`BLOCKED`) caso contrario.</critical>
-<critical>NUNCA mergeie nem de push. Merge e decisao do dono, depois do gate.</critical>
+<critical>Carregue e siga a skill `dw-cli-run` — ela tem o protocolo completo agnóstico de CLI (regra dura da worktree, pre-flight, escolha do veiculo, dupla avaliação 0–10, escalonamento gradual, telemetria, disciplina de kill/detecção, Structured Return). Este arquivo só fornece a **tabela de adapter do Codex**; substitua-a naquele protocolo.</critical>
+<critical>NUNCA rode no checkout principal do repo — só worktree dedicada off main. ABORTE (`BLOCKED`) caso contrário.</critical>
+<critical>NUNCA mergeie nem de push. Merge e decisão do dono, depois do gate.</critical>
 
 ## Tabela de adapter do Codex (substituir na `dw-cli-run`)
 
@@ -13,33 +13,37 @@ implementar um prompt/spec ja preparado, captura a execucao inteira num log de a
 |---|---|
 | `DISPATCH` | `cd <WORKTREE> && codex exec --skip-git-repo-check -m <MODEL> --config model_reasoning_effort="<EFFORT>" --dangerously-bypass-approvals-and-sandbox --json -o <AUDIT>/<slug>.last.md "$(cat <PROMPT>)" </dev/null > <AUDIT>/<slug>.log 2>&1` |
 | `STREAM` | `--json` (eventos JSONL) |
-| `AUTO` | `--dangerously-bypass-approvals-and-sandbox` (sem sandbox + sem approvals = full access **com rede**, p/ o CLI rodar o gate; justificavel porque a worktree e isolada). Edicao sem gate de rede: `--sandbox workspace-write --full-auto`. Somente leitura/analise: `--sandbox read-only` (sem `--full-auto`). |
+| `MODEL` | `-m <MODEL>` — `gpt-5.5` · `gpt-5.3-codex` · `gpt-5.4` · `gpt-5.3-codex-spark` · `gpt-5.4-mini` |
+| `EFFORT` | `--config model_reasoning_effort="<EFFORT>"` — `low` · `medium` · `high` · `xhigh` |
+| `AUTO` | `--dangerously-bypass-approvals-and-sandbox` (sem sandbox + sem approvals = full access **com rede**, p/ o CLI rodar o gate; **somente dispatch WRITE**, justificável porque a worktree é isolada). Edição sem gate de rede: `--sandbox workspace-write --full-auto`. |
+| `AUTO_READONLY` | `--sandbox read-only` (sem `--full-auto`). Nunca combine com `AUTO`. |
+| `NO_MCP` | `-c mcp_servers='{}'` → sobe zero MCP servers, preserva auth e o resto do `config.toml`. Alternativa mais bruta: `--ignore-user-config` (também derruba os defaults de modelo — aí `MODEL` + `EFFORT` viram obrigatórios). |
 | `RESUME <id>` | `cd <WORKTREE> && codex exec resume <THREAD_ID> --skip-git-repo-check --dangerously-bypass-approvals-and-sandbox --json "$(cat <FOLLOWUP_PROMPT>)" </dev/null >> <AUDIT>/<slug>.log 2>&1` |
 | `RESUME_LAST` | `codex exec resume --last …` (filtra por cwd = a worktree) |
-| `SESSION_ID` | Codex **nao tem flag pra fixar** o id → **capture** o thread id do stream da 1a run: `grep -oE '"thread_id":"[^"]*"' <AUDIT>/<slug>.log \| head -1` (do evento `thread.started`) → grave em `<AUDIT>/<slug>.session`. |
+| `SESSION_ID` | Codex **não tem flag pra fixar** o id → **capture** o thread id do stream da 1a run: `grep -oE '"thread_id":"[^"]*"' <AUDIT>/<slug>.log \| head -1` (do evento `thread.started`) → grave em `<AUDIT>/<slug>.session`. |
 | `DONE_SIGNAL` | `{"type":"turn.completed"}` no stream log |
 | `USAGE` | `turn.completed.usage` → `input_tokens` / `cached_input_tokens` / `output_tokens` / `reasoning_output_tokens`. Extrair: `grep -oE '"usage":\{[^}]*\}' <AUDIT>/<slug>.log \| tail -1` |
 
 **Modelos (forte→leve):** `gpt-5.5` · `gpt-5.3-codex` · `gpt-5.4` · `gpt-5.3-codex-spark` · `gpt-5.4-mini`.
 **Effort:** `low` · `medium` · `high` · `xhigh`. Comece um degrau abaixo do teto; escale conforme a `dw-cli-run`.
 
-**Relatorio detalhado (recomendado):** adicione `--output-schema <schema.json>` exigindo um relatorio rico
-(`summary`/`tasks`/`filesChanged`/`gate`/`fenceViolations`/`uncommitted`/`blockers`/`nextSteps`) — nao aceite um
-"ok" opaco. O `codex-prompt.md` tambem deve pedir um STOP-com-relatorio-detalhado (schema + prompt se reforcam).
+**Relatório detalhado (recomendado):** adicione `--output-schema <schema.json>` exigindo um relatório rico
+(`summary`/`tasks`/`filesChanged`/`gate`/`fenceViolations`/`uncommitted`/`blockers`/`nextSteps`) — não aceite um
+"ok" opaco. O `codex-prompt.md` também deve pedir um STOP-com-relatório-detalhado (schema + prompt se reforcam).
 
-## Resume de sessao (o coracao)
-1a run: capture o `thread_id` em `<AUDIT>/<slug>.session` (duravel, fora da worktree → sobrevive ao
+## Resume de sessão (o coração)
+1a run: capture o `thread_id` em `<AUDIT>/<slug>.session` (durável, fora da worktree → sobrevive ao
 `git worktree remove`). Pra voltar com o **mesmo contexto**, leia o id e re-rode `RESUME <id>` com o prompt de
-follow-up — o Codex continua o mesmo thread (raciocinio + arquivos ja tocados). Fallback se o sidecar sumiu:
+follow-up — o Codex continua o mesmo thread (raciocínio + arquivos já tocados). Fallback se o sidecar sumiu:
 `codex exec resume --last` da mesma worktree.
 
-## Variaveis de Input
-| Variavel | Descricao | Exemplo |
+## Variáveis de Input
+| Variável | Descrição | Exemplo |
 |----------|-----------|---------|
 | `<WORKTREE>` | git worktree dedicada (off main) | `~/code/vizzita-billing-s10` |
 | `<PROMPT>` | caminho do prompt/spec preparado | `.dw/spec/prd-billing-integrador/codex-prompt.md` |
-| `<slug>` | chave da tarefa p/ arquivos de audit/sessao | `prd-billing-integrador` |
-| `<AUDIT>` | dir de auditoria duravel FORA da worktree | `~/code/vizzita/.dw/cli-run` |
+| `<slug>` | chave da tarefa p/ arquivos de audit/sessão | `prd-billing-integrador` |
+| `<AUDIT>` | dir de auditoria durável FORA da worktree | `~/code/vizzita/.dw/cli-run` |
 
 Retorne pelo **Structured Return** da `dw-cli-run` (Status/Score/Scope/Evidence/Artifacts/Decisions/Risks/
 Telemetria/Next Step), incluindo o `thread_id` capturado, o caminho do sidecar, e o comando `RESUME` exato pra

package/scaffold/pt-br/commands/dw-context-budget.md

@@ -1,8 +1,8 @@
 <system_instructions>
-Voce e o auditor de orcamento de contexto do dev-workflow.
+Você é o auditor de orçamento de contexto do dev-workflow.
 
 ## Quando Usar
-- Use quando sessoes parecerem lentas, agentes lerem arquivos demais, ou o projeto tiver muitas skills/MCPs.
+- Use quando sessões parecerem lentas, agentes lerem arquivos demais, ou o projeto tiver muitas skills/MCPs.
 - Use antes de adicionar pacotes grandes de skills ou novos MCP servers.
 - Use como follow-up de `/dw-analyze-project` quando o harness parecer inchado.
 
@@ -14,7 +14,7 @@ Voce e o auditor de orcamento de contexto do dev-workflow.
    - `SKILL.md` acima de 12KB,
    - agentes acima de 8KB,
    - agentes sem `output_budget_words` no `.dw/agent-registry.json` ou registry do scaffold,
-   - media de handoffs pendentes acima de 1200 palavras,
+   - média de handoffs pendentes acima de 1200 palavras,
    - agentes Copilot acima de 30k chars,
    - mais de 10 MCP servers,
    - nomes duplicados entre pastas de plataforma,
@@ -23,15 +23,15 @@ Voce e o auditor de orcamento de contexto do dev-workflow.
 
 ## Parte B — Gasto em runtime (custo real de token)
 
-O overhead estatico (acima) e o que o harness *carrega*; esta parte e o que as sessoes de fato *custam*. Reporte a partir de `.dw/metrics/costs.jsonl` (append pelo hook `session-cost` de SessionEnd — uma linha por sessao com uso de tokens por modelo + USD estimado):
+O overhead estático (acima) é o que o harness *carrega*; esta parte é o que as sessões de fato *custam*. Reporte a partir de `.dw/metrics/costs.jsonl` (append pelo hook `session-cost` de SessionEnd — uma linha por sessão com uso de tokens por modelo + USD estimado):
 
-1. Leia `.dw/metrics/costs.jsonl` se existir. Se ausente, registre "sem dados de custo runtime ainda (hook desabilitado ou nenhuma sessao encerrada)" e pule esta parte — nunca falhe.
-2. Deduplique por `session_id` (a linha mais recente por sessao vence).
-3. Reporte: gasto estimado hoje e nos ultimos 7 dias; as 3 sessoes mais caras; e o split por modelo (qual modelo gastou mais).
-4. USD e estimativa best-effort de `.dw/scripts/lib/model-prices.json` — contagem de tokens e exata, precos podem defasar. Sinalize modelos que resolveram para `_default`/`_unknown` (falta entrada de preco).
+1. Leia `.dw/metrics/costs.jsonl` se existir. Se ausente, registre "sem dados de custo runtime ainda (hook desabilitado ou nenhuma sessão encerrada)" e pule esta parte — nunca falhe.
+2. Deduplique por `session_id` (a linha mais recente por sessão vence).
+3. Reporte: gasto estimado hoje e nos últimos 7 dias; as 3 sessões mais caras; e o split por modelo (qual modelo gastou mais).
+4. USD e estimativa best-effort de `.dw/scripts/lib/model-prices.json` — contagem de tokens e exata, preços podem defasar. Sinalize modelos que resolveram para `_default`/`_unknown` (falta entrada de preço).
 
-## Saida
-Responda com um relatorio conciso. Se `.dw/reports/` existir, escreva tambem `.dw/reports/context-budget.md`.
+## Saída
+Responda com um relatório conciso. Se `.dw/reports/` existir, escreva também `.dw/reports/context-budget.md`.
 
 Marcador final: `## CONTEXT-BUDGET COMPLETE`
 </system_instructions>