Workflow Padrão

Uma metodologia clara para garantir a qualidade do código e a consistência do projeto.

Etapas Técnicas

Brainstorming

Etapa inicial para alinhar ideias e definir a melhor abordagem antes de escrever código.

Especificação

Documentação formal de requisitos, comportamento esperado e critérios de aceitação.

Planejamento em Fases

Transforma a spec em tarefas pequenas, revisáveis e testáveis (Implementation Plan).

Ciclo TDD

Red → Green → Refactor. Escreva o teste primeiro, depois o código mínimo para passar.

Review Automatizado

Verificação com subagentes e linters antes de realizar o commit de qualquer mudança.

Debug Sistemático

Debugging estruturado com hipóteses, investigação e verificação sistemática.

Finalizando uma Branch

Limpeza e preparação para merge. Commits limpos, PR pronto para review.

SDD na Prática

O fluxo oficial do Superpowers é guiado por skills. Na maior parte do tempo, você descreve a intenção, aprova o design e inicia a execução.

1. Brainstorming

Descreva o problema; o skill deve ativar automaticamente

Como usar

Quero adicionar autenticação JWT
com refresh tokens e revogação.

Skill esperado:
brainstorming

Saída

Discussão de design

Requisitos, trade-offs e arquitetura são refinados em conversa.

Arquivo de design

Salvo em docs/superpowers/specs/ após aprovação.

2. Worktree + Plano

Depois da aprovação, o Superpowers isola o trabalho e escreve o plano de implementação

Skills esperados

using-git-worktrees
writing-plans

Saída

docs/superpowers/specs/...-design.md
docs/superpowers/plans/...md

O plano quebra o trabalho em tarefas
pequenas, testáveis e verificáveis.

3. Execução + TDD

Execute o plano aprovado tarefa por tarefa

Execução recomendada

/subagent-driven-development

Alternativa:
executing-plans

TDD em cada tarefa

RED

Escreva primeiro o teste que falha.

GREEN

Implemente o mínimo para passar.

REFACTOR

Melhore a estrutura sem quebrar os testes.

4. Review Entre Tarefas

Review faz parte do fluxo, não é um extra no final

Skill esperado

requesting-code-review

O que verifica

Aderência ao plano

Confere se a implementação ainda segue o design e o plano aprovados.

Issues de qualidade

Aponta preocupações não bloqueantes para limpeza.

Bloqueios críticos

Interrompe o progresso quando a tarefa introduz defeitos graves.

6. Debug Sistemático

Hipótese → Investigação → Fix cirúrgico

Como usar

/debug-issue

Descreva o sintoma:
"O refresh token retorna 401
após 30 minutos"

A IA segue o método:
1. Formula hipóteses
2. Investiga cada uma
3. Aplica fix cirúrgico
4. Verifica com testes

Método

1. Hipótese

"Token expirado? Clock skew? Secret errado?"

2. Investigação

Verifica logs, testa cada hipótese isoladamente.

3. Fix

Aplica correção mínima. Não refatora durante debug.

7. Finalizar a Branch

Encerre com o workflow oficial de finalização

Como finalizar

/finishing-a-development-branch

Resultados típicos:
- fazer merge agora
- abrir um PR
- manter a branch
- descartar a branch

Checklist Final

✓ Todos os testes passam

✓ Reviews foram resolvidos

✓ O estado da branch está explícito

✓ Houve verificação antes de concluir

✓ A decisão de merge ou PR está documentada

Sistema de Memória

4 camadas de memória, cada uma com responsabilidade clara. Contexto que sobrevive entre sessões.

Camada	Escopo	Persistência	Status
Regras	Convenções e padrões do projeto	Commitado no repo	commitado
Aprendizados	Decisões e lições das sessões	Commitado no repo	commitado
Sessões	Contexto da conversa atual	Efêmero (conversa)	automático
Auto Dream	Entidades e preferências aprendidas	Memória semântica (MCP)	mem0

Próximo Passo

Entenda a estrutura gerada pelo wizard e como cada peça se conecta.

Ver Estrutura