O Claude Code é poderoso por padrão, mas sem estrutura, ele pula direto para a codificação: sem planejamento, sem testes, sem abordagem sistemática. O plugin Superpowers corrige esse problema ao aplicar fluxos de trabalho de desenvolvimento comprovados que previnem o caos.
O que o Superpowers realmente faz
O Superpowers é um framework de habilidades que intercepta o Claude Code em momentos-chave. Em vez de escrever código imediatamente quando você pede algo, ele para e faz perguntas primeiro. Depois, aplica TDD, cria planos de implementação e revisa seu próprio trabalho antes de seguir em frente.
O fluxo de trabalho principal:
- Brainstorm: refina sua ideia através de questionamento socrático
- Planejar: cria tarefas pequenas (2 a 5 minutos cada) com caminhos de arquivo exatos
- Executar: despacha subagentes por tarefa com revisão em dois estágios
- Finalizar: verifica testes, oferece opções de PR/merge, limpa tudo
Instalação (10 Segundos)
bash
Abra o menu de plugins
/plugin
Navegue até a aba "Discover"
Busque por "superpowers"
Selecione e instale
Após a instalação, reinicie o Claude Code. Você verá "SessionStart:startup hook succeeded: Success" confirmando que o plugin está ativo.
O que é instalado
O plugin inclui tudo que você precisa:
| Componente | Incluído |
|---|---|
| Comandos | execute-plan, write-plan, brainstorm |
| Agentes | code-reviewer |
| Habilidades | 14 habilidades incluindo TDD, debugging, git worktrees, revisão de código |
| Hooks | SessionStart (inicializa automaticamente o fluxo de trabalho) |
Os três comandos principais
/superpowers:brainstorm
Use isso antes de QUALQUER nova funcionalidade. O Claude vai:
- fazer perguntas esclarecedoras sobre seu objetivo
- explorar alternativas que você não considerou
- apresentar o design em partes digestíveis para validação
- salvar um documento de design para referência
Quando acionar: Início de qualquer funcionalidade, refatoração ou migração.
/superpowers:write-plan
Após o brainstorm, isso cria um plano de implementação onde:
- cada tarefa leva no máximo 2 a 5 minutos
- toda tarefa tem caminhos de arquivo exatos e trechos de código completos
- etapas de verificação são incorporadas em cada tarefa
- o plano assume que um "engenheiro júnior entusiasmado sem contexto" vai executá-lo
/superpowers:execute-plan
Executa o plano usando desenvolvimento orientado por subagentes:
- subagente novo gerado por tarefa (contexto limpo)
- revisão em dois estágios: conformidade com especificação, depois qualidade de código
- pontos de verificação humanos entre lotes
- problemas críticos bloqueiam o progresso automaticamente
As 14 habilidades explicadas
| Habilidade | O que faz |
|---|---|
| test-driven-development | Aplica RED-GREEN-REFACTOR. Deleta código escrito antes dos testes. |
| systematic-debugging | Processo de causa raiz em 4 fases com defesa em profundidade |
| using-git-worktrees | Cria branch isolado, executa configuração, verifica baseline limpo |
| using-superpowers | Introdução ao sistema de habilidades |
| dispatching-parallel-agents | Fluxos de trabalho de subagentes concorrentes |
| executing-plans | Execução em lotes com pontos de verificação |
| finishing-a-development-branch | Opções de merge/PR/manter/descartar, limpeza |
| brainstorming | Refinamento de design socrático |
| writing-plans | Planejamento detalhado de implementação |
| requesting-code-review | Checklist pré-revisão, bloqueia em problemas críticos |
| receiving-code-review | Responde a feedback sistematicamente |
| writing-skills | Meta-habilidade para criar novas habilidades |
| verification-before-completion | Garante que as correções realmente funcionam |
| subagent-driven-development | Revisão em dois estágios por tarefa |
Como as habilidades acionam automaticamente
As habilidades não são comandos que você chama, elas ativam baseadas no contexto:
- começa a discutir uma nova funcionalidade → brainstorming ativa
- design aprovado → using-git-worktrees ativa
- implementação começa → test-driven-development ativa
- tarefa concluída → requesting-code-review ativa
- todas as tarefas concluídas → finishing-a-development-branch ativa
O Claude verifica habilidades relevantes antes de qualquer tarefa. Estes são fluxos de trabalho obrigatórios, não sugestões.
Integração com git worktree
O Superpowers usa git worktrees para desenvolvimento isolado: bash
O que acontece nos bastidores:
git worktree add ../project-feature feature-branch cd ../project-feature
Claude trabalha aqui, branch main permanece limpo
Benefícios:
- executar múltiplas instâncias do Claude em funcionalidades diferentes
- manter branch main estável durante experimentação
- limpeza fácil se algo der errado
Desenvolvimento orientado por subagentes
O padrão mais poderoso. Em vez de uma sessão longa do Claude:
- Agente principal cria o plano
- Subagente novo executa cada tarefa
- Agente revisor (code-reviewer) verifica o trabalho
- Agente principal continua ou solicita correções
Por que isso funciona: cada subagente começa com contexto limpo focado em UMA tarefa. Sem confusão acumulada de sessões longas.
Aplicação de TDD
O Superpowers leva TDD a sério. A habilidade:
- requer teste falhando ANTES da implementação
- observa o teste falhar (prova que testa algo)
- implementa código mínimo para passar
- faz commit no verde
- refatora apenas após o verde
Se o Claude escrever código antes dos testes, a habilidade o instrui a deletar esse código e começar de novo.
Exemplo prático
Você: Preciso de autenticação de usuário para meu app Express
Claude (com Superpowers): → Ativa habilidade brainstorming → Pergunta: OAuth ou senhas? Sessão ou JWT? Quais provedores? → Explora: Rate limiting? Bloqueio de conta? Requisitos de senha? → Apresenta design em seções para sua aprovação
Você: Parece bom, vamos planejar
Claude: → Ativa habilidade writing-plans → Cria 12 tarefas, cada uma de 2 a 5 minutos → Tarefa 1: Criar teste falhando para endpoint /signup → Tarefa 2: Implementar handler de signup para passar no teste → Cada tarefa tem caminhos de arquivo exatos e código
Você: Execute
Claude: → Gera subagente para Tarefa 1 → Agente code-reviewer valida saída → Gera subagente para Tarefa 2 → Reporta progresso, pede aprovação para continuar
Gerenciando o plugin
No menu /plugin você pode:
- Desabilitar plugin: desligar temporariamente
- Marcar para atualização: sinalizar para próximo ciclo de atualização
- Atualizar agora: obter versão mais recente imediatamente
- Desinstalar: remover completamente
- Ver no GitHub: ver código-fonte
Quando NÃO usar o Superpowers
- perguntas rápidas pontuais
- edições simples de arquivo
- tarefas com menos de 5 minutos
Para estes casos, o overhead não vale a pena. O Superpowers brilha em funcionalidades multi-arquivo, refatorações e migrações que requerem execução sistemática.
Referência Rápida
| Ação | Como |
|---|---|
| Instalar | /plugin → Discover → superpowers |
| Iniciar design | /superpowers:brainstorm |
| Criar plano | /superpowers:write-plan |
| Executar plano | /superpowers:execute-plan |
| Atualizar | /plugin → selecionar superpowers → Update now |
O Superpowers transforma o Claude Code de "assistente útil que às vezes sai dos trilhos" em "parceiro de desenvolvimento sistemático que segue processos comprovados". O fluxo de trabalho estruturado previne os modos de falha mais comuns: testes pulados, casos extremos perdidos e funcionalidades que se desviam dos requisitos.
