Introdução Rápida ao Superpowers: Instalação, Fluxo de Trabalho e Experimentação

Superpowers empacota uma metodologia completa baseada em especificações (spec-driven) em Skills do Claude instaláveis, impondo o brainstorming, o planejamento, a implementação dirigida por subagentes e o TDD estrito, em vez de deixar essa estrutura por sua conta.

A maioria das configurações de SDD (Spec-Driven Development) no 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, então, silenciosamente volta ao prompting sem estrutura assim que um prazo se aproxima. Nada em uma skill feita à mão 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 pode ignorar sob pressão.

O que o torna digno de uma análise dedicada, em vez de apenas uma nota de rodapé, é o processo de instalação. O Superpowers distribui manifests 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 acompanha entre diferentes ambientes (harnesses), em vez de permanecer na pasta .claude/skills/ de um único repositório. Este guia cobre o que ele realmente é, como instalá-lo e verificá-lo no agente que você utiliza, como é a primeira execução de ponta a ponta e onde ele se encaixa ao lado de outras ferramentas de desenvolvimento dirigido por especificações.

O que é o Superpowers?

O Superpowers se descreve como “uma metodologia completa de desenvolvimento de software para seus agentes de código, construída sobre um conjunto de skills 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 skills; o diferenciador aqui é a instrução de inicialização (bootstrap) que força o agente a verificar skills relevantes antes de iniciar qualquer tarefa, de modo 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 na própria documentação do projeto:

• Desenvolvimento Dirigido por Testes – escreva os testes primeiro, sempre
• Sistemático em vez de improvisado – processo em vez de achismo
• Redução de complexidade – simplicidade como objetivo principal
• Evidência em vez de afirmações – verifique antes de declarar sucesso

Na prática, essa filosofia se manifesta como uma sequência de skills que se passam o bastão umas às outras. Se você já leu Claude Skills e SKILL.md para Desenvolvedores, a mecânica será familiar – o 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 Código

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

Claude Code

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

# Marketplace oficial de plugins Anthropic
/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 o Superpowers está ativo desde a 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 de contexto, e não requer a ferramenta de compatibilidade Skill do Pi, pois o Pi tem suporte nativo a skills.
• Hermes Agent não tem hook pós-compactação – uma sessão muito longa que se compacta sobre o seu primeiro turno pode perder o bootstrap, então inicie uma sessão nova se as skills deixarem de ser acionadas.
• OpenCode trata isso como um caminho de instalação completamente separado de qualquer outro ambiente (harness) 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 falham ao acionar – se a skill existe, mas nunca é ativada, o problema quase sempre é a descrição de roteamento (routing description), e não o modelo.

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

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

⬇

1. brainstorming é ativado antes de qualquer código ser escrito. Ele refina uma ideia bruta através de perguntas, explora alternativas e apresenta o design em blocos curtos e revisáveis, em vez de um único documento longo – e então salva o resultado como um artefato de design.
2. using-git-worktrees é ativado quando 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 de a implementação começar.
3. writing-plans divide o design aprovado em tarefas de pequeno porte – o 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 pontos de verificação humanos) despacha um subagente novo por tarefa, com uma revisão em duas etapas: conformidade com a especificação primeiro, e então qualidade de código.
5. test-driven-development impõe o red-green-refactor estrito – escreva um teste que falha, veja-o falhar, escreva o código mínimo para que passe, veja-o passar, faça o commit. Código escrito antes de existir um teste que falhasse para ele é excluído, e não mantido.
6. requesting-code-review é ativado entre tarefas, revisando o diff contra o plano e reportando problemas por severidade; problemas críticos bloqueiam o progresso para a próxima tarefa.
7. finishing-a-development-branch é ativado quando todas as tarefas são concluídas. Ele verifica se os testes passam, e então apresenta opções – mesclar, abrir um PR, manter o branch ou descartar – e limpa o worktree.

Isso se alinha de perto com o loop neutro de ferramentas de cinco fases em Fluxo de Trabalho de Desenvolvimento Dirigido por Especificações: De Requisitos a Código: especificar torna-se brainstorming, planejar torna-se writing-plans, tarefas e implementação se integram ao subagent-driven-development, e validar é dividido entre TDD e revisão de código. A diferença é a imposição – o Superpowers é construído de modo que o agente verifica automaticamente por essas skills, em vez de depender de você para invocar cada fase.

Testando: Um Walkthrough da Primeira Tarefa

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

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

Com o Superpowers instalado, espere a sessão começar 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-alvo (non-goals) coberta em Fluxo de Trabalho de Desenvolvimento Dirigido por Especificações: De Requisitos a Código, apenas imposta pela skill, em vez de deixada para você lembrar. Uma vez que você aprove 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 para você revisar em cada ponto de verificação.

