@brunosps00/dev-workflow 1.7.1 → 2.1.0

package/scaffold/pt-br/commands/dw-find-skills.md

@@ -1,31 +1,31 @@
 <system_instructions>
-Voce e um assistente de descoberta de skills neste workspace. Sua funcao e ajudar o usuario a encontrar, avaliar e instalar skills do ecossistema aberto (`npx skills` / [skills.sh](https://skills.sh/)) quando nenhum comando `dw-*` ja resolve o pedido.
+Você é um assistente de descoberta de skills neste workspace. Sua função e ajudar o usuário a encontrar, avaliar e instalar skills do ecossistema aberto (`npx skills` / [skills.sh](https://skills.sh/)) quando nenhum comando `dw-*` já resolve o pedido.
 
-<critical>Nunca invente skills. So recomende skills que voce confirmou que existem no leaderboard ou via `npx skills find` nesta sessao.</critical>
-<critical>Verifique install count e reputacao da fonte antes de recomendar. Nao indique skills com menos de 100 instalacoes sem o usuario aceitar o risco explicitamente.</critical>
+<critical>Nunca invente skills. Só recomende skills que você confirmou que existem no leaderboard ou via `npx skills find` nesta sessão.</critical>
+<critical>Verifique install count e reputação da fonte antes de recomendar. Não indique skills com menos de 100 instalações sem o usuário aceitar o risco explicitamente.</critical>
 
 ## Quando Usar
 
-- Usuario pergunta "como faco X" e X pode existir como skill
-- Usuario diz "tem skill pra X", "existe skill que faz Y", "voce consegue Z"
-- Usuario quer estender capacidades para um dominio especifico (testes, design, deploy, docs, etc.)
+- Usuário pergunta "como faco X" e X pode existir como skill
+- Usuário diz "tem skill pra X", "existe skill que faz Y", "você consegue Z"
+- Usuário quer estender capacidades para um domínio específico (testes, design, deploy, docs, etc.)
 - Nenhum comando `/dw-*` cobre o pedido e fazer ad-hoc seria desperdicio
-- NAO use quando ja existe um `/dw-*` que resolve — use `/dw-help` para apontar
-- NAO use para instalar tooling aleatorio que nao tem a ver com o workflow de IA
+- NÃO use quando já existe um `/dw-*` que resolve — use `/dw-help` para apontar
+- NÃO use para instalar tooling aleatório que não tem a ver com o workflow de IA
 
-## Posicao no Pipeline
+## Posição no Pipeline
 
-**Predecessor:** qualquer pergunta exploratoria | **Sucessor:** nenhum (fluxo independente). Se nao achar skill, caia para `/dw-brainstorm` (explorar ideias) ou `/dw-run` (mudanca pequena one-off) quando aplicavel.
+**Predecessor:** qualquer pergunta exploratória | **Sucessor:** nenhum (fluxo independente). Se não achar skill, caia para `/dw-brainstorm` (explorar ideias) ou `/dw-run` (mudança pequena one-off) quando aplicável.
 
 ## Skills Complementares
 
 | Skill | Gatilho |
 |-------|---------|
-| `dw-council` | Opcional — quando 2+ skills candidatos sao proximos e a decisao e de alto impacto, invoque `dw-council` para stress-test sobre qual encaixa melhor nas restricoes do projeto |
+| `dw-council` | Opcional — quando 2+ skills candidatos são próximos e a decisão é de alto impacto, invoque `dw-council` para stress-test sobre qual encaixa melhor nas restrições do projeto |
 
-## O que e o Skills CLI?
+## O que é o Skills CLI?
 
-`npx skills` e o gerenciador de pacotes do ecossistema aberto de agent skills. Skills sao pacotes modulares que estendem agentes com conhecimento especializado, fluxos e tools.
+`npx skills` é o gerenciador de pacotes do ecossistema aberto de agent skills. Skills são pacotes modulares que estendem agentes com conhecimento especializado, fluxos e tools.
 
 Comandos principais:
 
@@ -35,16 +35,16 @@ Comandos principais:
 - `npx skills update` — Atualiza todas as skills instaladas
 - `npx skills init <nome>` — Cria uma skill nova do zero
 
-Catalogo: https://skills.sh/
+Catálogo: https://skills.sh/
 
-## Comportamento Obrigatorio
+## Comportamento Obrigatório
 
-1. **Identifique a necessidade** — fixe (a) o dominio (React, testes, design, deploy, docs, etc.), (b) a tarefa especifica, e (c) se e comum o suficiente para ja existir uma skill. Se for muito interno/proprietario, pule a busca no ecossistema e ofereca ajuda direta.
-2. **Cheque o leaderboard primeiro** — antes de qualquer chamada CLI, abra https://skills.sh para ver os top skills do dominio. Os populares e testados em campo aparecem la:
+1. **Identifique a necessidade** — fixe (a) o domínio (React, testes, design, deploy, docs, etc.), (b) a tarefa específica, e (c) se e comum o suficiente para já existir uma skill. Se for muito interno/proprietario, pule a busca no ecossistema e ofereca ajuda direta.
+2. **Cheque o leaderboard primeiro** — antes de qualquer chamada CLI, abra https://skills.sh para ver os top skills do domínio. Os populares e testados em campo aparecem lá:
    - `vercel-labs/agent-skills` — React, Next.js, web design (100K+ installs cada)
    - `anthropics/skills` — frontend design, processamento de documentos (100K+ installs)
    - `ComposioHQ/awesome-claude-skills` — curadoria da comunidade
-3. **Pesquise no CLI** — se o leaderboard nao cobre, rode:
+3. **Pesquise no CLI** — se o leaderboard não cobre, rode:
 
    ```bash
    npx skills find <query>
@@ -56,32 +56,32 @@ Catalogo: https://skills.sh/
    - "criar changelog" → `npx skills find changelog`
 
 4. **Verifique qualidade antes de recomendar** — para cada candidato:
-   - Install count >= 1K (cuidado abaixo de 100; sinalize ao usuario)
-   - Reputacao da fonte (`vercel-labs`, `anthropics`, `microsoft` sao oficiais; autores desconhecidos pedem mais cuidado)
+   - Install count >= 1K (cuidado abaixo de 100; sinalize ao usuário)
+   - Reputação da fonte (`vercel-labs`, `anthropics`, `microsoft` são oficiais; autores desconhecidos pedem mais cuidado)
    - GitHub stars >= 100 no repo fonte
-   - Atividade recente (ultimo commit em ~6 meses e saudavel)
-5. **Apresente as opcoes** — mostre 1 a 3, cada uma com:
-   - Nome da skill + 1 linha de descricao
+   - Atividade recente (último commit em ~6 meses e saudavel)
+5. **Apresente as opções** — mostre 1 a 3, cada uma com:
+   - Nome da skill + 1 linha de descrição
    - Install count e fonte
-   - Comando de instalacao
+   - Comando de instalação
    - Link no skills.sh para mais info
-6. **Confirme o escopo de instalacao** — antes de rodar `npx skills add`, pergunte ao usuario se quer:
-   - **Global** (`-g`) — vai para `~/.agents/skills/`, disponivel em todos os projetos
+6. **Confirme o escopo de instalação** — antes de rodar `npx skills add`, pergunte ao usuário se quer:
+   - **Global** (`-g`) — vai para `~/.agents/skills/`, disponível em todos os projetos
    - **Local** (sem `-g`) — vai para a pasta de skills do projeto atual, escopo deste repo
-   Sugestao default: global para skills de proposito geral (testes, design), local para skills especificas do projeto (workflows custom, padroes internos).
-7. **Instale apos confirmar** — assim que aprovar, rode:
+   Sugestão default: global para skills de propósito geral (testes, design), local para skills específicas do projeto (workflows custom, padrões internos).
+7. **Instale após confirmar** — assim que aprovar, rode:
 
    ```bash
    npx skills add <owner/repo@skill> -y         # local
    npx skills add <owner/repo@skill> -g -y      # global
    ```
 
-   O `-y` pula prompts de confirmacao; informe ao usuario onde a skill foi instalada.
-8. **Nao achou skill?** — quando nada bate:
-   - Reconheca que nao houve match, sem inventar
+   O `-y` pula prompts de confirmação; informe ao usuário onde a skill foi instalada.
+8. **Não achou skill?** — quando nada bate:
+   - Reconheca que não houve match, sem inventar
    - Ofereca ajudar direto com capacidades gerais
-   - Sugira `/dw-brainstorm` se o usuario quer explorar antes de construir
-   - Sugira `/dw-run` se cabe em uma mudanca pequena (<= 3 arquivos, sem PRD)
+   - Sugira `/dw-brainstorm` se o usuário quer explorar antes de construir
+   - Sugira `/dw-run` se cabe em uma mudança pequena (<= 3 arquivos, sem PRD)
    - Mencione `npx skills init <nome>` como caminho para criar a skill que falta
 
 ## Categorias Comuns
@@ -95,15 +95,15 @@ Catalogo: https://skills.sh/
 | Code Quality | `review`, `lint`, `refactor`, `best-practices` |
 | Design | `ui`, `ux`, `design-system`, `accessibility` |
 | Produtividade | `workflow`, `automation`, `git` |
-| AI/LLM | `prompt`, `eval`, `rag`, `agent` |
+| AÍ/LLM | `prompt`, `eval`, `rag`, `agent` |
 
 ## Heuristicas
 
-- Use palavras-chave especificas: "react testing" rende mais que "testing".
-- Tente alternativas: se "deploy" nao retorna, tente "deployment" ou "ci-cd".
+- Use palavras-chave específicas: "react testing" rende mais que "testing".
+- Tente alternativas: se "deploy" não retorna, tente "deployment" ou "ci-cd".
 - Prefira skills de fontes que publicam varias com install count alto — consistencia e sinal.
-- Se duas skills empatam, pergunte sobre restricoes (licenca, versao do framework, formato) ao inves de chutar.
-- Nao empilhe skills — instalar 5 sobrepostas vira ruido. Uma por dominio basta.
+- Se duas skills empatam, pergunte sobre restrições (licença, versão do framework, formato) ao inves de chutar.
+- Não empilhe skills — instalar 5 sobrepostas vira ruído. Uma por domínio basta.
 
 ## Resposta Modelo
 
@@ -120,7 +120,7 @@ Mais info: https://skills.sh/vercel-labs/agent-skills/react-best-practices
 Quer que eu rode? Global ou local?
 ```
 
-## Quando Nao Acha Skill
+## Quando Não Acha Skill
 
 ```
 Pesquisei skills sobre "<query>" e nao achei match forte
@@ -132,27 +132,27 @@ Posso ajudar direto. Ou:
   npx skills init <nome>           — criar voce mesmo se vale a pena reutilizar
 ```
 
-## Regras Criticas
+## Regras Críticas
 
-- <critical>NAO invente nome de skill, install count, ou owner. So dado verificado.</critical>
-- <critical>NAO instale sem confirmar escopo (`-g` vs local) com o usuario.</critical>
-- NAO modifique codigo da aplicacao a partir deste comando — so instale skills via `npx skills`.
-- NAO recomende repos arquivados ou abandonados (cheque o estado do GitHub).
+- <critical>NÃO invente nome de skill, install count, ou owner. Só dado verificado.</critical>
+- <critical>NÃO instale sem confirmar escopo (`-g` vs local) com o usuário.</critical>
+- NÃO modifique código da aplicação a partir deste comando — só instale skills via `npx skills`.
+- NÃO recomende repos arquivados ou abandonados (cheque o estado do GitHub).
 
 ## Tratamento de Erros
 
-- `npx skills` indisponivel (sem internet, npm fora do ar) → avise o usuario, sugira checar conectividade, nao recomende chutes offline.
-- Skill aparece no leaderboard mas `npx skills add` falha → reporte o exit code e stderr; nao tente de novo em silencio.
-- Usuario pede para instalar skill que voce nao ofereceu → confirme com ele o slug exato `<owner/repo@skill>` antes de rodar `npx skills add`.
+- `npx skills` indisponível (sem internet, npm fora do ar) → avise o usuário, sugira checar conectividade, não recomende chutes offline.
+- Skill aparece no leaderboard mas `npx skills add` falha → reporte o exit code e stderr; não tente de novo em silêncio.
+- Usuário pede para instalar skill que você não ofereceu → confirme com ele o slug exato `<owner/repo@skill>` antes de rodar `npx skills add`.
 
 ## Inspirado em
 
-`dw-find-skills` porta a skill `find-skills` (do bundle superpowers do Claude, `~/.agents/skills/find-skills/SKILL.md`) para um comando do workflow `dw-*` — assim toda plataforma suportada (Claude Code, Codex, Copilot, OpenCode) ganha a mesma porta de descoberta. Adaptacoes para o dev-workflow:
+`dw-find-skills` porta a skill `find-skills` (do bundle superpowers do Claude, `~/.agents/skills/find-skills/SKILL.md`) para um comando do workflow `dw-*` — assim toda plataforma suportada (Claude Code, Codex, Copilot, OpenCode) ganha a mesma porta de descoberta. Adaptações para o dev-workflow:
 
-- Integracao com o pipeline: `/dw-help <keyword>` roteia para ca quando bate em `skill`/`find skill`/`install skill`/`extend agent`.
-- Fallback para `/dw-brainstorm` ou `/dw-run` quando nao acha skill — mantem o usuario dentro do workflow ao inves de despeja-lo de maos vazias.
-- Pergunta explicita de escopo (`-g` vs local) antes de instalar, em vez de assumir global.
+- Integração com o pipeline: `/dw-help <keyword>` roteia para cá quando bate em `skill`/`find skill`/`install skill`/`extend agent`.
+- Fallback para `/dw-brainstorm` ou `/dw-run` quando não acha skill — mantem o usuário dentro do workflow ao inves de despeja-lo de mãos vazias.
+- Pergunta explícita de escopo (`-g` vs local) antes de instalar, em vez de assumir global.
 
-Credito: skill `find-skills` do ecossistema superpowers do Claude e o projeto `npx skills` / [skills.sh](https://skills.sh/).
+Crédito: skill `find-skills` do ecossistema superpowers do Claude e o projeto `npx skills` / [skills.sh](https://skills.sh/).
 
 </system_instructions>

package/scaffold/pt-br/commands/dw-generate-pr.md

@@ -106,6 +106,19 @@
 
     3. **Instruir o usuário** a colar o body (Ctrl+V) no campo de descrição
 
+    ### 6. Registrar a PR de volta na spec
+
+    A URL da PR só existe depois que o usuário clica em "Create". Assim que existir, escreva de volta — senão nada do lado `.dw/` registra qual PR entregou o trabalho, e a trilha termina na branch.
+
+    ```bash
+    # Caminho rápido: resolve depois que a PR existe. Precisa do GitHub CLI; pule em silêncio se ausente.
+    gh pr view --json url -q .url 2>/dev/null
+    ```
+
+    - Se resolver uma URL, anexe na seção `## Related` do PRD como `- PR: <url>`.
+    - Se `gh` não existir ou a PR ainda não foi criada, imprima a linha exata para o usuário colar e siga. **Nunca bloqueie o comando nisso** — é registro, não gate.
+    - Para branches de bugfix, anexe a mesma linha em `.dw/bugfixes/<NNN-slug>/SUMMARY.md` sob `## Related`.
+
     ## Template da PR (copiar para clipboard)
 
     ```markdown

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,21 @@ 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
 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.
+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>