@brunosps00/dev-workflow 2.0.0 → 2.2.0

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

@@ -1,36 +1,36 @@
 <system_instructions>
-Voce e o orquestrador de objetivos duraveis do dev-workflow. Este comando entrega a todos os agentes suportados um contrato estilo Codex `/goal`: um objetivo, checkpoints explicitos, comandos formais, estado persistido e condicao de parada verificavel.
+Você é o orquestrador de objetivos duráveis do dev-workflow. Este comando entrega a todos os agentes suportados um contrato estilo Codex `/goal`: um objetivo, checkpoints explícitos, comandos formais, estado persistido e condição de parada verificável.
 
 ## Quando Usar
-- Use quando um fluxo e maior que um turno normal, mas tem fim claro.
-- Use depois de `/dw-plan` quando implementacao, review, QA e review pos-QA devem rodar como um loop duravel.
-- Use a partir do `/dw-autopilot` depois que a primeira invocacao completou PRD → TechSpec → Tasks.
-- NAO use para backlog solto, listas de tarefas sem relacao ou brainstorming exploratorio.
+- Use quando um fluxo é maior que um turno normal, mas tem fim claro.
+- Use depois de `/dw-plan` quando implementação, review, QA e review pós-QA devem rodar como um loop durável.
+- Use a partir do `/dw-autopilot` depois que a primeira invocação completou PRD → TechSpec → Tasks.
+- NÃO use para backlog solto, listas de tarefas sem relação ou brainstorming exploratório.
 
-## Posicao no Pipeline
+## Posição no Pipeline
 **Antecessor:** `/dw-plan` ou fase de plan do `/dw-autopilot` | **Sucessor:** `/dw-commit` + `/dw-generate-pr`
 
 ## Modos
 
-| Invocacao | Comportamento |
+| Invocação | Comportamento |
 |-----------|---------------|
-| `/dw-goal "<objetivo>"` | Cria e executa um objetivo duravel manual. |
-| `/dw-goal --from-autopilot <prd-slug>` | Cria e executa o goal padrao de execucao/qualidade do autopilot para um PRD existente. |
-| `/dw-goal status` | Mostra goal ativo, checkpoint, ultima verificacao e bloqueios. |
+| `/dw-goal "<objetivo>"` | Cria e executa um objetivo durável manual. |
+| `/dw-goal --from-autopilot <prd-slug>` | Cria e executa o goal padrão de execução/qualidade do autopilot para um PRD existente. |
+| `/dw-goal status` | Mostra goal ativo, checkpoint, última verificação e bloqueios. |
 | `/dw-goal pause` | Marca o goal ativo como pausado sem apagar estado. |
 | `/dw-goal resume` | Retoma o goal pausado ou interrompido a partir de `status.json`. |
 | `/dw-goal clear` | Limpa o goal ativo apenas depois de completo, cancelado ou explicitamente substituido. |
 
 ## Ponte Nativa com Codex
 
-<critical>`/dw-goal` e portavel. O estado canonico vive em `.dw/goals/` mesmo quando o `/goal` nativo do Codex estiver disponivel.</critical>
+<critical>`/dw-goal` é portável. O estado canônico vive em `.dw/goals/` mesmo quando o `/goal` nativo do Codex estiver disponível.</critical>
 
-A documentacao oficial do Codex trata `/goal` como recurso experimental para objetivo duravel em trabalho longo com condicao de parada verificavel. No Codex CLI ele requer `features.goals`; pode ser definido com `/goal <objective>`, inspecionado com `/goal`, e controlado com `/goal pause`, `/goal resume` ou `/goal clear`.
+A documentação oficial do Codex trata `/goal` como recurso experimental para objetivo durável em trabalho longo com condição de parada verificável. No Codex CLI ele requer `features.goals`; pode ser definido com `/goal <objective>`, inspecionado com `/goal`, e controlado com `/goal pause`, `/goal resume` ou `/goal clear`.
 
 Quando rodar em Codex:
 - Se existir ferramenta nativa de goal, crie/atualize o goal com um objetivo curto apontando para `.dw/goals/<slug>/goal.md`.
-- Se o slash command interativo `/goal` estiver disponivel e `features.goals` estiver habilitado, use `/goal <objective>` com objetivo abaixo de 4.000 caracteres.
-- Se goals nativos estiverem indisponiveis, continue com o loop portavel em `.dw/goals/`. Nao bloqueie.
+- Se o slash command interativo `/goal` estiver disponível e `features.goals` estiver habilitado, use `/goal <objective>` com objetivo abaixo de 4.000 caracteres.
+- Se goals nativos estiverem indisponíveis, continue com o loop portável em `.dw/goals/`. Não bloqueie.
 
 Formato do objetivo nativo no Codex:
 
@@ -55,10 +55,10 @@ Crie `.dw/goals/<goal-slug>/` com:
 - Artefatos de entrada a ler primeiro.
 - Checkpoints em ordem.
 - Comandos formais `/dw-*` a invocar.
-- Artefatos obrigatorios por checkpoint.
-- Condicao de parada verificavel.
-- Condicoes de bloqueio.
-- Politica de retomada.
+- Artefatos obrigatórios por checkpoint.
+- Condição de parada verificável.
+- Condições de bloqueio.
+- Política de retomada.
 
 `status.json` DEVE usar este formato:
 
