Pular para o conteudo
Voltar aos artigos
superpowersclaude-codespec-driven-developmentai-coding

Descomplicando o Superpowers: o framework de AI coding workflow mais popular do GitHub

Superpowers, Spec Kit ou GSD? Entenda o que é um framework de workflow AI Coding, compare os 3 e aprenda a usar Superpowers num app web real.

14 min de leitura

Descomplicando o Superpowers: o framework de AI coding workflow mais popular do GitHub

Por que esses frameworks de workflow AI Coding viraram o "novo normal" de quem usa Claude Code a sério, e como começar a usar Superpowers em um app web real.

Contexto

Trabalhar com um coding agent sem método é como contratar um engenheiro talentoso e aceitar que ele vá direto pro git push sem revisar nada. Funciona em demos. Quebra em produção.

A virada que vem acontecendo desde o segundo semestre de 2025 é o surgimento de frameworks de workflow: uma camada de disciplina que se instala em cima do Claude Code (e similares) e força o agente a brainstormar antes de codar, escrever spec antes de plano, plano antes de código, e revisar antes de marcar pronto.

Em abril de 2026, três projetos lideram essa categoria: Superpowers (171 mil stars), Spec Kit (91 mil) e GSD (58 mil). Os três incorporam alguma forma de "spec-driven development" como prática central (Spec Kit é o mais explícito; Superpowers e GSD a usam como uma camada do workflow), mas resolvem o problema geral com vocabulário e mecânica diferentes. Este artigo compara os três e mostra como rodar o Superpowers, o mais popular, em um projeto web real.

O que é um framework de workflow para AI coding

Um framework de workflow para AI coding (na literatura em inglês também chamado de "methodology for coding agents") é, no fundo, um conjunto de instruções e gates que você acopla ao seu agente (Claude Code, Cursor, Codex, OpenCode etc.) pra fazer ele seguir um processo de engenharia em vez de improvisar.

A diferença entre isso e um prompt comum é estrutural:

  • Prompt único: você escreve "implemente feature X". O agente decide tudo: escopo, design, código, testes, ordem.
  • Framework de workflow: o agente é forçado a parar antes de escrever a primeira linha de código. Faz perguntas. Apresenta opções. Pede aprovação por seção. Só depois disso entra em modo de implementação. E mesmo aí, segue ritmo de TDD, commits frequentes, e revisão entre tasks.

Jesse Vincent, criador do Superpowers, descreve a categoria como "a complete software development workflow for your coding agents, built on top of a set of composable 'skills'". Skills aqui são arquivos markdown que vivem na sua instalação do agente, descrevem como executar uma capacidade específica (brainstormar, escrever plano, fazer TDD, revisar código), e se ativam automaticamente quando o agente reconhece a intenção do usuário.

A categoria nasceu como reação a três problemas concretos do AI coding sem método:

  1. Vibe coding não escala. Pedir "faz aí" funciona em scripts. Em features médias, o agente perde rumo.
  2. Replan constante consome contexto. Sem spec antes do plano, o agente refaz design no meio da implementação e enche o context window com lixo.
  3. Falta de gates produz "agentic slop". Sem brainstorming forçado e revisão obrigatória, sai PR cheio de complexidade que ninguém pediu.

O vocabulário do ecossistema (e quem usa o quê)

Cada projeto popularizou conceitos próprios. Conhecer o vocabulário ajuda a entender qual ferramenta cobre qual problema.

Conceito Origem O que significa
Open source toolkit / product scenarios Spec Kit (GitHub) Conjunto de comandos CLI para escrever specs de "cenários de produto" (o "que" e o "porquê") antes de pensar em stack
Meta-prompting GSD Roteamento entre agentes especializados (orchestrator, researcher, planner, executor, verifier) em vez de um prompt monolítico
Context engineering GSD Construir e manter artefatos (PROJECT.md, STATE.md, PLAN.md etc.) que o agente carrega seletivamente, evitando "context rot" (degradação de qualidade conforme o context window enche)
Spec-driven development (SDD) Spec Kit + GSD + Superpowers O spec escrito é fonte da verdade; código é gerado/regenerado a partir dele
Agentic skills framework Superpowers Skills como unidade composável: instruções markdown que se auto-ativam por intenção e se compõem em workflows
Subagent-driven development Superpowers Despachar subagent fresco por tarefa, com revisão de spec compliance e qualidade entre cada uma

