Superpowers Quickstart: Instalação, Fluxo de Trabalho e Teste

Superpowers empacota uma metodologia completa orientada por especificação em Claude Skills instaláveis, aplicando brainstorming, planejamento, implementação dirigida por subagentes e TDD rigoroso, em vez de deixar essa estrutura por conta de você.

A maioria das configurações de SDD (Spec-Driven Development) no Claude Code falha da mesma forma: alguém escreve uma habilidade sólida de specify-plan-implement uma vez, usa-a diligentemente por uma semana e, então, volta discretamente para o prompting não estruturado assim que um prazo se aproxima. Nada em uma habilidade feita à mão realmente impede isso. Superpowers é uma resposta direta a esse problema de disciplina – um pacote de habilidades criado por Jesse Vincent e a equipe da Prime Radiant que trata brainstorming, planejamento, revisão por subagentes e TDD red-green-refactor como etapas obrigatórias que o agente verifica antes de cada tarefa, e não como sugestões opcionais que ele pode pular sob pressão.

O que torna isso digno de uma análise dedicada, em vez de uma nota de rodapé, é o processo de instalação. Superpowers fornece manifestos de plugins para Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot CLI, Grok Build CLI, Kimi Code, OpenCode, Pi, Devin CLI, Factory Droid e Hermes Agent, de modo que a mesma metodologia o acompanhe entre diferentes ambientes (harnesses), em vez de ficar presa na pasta .claude/skills/ de um único repositório. Este guia cobre o que ele realmente é, como instalar e verificar no agente que você usa, como é uma primeira execução de ponta a ponta e onde ele se encaixa ao lado de outras ferramentas de desenvolvimento orientado por especificação.

O que é Superpowers?

Superpowers se descreve como “uma metodologia completa de desenvolvimento de software para seus agentes de codificação, construída sobre um conjunto de habilidades componíveis e algumas instruções iniciais que garantem que seu agente as utilize”. Essa última cláusula é a parte que importa. Existem muitos colecionamentos de habilidades; o diferencial aqui é a instrução de inicialização (bootstrap) que força o agente a verificar habilidades 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 é declarada claramente nos próprios documentos do projeto:

• Test-Driven Development (TDD) – escreva testes primeiro, sempre
• Sistemático em vez de ad-hoc – processo em vez de suposições
• Redução de complexidade – simplicidade como objetivo principal
• Evidências em vez de alegações – verifique antes de declarar sucesso

Na prática, essa filosofia aparece como uma sequência de habilidades que se entregam umas às outras. Se você leu Claude Skills and SKILL.md for Developers, a mecânica parecerá familiar – Superpowers é um conjunto grande e opinativo exatamente desse tipo de diretório SKILL.md, distribuído como um plugin instalável em vez de algo que você mesmo cria.

Instalando Superpowers em Agentes de Codificação

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

Claude Code

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

# Official Anthropic plugin marketplace
/plugin install superpowers@claude-plugins-official

Ou através do marketplace dedicado do 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

Alguns detalhes de instalação valem a pena destacar antes de você executar uma tarefa real:

• Antigravity executa o hook de início de sessão do plugin automaticamente, então Superpowers está ativo desde a primeira mensagem; reinstale com o mesmo comando para atualizar.
• Pi carrega as habilidades 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 de contexto, e não requer a ferramenta Skill de compatibilidade do Pi, já que o Pi tem suporte nativo a habilidades.
• Hermes Agent não tem hook pós-compactação – uma sessão muito longa que compacta sobre sua primeira rodada pode perder o bootstrap, então inicie uma nova sessão se as habilidades deixarem de ser acionadas.
• OpenCode trata isso como um caminho de instalação completamente separado de qualquer outro ambiente que você já usa, 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 Superpowers foi instalado corretamente, o agente deve listar habilidades como brainstorming, writing-plans, test-driven-development e subagent-driven-development entre os resultados. Esta é a mesma verificação de descoberta recomendada para debugging Claude Skills that fail to trigger – se a habilidade existe, mas nunca é ativada, a descrição de roteamento quase sempre é o problema, não o modelo.

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

Superpowers documenta sete habilidades como “o fluxo de trabalho básico”, cada uma ativando-se em um ponto específico e passando para 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 único documento longo – e depois 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) despacha um novo subagente por tarefa, com uma revisão de duas etapas: conformidade com a especificação primeiro, depois qualidade do código.
5. test-driven-development impõe um red-green-refactor rigoroso – escreva um teste falho, veja-o falhar, escreva o código mínimo para passar, veja-o passar, commit. Código escrito antes que existisse um teste falho 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 concluídas. 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 estreitamente para o loop de cinco fases neutro de ferramentas em Spec-Driven Development Workflow From Requirements to Code: especificar torna-se brainstorming, planejar torna-se writing-plans, tarefas e implementação se integram no subagent-driven-development, e validar é dividido entre TDD e revisão de código. A diferença é a aplicação – Superpowers é construído para que o agente verifique essas habilidades automaticamente, em vez de depender de você para invocar cada fase.

Experimentando: Um Passo a Passo da Primeira Tarefa

Não aponte Superpowers para seu recurso mais importante na primeira execução. Escolha algo real, porém 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 ali.

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