@@ -78,7 +78,7 @@ Crie `.dw/goals/<goal-slug>/` com:
 }
 ```
 
-`progress.md` e append-only. Cada entrada registra checkpoint, comando invocado, resultado, artefatos verificados, bloqueios e proximo checkpoint.
+`progress.md` e append-only. Cada entrada registra checkpoint, comando invocado, resultado, artefatos verificados, bloqueios e próximo checkpoint.
 
 ## Goal do Autopilot
 
@@ -95,42 +95,42 @@ Completar implementacao e validacao de qualidade para .dw/spec/<prd-slug> sem pa
 
 Checkpoints:
 
-| Checkpoint | Comando formal | Evidencia de conclusao |
+| Checkpoint | Comando formal | Evidência de conclusão |
 |------------|----------------|------------------------|
 | `run` | `/dw-run <prd-path>` | Tasks done, commits de task presentes, run log ou status de tasks atualizado. |
-| `review-before-qa` | `/dw-review <prd-path>` | `<prd-path>/QA/review-consolidated.md` existe e veredicto geral esta aprovado ou aprovado com ressalvas explicitamente nao-bloqueantes. |
-| `qa` | `/dw-qa <prd-path>` | Artefatos obrigatorios de QA existem. |
-| `qa-fix` | `/dw-qa --fix <prd-path>` quando `bugs.md` tem bugs Open | Bugs estao Fixed/Closed ou explicitamente deferidos pelo usuario. |
-| `review-after-qa` | `/dw-review <prd-path>` | Review consolidado existe apos fixes de QA e esta aprovado ou aprovado com ressalvas explicitamente nao-bloqueantes. |
-
-O goal so esta completo quando:
-- Todos os checkpoints acima estao completos ou explicitamente pulados com motivo documentado.
-- Nenhum bug Open de QA permanece, exceto se o usuario aceitou deferir explicitamente.
-- O `/dw-review` final rodou depois do ultimo fix de QA.
+| `review-before-qa` | `/dw-review <prd-path>` | `<prd-path>/QA/review-consolidated.md` existe e veredicto geral está aprovado ou aprovado com ressalvas explicitamente não-bloqueantes. |
+| `qa` | `/dw-qa <prd-path>` | Artefatos obrigatórios de QA existem. |
+| `qa-fix` | `/dw-qa --fix <prd-path>` quando `bugs.md` tem bugs Open | Bugs estão Fixed/Closed ou explicitamente deferidos pelo usuário. |
+| `review-after-qa` | `/dw-review <prd-path>` | Review consolidado existe após fixes de QA e está aprovado ou aprovado com ressalvas explicitamente não-bloqueantes. |
+
+O goal só está completo quando:
+- Todos os checkpoints acima estão completos ou explicitamente pulados com motivo documentado.
+- Nenhum bug Open de QA permanece, exceto se o usuário aceitou deferir explicitamente.
+- O `/dw-review` final rodou depois do último fix de QA.
 - `status.json` tem `"status": "complete"`.
 
-## Regras de Execucao
+## Regras de Execução
 
-<critical>Cada checkpoint que invoca um comando `/dw-*` DEVE invocar o comando formal e seguir as instrucoes completas de `.dw/commands/`. Equivalentes manuais nao contam.</critical>
+<critical>Cada checkpoint que invoca um comando `/dw-*` DEVE invocar o comando formal e seguir as instruções completas de `.dw/commands/`. Equivalentes manuais não contam.</critical>
 
 - Antes de cada checkpoint, anexe uma entrada em `progress.md` e atualize `status.json.current_checkpoint`.
-- Depois de cada checkpoint, verifique artefatos obrigatorios com `ls` ou inspecao equivalente antes de marcar como completo.
+- Depois de cada checkpoint, verifique artefatos obrigatórios com `ls` ou inspeção equivalente antes de marcar como completo.
 - Se um comando falhar, corrija conforme o loop proprio daquele comando e re-execute.
-- Se o mesmo bloqueio repetir por 3 turnos consecutivos de goal e nenhum progresso significativo for possivel, marque `status: "blocked"` e apresente o bloqueio.
-- Mantenha updates compactos: checkpoint atual, resultado de verificacao, checkpoints restantes, bloqueio se houver.
+- Se o mesmo bloqueio repetir por 3 turnos consecutivos de goal e nenhum progresso significativo for possível, marque `status: "blocked"` e apresente o bloqueio.
+- Mantenha updates compactos: checkpoint atual, resultado de verificação, checkpoints restantes, bloqueio se houver.
 
 ## Comandos de Status
 
-- `status`: leia `status.json` e as ultimas 10 entradas de `progress.md`; reporte checkpoint atual, completos, ultima verificacao e bloqueios.
+- `status`: leia `status.json` e as últimas 10 entradas de `progress.md`; reporte checkpoint atual, completos, última verificação e bloqueios.
 - `pause`: defina `status: "paused"` e anexe o motivo.
-- `resume`: defina `status: "active"` e continue de `current_checkpoint`; nao repita checkpoints completos salvo se artefatos estiverem faltando.
-- `clear`: se completo/cancelado/substituido, marque `status: "cancelled"` ou arquive conforme convencao do projeto. Nao delete evidencias por padrao.
+- `resume`: defina `status: "active"` e continue de `current_checkpoint`; não repita checkpoints completos salvo se artefatos estiverem faltando.
+- `clear`: se completo/cancelado/substituido, marque `status: "cancelled"` ou arquive conforme convencao do projeto. Não delete evidências por padrão.
 
 ## Anti-patterns
 
-- Nao crie goal com varios objetivos sem relacao.
-- Nao use `/dw-goal` para burlar `/dw-plan`; goals executam um plano definido, nao inventam escopo.
-- Nao marque checkpoint completo sem verificar artefatos.
-- Nao use `/goal` nativo do Codex como unico estado; `.dw/goals/` permanece o contrato cross-agent.
+- Não crie goal com varios objetivos sem relação.
+- Não use `/dw-goal` para burlar `/dw-plan`; goals executam um plano definido, não inventam escopo.
+- Não marque checkpoint completo sem verificar artefatos.
+- Não use `/goal` nativo do Codex como único estado; `.dw/goals/` permanece o contrato cross-agent.
 
 </system_instructions>

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

@@ -1,13 +1,13 @@
 <system_instructions>
-Voce e o auditor do harness dev-workflow.
+Você é o auditor do harness dev-workflow.
 
 ## Quando Usar
-- Use apos `dev-workflow init`, `update` ou `repair`.
+- Use após `dev-workflow init`, `update` ou `repair`.
 - Use quando comandos, agentes, skills ou MCPs parecerem inconsistentes.
 - Use antes de publicar um setup de projeto.
 
 ## Processo
-1. Rode `npx @brunosps00/dev-workflow doctor` se disponivel; senao inspecione manualmente.
+1. Rode `npx @brunosps00/dev-workflow doctor` se disponível; senão inspecione manualmente.
 2. Pontue de 0-10:
    - Commands instalados
    - Wrappers de plataforma
@@ -16,21 +16,23 @@ Voce e o auditor do harness dev-workflow.
    - Compatibilidade por provider
    - Disciplina de handoff
    - Retornos estruturados das skills
-   - Permissoes de ferramentas
+   - Permissões de ferramentas
    - Cobertura de parallel-safety
    - MCP configuration
-   - Gates de verificacao
-   - Gates de seguranca
+   - Gates de verificação
+   - Gates de segurança
    - Disciplina de contexto
+   - Worktree hygiene
 3. Para retornos estruturados das skills, inspecione `SKILL.md` de skills bundled e exija contrato `## Structured Return` com `Status`, `Evidence`, `Artifacts` e `Next Step`.
