Ir para o conteúdo

Modo Autônomo — /autonomous-sdd

/autonomous-sdd é o skill de autopilot ponta a ponta da Planu. Dada uma spec aprovada, gerencia o pipeline de implementação completo sem exigir intervenção humana a cada etapa: gate de prontidão, criação de branch, implementação contra todos os critérios de aceitação, auto-revisão, validação e merge.

Se você conhece o cc-sdd, /autonomous-sdd é o equivalente funcional do /kiro-impl — com duas fases adicionais (verificação de prontidão e observador de cura pós-merge) que o /kiro-impl não inclui.


Quando Usar

O modo autônomo é apropriado quando:

  • A spec foi aprovada e todos os critérios de aceitação são específicos e verificáveis.
  • A tarefa é autocontida — um agente pode completá-la sem decisões de design durante a execução.
  • Você quer delegar o loop de implementação completo e revisar o resultado ao final, em vez de a cada etapa.

Não é a escolha certa quando:

  • Os critérios de aceitação ainda são ambíguos. Execute challenge_spec e check_readiness primeiro.
  • A tarefa requer decisões de produto que dependem de contexto que um agente não consegue inferir apenas da spec.
  • Você prefere visibilidade passo a passo — nesse caso, execute implement_plan, validate e create_pr_from_spec manualmente.

Como Ativar

O modo autônomo é um skill da Planu. Instale uma vez e invoque-o a partir de qualquer agente compatível com MCP.

Instalar o skill:

bash
planu skill install autonomous-sdd

Invocar pelo Claude Code (ou qualquer cliente MCP):

/autonomous-sdd SPEC-042

O skill lê sua spec aprovada, bloqueia-a para evitar edições concorrentes e inicia o pipeline. O progresso é transmitido em tempo real.


As Seis Fases Internas

O modo autônomo executa seis fases internamente. Cada fase é observável e pode ser interrompida se necessário.

Fase 1 — Gate de prontidão. Antes de escrever uma única linha de código, o skill valida que cada critério de aceitação atende ao limite mínimo de qualidade para implementação autônoma: especificidade, testabilidade e ausência de contradições. Se algum critério falhar no gate, o skill para e informa quais critérios precisam de melhoria. Isso evita desperdício de computação em trabalho mal especificado.

Fase 2 — Branch. Um branch Git dedicado é criado para a spec, seguindo a convenção de nomenclatura de branches do seu projeto (feat/SPEC-NNN-slug). A spec é bloqueada no branch para que nenhum outro agente ou sessão possa modificá-la enquanto a implementação está em andamento.

Fase 3 — Implementação. O agente trabalha os critérios de aceitação sequencialmente, referenciando explicitamente cada critério enquanto escreve o código. O progresso intermediário é salvo em checkpoints para que a execução possa ser retomada se interrompida. As decisões arquiteturais tomadas durante a implementação são registradas automaticamente no registro de decisões técnicas da spec.

Fase 4 — Auto-revisão. Quando a implementação está completa, o skill executa uma revisão multi-passagem contra a spec. Cada critério de aceitação é verificado em relação à implementação. Lacunas são sinalizadas antes do início da fase de validação, reduzindo o número de falhas de validação que requerem atenção humana.

Fase 5 — Validação. O loop de validação completo é executado: testes automatizados, detecção de deriva e uma verificação de conformidade critério por critério. Um relatório de validação é produzido. Se todos os critérios passarem, o pipeline avança. Se algum critério falhar, o skill tenta uma correção direcionada (até duas tentativas) antes de escalar a falha para revisão humana.

Fase 6 — Merge. Com um relatório de validação limpo, o branch é mesclado e o status da spec é atualizado para done. Um observador de cura pós-merge é registrado: a Planu continua monitorando a spec em busca de deriva em commits subsequentes e exibirá sugestões de cura retroativa se a implementação divergir.


Observabilidade e Controle

O modo autônomo foi projetado para ser interrompível em qualquer limite de fase. Pressione Ctrl+C durante uma execução ativa para pausar no próximo checkpoint seguro. O estado da execução é persistido e pode ser retomado com:

/autonomous-sdd --resume SPEC-042

Para revisar o que o skill fará antes de executá-lo:

/autonomous-sdd --dry-run SPEC-042

Isso imprime o plano de execução para as seis fases sem escrever código ou criar branches.


Relação com o /kiro-impl do cc-sdd

O /kiro-impl do cc-sdd executa três fases: branch, implementação e merge. /autonomous-sdd adiciona um gate de prontidão antes da implementação e um observador de cura pós-merge após ela. As fases de branch, implementação, auto-revisão e merge são estruturalmente equivalentes.

Se você está migrando do cc-sdd, suas specs aprovadas existentes são compatíveis com /autonomous-sdd sem modificações.


Leitura Adicional

Junte-se à comunidadeFaça perguntas, compartilhe feedback e conecte-se com outros desenvolvedores usando Planu.
Entrar no Discord