← IA

superpowers

Plugin de skills de processo para o Claude Code. Elas disparam sozinhas pelo contexto e levam do pedido ao PR: pensar, planejar, testar, revisar e só então dizer que terminou.

Fluxo de uma feature

12 skills, 1 pedido

00/12o pedido

pedido: O ponto de partida: um pedido curto, do jeito que se fala no dia a dia. O exemplo é um filtro por tag na lista de projetos do portfólio. Avance pela seta ou pelas teclas ← →.

claude code

> adiciona um filtro por tag

na lista de projetos

app/page.tsx

// lista de projetos, sem filtro

  1. Preparar
  2. Construir
  3. Revisar
  4. Fechar

Antes de codar

4 dicas
01

using-superpowers

Carrega sozinho no início da conversa. Faz o Claude checar se alguma skill se aplica antes de responder, até antes de perguntas.

Antes

> corrige o login

Vou mudar o if da linha 42...

Depois

> corrige o login

Usando systematic-debugging

para achar a causa antes.

02

brainstorming

Para toda feature nova, mesmo as "simples demais". Uma pergunta por vez, 2 ou 3 abordagens e uma spec aprovada por você.

Antes

> faz um modo escuro

Criando ThemeToggle.tsx...

Depois

> faz um modo escuro

Segue o sistema ou tem botão?

> botão

3 abordagens, recomendo a A.

03

using-git-worktrees

Isola a feature em pasta e branch próprias. Testa a base antes, para não herdar falha de outro trabalho.

Antes

main

M 14 arquivos misturados

(feature + ajuste + experimento)

Depois

main: limpa

.worktrees/modo-escuro

baseline: 12 testes ✓

04

writing-plans

Quebra a spec em tarefas de 2 a 5 minutos, com arquivos exatos, teste e commit. Nada de "TODO" ou "ajustar depois".

Antes

Plano:

1. fazer o tema

2. ajustar o resto

Depois

1. Tokens de cor em globals.css · 3 min

2. useTheme + localStorage · 3 min

3. Botão no header + teste · 3 min

Construir

5 dicas
05

subagent-driven-development

Executa o plano na mesma sessão: um subagente novo por tarefa e um revisor depois de cada uma. Erro não se acumula.

Antes

1 contexto longo fazendo tudo

tarefa 4 esquece a regra da tarefa 1

Depois

tarefa 1implementarevisa

tarefa 2implementarevisa

tarefa 3implementarevisa

06

executing-plans

Alternativa ao subagent-driven: roda o plano em outra sessão, em lotes, parando para você revisar entre eles.

Antes

Executando as 12 tarefas...

(você só vê o fim)

Depois

Lote 1: tarefas 1-3 ✓

Pausa para revisão.

> segue

Lote 2: tarefas 4-6...

07

test-driven-development

Teste primeiro, e ele tem que falhar. Depois o mínimo para passar, depois refatora. Código escrito antes do teste é apagado.

Antes

1. escreve o código

2. escreve teste que passa

o teste nunca provou nada

Depois

✗ vermelho: falha pelo motivo certo

✓ verde: código mínimo

✓ refatora com rede de segurança

08

dispatching-parallel-agents

Duas ou mais tarefas sem estado em comum? Um agente para cada, ao mesmo tempo. Se dependem uma da outra, não use.

Antes

uma falha por vez

Depois

as três ao mesmo tempo

09

systematic-debugging

Nenhuma correção sem causa raiz. Lê o erro, reproduz, compara com o que funciona e testa uma hipótese por vez.

Antes

Tentativa 1: adicionei um if

Tentativa 2: aumentei o timeout

Tentativa 3: try/catch em volta...

Depois

Reproduzido em 3 de 3 vezes.

Causa: estado lido antes do fetch.

Teste de regressão ✗ → correção ✓

Revisar e fechar

4 dicas
10

requesting-code-review

Pede revisão do diff contra a spec ao fim de cada tarefa e antes do merge. Achados vêm por gravidade.

Antes

> tá pronto, pode subir

(ninguém olhou o diff)

Depois

0 críticos1 importante2 menores

importante: contraste do texto no tema escuro

11

receiving-code-review

Confere cada sugestão no código antes de aplicar. Corrige o que procede, recusa com argumento o que não procede.

Antes

Ótimo ponto, você está certo!

Aplicando as 5 sugestões...

Depois

1. verificado, procede: corrigido

2. quebra o Safari 15: mantenho

3. YAGNI, ninguém usa: recuso

12

verification-before-completion

Proíbe "deve funcionar". Antes de dizer que terminou, roda o comando que prova e mostra a saída.

Antes

> terminou?

Sim! Deve estar tudo passando.

Depois

> terminou?

$ npm test → 15 passed

$ npm run build → ok

Sim, com a saída acima.

13

finishing-a-development-branch

Com testes verdes, oferece sempre 4 opções: merge local, PR, manter ou descartar. Descartar pede confirmação.

Antes

Pronto! Já fiz merge e

apaguei a branch.

Depois

1. Merge local

2. Push + PR

3. Manter branch

4. Descartar

Dicas de uso

4 dicas
14

writing-skills

Para criar suas próprias skills. Aplica TDD à documentação: primeiro vê o agente errar sem a skill, depois escreve só o que corrige.

Antes

Skill de 400 linhas escrita

de cabeça, nunca testada.

Depois

Sem skill: agente pula o teste ✗

Escreve a regra que faltava

Com skill: agente testa primeiro ✓

15

chame pelo nome

As skills disparam sozinhas, mas citar o nome garante. Útil quando o pedido parece simples demais para elas.

Antes

> conserta esse teste aí

Depois

> usa systematic-debugging

nesse teste que falha

16

"é simples demais"

É exatamente o pensamento que as skills combatem. Pedido simples é onde suposições não checadas mais desperdiçam trabalho.

Antes

Simples, vou direto ao código.

...

Refazendo pela 3ª vez.

Depois

Duas perguntas antes:

o botão fica no header?

e lembra a escolha?

17

suas regras vencem

CLAUDE.md e pedidos diretos têm prioridade sobre as skills. Se você disser "pula o TDD aqui", ele pula.

Antes

> sem testes, é um protótipo

Mas a skill exige TDD...

Depois

> sem testes, é um protótipo

Ok, sem testes neste protótipo.