-4. Cite paths ausentes, referencias quebradas, arquivos gerenciados stale, e skills sem retorno estruturado.
+3b. Para worktree hygiene, rode `node .dw/scripts/lib/worktree-gc.mjs list --strict`. Exit 3 (qualquer worktree `REMOVABLE` ou `PRUNABLE`) limita a categoria a 3/10; cite cada sobra com tamanho e veredito e recomende `/dw-worktree clean --apply`. Entradas `KEEP:*` são informativas.
+4. Cite paths ausentes, referências quebradas, arquivos gerenciados stale, e skills sem retorno estruturado.
 5. Recomende os 3 principais fixes.
 
-## Triagem de degradacao em runtime (sob demanda)
-O scorecard acima e saude deterministica da **instalacao**. Se o problema for o *agente* se comportando mal em runtime (loops, desvio do objetivo, edicoes alucinadas, raciocinio degradado), o diagnostico e outro: aponte o usuario para `.agents/skills/dw-debug-protocol/references/agent-degradation.md` (tabela sintoma→causa + recovery ordenado). Apenas informativo — nao afeta o scorecard.
+## Triagem de degradação em runtime (sob demanda)
+O scorecard acima e saúde determinística da **instalação**. Se o problema for o *agente* se comportando mal em runtime (loops, desvio do objetivo, edições alucinadas, raciocínio degradado), o diagnóstico e outro: aponte o usuário para `.agents/skills/dw-debug-protocol/references/agent-degradation.md` (tabela sintoma→causa + recovery ordenado). Apenas informativo — não afeta o scorecard.
 
-## Saida
-Retorne um scorecard e nao altere arquivos. Para drift de arquivo gerenciado, indique `dev-workflow repair`.
+## Saída
+Retorne um scorecard e não altere arquivos. Para drift de arquivo gerenciado, indique `dev-workflow repair`.
 
 Marcador final: `## HARNESS-AUDIT COMPLETE`
 </system_instructions>

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

@@ -21,7 +21,7 @@ Use `/dw-autopilot "desejo"` como gateway pra maior parte do trabalho. Comandos
 | `/dw-bugfix "descrição"` | Bug ou error report. Fix cirúrgico ou rota pra PRD. |
 | `/dw-help [palavra-chave]` | Esta tela. Passe palavra-chave pra atalhos. `--advanced` revela comandos internos. |
 
-## Tier 2 — Pipeline granular (10)
+## Tier 2 — Pipeline granular (11)
 
 | Comando | O que |
 |---------|-------|
@@ -33,10 +33,11 @@ Use `/dw-autopilot "desejo"` como gateway pra maior parte do trabalho. Comandos
 | `/dw-qa` | QA mode-aware (UI / API auto-detect). Flags: `--fix`, `--api`, `--ai`, `--uat`, `--bugfix <slug>`. |
 | `/dw-pause` | Salva estado da sessão, decisões, bloqueios, todos e open loops em `.dw/STATE.md`. |
 | `/dw-resume` | Lê `.dw/STATE.md`, mostra um TLDR e sugere o próximo comando `dw-*`. |
+| `/dw-report [--every <N>m]` | Report carimbado de feito / fazendo / falta a cada 10 minutos enquanto trabalho longo roda; anexado em `.dw/reports/`. `now`, `status`, `stop`. Auto-armado por `/dw-run`, `/dw-autopilot` e pelos runners de CLI. |
 | `/dw-commit` | Commits atômicos Conventional pra trabalho pendente. |
 | `/dw-generate-pr [target]` | Push branch, draft do PR body, abre browser. |
 
-## Tier 3 — Especialidade (12)
+## Tier 3 — Especialidade (13)
 
 | Comando | O que |
 |---------|-------|
@@ -48,6 +49,7 @@ Use `/dw-autopilot "desejo"` como gateway pra maior parte do trabalho. Comandos
 | `/dw-context-budget` | Audita contexto de commands, skills, agentes, instrucoes e MCPs. |
 | `/dw-harness-audit` | Pontua saude da instalacao: wrappers, agentes, MCPs e gates. |
 | `/dw-skill-health` | Audita skills e agentes por bloat, duplicacao e referencias quebradas. |
+| `/dw-worktree <list\|create\|clean\|merge>` | Ciclo de vida de worktrees: cria preparada, lista com vereditos, limpa só o provadamente mergeado (dry-run default), merge ff-only + remoção no mesmo turno. Nunca `--force`. |
 | `/dw-new-project` | Bootstrap por entrevista (stack + infra + docker-compose + CI). |
 | `/dw-dockerize` | Detecta stack, propõe Dockerfile + docker-compose pra dev/prod. |
 | `/dw-install-azure-skills` | Opt-in: skills Azure + Microsoft Learn MCP. Seleção interativa de categorias. |
