a9a7a328e6
Mechanical rename produced by scripts/msd-rename.cjs: gsd/Gsd/GSD -> msd/Msd/MSD across contents and paths, upstream package/repo coordinates -> @golem15/msd-core and golem15com/msd-core. Deep links into upstream history, sibling upstream packages, the GSD-2 import feature, CHANGELOG.md and .changeset/ are kept as-is. Hand edits on top: MSD block-letter banner and logos, LICENSE copyright line, package/plugin identity, regenerated lockfile, install-tree fixtures, derived registries and benchmark baseline; migration checksum baseline re-locked (MSD keeps its own install state, so no install had applied the old sums); sort-order and regex-escaped expectations in tests adjusted.
125 lines
5.6 KiB
Markdown
125 lines
5.6 KiB
Markdown
# Como executar fases de forma autônoma
|
|
|
|
Execute todas as fases restantes — ou um intervalo delimitado delas — sem supervisão, para que o MSD avance por discuss → plan → execute em cada fase sem que você precise conduzir cada etapa.
|
|
|
|
Para mais informações sobre o que o loop de fases faz durante uma execução autônoma, consulte [O loop de fases](../explanation/the-phase-loop.md).
|
|
|
|
---
|
|
|
|
## Pré-requisitos
|
|
|
|
- Um projeto ativo com `.planning/ROADMAP.md` e `.planning/STATE.md`
|
|
- Todas as fases que você deseja executar devem estar em um estado que o modo autônomo possa conduzir (pendente ou em andamento; não já concluídas)
|
|
- Qualquer decisão de design que você se importe já deve estar em `PROJECT.md` ou registrada via um `/msd-discuss-phase` anterior — o modo autônomo só consegue apresentar áreas cinzentas de forma interativa quando você usa `--interactive`
|
|
|
|
---
|
|
|
|
## Executar todas as fases restantes
|
|
|
|
```bash
|
|
/msd-autonomous
|
|
```
|
|
|
|
O MSD lê o `ROADMAP.md`, descobre cada fase incompleta em ordem numérica e executa discuss → plan → execute em cada uma. Após todas as fases serem concluídas, ele executa automaticamente o ciclo de vida do milestone: audit → complete → cleanup.
|
|
|
|
---
|
|
|
|
## Executar um intervalo específico de fases
|
|
|
|
Use `--from` e `--to` para delimitar a execução. Ambos os flags aceitam números de fase decimais (ex.: `3.1`).
|
|
|
|
```bash
|
|
/msd-autonomous --from 3 # fases 3, 4, 5 … (ignora as fases 1 e 2 já concluídas)
|
|
/msd-autonomous --to 5 # fases até e incluindo a 5
|
|
/msd-autonomous --from 3 --to 5 # exatamente as fases 3, 4 e 5
|
|
```
|
|
|
|
Quando `--to` é atingido, a etapa de ciclo de vida é ignorada, pois nem todas as fases do milestone foram concluídas. O banner de conclusão informa como retomar:
|
|
|
|
```text
|
|
Resume with: /msd-autonomous --from 6
|
|
```
|
|
|
|
---
|
|
|
|
## Executar com discuss interativo
|
|
|
|
Por padrão, o modo autônomo responde às perguntas de discuss automaticamente usando o smart discuss (propostas em tabela em lote). Se você quiser responder às perguntas de design você mesmo, mantendo plan e execute fora do contexto principal:
|
|
|
|
```bash
|
|
/msd-autonomous --interactive
|
|
```
|
|
|
|
No modo interativo:
|
|
- `/msd-discuss-phase` é executado inline e aguarda suas respostas
|
|
- Planejamento e execução são despachados como agentes em segundo plano para que você possa discutir a próxima fase enquanto a atual está sendo construída
|
|
- O contexto principal permanece enxuto — apenas as conversas de discuss se acumulam
|
|
|
|
---
|
|
|
|
## Quais barreiras de segurança ainda se aplicam
|
|
|
|
O modo autônomo não ignora o pipeline de qualidade do MSD. Cada fase ainda:
|
|
|
|
- Executa o plan-checker antes da execução
|
|
- Lê o `VERIFICATION.md` após a execução e decide o caminho com base no resultado
|
|
- Pausa e pergunta o que fazer quando o status de verificação é `human_needed` ou `gaps_found`
|
|
- Para e apresenta opções (corrigir e tentar novamente, ignorar fase ou parar) se alguma etapa falhar
|
|
|
|
A única diferença em relação à execução manual é que a verificação com resultado `passed` avança automaticamente — você não é questionado entre as fases a menos que uma decisão seja necessária.
|
|
|
|
A barreira de legitimidade de pacotes também permanece ativa. Se um plano incluir uma tarefa `checkpoint:human-verify` para um pacote suspeito, o executor irá parar e apresentar o checkpoint. O modo autônomo não instalará silenciosamente pacotes sinalizados.
|
|
|
|
---
|
|
|
|
## Quando não usar o modo autônomo
|
|
|
|
Não use `/msd-autonomous` quando:
|
|
|
|
- **As fases têm decisões de design não resolvidas.** Se você não executou `/msd-discuss-phase` e seu `PROJECT.md` não registra suas preferências, o smart discuss fará escolhas autônomas com as quais você pode não concordar. Execute o discuss de forma interativa primeiro, ou use `--interactive`.
|
|
|
|
- **Você precisa de controle detalhado sobre uma única fase.** Para uma fase, `/msd-execute-phase N` fornece saída passo a passo e permite que você reaja antes de continuar. O modo autônomo é projetado para execuções em lote sem supervisão.
|
|
|
|
- **A fase tem trabalho novo ou de alto risco.** O modo autônomo ignora pausas a menos que encontre um bloqueador. Em uma fase onde você espera surpresas, mantenha-se no loop com execução manual.
|
|
|
|
- **Você está no meio de uma fase com execução parcial.** O modo autônomo retoma fases incompletas, mas não retoma uma onda parcialmente executada. Use `/msd-execute-phase N` para concluir uma fase que já está em andamento.
|
|
|
|
Se uma execução parar no meio do caminho, consulte [Depurar uma execução com falha](debug-a-failed-execution.md) para saber como diagnosticar o que deu errado.
|
|
|
|
---
|
|
|
|
## Verificar o progresso durante uma execução
|
|
|
|
O modo autônomo exibe um banner de progresso antes de cada fase:
|
|
|
|
```text
|
|
MSD ► AUTONOMOUS ▸ Phase 3/7: Auth Middleware [████░░░░] 28%
|
|
```
|
|
|
|
Se você precisar verificar onde a execução está no meio da sessão, abra outro terminal e execute:
|
|
|
|
```bash
|
|
/msd-progress
|
|
```
|
|
|
|
---
|
|
|
|
## Retomar após uma parada
|
|
|
|
Se o modo autônomo parar — seja porque você escolheu "Stop autonomous mode" no prompt de bloqueio, ou a sessão foi interrompida — retome de onde parou:
|
|
|
|
```bash
|
|
/msd-autonomous --from 4 # substitua 4 pelo número da primeira fase incompleta
|
|
```
|
|
|
|
O MSD ignora automaticamente as fases já concluídas, portanto é seguro executar novamente a partir de um número de fase anterior caso não tenha certeza de onde a execução parou.
|
|
|
|
---
|
|
|
|
## Relacionados
|
|
|
|
- [Executar uma fase](execute-a-phase.md)
|
|
- [Depurar uma execução com falha](debug-a-failed-execution.md)
|
|
- [Comandos](../COMMANDS.md)
|
|
- [Índice da documentação](../README.md)
|