Repare na sobreposição: todos os três fazem alguma forma de spec-driven development, mas só o GSD usa "context engineering" como termo central, e só o Superpowers fala em "subagent-driven development" como técnica de execução.

Os três frameworks em comparação direta

Superpowers Spec Kit GSD
Stars (Apr 2026) 171.494 91.530 58.471
Maintainer Jesse Vincent (obra) GitHub oficial TÂCHES
Lançado em 2025-10-09 2025-08-21 2025-12-14
Tagline "agentic skills framework & software development methodology that works" "open source toolkit that allows you to focus on product scenarios... instead of vibe coding" "meta-prompting, context engineering and spec-driven development system"
Abordagem Skills auto-ativadas + subagents com two-stage review Comandos CLI explícitos (/speckit.specify, /speckit.plan, /speckit.tasks, /speckit.implement) Workflow em 6 fases por milestone com comandos /gsd-*
Plataformas Claude Code, Cursor, Codex, OpenCode, Gemini CLI, Copilot CLI 30+ agentes (Claude, Gemini, Cursor, Qwen, Tabnine, Kiro, Goose etc.) 14+ (Claude, OpenCode, Gemini, Codex, Copilot, Cursor, Windsurf, Cline etc.)
Marketplace oficial Sim, no Anthropic Claude plugins desde 2026-01-15 Não (CLI próprio) Não (npx)
Diferencial Modular: dá pra usar uma skill só (ex: só brainstorming) sem amarrar o workflow inteiro. Skills auto-ativam por intenção, sem comandos específicos. Two-stage subagent review (spec + qualidade) é mecanismo próprio. Comandos numerados explícitos (/speckit.*) acionados em sequência. "Constitution" (princípios governantes do projeto) e ecossistema oficial de extensões são conceitos próprios do Spec Kit. Trabalho organizado em milestones (não features). Auto-pilot: /gsd-next decide a próxima fase. Plans nascem em XML estruturado com gates <verify> e <done> embutidos no spec.

Quando escolher cada um:

  • Superpowers se você valoriza modularidade e zero ritual: dá pra instalar e usar uma skill só (ex: só brainstorming) sem amarrar o workflow inteiro, e as skills disparam quando o agente reconhece a intenção, não quando você digita um comando específico.
  • Spec Kit se você prefere comandos explícitos numerados acionados em sequência (/speckit.specify → /speckit.plan → /speckit.tasks → /speckit.implement). Tem o conceito próprio de "constitution" (princípios governantes do projeto) como artefato de primeira classe e ecossistema oficial de extensões da comunidade.
  • GSD se você organiza trabalho em milestones grandes com modo auto-pilot: o comando /gsd-next decide a próxima fase automaticamente, e plans nascem em XML estruturado com gates <verify> e <done> embutidos no spec (formato mais rígido que o markdown dos outros dois).

Como o Superpowers funciona

Tecnicamente, o Superpowers é um plugin que instala 14 skills no seu agente. As principais:

  • brainstorming: refina ideias por perguntas antes de qualquer código.
  • writing-plans: gera plano de implementação com tasks de 2-5 minutos cada, paths exatos, código completo, comandos com expected output.
  • subagent-driven-development: despacha um subagent por task, revisa em duas etapas (spec compliance + qualidade) e itera.
  • executing-plans: alternativa para plataformas sem subagentes.
  • test-driven-development: força ciclo red-green-refactor em cada task.
  • using-git-worktrees: isola cada feature em worktree próprio.
  • finishing-a-development-branch: fecha a branch via PR ou merge.
  • systematic-debugging: quando aparece bug, força investigação de root cause antes de fix.

Skills não rodam "uma de cada vez" como comandos isolados. Elas se compõem: começar uma feature dispara o brainstorming, que após aprovação chama o writing-plans, que após o plano oferece subagent-driven-development como execução. Você aprova nos pontos de gate, mas o fluxo entre skills é automático.