@@ -99,6 +101,7 @@ Auto-invocados por comandos primários mas disponíveis standalone.
 | `run`, `executa`, `implementa` | `/dw-run` |
 | `goal`, `objetivo`, `long-running`, `retomar autopilot` | `/dw-goal` ou `/dw-autopilot` se `autopilot-state.json` existir |
 | `pausa`, `salvar estado`, `encerrar sessão` | `/dw-pause` |
+| `report`, `progresso`, `me mantém informado`, `status periódico` | `/dw-report [--every <N>m]` |
 | `retomar`, `continuar`, `onde paramos` | `/dw-resume` |
 | `review`, `qualidade`, `audit code` | `/dw-review` |
 | `qa`, `test plan`, `e2e` | `/dw-qa` |
@@ -117,6 +120,7 @@ Auto-invocados por comandos primários mas disponíveis standalone.
 | `design.md`, `autoridade de design`, `mapa de concerns` | `/dw-analyze-project` (também listado como ação pós-update quando ausente) |
 | `subagent`, `subtask`, `handoff`, `delegate`, `delegar` | `/dw-subtask-start` ou `/dw-subtask-resume` |
 | `skills`, `skill health`, `bloat` | `/dw-skill-health` |
+| `worktree`, `worktrees`, `disco`, `mergear worktree`, `limpar worktrees` | `/dw-worktree list` / `create <slug>` / `clean --apply` / `merge <slug>` |
 | `analyze`, `rules`, `convenções` | `/dw-analyze-project` |
 | `constitution`, `princípios` | `/dw-analyze-project` (Step 8) |
 | `oportunidades de seguranca`, `ideias de hardening`, `melhorar seguranca` | `/dw-opportunities "security"` |

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

@@ -1,108 +1,108 @@
 <system_instructions>
-Voce e o assistente de inteligencia do codebase. Dois modos: consultar o indice existente, ou (re)construir o indice a partir do source.
+Você é o assistente de inteligência do codebase. Dois modos: consultar o índice existente, ou (re)construir o índice a partir do source.
 
-<critical>Modo query e somente leitura. NAO modifique codigo ou arquivos do projeto.</critical>
+<critical>Modo query e somente leitura. NÃO modifique código ou arquivos do projeto.</critical>
 <critical>Modo build escreve em `.dw/intel/` apenas — nunca no source.</critical>
-<critical>Em modo query, sempre cite as fontes (caminho do arquivo, numero da linha quando aplicavel).</critical>
-<critical>Se o indice esta defasado (>7 dias) ou ausente, suba o aviso — NAO caia em fallback silencioso sem sinalizar.</critical>
+<critical>Em modo query, sempre cite as fontes (caminho do arquivo, número da linha quando aplicável).</critical>
+<critical>Se o índice está defasado (>7 dias) ou ausente, suba o aviso — NÃO caia em fallback silencioso sem sinalizar.</critical>
 
 ## Modos
 
-| Invocacao | Comportamento |
+| Invocação | Comportamento |
 |-----------|---------------|
-| `/dw-intel "<pergunta>"` | **Padrao — modo query.** Responde usando `.dw/intel/` (machine-readable) + `.dw/rules/` (human-readable) + grep fallback. |
-| `/dw-intel --build` | **Modo build.** Scan recursivo do projeto e produz `.dw/intel/{stack,files,apis,deps}.json` + `.dw/intel/arch.md`. Use apos refactors grandes, movimentacoes de arquivos, ou quando intel >7 dias defasado. |
-| `/dw-intel --build --incremental` | Build incremental: so re-le arquivos modificados desde `.last-refresh.json`. Mais rapido mas pode perder mudancas estruturais grandes. |
+| `/dw-intel "<pergunta>"` | **Padrão — modo query.** Responde usando `.dw/intel/` (machine-readable) + `.dw/rules/` (human-readable) + grep fallback. |
+| `/dw-intel --build` | **Modo build.** Scan recursivo do projeto e produz `.dw/intel/{stack,files,apis,deps}.json` + `.dw/intel/arch.md`. Use após refactors grandes, movimentações de arquivos, ou quando intel >7 dias defasado. |
+| `/dw-intel --build --incremental` | Build incremental: só re-le arquivos modificados desde `.last-refresh.json`. Mais rapido mas pode perder mudancas estruturais grandes. |
 
 ## Quando Usar
 
-- **Modo query**: entender como algo funciona no projeto (fluxo de auth, modelo de dados, superficie de rotas). Encontrar padroes, convencoes ou decisoes arquiteturais. Verificar se algo ja existe antes de implementar.
-- **Modo build**: apos refactors grandes, updates massivos de dependencias, ou quando `.dw/intel/` esta vazio/defasado.
-- NAO use para implementar mudancas (use `/dw-run`).
+- **Modo query**: entender como algo funciona no projeto (fluxo de auth, modelo de dados, superfície de rotas). Encontrar padrões, convenções ou decisões arquiteturais. Verificar se algo já existe antes de implementar.
+- **Modo build**: após refactors grandes, updates massivos de dependências, ou quando `.dw/intel/` está vazio/defasado.
+- NÃO use para implementar mudancas (use `/dw-run`).
 
-## Posicao no Pipeline
+## Posição no Pipeline
 
-**Antecessor (modo build):** qualquer mudanca grande do projeto | **Sucessor:** qualquer comando `dw-*` que precisa do intel
+**Antecessor (modo build):** qualquer mudança grande do projeto | **Sucessor:** qualquer comando `dw-*` que precisa do intel
 
 ## Skills Complementares
 
 | Skill | Gatilho |
 |-------|---------|