Com 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 não-objetivos coberta em Spec-Driven Development Workflow From Requirements to Code, apenas aplicada pela habilidade em vez de deixada para você se lembrar. Assim que você aprova o design em blocos, espere um plano com tarefas pequenas e numeradas antes de qualquer alteração de arquivo, e então um subagente despachado por tarefa com um diff que você revisa em cada checkpoint.

Duas coisas a observar na primeira execução:

• Confirme se o TDD está realmente sendo aplicado. Peça ao agente para implementar uma tarefa e verifique se um teste falho aparece antes da implementação. Se o código for colocado primeiro, a habilidade não foi acionada 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 alguns bases de código. Se as tarefas parecerem fragmentadas desnecessariamente para seu projeto, vale a pena levantar isso durante o checkpoint de revisão do writing-plans, em vez de depois.

O que Há Dentro: A Biblioteca de Habilidades

Além das sete habilidades do fluxo de trabalho, Superpowers fornece habilidades de suporte agrupadas por área:

dispatching-parallel-agents merece destaque separado: ele cobre fluxos de trabalho de subagentes concorrentes, que é o mesmo território de Claude Code subagents – contexto isolado, revisão independente e um resumo reportado de volta para a 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 habilidades do Claude Code para Spec-Driven Development 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 múltiplos agentes de codificação e quer uma única metodologia que viaje com você, em vez de uma habilidade exclusiva do Claude Code.
• Você quer aplicação rigorosa de TDD sem escrever a lógica de aplicação você mesmo.
• Recursos multi-sessão onde a derivação arquitetural e restrições esquecidas são um risco real – o exato modo de falha descrito em Spec-Driven Development vs Vibe Coding.

Encaixe mais fraco:

• Scripts rápidos, protótipos descartáveis e automação pontual – a sobrecarga de brainstorming e planejamento é real, e não vale a pena pagá-la por uma alteração de cinquenta linhas.
• Equipes com uma habilidade SDD específica de projeto já existente e bem ajustada. Superpowers troca essa personalização por uma cerimônia aplicada e opinativa; você pode preferir manter o que já funciona e emprestar apenas ideias de habilidades individuais.
• Ambientes onde a granularidade estrita de tarefas de dois a cinco minutos ou o TDD obrigatório conflitariam 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 habilidades do Claude Code / entre agentes, em vez de ser um CLI ou IDE autônomo. Spec Kit lhe dá artefatos markdown portáveis e independência de agentes; Kiro lhe dá uma experiência de IDE guiada e integrada; uma habilidade feita à mão no Claude Code lhe dá flexibilidade máxima com zero aplicação. Superpowers fica entre os dois últimos: mesmo mecanismo baseado em habilidades que um fluxo de trabalho DIY do Claude Code, mas com aplicação de sensação obrigatória e distribuição de plugins entre agentes que uma habilidade local no repositório não fornece.

Para a análise completa de portabilidade, fricção de configuração, portas de revisão e lock-in entre Spec Kit, Kiro, habilidades do Claude Code, OpenSpec, BMAD-METHOD e Tessl – incluindo onde Superpowers se encaixa na tabela de comparação e no quadro de decisão – veja GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows.

Solução de Problemas e Coisas a Saber

As atualizações são em sua maioria automáticas, mas dependem do agente. Quão atual sua instalação permanece depende do ambiente (harness) – 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 desativá-la. O companheiro visual opcional da habilidade de brainstorming carrega o logotipo da Prime Radiant do site deles, que inclui sua versão do Superpowers, mas nenhum dado de projeto, prompt ou clique. Defina SUPERPOWERS_DISABLE_TELEMETRY para qualquer valor verdadeiro para desativá-lo. Superpowers também respeita os opt-outs DISABLE_TELEMETRY e CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC do próprio Claude Code.

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

Se uma habilidade não for acionada, 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 (e não para outro na mesma máquina) e lembre-se de que sessões do Hermes precisam de um novo início após a compactação de sessões longas se o bootstrap for perdido silenciosamente.

Conclusão

Superpowers vale a pena instalar quando a lacuna 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á é bem coberto por What Is Spec-Driven Development? – ele torna uma ideia existente mais difícil de pular, e faz isso em mais agentes do que uma habilidade local no repositório pode alcançar. Instale-o primeiro no ambiente (harness) que você usa diariamente, execute uma pequena tarefa limitada através do ciclo completo de brainstorm para finalização e decida a partir daí se a cerimônia aplicada vale a pena na sua carga de trabalho real.

Links Úteis

• Superpowers repository – fonte, habilidades e manifestos de plugins para cada agente suportado
• Superpowers marketplace – marketplace do Claude Code para Superpowers e plugins relacionados
• GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows – comparação completa de ferramentas e quadro de decisão
• Claude Skills and SKILL.md for Developers – a mecânica subjacente de habilidades sobre a qual Superpowers se constrói
• Claude Code Subagents: Setup, Config, and When to Use Them – revisão de contexto isolado, o mecanismo por trás do subagent-driven-development
• Spec-Driven Development Workflow From Requirements to Code – o processo neutro de ferramentas de cinco fases que Superpowers automatiza
• What Is Spec-Driven Development? The Spec as Source of Truth – conceitos e terminologia centrais de SDD
• Claude Code install and config for Ollama, llama.cpp, pricing – instale o próprio Claude Code antes de adicionar Superpowers