3bb2f8f1c5
* chore: wire docs/agents config into AGENTS.md Agent skills section
Add the `## Agent skills` discovery block pointing the engineering
skills at the existing docs/agents/{issue-tracker,triage-labels,domain}.md
files (issue tracker, triage label mapping, single-context domain docs).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: rebrand to GSD Core and restructure docs with Diataxis
Reorganise the root README and docs/ around the Diataxis framework
(tutorials, how-to guides, reference, explanation), add new how-to
guides and schema references (STATE.md / CONTEXT.md / PLAN.md /
planning artifacts), and cross-link the whole set. Update the lone
legacy gsd-build reference to open-gsd; keep internal get-shit-done/
filesystem paths unchanged (directory rename tracked separately in
open-gsd/gsd-core#604). Regenerate the ja-JP, ko-KR, pt-BR and zh-CN
localised trees to mirror the new structure.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: backfill changeset PR number (#605)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
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 GSD 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 `/gsd-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
|
|
/gsd-autonomous
|
|
```
|
|
|
|
O GSD 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
|
|
/gsd-autonomous --from 3 # fases 3, 4, 5 … (ignora as fases 1 e 2 já concluídas)
|
|
/gsd-autonomous --to 5 # fases até e incluindo a 5
|
|
/gsd-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: /gsd-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
|
|
/gsd-autonomous --interactive
|
|
```
|
|
|
|
No modo interativo:
|
|
- `/gsd-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 GSD. 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 `/gsd-autonomous` quando:
|
|
|
|
- **As fases têm decisões de design não resolvidas.** Se você não executou `/gsd-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, `/gsd-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 `/gsd-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
|
|
GSD ► 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
|
|
/gsd-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
|
|
/gsd-autonomous --from 4 # substitua 4 pelo número da primeira fase incompleta
|
|
```
|
|
|
|
O GSD 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)
|