Módulo 4.3

🤖 Modo Autônomo e Multi-Agent

O modo autônomo do GSD executa todas as fases restantes sem intervenção humana. Entenda como a orquestração de múltiplos agentes funciona, o mecanismo de waves paralelas e os guardrails de segurança que protegem o trabalho.

1

🚀 /gsd:autonomous

O /gsd:autonomous encadeia automaticamente discuss → plan → execute → verify para todas as fases restantes do projeto. Você inicia e pode deixar rodar.

Sintaxe

/gsd:autonomous              # Executar todas as fases restantes
/gsd:autonomous --from 3     # Começar a partir da fase 3

O que /gsd:autonomous faz por fase

1

discuss-phase (se skip_discuss: false)

Captura contexto de implementação. Com skip_discuss: true, escreve CONTEXT.md mínimo a partir do ROADMAP sem perguntas.

2

plan-phase (com --auto)

Pesquisa, planejamento e verificação de planos sem confirmações interativas.

3

execute-phase (waves paralelas)

Executa planos em ondas de dependência. Planos independentes rodam simultaneamente.

4

verify-work

Verifica fase concluída. Se falhar e node_repair habilitado: tenta reparar antes de avançar.

Config recomendada para /gsd:autonomous

{
  "mode": "yolo",
  "workflow": {
    "skip_discuss": true,   // pula perguntas
    "auto_advance": true,   // encadeia sem parar
    "node_repair": true     // repara falhas automaticamente
  }
}
2

🌊 Waves de Execução Paralela

Durante o /gsd:execute-phase, o GSD agrupa os planos da fase em waves baseado em dependências. Planos da mesma wave rodam em paralelo; waves distintas rodam em sequência.

Exemplo de waves em uma fase

Wave 1— paralelo
1.1-PLAN: criar schema DB 1.2-PLAN: configurar autenticação
↓ aguarda Wave 1 concluir
Wave 2— paralelo
1.3-PLAN: endpoints REST (depende de schema) 1.4-PLAN: middleware JWT (depende de auth)
Configuração Default Descrição
parallelization.enabledtrueHabilita execução paralela de planos
parallelization.max_concurrent_agents3Máximo de agentes simultâneos por wave
parallelization.min_plans_for_parallel2Mínimo de planos para ativar paralelo
parallelization.task_levelfalseParalelismo dentro de um plano (experimental)
parallelization.skip_checkpointstruePula checkpoints durante execução paralela

Pre-commit hooks e execução paralela

Com paralelização ativa, os executores fazem commits com --no-verify para evitar contenção de lock (ex: cargo lock em projetos Rust). O orquestrador valida hooks uma vez após cada wave. Para forçar hooks por commit, desative: "parallelization.enabled": false.

3

🛡️ Guardrails de Segurança

O modo autônomo tem salvaguardas que impedem que um agente destrua trabalho ou tome ações irreversíveis sem supervisão.

🔒

always_confirm_destructive

safety.always_confirm_destructive: true

Mesmo em modo yolo, operações destrutivas (deletar arquivos, sobrescrever schemas) exigem confirmação. Nunca desative em produção.

🌐

always_confirm_external_services

safety.always_confirm_external_services: true

Chamadas a APIs externas, deploys e envio de emails sempre pedem confirmação. Evita custos ou ações indesejadas no modo autônomo.

🔐

Prompt Injection Guard

gsd-prompt-guard.js — sempre ativo, não pode ser desabilitado

Hook de segurança que detecta e bloqueia tentativas de prompt injection nos artefatos de planejamento. É uma feature de segurança, não um toggle de workflow.

📊

Context Window Monitor

hooks.context_warnings: true

Monitora uso da janela de contexto durante a execução autônoma. Emite avisos antes de atingir limites críticos para evitar truncamento silencioso.

Workflow Guard — opcional mas recomendado

Com "workflow_guard": true, o GSD avisa quando edições de arquivo acontecem fora do contexto GSD (ex: edição direta sem usar /gsd:quick ou /gsd:fast). Útil para equipes que querem rastreabilidade total.

4

🔄 Recuperação e Monitoramento

/gsd:forensics

Investigação post-mortem de workflows travados ou falhados. Analisa histórico git, integridade de artefatos, anomalias de STATE.md e trabalho abandonado.

/gsd:forensics
/gsd:forensics "Fase 3 travou"

/gsd:execute-phase N --wave W

Retomar execução a partir de uma wave específica após falha. Evita re-executar work já concluído.

/gsd:execute-phase 3 --wave 2
# Executa apenas a Wave 2 da fase 3

/gsd:pause-work

Salva handoff de contexto quando parar no meio de uma fase. Cria continue-here.md para retomada precisa.

/gsd:pause-work    # → continue-here.md
/gsd:resume-work   # → restaura contexto

/gsd:thread

Contexto persistente para trabalho que cruza múltiplas sessões mas não pertence a nenhuma fase específica.

/gsd:thread                   # Listar threads
/gsd:thread "Investigar TCP"  # Novo thread

Visão geral: do interativo ao autônomo

Máx controle
mode: interactive + todos os gates habilitados
Equilibrado
mode: interactive + auto_advance: true
Semiautônomo
mode: yolo + skip_discuss: false
Máx autônomo
/gsd:autonomous + mode: yolo + skip_discuss: true

Parabéns — Curso Concluído!

Você concluiu as 4 trilhas do curso GSD. Agora você domina desde a filosofia do framework até execução autônoma com orquestração multi-agent.

Próximos passos

Instale o GSD (npm i -g @getshitdone/gsd), inicie um projeto real com /gsd:new-project e coloque em prática tudo o que aprendeu.