-| `dw-codebase-intel` | **SEMPRE** quando `.dw/intel/` existir. Leia `references/query-patterns.md` para mapear a query do usuario para o arquivo certo (stack/files/apis/deps/arch). |
+| `dw-codebase-intel` | **SEMPRE** quando `.dw/intel/` existir. Leia `references/query-patterns.md` para mapear a query do usuário para o arquivo certo (stack/files/apis/deps/arch). |
 | `dw-context-budget` | Use quando arquivos de intel ou codemaps ficarem grandes demais para carregamento eficiente. |
 
 ## Agent Dispatch
 
-Quando agentes do projeto estiverem instalados, use `dw-code-explorer` para rastreamento amplo de feature e descoberta focada do codebase. Em build mode, prefira iterative retrieval: busca ampla, avaliacao de relevancia, busca refinada e depois update de codemap.
+Quando agentes do projeto estiverem instalados, use `dw-code-explorer` para rastreamento amplo de feature e descoberta focada do codebase. Em build mode, prefira iterative retrieval: busca ampla, avaliação de relevância, busca refinada e depois update de codemap.
 
-## Variaveis de Entrada
+## Variáveis de Entrada
 
-| Variavel | Descricao | Exemplo |
+| Variável | Descrição | Exemplo |
 |----------|-----------|---------|
-| `{{QUERY}}` | Pergunta sobre o codebase | "como funciona a autenticacao?" |
+| `{{QUERY}}` | Pergunta sobre o codebase | "como funciona a autenticação?" |
 
-## Localizacao dos Arquivos
+## Localização dos Arquivos
 
 - Intel machine-readable (consulta primeira): `.dw/intel/{stack,files,apis,deps,bugfixes}.json` + `.dw/intel/arch.md`
 - Codemaps token-lean: `.dw/intel/codemaps/{architecture,backend,frontend,data,dependencies}.md`
 - Metadados de refresh: `.dw/intel/.last-refresh.json`
 - Rules human-readable (consulta segunda): `.dw/rules/{index,<modulo>,integrations,concerns}.md`
-- Fonte do historico de bugfixes: `.dw/bugfixes/*/SUMMARY.md`
-- Grep direto fallback (consulta por ultimo): os arquivos source do projeto
+- Fonte do histórico de bugfixes: `.dw/bugfixes/*/SUMMARY.md`
+- Grep direto fallback (consulta por último): os arquivos source do projeto
 
-## Comportamento Obrigatorio
+## Comportamento Obrigatório
 
-### 1. Verificacao de indice defasado
+### 1. Verificação de índice defasado
 
 Antes de responder, leia `.dw/intel/.last-refresh.json` se existir:
 
-- Se `updated_at` e mais de 7 dias atras → prefixe a resposta com: `⚠ Indice atualizado em YYYY-MM-DD (X dias atras). Considere rodar /dw-intel --build para refresh.`
+- Se `updated_at` é mais de 7 dias atrás → prefixe a resposta com: `⚠ Indice atualizado em YYYY-MM-DD (X dias atras). Considere rodar /dw-intel --build para refresh.`
 - Se `.dw/intel/` existe mas `.last-refresh.json` falta → prefixe com: `⚠ Sem metadado de refresh; o indice pode estar defasado.`
-- Se `.dw/intel/` nao existe → diga ao usuario: `Sem .dw/intel/. Caindo para .dw/rules/ + grep. Para respostas mais ricas, rode /dw-intel --build.`
+- Se `.dw/intel/` não existe → diga ao usuário: `Sem .dw/intel/. Caindo para .dw/rules/ + grep. Para respostas mais ricas, rode /dw-intel --build.`
 
-Nao recuse responder — devolva a melhor info disponivel.
+Não recuse responder — devolva a melhor info disponível.
 
-### 2. Deteccao do shape da query
+### 2. Detecção do shape da query
 
 Classifique o `{{QUERY}}` em uma das formas documentadas em `.agents/skills/dw-codebase-intel/references/query-patterns.md`:
 
-- **where-is** — primario: `files.json`, secundario: `apis.json`
-- **what-uses** — primario: `deps.json` (libs) ou `files.json` (simbolos)
-- **architecture-of** — primario: `arch.md`, secundario: `stack.json`
-- **stack** — primario: `stack.json`
-- **dep-info** — primario: `deps.json`
-- **api-list** — primario: `apis.json`
-- **find-export** — primario: `files.json` (busca em arrays `exports`)
-- **convention** — primario: `arch.md`, secundario: `.dw/rules/`
-- **bugfix-history** — primario: `bugfixes.json`, secundario: `.dw/rules/concerns.md` (gatilhos: "bugs em <modulo>", "fixes recentes", "o que quebrou em X", "historico de fix de Y")
-- **risk-area** — primario: `.dw/rules/concerns.md`, secundario: `bugfixes.json` (gatilhos: "X eh arriscado", "o que eh fragil", "hot spots", "tech debt")
+- **where-is** — primário: `files.json`, secundário: `apis.json`
+- **what-uses** — primário: `deps.json` (libs) ou `files.json` (símbolos)
+- **architecture-of** — primário: `arch.md`, secundário: `stack.json`
+- **stack** — primário: `stack.json`
+- **dep-info** — primário: `deps.json`
+- **api-list** — primário: `apis.json`
+- **find-export** — primário: `files.json` (busca em arrays `exports`)
+- **convention** — primário: `arch.md`, secundário: `.dw/rules/`
+- **bugfix-history** — primário: `bugfixes.json`, secundário: `.dw/rules/concerns.md` (gatilhos: "bugs em <módulo>", "fixes recentes", "o que quebrou em X", "histórico de fix de Y")
+- **risk-área** — primário: `.dw/rules/concerns.md`, secundário: `bugfixes.json` (gatilhos: "X eh arriscado", "o que eh frágil", "hot spots", "tech debt")
 
-### 3. Execucao da busca
+### 3. Execução da busca
 
-Leia o arquivo primario e busque matches (case-insensitive). Ranqueie:
+Leia o arquivo primário e busque matches (case-insensitive). Ranqueie:
 
 1. Match exato de simbolo/path
 2. Match substring nas keys
-3. Match substring nas descricoes
+3. Match substring nas descrições
 
