Início Rápido do Superpowers: Instalação, Fluxo de Trabalho e Teste

Superpowers empacota uma metodologia completa orientada por especificações em Skills instaláveis do Claude, impondo brainstorming, planejamento, implementação conduzida por subagentes e TDD rigoroso, em vez de deixar essa estrutura a seu critério.

A maioria das configurações de SDD do Claude Code falha da mesma maneira: alguém escreve uma skill sólida de specify-plan-implement uma vez, usa-a diligentemente por uma semana e, em seguida, volta silenciosamente ao prompting não estruturado assim que um prazo se aproxima. Nada em uma skill artesanal realmente impede isso. Superpowers é uma resposta direta a esse problema de disciplina — um pacote de skills criado por Jesse Vincent e a equipe da Prime Radiant que trata o brainstorming, o planejamento, a revisão por subagentes e o TDD red-green-refactor como etapas obrigatórias que o agente verifica antes de cada tarefa, e não como sugestões opcionais que podem ser ignoradas sob pressão.

O que torna a ferramenta merecedora de uma análise dedicada, em vez de uma nota de rodapé, é o processo de instalação. Superpowers oferece manifests de plugin para Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot CLI, Grok Build CLI, Kimi Code, OpenCode, Pi, Devin CLI, Factory Droid e Hermes Agent, para que a mesma metodologia o acompanhe entre diferentes frameworks, em vez de ficar presa na pasta .claude/skills/ de um único repositório. Este guia cobre o que a ferramenta realmente é, como instalá-la e verificá-la no agente que você usa, como é uma primeira execução de ponta a ponta e onde ela se encaixa ao lado de outras ferramentas de desenvolvimento orientado por especificação.

O que é o Superpowers?

Superpowers se descreve como “uma metodologia completa de desenvolvimento de software para seus agentes de codificação, construída sobre um conjunto de skills composáveis e algumas instruções iniciais que garantem que seu agente as utilize.” Essa última cláusula é a parte que importa. Existem muitas coleções de skills; o diferencial aqui é a instrução de inicialização que força o agente a verificar skills relevantes antes de iniciar qualquer tarefa, para que o fluxo de trabalho seja ativado automaticamente, em vez de exigir que você se lembre de um comando de barra.

A filosofia por trás disso está declarada claramente nos próprios documentos do projeto:

• Desenvolvimento Orientado a Testes – escreva testes primeiro, sempre
• Sistêmico em vez de improvisado – processo em vez de chute
• Redução da complexidade – simplicidade como objetivo primário
• Evidência em vez de alegações – verifique antes de declarar sucesso

Na prática, essa filosofia se manifesta como uma sequência de skills que se entregam umas às outras. Se você leu Claude Skills e SKILL.md para Desenvolvedores, os mecanismos parecerão familiares – Superpowers é um conjunto grande e opinativo de exatamente esse tipo de diretório SKILL.md, distribuído como um plugin instalável em vez de algo que você cria você mesmo.

Instalando o Superpowers em Agentes de Codificação

A instalação é específica para cada framework (harness), e o projeto deixa explícito que você deve instalá-lo separadamente para cada agente que usa – não há uma instalação global única.

Claude Code

Superpowers é distribuído através de dois marketplaces para Claude Code:

# Marketplace oficial de plugins da Anthropic
/plugin install superpowers@claude-plugins-official

Ou através do marketplace dedicado Superpowers, que também carrega alguns plugins relacionados:

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Cursor

/add-plugin superpowers

Você também pode pesquisar “superpowers” diretamente na interface do marketplace de plugins do Cursor.

Outros agentes

Algumas informações sobre a instalação valem a pena destacar antes de você executar uma tarefa real:

• Antigravity executa automaticamente o hook de início de sessão do plugin, então o Superpowers fica ativo a partir da primeira mensagem; reinstale com o mesmo comando para atualizar.
• Pi carrega as skills através de uma pequena extensão que injeta o bootstrap using-superpowers na inicialização da sessão e após a compactação do contexto, e não requer a ferramenta de compatibilidade Skill do Pi, já que o Pi tem suporte nativo a skills.
• Hermes Agent não tem hook pós-compactação – uma sessão muito longa que compactar sobre sua primeira rodada pode perder o bootstrap, então inicie uma nova sessão se as skills pararem de disparar.
• OpenCode trata isso como um caminho de instalação completamente separado de qualquer outro framework que você já use, mesmo na mesma máquina.

Verificar a instalação

Uma vez instalado, pergunte diretamente ao agente, em vez de confiar em uma mensagem de sucesso silenciosa:

What skills are available?

Se o Superpowers foi instalado corretamente, o agente deve listar skills como brainstorming, writing-plans, test-driven-development e subagent-driven-development entre os resultados. Esta é a mesma verificação de descoberta recomendada para depurar Claude Skills que não disparam – se a skill existe, mas nunca é ativada, o problema quase sempre é a descrição de roteamento, e não o modelo.

O Fluxo de Trabalho do Superpowers: Do Brainstorming ao Código Entregue

Superpowers documenta sete skills como “o fluxo de trabalho básico”, cada uma ativando-se em um ponto específico e entregando a próxima:

⬇

1. brainstorming ativa-se antes de qualquer código ser escrito. Ele refina uma ideia vaga através de perguntas, explora alternativas e apresenta o design em blocos curtos e revisáveis, em vez de um documento longo – em seguida, salva o resultado como um artefato de design.
2. using-git-worktrees ativa-se assim que você aprova o design. Ele cria um espaço de trabalho isolado em um novo branch, executa a configuração do projeto e verifica uma linha de base de testes limpa antes que a implementação comece.
3. writing-plans divide o design aprovado em tarefas pequenas – Superpowers visa de dois a cinco minutos de trabalho por tarefa – com caminhos de arquivo exatos, código completo onde relevante e etapas de verificação explícitas.
4. subagent-driven-development (iteração rápida) ou executing-plans (execução em lote com checkpoints humanos) desperta um novo subagente por tarefa, com uma revisão em duas etapas: conformidade com a especificação primeiro, então qualidade do código.
5. test-driven-development impõe rigoroso red-green-refactor – escreva um teste falho, veja-o falhar, escreva o código mínimo para passar, veja-o passar, commite. Código escrito antes que um teste falho existisse para ele é excluído, não mantido.
6. requesting-code-review ativa-se entre tarefas, revisando o diff contra o plano e relatando problemas por severidade; problemas críticos bloqueiam o progresso para a próxima tarefa.
7. finishing-a-development-branch ativa-se assim que todas as tarefas são completadas. Ele verifica se os testes passam, então apresenta opções – mesclar, abrir um PR, manter o branch ou descartar – e limpa o worktree.

Isso mapeia de perto para o loop neutro de ferramenta de cinco fases em Fluxo de Trabalho de Desenvolvimento Orientado por Especificação: Da Exigência ao Código: specify se torna brainstorming, plan se torna writing-plans, tasks e implement se fundem em subagent-driven-development, e validate se divide entre TDD e revisão de código. A diferença é a aplicação – Superpowers é construído de modo que o agente verifica essas skills automaticamente, em vez de depender de você para invocar cada fase.

Tentando: Um Passo a Passo da Primeira Tarefa

Não aponte o Superpowers para seu recurso mais importante na primeira execução. Escolha algo real, mas limitado – um pequeno endpoint, uma correção de bug focada, um refatoramento de um único módulo – e inicie uma sessão em um projeto que já tenha uma suíte de testes, já que a aplicação do TDD é mais visível lá.

I want to add rate limiting to our public API endpoints.

Com o Superpowers instalado, espere que a sessão comece com perguntas de brainstorming em vez de código: quais endpoints, qual limite, por usuário ou por chave, o que deve acontecer quando o limite for atingido. Essa fricção é intencional – é a mesma disciplina de objetivos não coberta em Fluxo de Trabalho de Desenvolvimento Orientado por Especificação: Da Exigência ao Código, apenas aplicada pela skill em vez de deixada para você lembrar. Assim que você aprova o design em blocos, espere um plano com tarefas numeradas e pequenas antes de qualquer mudança de arquivo, em seguida um subagente despachado por tarefa com um diff que você revisa em cada checkpoint.

Duas coisas para observar na primeira execução:

• Confirme se o TDD é realmente aplicado. Peça ao agente para implementar uma tarefa e verifique se um teste falho aparece antes da implementação. Se o código chegar primeiro, a skill não disparou para aquela etapa, e vale a pena reexecutar a verificação de descoberta da seção de instalação.
• Observe a granularidade das tarefas. O dimensionamento de tarefas de dois a cinco minutos é agressivo para algumas bases de código. Se as tarefas parecerem desnecessariamente fragmentadas para seu projeto, isso vale a pena levantar durante o checkpoint de revisão do writing-plans, em vez de depois.

O Que Há Lá Dentro: A Biblioteca de Skills

Além das sete skills de fluxo de trabalho, Superpowers oferece skills de suporte agrupadas por área:

dispatching-parallel-agents vale a pena destacar separadamente: ele cobre fluxos de trabalho de subagentes concorrentes, que é o mesmo território de Subagentes do Claude Code – contexto isolado, revisão independente e um resumo reportado de volta à sessão principal, em vez de inundá-la com saída intermediária.

Quando o Superpowers se Encaixa (e Quando Não)

Bom encaixe:

• Você já gosta da abordagem de skills do Claude Code para Desenvolvimento Orientado por Especificação vs Vibe Coding mas continua deslizando de volta para o prompting não estruturado porque nada aplica as portas de revisão.
• Você trabalha com vários agentes de codificação e quer uma metodologia que viaje com você em vez de uma skill exclusiva do Claude Code.
• Você quer aplicação rigorosa de TDD sem escrever a lógica de aplicação você mesmo.
• Recursos de múltiplas sessões onde a deriva arquitetural e restrições esquecidas são um risco real – o exato modo de falha descrito em Desenvolvimento Orientado por Especificação vs Vibe Coding.

Encaixe mais fraco:

• Scripts rápidos, protótipos descartáveis e automação pontual – o overhead de brainstorming e planejamento é real, e não vale a pena pagar por uma mudança de cinquenta linhas.
• Equipes com uma skill de SDD específica de projeto, bem ajustada, existente. Superpowers troca essa customização por cerimônia aplicada e opinativa; você pode preferir manter o que já funciona e pegar apenas ideias de skills individuais.
• Ambientes onde a granularidade estrita de tarefas de dois a cinco minutos ou o TDD obrigatório conflitar com um processo de equipe estabelecido que você não está pronto para mudar.

Como o Superpowers Difere de Outras Ferramentas de SDD

Superpowers não é um concorrente do GitHub Spec Kit ou AWS Kiro no sentido usual – ele opera na camada de skills do Claude Code / entre agentes, em vez de ser um CLI ou IDE independente. Spec Kit te dá artefatos markdown portáveis e independência de agente; Kiro te dá uma experiência de IDE integrada e guiada; uma skill artesanal do Claude Code te dá flexibilidade máxima com zero aplicação. Superpowers fica entre os últimos dois: mesmo mecanismo baseado em skills como um fluxo de trabalho do Claude Code feito por você, mas com aplicação que se sente obrigatória e distribuição de plugin entre agentes que uma skill local no repositório não oferece.

Para a análise completa de portabilidade, fricção de configuração, portas de revisão e dependência (lock-in) entre Spec Kit, Kiro, skills do Claude Code, OpenSpec, BMAD-METHOD e Tessl – incluindo onde o Superpowers se encaixa na tabela de comparação e framework de decisão – veja GitHub Spec Kit vs Kiro vs Fluxos de Trabalho SDD do Claude Code. Se você quer menos cerimônia aplicada e mais liberdade para iterar em uma base de código brownfield, o Início Rápido do OpenSpec cobre a alternativa mais leve, centrada em mudanças.

Solução de Problemas e Pontos Importantes

As atualizações são principalmente automáticas, mas dependem do agente. Quão atual sua instalação permanece depende do framework – Antigravity reexecuta o hook de início de sessão na reinstalação, instalações baseadas em npm ou Git precisam de um comando de atualização explícito, e instalações baseadas em marketplace geralmente seguem o fluxo de atualização de plugins do próprio agente hospedeiro.

A telemetria está ativada por padrão, mas é fácil desativar. O companheiro visual opcional da skill de brainstorming carrega o logotipo da Prime Radiant do site deles, o que inclui sua versão do Superpowers, mas nenhum dado de projeto, prompt ou clique. Defina SUPERPOWERS_DISABLE_TELEMETRY para qualquer valor verdadeiro para desativar. Superpowers também honra os opt-outs próprios do Claude Code DISABLE_TELEMETRY e CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC.

Contribuições requerem o branch dev. Se você quiser modificar ou adicionar skills, faça um fork do repositório, mude para dev e siga a skill writing-skills para criar e testar mudanças – contribuições de novas skills especificamente geralmente não são aceitas, já que cada skill deve funcionar identicamente em todos os agentes suportados.

Se uma skill não dispara, trate-a como qualquer outro problema de Claude Skill. Pergunte “What skills are available?” para confirmar a descoberta, verifique se você instalou para o agente específico que está usando atualmente (não um diferente na mesma máquina) e lembre-se que sessões do Hermes precisam de um novo início após a compactação de longa duração se o bootstrap cair silenciosamente.

Conclusão

Superpowers vale a pena instalar quando o gap entre suas intenções de SDD e o que realmente acontece em uma sessão é o problema que você está tentando resolver. Ele não introduz uma nova ideia de specify-plan-implement – esse loop já está bem coberto por O que é Desenvolvimento Orientado por Especificação? – ele torna uma ideia existente mais difícil de pular, e faz isso em mais agentes do que uma skill local no repositório pode alcançar. Instale-o primeiro no framework que você usa diariamente, execute uma pequena tarefa limitada pelo ciclo completo de brainstorming ao término, e decida a partir daí se a cerimônia aplicada vale a pena na sua carga de trabalho real.

Links Úteis

• Repositório Superpowers – código-fonte, skills e manifests de plugin para cada agente suportado
• Marketplace Superpowers – marketplace do Claude Code para Superpowers e plugins relacionados
• GitHub Spec Kit vs Kiro vs Fluxos de Trabalho SDD do Claude Code – comparação completa de ferramentas e framework de decisão
• Claude Skills e SKILL.md para Desenvolvedores – os mecanismos subjacentes de skills sobre os quais o Superpowers é construído
• Subagentes do Claude Code: Configuração, Setup e Quando Usá-los – revisão de contexto isolado, o mecanismo por trás de subagent-driven-development
• Fluxo de Trabalho de Desenvolvimento Orientado por Especificação: Da Exigência ao Código – o processo neutro de ferramenta de cinco fases que o Superpowers automatiza
• O que é Desenvolvimento Orientado por Especificação? A Especificação como Fonte da Verdade – conceitos e terminologia centrais do SDD
• Instalação e configuração do Claude Code para Ollama, llama.cpp, preços – instale o próprio Claude Code antes de adicionar o Superpowers