@brunosps00/dev-workflow 1.0.5 → 1.0.6

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

@@ -0,0 +1,136 @@
+<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.
+
+## 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.
+
+## Posicao no Pipeline
+**Antecessor:** `/dw-plan` ou fase de plan do `/dw-autopilot` | **Sucessor:** `/dw-commit` + `/dw-generate-pr`
+
+## Modos
+
+| Invocacao | 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 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>
+
+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`.
+
+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.
+
+Formato do objetivo nativo no Codex:
+
+```text
+Execute o objetivo duravel definido em .dw/goals/<goal-slug>/goal.md ate que sua condicao de parada verificavel seja atingida. Atualize .dw/goals/<goal-slug>/progress.md depois de cada checkpoint.
+```
+
+## Estado Persistente
+
+Crie `.dw/goals/<goal-slug>/` com:
+
+```
+.dw/goals/<goal-slug>/
+├── goal.md
+├── status.json
+└── progress.md
+```
+
+`goal.md` DEVE incluir:
+- Um objetivo.
+- Dentro de escopo / fora de escopo.
+- 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.
+
+`status.json` DEVE usar este formato:
+
+```json
+{
+  "schema_version": "1.0",
+  "slug": "goal-prd-example",
+  "source": "manual",
+  "prd_path": null,
+  "status": "active",
+  "current_checkpoint": "start",
+  "completed_checkpoints": [],
+  "required_artifacts": [],
+  "last_verification": null,
+  "created_at": "2026-05-20T00:00:00Z",
+  "updated_at": "2026-05-20T00:00:00Z"
+}
+```
+
+`progress.md` e append-only. Cada entrada registra checkpoint, comando invocado, resultado, artefatos verificados, bloqueios e proximo checkpoint.
+
+## Goal do Autopilot
+
+Quando invocado como `/dw-goal --from-autopilot <prd-slug>`:
+
+1. Resolva `<prd-slug>` para `.dw/spec/<prd-slug>/`.
+2. Verifique que `prd.md`, `techspec.md`, `tasks.md`, arquivos per-task e `tasks-validation.md` existem.
+3. Crie o slug `autopilot-<prd-slug>`.
+4. Escreva `goal.md` com este objetivo:
+
+```text
+Completar implementacao e validacao de qualidade para .dw/spec/<prd-slug> sem parar ate run, review completo, QA/fix e review completo pos-QA estarem formalmente completos e verificados.
+```
+
+Checkpoints:
+
+| Checkpoint | Comando formal | Evidencia de conclusao |
+|------------|----------------|------------------------|
+| `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.
+- `status.json` tem `"status": "complete"`.
+
+## Regras de Execucao
+
+<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>
+
+- 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.
+- 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.
+
+## Comandos de Status
+
+- `status`: leia `status.json` e as ultimas 10 entradas de `progress.md`; reporte checkpoint atual, completos, ultima verificacao 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.
+
+## 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.
+
+</system_instructions>

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

@@ -17,7 +17,7 @@ Use `/dw-autopilot "desejo"` como gateway pra maior parte do trabalho. Comandos
 
 | Comando | Quando |
 |---------|--------|
-| `/dw-autopilot "desejo"` | Entry point padrão. PRD → TechSpec → Tasks → Run → QA → Review → Commit → PR. Três gates de aprovação. |
+| `/dw-autopilot "desejo"` | Entry point padrão em duas invocações. Primeira roda plan e para; segunda retoma via `/dw-goal`, commit e PR. |
 | `/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. |
 
@@ -48,15 +48,15 @@ Use `/dw-autopilot "desejo"` como gateway pra maior parte do trabalho. Comandos
 
 ## Workflow em resumo
 
-`/dw-autopilot "desejo"` roda o pipeline completo (PRD → ... → PR) com 3 gates. Passo a passo:
+`/dw-autopilot "desejo"` roda planejamento primeiro e para. Reinvoque para retomar via `/dw-goal`, commit e PR. Passo a passo:
 
 ```