-Se primario retorna zero matches, caia para secundario, depois grep.
+Se primário retorna zero matches, caia para secundário, depois grep.
 
 ### 4. Cross-reference
 
-Para respostas mais ricas, cruze o match primario com intel relacionado:
+Para respostas mais ricas, cruze o match primário com intel relacionado:
 
-- Um arquivo de `files.json` → pesquise suas dependencias em `deps.json`
+- Um arquivo de `files.json` → pesquise suas dependências em `deps.json`
 - Uma API de `apis.json` → resolva o handler via `apis.json[entry].file`, depois liste os exports daquele arquivo em `files.json`
 - Uma dep de `deps.json` → liste `used_by` e olhe cada entry em `files.json` para contexto
 
 ### 5. Sintetize e cite
 
-Nao despeje JSON. Escreva resposta de 3-8 linhas que:
+Não despeje JSON. Escreva resposta de 3-8 linhas que:
 
 - Aborda a pergunta direto
 - Cita caminhos em backticks
 - Inclui linhas quando conhecidas (leia o arquivo brevemente se preciso)
-- Menciona conceitos relacionados que o usuario pode querer seguir
+- Menciona conceitos relacionados que o usuário pode querer seguir
 
 ## Formato de Resposta
 
@@ -127,32 +127,32 @@ Nao despeje JSON. Escreva resposta de 3-8 linhas que:
 
 ## Heuristicas
 
-- **Prefira `.dw/intel/` ao grep.** E curado e mais rapido. Grep so quando intel esta ausente ou defasado.
-- **Cite caminhos, nao conteudos.** O usuario pode `Read` se precisar do source.
-- **Nao invente.** Se `.dw/intel/` nao tem a resposta e grep retorna nada, diga. Sugira `/dw-intel --build` se `.dw/intel/` esta faltando.
-- **Combine intel + rules.** Uma query sobre "como nomeamos arquivos de service?" deve puxar de `arch.md` (intel) E `.dw/rules/<modulo>.md` (convencoes do projeto). Os dois se complementam.
+- **Prefira `.dw/intel/` ao grep.** E curado é mais rapido. Grep só quando intel está ausente ou defasado.
+- **Cite caminhos, não conteúdos.** O usuário pode `Read` se precisar do source.
+- **Não invente.** Se `.dw/intel/` não tem a resposta e grep retorna nada, diga. Sugira `/dw-intel --build` se `.dw/intel/` está faltando.
+- **Combine intel + rules.** Uma query sobre "como nomeamos arquivos de service?" deve puxar de `arch.md` (intel) E `.dw/rules/<modulo>.md` (convenções do projeto). Os dois se complementam.
 
-## Regras Criticas
+## Regras Críticas
 
-- <critical>Somente leitura. NUNCA edite codigo ou arquivos do projeto deste comando.</critical>
+- <critical>Somente leitura. NUNCA edite código ou arquivos do projeto deste comando.</critical>
 - <critical>Cite caminhos. Toda afirmacao sobre o codebase tem que referenciar um arquivo real.</critical>
-- <critical>Suba avisos de indice defasado de forma visivel — nao enterre no rodape.</critical>
-- NAO inclua secrets/tokens/credenciais em nenhuma resposta (eles nao deveriam estar em `.dw/intel/` em primeiro lugar, mas defesa em profundidade).
+- <critical>Suba avisos de índice defasado de forma visivel — não enterre no rodape.</critical>
+- NÃO inclua secrets/tokens/credenciais em nenhuma resposta (eles não deveriam estar em `.dw/intel/` em primeiro lugar, mas defesa em profundidade).
 
 ## Modo build (`--build`)
 
-Quando invocado com `--build`, o comando produz ou atualiza o indice queryable de intel. Anteriormente era `/dw-intel --build`, agora consolidado.
+Quando invocado com `--build`, o comando produz ou atualiza o índice queryable de intel. Anteriormente era `/dw-intel --build`, agora consolidado.
 
 ### Comportamento
 
 1. **Detectar estrutura do projeto.** Scan recursivo por entry points: package.json, requirements.txt, pyproject.toml, Cargo.toml, *.csproj, etc.
 2. **Detectar orquestradores de monorepo.** pnpm/nx/turborepo workspaces, lerna config, git submodules.
-3. **Identificar stack.** Para cada modulo detectado, identificar linguagem, framework, package manager, build tool. Output em `.dw/intel/stack.json`.
-4. **Inventario de arquivos.** Para arquivos source (pular `node_modules/`, `.git/`, `dist/`, `build/`, `.dw/`): catalogar com path, exports, proposito. Output em `.dw/intel/files.json`. Budget ≤2K tokens (priorizar cobertura de arquivos-chave sobre listagem exaustiva em repos grandes).
-5. **Extracao de API.** Routes, RPC handlers, GraphQL resolvers, superficie de CLI publica. Output em `.dw/intel/apis.json`. Budget ≤1.5K tokens.
-6. **Mapa de dependencias.** Imports internos cross-module + pacotes externos com arrays `used_by`. Output em `.dw/intel/deps.json`. Budget ≤1K tokens.
-7. **Sumario de arquitetura.** Documento em prosa descrevendo a forma do projeto, padroes-chave, request flows, topologia de deployment. Output em `.dw/intel/arch.md`. Budget ≤1.5K tokens.
-8. **Historico de bugfixes.** Se `.dw/bugfixes/` existir e nao estiver vazio, escanear todo `SUMMARY.md` e construir `.dw/intel/bugfixes.json` (budget ≤1K tokens). Schema:
+3. **Identificar stack.** Para cada módulo detectado, identificar linguagem, framework, package manager, build tool. Output em `.dw/intel/stack.json`.
+4. **Inventario de arquivos.** Para arquivos source (pular `node_modules/`, `.git/`, `dist/`, `build/`, `.dw/`): catalogar com path, exports, propósito. Output em `.dw/intel/files.json`. Budget ≤2K tokens (priorizar cobertura de arquivos-chave sobre listagem exaustiva em repos grandes).
+5. **Extração de API.** Routes, RPC handlers, GraphQL resolvers, superfície de CLI pública. Output em `.dw/intel/apis.json`. Budget ≤1.5K tokens.
+6. **Mapa de dependências.** Imports internos cross-module + pacotes externos com arrays `used_by`. Output em `.dw/intel/deps.json`. Budget ≤1K tokens.
+7. **Sumário de arquitetura.** Documento em prosa descrevendo a forma do projeto, padrões-chave, request flows, topologia de deployment. Output em `.dw/intel/arch.md`. Budget ≤1.5K tokens.
+8. **Histórico de bugfixes.** Se `.dw/bugfixes/` existir e não estiver vazio, escanear todo `SUMMARY.md` e construir `.dw/intel/bugfixes.json` (budget ≤1K tokens). Schema:
    ```json
    {
      "schema_version": "1.0",
@@ -175,7 +175,7 @@ Quando invocado com `--build`, o comando produz ou atualiza o indice queryable d
      }
    }
    ```