O ciclo na prática

  1. Você diz "vamos construir feature X".
  2. Brainstorming ativa. Faz perguntas (uma de cada vez, multiple choice quando possível), apresenta 2-3 abordagens com trade-offs, e propõe um design em seções. Cada seção precisa do seu aprovação antes de seguir.
  3. Design aprovado vira spec em docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md (caminho default, configurável).
  4. Writing-plans gera o plano em docs/superpowers/plans/YYYY-MM-DD-<feature>.md. Cada task tem paths exatos, código completo, comandos com expected output, sem placeholders.
  5. Você escolhe execução: subagent-driven (recomendado, fresh subagent por task) ou inline (executing-plans).
  6. Subagent-driven-development despacha o primeiro subagent implementador. Ele faz TDD: escreve teste falho, roda, implementa o mínimo, faz passar, commita.
  7. Spec reviewer subagent valida que o que foi feito bate com o spec. Code quality reviewer subagent valida qualidade.
  8. Se algum dos dois reprova, o implementador ajusta e revisa de novo.
  9. Repetido por todas as tasks. No fim, code reviewer final passa o olho na implementação inteira.
  10. Finishing-a-development-branch abre o PR (ou merge) com o trabalho completo.

A lógica de fundo: cada subagent começa com contexto limpo, recebe só o texto do task que precisa fazer mais o contexto curado pelo controlador (o agente principal). Isso evita context pollution e mantém qualidade estável ao longo de horas de trabalho autônomo.

Repercussão na comunidade

A reação mistura entusiasmo prático e ceticismo informado.

Pontos de elogio mais citados:

  • Evan Schwartz, em rave review pessoal: "Using Claude Code with Superpowers is so much more productive and the features it builds are so much more correct than with stock Claude Code."
  • Anthropic absorveu o Superpowers no marketplace oficial em 2026-01-15, validando institucionalmente.
  • Benchmarks de terceiros relatam redução de tokens e maior previsibilidade de custo em features médias e complexas, com ganho desprezível em tasks curtas.

Críticas e ressalvas (Hacker News e outros fóruns):

  • Tarefas pequenas sofrem com overhead. Se você só quer renomear uma variável, brainstormar é trabalho desnecessário.
  • "O modelo é o mesmo Claude": Superpowers organiza, mas não corrige limitações fundamentais do modelo subjacente.
  • Plan mode do Claude Code (não do Superpowers em si) tem UX truncada: feedback no plano força reescrever do zero em vez de editar pontos.
  • Alguns argumentam que separar spec e plan é cerimônia desnecessária quando o spec já é claro.

Conclusão da repercussão: o consenso emergente é que Superpowers vale ouro em features médias e complexas (o tipo que naturalmente exigiria várias rodadas de retrabalho sem método) e é overhead em tasks curtas. O ganho relativo é maior em quem improvisa muito; quem já segue um processo manual disciplinado tende a ver ganho menor.

Na Prática

Passo a passo para começar a usar Superpowers num projeto Next.js (ou qualquer app web) com Claude Code.

Pré-requisitos: Claude Code instalado, repositório git inicializado, branch de trabalho diferente de main.

1. Instale o Superpowers via marketplace oficial

Dentro do Claude Code, rode:

/plugin install superpowers@claude-plugins-official

Reinicie a sessão pra garantir que as skills sejam carregadas.

2. Verifique a instalação

Comece uma sessão nova e diga algo que dispare uma skill:

Vamos planejar a feature de comentários por post no app Next.js.

Se Superpowers estiver ativo, o agente não vai direto pro código. Vai responder com algo como "I'm using the brainstorming skill to refine this idea" e começar a fazer perguntas. Se em vez disso ele já gerar componente React, a instalação não pegou. Confira com /plugin list.

3. Deixe o brainstorming guiar

Responda as perguntas com sinceridade. O agente está pesquisando o seu projeto e perguntando sobre escopo, integração com auth existente, modelo de dados e UX. Quando ele apresentar 2-3 abordagens com trade-offs, escolha (não improvise uma quarta opção sem necessidade, isso quebra o fluxo).