-/dw-brainstorm → /dw-plan → /dw-run → /dw-qa → /dw-review → /dw-commit → /dw-generate-pr
+/dw-brainstorm → /dw-plan → /dw-goal → /dw-commit → /dw-generate-pr
 ```
 
 ## Comandos avançados / internos
 
-Passe `--advanced` pra ver internos (`dw-adr`, `dw-intel`, `dw-secure-audit`, `dw-find-skills`, `dw-update`, `dw-subtask-start`, `dw-subtask-complete`, `dw-subtask-resume`) — usualmente invocados por outros comandos.
+Passe `--advanced` pra ver internos (`dw-adr`, `dw-intel`, `dw-secure-audit`, `dw-goal`, `dw-find-skills`, `dw-update`, `dw-subtask-start`, `dw-subtask-complete`, `dw-subtask-resume`) — usualmente invocados por outros comandos.
 ```
 
 ## Modo advanced — flag `--advanced`
@@ -68,13 +68,14 @@ ALSO show:
 
 Auto-invocados por comandos primários mas disponíveis standalone.
 
-## Tier 4 — Hidden (8)
+## Tier 4 — Hidden (9)
 
 | Comando | O que | Invocado por |
 |---------|-------|--------------|
 | `/dw-adr "decisão"` | Registra um ADR em `.dw/spec/<prd>/adrs/`. | `/dw-plan techspec --council`, desvios de constitution |
 | `/dw-intel "pergunta"` | Query de codebase intel; `--build` (re)indexa `.dw/intel/`. | `/dw-plan`, `/dw-review`, `/dw-bugfix` |
 | `/dw-secure-audit` | OWASP + Trivy + lockfile + supply-chain scan. Hard gate. Flags: `--scan-only`, `--plan`, `--execute`. | `/dw-review`, `/dw-generate-pr` |
+| `/dw-goal "<objetivo>"` | Contrato de objetivo duravel com `.dw/goals/`; faz ponte com `/goal` nativo do Codex quando disponivel. | `/dw-autopilot` apos planejamento |
 | `/dw-find-skills "query"` | Busca npx skills ecosystem, valida, instala. | manual ao estender bundle |
 | `/dw-update` | Atualiza dev-workflow pro último release npm com snapshot rollback. | manutenção manual |
 | `/dw-subtask-start "goal"` | Cria um input packet minimo para subagente. | parent antes de delegar |
@@ -89,6 +90,7 @@ Auto-invocados por comandos primários mas disponíveis standalone.
 | `prd`, `spec`, `plan`, `arquitetura`, `techspec`, `tasks` | `/dw-plan` (stage apropriado) |
 | `bug`, `erro`, `quebrado`, `fix` | `/dw-bugfix` |
 | `run`, `executa`, `implementa` | `/dw-run` |
+| `goal`, `objetivo`, `long-running`, `retomar autopilot` | `/dw-goal` ou `/dw-autopilot` se `autopilot-state.json` existir |
 | `review`, `qualidade`, `audit code` | `/dw-review` |
 | `qa`, `test plan`, `e2e` | `/dw-qa` |
 | `commit`, `git` | `/dw-commit` |
@@ -117,10 +119,10 @@ Sem match: surface padrão + nota.
 ## FAQ
 
 **P: Onde começo com uma nova feature?**
-- `/dw-autopilot "o que voce quer"`. Roda PRD → ... → PR com três gates.
+- `/dw-autopilot "o que voce quer"`. Primeira invocacao roda PRD → TechSpec → Tasks e para; segunda invocacao retoma via `/dw-goal`, commit e PR.
 
 **P: Tenho que usar `/dw-autopilot`?**
-- Não. Pipeline granular dá controle a cada step.
+- Não. Pipeline granular dá controle a cada step, com `/dw-goal` quando quiser executar run/review/QA/review como objetivo duravel.
 
 **P: Só quero corrigir um bug.**
 - `/dw-bugfix "<descrição>"`. Tria, 3 perguntas, fixa ou roteia.

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

@@ -50,6 +50,12 @@ Quando agentes do projeto estiverem instalados, use:
 
 Claude Code e OpenCode podem usar agentes nativos. Codex e Copilot usam `.agents/agents/` mais estas instrucoes como fallback.
 