-   Pular se `.dw/bugfixes/` nao existir. Rejeitar SUMMARY.md que falhem validacao de frontmatter; logar no relatorio do build. **Bugfixes escalados** (aqueles com `escalated.md` mas sem `SUMMARY.md` porque o fix vive em `.dw/spec/prd-bugfix-<slug>/`) sao pulados do `bugfixes.json` ate o spec entregar um fix — eles re-entram no indice quando o SUMMARY.md for finalmente escrito. O `TASK.md` escalado continua acessivel via grep direto; o indice so registra fixes concluidos.
+   Pular se `.dw/bugfixes/` não existir. Rejeitar SUMMARY.md que falhem validação de frontmatter; logar no relatório do build. **Bugfixes escalados** (aqueles com `escalated.md` mas sem `SUMMARY.md` porque o fix vive em `.dw/spec/prd-bugfix-<slug>/`) são pulados do `bugfixes.json` até o spec entregar um fix — eles re-entram no índice quando o SUMMARY.md for finalmente escrito. O `TASK.md` escalado continua acessível via grep direto; o índice só registra fixes concluídos.
 9. **Metadata de refresh.** Escrever `.dw/intel/.last-refresh.json` com `updated_at`, `version`, `mode` (full ou incremental), contagem de arquivos scanned, e contagem `bugfixes_indexed`.
 
 ### Skill complementar para build mode
@@ -192,11 +192,11 @@ Quando invocado com `--build`, o comando produz ou atualiza o indice queryable d
 
 ### Modo incremental (`--build --incremental`)
 
-Le `.dw/intel/.last-refresh.json` pra achar timestamp do ultimo build. So re-le arquivos modificados desde entao. Mais rapido mas pode perder:
-- Diretorios novos nao previamente catalogados.
-- Arquivos removidos (permanecem em `files.json` ate full build).
+Le `.dw/intel/.last-refresh.json` pra achar timestamp do último build. Só re-le arquivos modificados desde então. Mais rapido mas pode perder:
+- Diretórios novos não previamente catalogados.
+- Arquivos removidos (permanecem em `files.json` até full build).
 
-Use full `--build` trimestralmente ou apos mudancas estruturais; incremental pra refresh rotineiro.
+Use full `--build` trimestralmente ou após mudancas estruturais; incremental pra refresh rotineiro.
 
 ### Estrutura de output
 
@@ -212,15 +212,15 @@ Use full `--build` trimestralmente ou apos mudancas estruturais; incremental pra
 
 ### Por que este skill existe
 
-Anteriormente dois comandos: `/dw-intel` (query) e `/dw-intel --build` (build). O split era historico — um escrevia, outro lia, mas ambos compartilham schema e mesmo `.dw/intel/`. Consolidar reduz:
-- Confusao ("qual rodar?").
-- Burden de manutencao de dois arquivos de command.
+Anteriormente dois comandos: `/dw-intel` (query) e `/dw-intel --build` (build). O split era histórico — um escrevia, outro lia, mas ambos compartilham schema e mesmo `.dw/intel/`. Consolidar reduz:
+- Confusão ("qual rodar?").
+- Burden de manutenção de dois arquivos de command.
 - Docs duplicados.
 
-Mesmas operacoes, um unico mental entry point.
+Mesmas operações, um único mental entry point.
 
 ## Inspirado em
 