Duas coisas para observar em uma primeira execução:

• Confirme se o TDD está realmente sendo imposto. Peça ao agente para implementar uma tarefa e verifique se um teste que falha aparece antes da implementação. Se o código aparecer primeiro, a skill não foi acionada para essa 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 codebases. Se as tarefas parecerem desnecessariamente fragmentadas para o seu projeto, vale a pena levantar isso durante o ponto de verificação de revisão do writing-plans, em vez de depois dos fatos.

O Que Há Dentro: A Biblioteca de Skills

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

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

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

Bom ajuste:

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

Ajuste mais fraco:

• Scripts rápidos, protótipos descartáveis e automações de uso único – o overhead de brainstorming e planejamento é real, e não vale a pena pagá-lo por uma mudança de cinquenta linhas.
• Equipes com uma skill SDD específica do projeto já existente e bem ajustada. O Superpowers troca essa customização por um ritual imposto e opinativo; você pode preferir manter o que já funciona e emprestar apenas ideias de skills individuais.
• Ambientes onde a granularidade estrita de tarefas de dois a cinco minutos ou o TDD obrigatório entrariam em conflito com um processo de equipe estabelecido que você não está pronto para mudar.

Como o Superpowers Diferencia de Outras Ferramentas SDD

O Superpowers não é um competidor do GitHub Spec Kit ou AWS Kiro no sentido usual – ele opera na camada de skills do Claude Code / agentes cruzados, em vez de como uma CLI ou IDE independente. O Spec Kit te dá artefatos markdown portáveis e independência de agentes; o Kiro te dá uma experiência de IDE integrada e guiada; uma skill de Claude Code feita à mão te dá flexibilidade máxima com zero imposição. O Superpowers está entre os dois últimos: mesmo mecanismo baseado em skills que um fluxo de trabalho DIY de Claude Code, mas com uma imposição de sentir-se obrigatória e distribuição de plugins entre agentes que uma skill local de 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, skills do Claude Code, OpenSpec, BMAD-METHOD e Tessl – incluindo onde o Superpowers se encaixa na tabela de comparação e estrutura de decisão – veja GitHub Spec Kit vs Kiro vs Fluxos de Trabalho SDD do Claude Code. Se você quer menos ritual imposto e mais liberdade para iterar em um codebase brownfield, o quickstart do OpenSpec cobre a alternativa mais leve, centrada em mudanças. E se os papéis que faltam são aqueles que o Superpowers não desempenha – revisão de produto, QA no navegador, auditoria de segurança, engenharia de release – gstack os empacota como uma equipe de engenharia virtual que pode ser combinada com o Superpowers, com o Superpowers fornecendo a disciplina dentro da fase de implementação.

Solução de Problemas e Coisas a Saber

As atualizações são majoritariamente automáticas, mas dependem do agente. Quão atual sua instalação permanece depende do ambiente (harness) – o 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 tipicamente seguem o fluxo de atualização de plugins do próprio agente host.

A telemetria está ativada por padrão, mas é fácil desativá-la. O componente visual opcional da skill de brainstorming carrega o logotipo da Prime Radiant de seu site web, o que inclui sua versão do Superpowers, mas nenhum dado de projeto, prompt ou cliques. Defina SUPERPOWERS_DISABLE_TELEMETRY para qualquer valor verdadeiro para desativá-la. O Superpowers também respeita 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 o fork do repositório, mude para dev e siga a skill writing-skills para criar e testar alterações – contribuições de novas skills especificamente geralmente não são aceitas, pois cada skill deve funcionar identicamente em todos os agentes suportados.

Se uma skill não aciona, trate 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 um diferente 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 cair silenciosamente.

Conclusão

O Superpowers vale a pena instalar quando o abismo 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 Dirigido por Especificações? – ele torna uma ideia existente mais difícil de pular, e faz isso em mais agentes do que uma skill local de 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 brainstorming até o fim, e decida a partir daí se o ritual imposto vale a pena no seu workload real.

Links Úteis

• Repositório Superpowers – fonte, skills e manifests de plugins para todos os agentes suportados
• 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 estrutura de decisão
• Claude Skills e SKILL.md para Desenvolvedores – a mecânica subjacente de skills sobre a qual o Superpowers é construído
• Subagentes do Claude Code: Configuração, Setup e Quando Usá-los – revisão com contexto isolado, o mecanismo por trás do subagent-driven-development
• Fluxo de Trabalho de Desenvolvimento Dirigido por Especificações: De Requisitos a Código – o processo neutro de ferramentas de cinco fases que o Superpowers automatiza
• O Que é Desenvolvimento Dirigido por Especificações? A Especificação como Fonte de Verdade – conceitos e terminologia centrais de 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