+## Ferramenta de Entrevista Estruturada
+
+<critical>Quando uma ferramenta estruturada de entrevista/input do usuario estiver disponivel, `/dw-plan` DEVE usa-la para as perguntas de clarificacao de PRD e TechSpec. Nao rebaixe para chat comum por conveniencia. Se nenhuma ferramenta desse tipo existir no runtime, faca as mesmas perguntas no chat e registre explicitamente: `Ferramenta de entrevista estruturada indisponivel; usando fallback em chat.`</critical>
+
+A ferramenta e obrigatoria no planejamento porque preserva escolhas explicitas do usuario e impede o agent de responder as proprias perguntas. Cada estagio mantem sua propria cota: PRD exige 7+ perguntas de produto; TechSpec exige 7+ perguntas tecnicas.
+
 ## Constitution Gate
 
 <critical>ANTES de qualquer estágio, cheque `.dw/constitution.md`. Se AUSENTE, copie `templates/constitution-template.md` para `.dw/constitution.md` (defaults severity=info), avise usuário no chat, e SIGA. Se PRESENTE, todo FR (PRD), toda decisão arquitetural (TechSpec) e toda task (Tasks) carrega metadata Constitution Alignment mapeando para princípios relevantes ou declarando desvio.</critical>
@@ -73,7 +79,7 @@ Roda em modo padrão OU `plan prd`.
 
 ### Comportamento obrigatório
 
-1. **Perguntas de clarificação (MÍNIMO 7).** Antes de escrever qualquer coisa, faça 7+ perguntas cobrindo: objetivos, usuários-alvo, limites de escopo, métricas de sucesso, estratégia de rollout, pontos de integração, edge cases.
+1. **Perguntas de clarificação (MÍNIMO 7).** Antes de escrever qualquer coisa, use a ferramenta de entrevista estruturada quando disponivel para fazer 7+ perguntas cobrindo: objetivos, usuários-alvo, limites de escopo, métricas de sucesso, estratégia de rollout, pontos de integração, edge cases. Se a ferramenta estiver indisponivel, use fallback em chat e registre o fallback.
 2. **Web search MÍNIMO 3 queries** para padrões de mercado, contexto regulatório, abordagens de competidores quando relevante.
 3. **Constitution alignment.** Cada requisito funcional (FR-N.M) inclui linha `Constitution Alignment: respects P-NNN, P-MMM` OU `no applicable principle: <motivo>`.
 4. **Awareness multi-projeto.** Se feature cruza projetos do workspace, consulte `.dw/rules/integrations.md` e documente escopo na seção "Projetos Impactados".
@@ -97,7 +103,7 @@ Roda em modo padrão (após aprovação do PRD) OU `plan techspec` OU `plan --fr
 ### Comportamento obrigatório
 
 1. **Hard gate: open questions do PRD.** Se `.dw/spec/prd-<feature>/prd.md` tem seção "Open Questions" com itens não resolvidos, PARE e peça pra usuário resolver primeiro.
-2. **Perguntas de clarificação (MÍNIMO 7).** Perguntas técnicas cobrindo: domain placement, data flow, dependências, core interfaces, estratégia de testes, reuse-vs-build, integração multi-projeto se aplicável.
+2. **Perguntas de clarificação (MÍNIMO 7).** Use a ferramenta de entrevista estruturada quando disponivel para fazer perguntas tecnicas cobrindo: domain placement, data flow, dependências, core interfaces, estratégia de testes, reuse-vs-build, integração multi-projeto se aplicável. Se a ferramenta estiver indisponivel, use fallback em chat e registre o fallback.
 3. **Web search MÍNIMO 3 queries** + Context7 MCP para framework/library specifics.
 4. **Source grounding (`dw-source-grounding`).** Toda decisão de framework/library carrega `[source: <url>, version: X.Y, retrieved: YYYY-MM-DD]`.
 5. **Constitution gate.** Cada decisão arquitetural lista `Respects: P-NNN` ou `Deviates: P-NNN — justification: <slug ADR ou racional>`. Desvios de princípios `severity: high/critical` sem ADR → PARE.
@@ -178,7 +184,7 @@ Após plan completo, o diretório do PRD contém:
 
 ## Diretrizes finais
 
-- Cada estágio tem sua própria cota de perguntas de clarificação — não recicle. Estágios diferentes precisam de framing diferente.
+- Cada estágio tem sua própria cota de perguntas de clarificação — não recicle. Estágios diferentes precisam de framing diferente. Use a ferramenta de entrevista estruturada sempre que disponivel.
 - Web search é obrigatório; Context7 MCP para libraries. Sem pular pra "acho que sei a versão mais recente."
 - Constitution gate roda na entrada de cada estágio; defaults são auto-instalados quando ausente (nunca bloqueia).
 - Os três estágios produzem Markdown commitado — esses são os artefatos canônicos de planejamento. Eles evoluem com a feature.