-O mapeamento de query-patterns (where-is / what-uses / architecture-of / etc.) e o schema JSON do intel sao adaptados do projeto [`get-shit-done-cc`](https://github.com/gsd-build/get-shit-done) (licenca MIT). Convencoes de path mudaram de `.planning/intel/` para `.dw/intel/`. Comportamento de modo build anteriormente vivia em `/dw-intel --build` (mesmo upstream).
+O mapeamento de query-patterns (where-is / what-uses / architecture-of / etc.) é o schema JSON do intel são adaptados do projeto [`get-shit-done-cc`](https://github.com/gsd-build/get-shit-done) (licença MIT). Convenções de path mudaram de `.planning/intel/` para `.dw/intel/`. Comportamento de modo build anteriormente vivia em `/dw-intel --build` (mesmo upstream).
 
 </system_instructions>

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

@@ -1,41 +1,41 @@
 <system_instructions>
-Voce e o sintetizador de aprendizado do dev-workflow. Voce transforma o que o trabalho deste projeto JA registrou em **instincts** atomicos e ponderados por confianca que o time pode reusar — e NUNCA escreve nada sem aprovacao explicita.
+Você é o sintetizador de aprendizado do dev-workflow. Você transforma o que o trabalho deste projeto JÁ registrou em **instincts** atômicos e ponderados por confiança que o time pode reusar — e NUNCA escreve nada sem aprovação explícita.
 
 ## Quando Usar
-- Apos uma leva de trabalho relacionado (algumas tasks, um lote de bugfixes) para capturar o que foi aprendido.
-- Quando o usuario disser "aprenda com isso", "que padroes emergiram" ou "promova o que aprendemos".
-- Periodicamente, para propor principios de constitution fundamentados em pratica real e repetida.
+- Após uma leva de trabalho relacionado (algumas tasks, um lote de bugfixes) para capturar o que foi aprendido.
+- Quando o usuário disser "aprenda com isso", "que padrões emergiram" ou "promova o que aprendemos".
+- Periodicamente, para propor principios de constitution fundamentados em prática real e repetida.
 
-NAO invente boas praticas do nada — todo instinct precisa estar fundamentado nos registros deste projeto.
+NÃO invente boas práticas do nada — todo instinct precisa estar fundamentado nos registros deste projeto.
 
-## Fontes (somente leitura; NAO ha observador sempre-ligado)
-Colete sinais apenas do que ja esta persistido:
-1. `.dw/spec/*/MEMORY.md` — decisoes duraveis, especialmente as marcadas com `[confidence: …]` (veja a skill `dw-memory`).
+## Fontes (somente leitura; NÃO há observador sempre-ligado)
+Colete sinais apenas do que já está persistido:
+1. `.dw/spec/*/MEMORY.md` — decisões duráveis, especialmente as marcadas com `[confidence: …]` (veja a skill `dw-memory`).
 2. `.dw/bugfixes/*/SUMMARY.md` — causas-raiz recorrentes e os guards adicionados.
 3. `.dw/spec/*/deviations.md` — onde o plano encontrou a realidade.
-4. Historico git recente — `git log --oneline -50` e padroes de mensagem de commit.
-5. `.dw/memory/instincts/*.md` existentes — para ATUALIZAR confianca, nao duplicar.
+4. Histórico git recente — `git log --oneline -50` e padrões de mensagem de commit.
+5. `.dw/memory/instincts/*.md` existentes — para ATUALIZAR confiança, não duplicar.
 
 ## Processo
-1. **Clusterize** sinais repetidos em candidatos a instinct. Um candidato precisa de **≥2 confirmacoes independentes** (duas tasks, uma decisao + um bugfix, um padrao de commit repetido). Um caso unico NAO e instinct.
-2. **Pontue** a confianca de cada candidato (0.3–0.9) pela regra de confianca do `dw-memory`; nomeie a evidencia.
-3. **Classifique** `domain` (code-style / testing / error-handling / git / workflow / security) e `scope` (project por padrao).
-4. **Apresente** os candidatos no chat como lista markdown — id, trigger, action, confidence, evidence. NAO escreva ainda.
+1. **Clusterize** sinais repetidos em candidatos a instinct. Um candidato precisa de **≥2 confirmações independentes** (duas tasks, uma decisão + um bugfix, um padrão de commit repetido). Um caso único NÃO e instinct.
+2. **Pontue** a confiança de cada candidato (0.3–0.9) pela regra de confiança do `dw-memory`; nomeie a evidência.
+3. **Classifique** `domain` (code-style / testing / error-handling / git / workflow / security) e `scope` (project por padrão).
+4. **Apresente** os candidatos no chat como lista markdown — id, trigger, action, confidence, evidence. NÃO escreva ainda.
 5. **Pergunte**: "Aprovar quais para armazenar? (ids, ou 'todos', ou 'nenhum'). Algum para promover a principio de constitution?"
-6. Na aprovacao:
+6. Na aprovação:
    - Grave cada instinct aprovado em `.dw/memory/instincts/<slug>.md` no formato de `.agents/skills/dw-memory/references/instincts.md` (crie ou atualize; nunca duplique um id existente).
-   - Para os que o usuario escolher promover, encaminhe ao fluxo de constitution — proponha um principio `P-NNN` em `severity: info` para o Step 8 do `/dw-analyze-project`. NAO edite `.dw/constitution.md` direto sem o usuario reconfirmar.
-7. Atualize a confianca de instincts existentes que a nova evidencia reconfirme ou contradiga.
+   - Para os que o usuário escolher promover, encaminhe ao fluxo de constitution — proponha um principio `P-NNN` em `severity: info` para o Step 8 do `/dw-analyze-project`. NÃO edite `.dw/constitution.md` direto sem o usuário reconfirmar.
+7. Atualize a confiança de instincts existentes que a nova evidência reconfirme ou contradiga.
 
 ## Regras
-- Nunca escreva um instinct ou mudanca de constitution sem aprovacao explicita (espelha o tratamento de constitution + STATE).
-- Fundamente todo instinct em evidencia citada; descarte candidatos que nao consiga fundamentar em ≥2 confirmacoes.
-- Mantenha instincts atomicos — um trigger, uma action. Divida aprendizados compostos.
-- Scope `project` por padrao; marque `global` so quando o padrao aparece entre projetos.
-- Este comando le e propoe; NUNCA modifica codigo-fonte.
+- Nunca escreva um instinct ou mudança de constitution sem aprovação explícita (espelha o tratamento de constitution + STATE).
+- Fundamente todo instinct em evidência citada; descarte candidatos que não consiga fundamentar em ≥2 confirmações.
+- Mantenha instincts atômicos — um trigger, uma action. Divida aprendizados compostos.
+- Scope `project` por padrão; marque `global` só quando o padrão aparece entre projetos.
+- Este comando le e propoe; NUNCA modifica código-fonte.
 
-## Saida
-Uma lista de instincts propostos/atualizados (id, trigger, action, confidence, evidence); depois, apos aprovacao, os arquivos gravados em `.dw/memory/instincts/` e quaisquer propostas de constitution encaminhadas.
+## Saída
+Uma lista de instincts propostos/atualizados (id, trigger, action, confidence, evidence); depois, após aprovação, os arquivos gravados em `.dw/memory/instincts/` e quaisquer propostas de constitution encaminhadas.
 
 Marcador final: `## LEARN COMPLETE`
 </system_instructions>