Quando ele disser "presenting design in sections", leia cada seção e responda "ok" ou peça ajuste. Cada aprovação trava aquele pedaço.

4. Aceite o spec gerado

Ao fim do brainstorming, o agente salva um arquivo tipo docs/superpowers/specs/2026-04-28-comentarios-por-post-design.md no seu repo. Abra, revise, e aceite ou peça ajustes inline.

5. Aprove o plano

O agente chama writing-plans automaticamente. O resultado vem em docs/superpowers/plans/2026-04-28-comentarios-por-post.md, com tasks numeradas. Cada task tem paths exatos, código de teste, código de implementação, comando pra rodar o teste e expected output.

Faça uma leitura crítica. Se algum task tem placeholder ou referência vaga, peça correção. Superpowers proíbe placeholders em planos exatamente porque cada task vai pra um subagent que não tem mais contexto que o texto da task.

6. Escolha execução por subagentes

Quando o agente perguntar "subagent-driven (recomendado) ou inline?", escolha subagent-driven. Cada task vira um subagent fresco com TDD obrigatório.

A partir daí, é assistir. O agente despacha o subagent implementador, recebe a saída, despacha o spec reviewer, depois o code quality reviewer. Se algum reviewer reprova, o implementador ajusta. No fim de cada task, marca o checkbox no plano.

7. Final review e PR

Depois de todas as tasks fechadas, um final code reviewer subagent passa o olho na implementação completa. Se aprovar, o agente chama finishing-a-development-branch e propõe abrir PR.

Você revisa o PR como faria com qualquer trabalho humano. Aprovado, merge.

Dica: Não tente acelerar pulando o brainstorming em features médias. O ganho não vem da velocidade da primeira iteração; vem da redução de retrabalho. O brainstorming custa 10-20 minutos. Ele economiza horas de "isso não era o que eu queria".

Quando escolher Superpowers (e quando não)

Use Superpowers quando:

  • A feature tem 3+ horas de trabalho ou toca múltiplos arquivos.
  • Você está trabalhando em código de produção com testes existentes.
  • Histórico recente do agente foi cheio de retrabalho ou refactor desnecessário.
  • Você quer paralelizar features e perder menos tempo coordenando contexto.

Não use Superpowers quando:

  • Tarefa cabe em um único commit pequeno (renomear, adicionar log, fix de uma linha).
  • Você está prototipando algo descartável onde "vibe coding" é literalmente o objetivo.
  • Modelo subjacente é fraco (modelos pequenos podem se confundir com a complexidade do framework).

Resultado final

O que você leva deste artigo:

  • A categoria é o framework de workflow para AI coding e existe pra resolver os três sintomas do AI coding sem disciplina: vibe coding sem rumo, replan constante, e PRs cheios de slop.
  • Os três principais em abril de 2026 são Superpowers (171K stars), Spec Kit (91K) e GSD (58K). Cada um popularizou termos próprios; não confundir as taglines.
  • Superpowers é o mais popular porque integra skills auto-ativadas, TDD obrigatório, subagent-driven execution e two-stage review num único plugin que se instala via marketplace oficial Anthropic.
  • Na prática, instalar é um comando. O ganho aparece na primeira feature média que você roda com brainstorming + spec + plan + subagent. Não no toy example de 30 linhas.
  • O método não substitui código bom. Substitui o caos de não ter método.

Pra ir além

Escolher o framework de workflow é metade do caminho. A outra metade é dominar o Claude Code: configuração de ambiente, ferramentas auxiliares, padrões de prompt e os hábitos que separam quem vibe-coda de quem entrega app pronto.

O Curso Claude Code: Criador de Apps ensina exatamente isso, do zero ao app no ar: setup completo do ambiente, Claude Code turbinado com as melhores ferramentas validadas, frontend, backend, autenticação, deploy em produção e workflow profissional. Acesso vitalício, Claude Code Guide incluso como bônus e garantia incondicional de 7 dias.

Referências