* docs(#2197): drop --validate docs for /gsd-plan-phase and /gsd-execute-phase These two commands never parse --validate (silent no-op); the flag is real only for /gsd-quick. Remove the false flag-table rows and CLI examples across COMMANDS.md and the how-to guides (en + ja-JP/zh-CN/ ko-KR/pt-BR mirrors), and correct the manager.flags.execute example from --validate to --cross-ai (a flag execute-phase actually parses). /gsd-quick's real --validate docs are left untouched. Ref #2197 * docs(#2197): add changeset for --validate docs removal --------- Co-authored-by: CI Rebase Check <ci@gsd-redux>
This commit is contained in:
Rezolv
@@ -171,7 +171,6 @@ Pesquisa, planeja e verifica uma fase.
|
||||
| `--ingest <path-or-glob>` | Usa arquivo(s) ADR em vez de discuss-phase para síntese de contexto |
|
||||
| `--ingest-format <auto\|nygard\|madr\|narrative>` | Substituição opcional do formato do parser ADR para `--ingest` |
|
||||
| `--reviews` | Replaneja com feedback de revisão cross-AI do REVIEWS.md |
|
||||
| `--validate` | Executa validação de estado antes de iniciar o planejamento |
|
||||
| `--bounce` | Executa validação de bounce externo após o planejamento (usa `workflow.plan_bounce_script`) |
|
||||
| `--skip-bounce` | Ignora o bounce do plano mesmo se habilitado na configuração |
|
||||
| `--mvp` | Modo MVP vertical — o planejador organiza tarefas como fatias de funcionalidade (UI→API→DB) em vez de camadas horizontais. Na Fase 1 de um novo projeto sem resumos de fases anteriores, também emite `SKELETON.md` (Walking Skeleton). Pode ser persistido em uma fase via `**Mode:** mvp` no ROADMAP.md, o que aplica `--mvp` automaticamente sem a flag. |
|
||||
@@ -200,7 +199,6 @@ Consulte o [Portão de Legitimidade de Pacotes no Guia do Usuário](USER-GUIDE.m
|
||||
/gsd-plan-phase 1 # Pesquisa + plano + verificação da fase 1
|
||||
/gsd-plan-phase 3 --skip-research # Planejar sem pesquisa (domínio familiar)
|
||||
/gsd-plan-phase --auto # Planejamento não interativo
|
||||
/gsd-plan-phase 2 --validate # Valida estado antes do planejamento
|
||||
/gsd-plan-phase 1 --bounce # Plano + validação de bounce externo
|
||||
/gsd-plan-phase 2 --ingest docs/adr/0010.md # Caminho expresso via ADR para síntese de contexto
|
||||
/gsd-plan-phase 2 --ingest 'docs/adr/00*.md' --ingest-format auto
|
||||
@@ -258,7 +256,6 @@ Executa todos os planos de uma fase com paralelização baseada em waves, ou exe
|
||||
|-----------|-------------|-----------|
|
||||
| `N` | **Sim** | Número da fase a executar |
|
||||
| `--wave N` | Não | Executa somente a Wave `N` da fase |
|
||||
| `--validate` | Não | Executa validação de estado antes de iniciar a execução |
|
||||
| `--cross-ai` | Não | Delega a execução para uma CLI de IA externa (usa `workflow.cross_ai_command`) |
|
||||
| `--no-cross-ai` | Não | Força execução local mesmo se cross-AI estiver habilitado na configuração |
|
||||
|
||||
@@ -270,7 +267,6 @@ Executa todos os planos de uma fase com paralelização baseada em waves, ou exe
|
||||
```bash
|
||||
/gsd-execute-phase 1 # Executa a fase 1
|
||||
/gsd-execute-phase 1 --wave 2 # Executa somente a Wave 2
|
||||
/gsd-execute-phase 1 --validate # Valida estado antes da execução
|
||||
/gsd-execute-phase 2 --cross-ai # Delega a fase 2 para CLI de IA externa
|
||||
```
|
||||
|
||||
@@ -590,7 +586,7 @@ Configure flags por etapa em `.planning/config.json` sob `manager.flags`. Essas
|
||||
"flags": {
|
||||
"discuss": "--auto",
|
||||
"plan": "--skip-research",
|
||||
"execute": "--validate"
|
||||
"execute": "--cross-ai"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -734,7 +734,7 @@ Configure flags por etapa que `/gsd-manager` acrescenta a cada comando despachad
|
||||
|---------|------|---------|-------------|
|
||||
| `manager.flags.discuss` | string | (nenhum) | Flags acrescidas a comandos de discuss-phase (por exemplo, `"--auto"`) |
|
||||
| `manager.flags.plan` | string | (nenhum) | Flags acrescidas a comandos de plan-phase (por exemplo, `"--skip-research"`) |
|
||||
| `manager.flags.execute` | string | (nenhum) | Flags acrescidas a comandos de execute-phase (por exemplo, `"--validate"`) |
|
||||
| `manager.flags.execute` | string | (nenhum) | Flags acrescidas a comandos de execute-phase (por exemplo, `"--cross-ai"`) |
|
||||
|
||||
**Exemplo:**
|
||||
|
||||
@@ -744,7 +744,7 @@ Configure flags por etapa que `/gsd-manager` acrescenta a cada comando despachad
|
||||
"flags": {
|
||||
"discuss": "--auto",
|
||||
"plan": "--skip-research",
|
||||
"execute": "--validate"
|
||||
"execute": "--cross-ai"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -114,12 +114,6 @@ Se precisar executar novamente apenas uma onda específica:
|
||||
/gsd-execute-phase 1 --wave 2
|
||||
```
|
||||
|
||||
Se quiser validar a integridade de `.planning/` antes de despachar:
|
||||
|
||||
```bash
|
||||
/gsd-execute-phase 1 --validate
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Reverter com `/gsd-undo`
|
||||
|
||||
@@ -45,18 +45,6 @@ O GSD Core executa apenas os planos da Onda 2. Ele primeiro verifica se todas as
|
||||
|
||||
---
|
||||
|
||||
## Validar o estado antes da execução
|
||||
|
||||
Se você suspeitar que o diretório `.planning/` está fora de sincronia com o sistema de arquivos — por exemplo, após uma falha ou uma execução anterior interrompida — passe `--validate`:
|
||||
|
||||
```bash
|
||||
/gsd-execute-phase 1 --validate
|
||||
```
|
||||
|
||||
O GSD Core executa uma verificação de consistência de estado antes de criar qualquer executor. Desvios detectados são relatados e você pode aceitá-los ou corrigi-los antes de prosseguir.
|
||||
|
||||
---
|
||||
|
||||
## Retomar uma execução paralisada
|
||||
|
||||
Se a execução parar no meio — um erro de cota, uma queda de rede ou uma sessão travada — o progresso no nível de onda é preservado. O GSD Core verifica a existência de um arquivo `SUMMARY.md` para cada plano; planos que já possuem esse arquivo são ignorados automaticamente ao reexecutar:
|
||||
|
||||
@@ -128,16 +128,6 @@ A pesquisa é ignorada; o planejador lê as lacunas de verificação diretamente
|
||||
|
||||
---
|
||||
|
||||
## Validar o estado do projeto antes de iniciar o planejamento
|
||||
|
||||
```bash
|
||||
/gsd-plan-phase 2 --validate
|
||||
```
|
||||
|
||||
Executa a validação de estado antes de acionar o pesquisador. Use isso se suspeitar que o ROADMAP.md ou STATE.md derivou.
|
||||
|
||||
---
|
||||
|
||||
## Executar uma validação externa de bounce após o planejamento
|
||||
|
||||
**Se `workflow.plan_bounce_script` estiver configurado e você quiser validação externa do plano concluído:**
|
||||
|
||||
Reference in New Issue
Block a user