Subagente por tarefa ou execução em lotes: qual modo do Superpowers combina com o seu projeto?

Superpowers Claude Code tem dois modos de executar o mesmo plano, e a escolha muda o seu dia inteiro. O subagent-driven-development despacha um subagente novo por tarefa, com contexto isolado, revisão em dois estágios (conformidade com a spec antes da qualidade de código) e uma revisão final ampla do branch. Já o executing-plans roda na sessão atual, tarefa a tarefa, com checkpoints humanos, e atende plataforma sem suporte a subagentes. Tem subagente disponível? O SDD é o modo recomendado. Quer enxergar cada passo antes de seguir? Fica no executing-plans
Fala aí, beleza? Você instalou o Superpowers, rodou o brainstorm, o plano tá escrito e bonito na sua frente… e aí chega a bifurcação de verdade: entregar esse plano pra subagentes trabalharem sozinhos ou executar tarefa a tarefa, olhando cada passo antes de liberar o próximo?
O Superpowers é um framework de skills agênticas e metodologia de desenvolvimento criado e mantido por Jesse Vincent, o obra no GitHub
E ele não te dá um caminho só: duas skills disputam exatamente o mesmo momento do fluxo, a hora de executar o plano
De um lado o subagent-driven-development, de outro o executing-plans
Bora comparar os dois e ver qual combina com o seu projeto? 🙂
Formação Vibe Coding
Do Prompt ao Produto: Crie Software Real com IA
- 474 aulas
- 20 projetos
- 39h 27min
O que é o Superpowers e onde os dois modos se encaixam
O Superpowers vive no repositório obra/superpowers e foi aceito no marketplace oficial de plugins do Claude Code da Anthropic em 15 de janeiro de 2026
A versão mais recente é a v6.3.0, lançada em 12 de agosto de 2026, e ela é a maior desde a v6.0: mexeu em suporte a harness, no roteador de brainstorming, na coordenação do SDD e na disciplina de escrita de testes
O fluxo dele tem três etapas, cada uma com comando de barra em namespace próprio:
/superpowers:brainstormpra lapidar a ideia/superpowers:write-planpra transformar a ideia em plano/superpowers:execute-planpra colocar o plano pra rodar
E é no passo 3 que a escolha aparece
Os dois modos são skills próprias dentro do repositório: skills/subagent-driven-development/SKILL.md e skills/executing-plans/SKILL.md
Ou seja, não é configuração escondida em arquivo de settings, é o método de execução que você escolhe na hora de executar
Instalando o Superpowers no Claude Code:
O caminho mais curto é o marketplace oficial, um comando só dentro de uma sessão do Claude Code:
/plugin install superpowers@claude-plugins-official
Também dá pra instalar pelo marketplace da comunidade, mantido pelo próprio autor
Aí são dois passos: registrar o marketplace e depois instalar o plugin
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
Tome cuidado com a ordem no segundo caminho: sem registrar o marketplace antes, o nome superpowers@superpowers-marketplace simplesmente não existe pro Claude Code resolver
Subagentes autônomos x sessão linear com checkpoints: comparativo direto
Aqui é onde a conversa fica objetiva
Os dois modos executam o MESMO plano, mas mudam onde o trabalho roda, o que o executor enxerga e quem confere o resultado
| Critério | subagent-driven-development | executing-plans |
|---|---|---|
| Onde o trabalho roda | um subagente implementador novo pra cada tarefa | na sessão atual, de forma linear, tarefa a tarefa |
| Como o contexto é montado | isolado e sob medida: cada subagente recebe só o que aquela tarefa precisa, sem herdar o histórico da sessão principal | o histórico acumulado da própria sessão segue junto |
| Revisão | dois estágios em ordem obrigatória: conformidade com a spec primeiro, qualidade de código só depois que o estágio 1 passa | checkpoints humanos ao longo da execução |
| Revisão final | revisão de escopo amplo sobre todo o branch no fim da execução | fica a cargo dos checkpoints que você fizer |
| Cadência de revisão | a cada tarefa ou em checkpoints naturais, somada a uma diretiva explícita de execução contínua (vale pros dois) | a cada tarefa ou em checkpoints naturais, somada a uma diretiva explícita de execução contínua (vale pros dois) |
| Requisito de plataforma | precisa de suporte a subagentes | roda mesmo onde não existe suporte a subagentes |
| Posição no projeto | é o método de execução preferido quando há subagentes disponíveis | é o caminho pra sessão linear única |
Repara num detalhe que muda tudo: a ordem da revisão no modo por subagente não é decoração
Primeiro se pergunta "isso faz o que a spec mandou?"
Só se a resposta for sim é que alguém vai discutir se o código tá bonito
Faz sentido, né? Não adianta polir a implementação de uma coisa que não era pra ter sido feita daquele jeito 😀
Quando cada modo é a escolha certa
Plano longo com muitas tarefas independentes: vai de subagente por tarefa
Se o seu plano tem um monte de tarefa que não depende uma da outra, o contexto isolado é o grande prêmio
Cada subagente entra limpo, recebe só o brief da tarefa dele e não carrega o entulho das dez tarefas anteriores
A revisão de dois estágios funciona como rede embaixo disso: conformidade com a spec, depois qualidade de código, e no fim uma revisão ampla do branch inteiro
É o cenário clássico de quem quer soltar o trabalho e voltar pra conferir o conjunto
Se a ideia de subagente ainda é meio nebulosa pra você, o blog já tem um post explicando quando usar subagentes no Claude Code e como eles se comportam dentro de um projeto
Plataforma sem subagentes ou vontade de ver cada etapa: executing-plans
O executing-plans é indicado justamente pra plataformas que não têm suporte a subagentes
E também pra quem prefere ficar numa sessão linear única, executando com checkpoints de revisão
Aqui você acompanha a coisa acontecendo, tarefa após tarefa, e o ponto de parada é humano
Se o seu incômodo com agente é "não sei o que ele fez enquanto eu não olhava", esse modo resolve o incômodo na raiz
Trabalho arriscado em repositório vivo: liga o worktree
Independente do modo, tem uma peça que vale ouro em repositório que já tá em produção
O Superpowers integra worktrees do git ao fluxo: existe uma skill de worktree que isola o trabalho em um branch novo, deixando o branch principal intocado
O agente trabalha lá, no cantinho dele, e o seu main continua exatamente onde estava
Já me ferrei o suficiente com experimento rodando direto no branch principal pra achar isso bem massa
O que mudou no modo por subagente e por que isso importa na escolha
O modo por subagente gera bastante material de trabalho: briefs de tarefa, relatórios do implementador, diffs de revisão e o ledger de progresso
Esses arquivos moravam dentro de .git/
Na v6.2.0 eles mudaram de endereço: passaram a viver no diretório .superpowers/sdd/, no próprio working tree, que se auto-ignora no git
Ou seja, dá pra abrir e ler o que cada subagente produziu sem garimpar dentro do .git/, e isso não polui o seu diff
Depois veio outra mudança importante: o workspace passou a ser escopado por plano
Cada plano ganha um subdiretório próprio em .superpowers/sdd/<plan-basename>/, o ledger nomeia o plano a que pertence, e o workspace é removido quando a revisão final passa limpa
Por que escopar por plano? Porque tinha bug de verdade:
Sem identidade de plano, uma segunda execução no mesmo repositório lia o progress.md da execução anterior
Resultado: ele pulava tarefas do plano novo, em silêncio
Esse é o tipo de falha que dói justamente em quem escolheu o modo por subagente pra não ficar olhando cada passo
Cuidado com tutorial desatualizado:
Os comandos de barra legados, sem namespace, foram REMOVIDOS na versão 5.1.0
/brainstorm, /write-plan e /execute-plan não existem mais
Então se você achar um tutorial ensinando esses atalhos, ele é anterior à v5.1.0 e provavelmente tá defasado em mais coisa também
Usa a versão com namespace: /superpowers:brainstorm, /superpowers:write-plan e /superpowers:execute-plan
Veredito: qual modo combina com o seu projeto
A régua é curta
Onde há suporte a subagentes, o subagent-driven-development é o método de execução preferido, porque evita poluição de contexto e habilita os loops de revisão especializados
Mas o executing-plans não é o irmão pobre da história
Ele é o caminho pra plataforma sem subagentes e pra quem quer manter o olho em cada tarefa, com checkpoint humano no meio
É escolha de estilo de acompanhamento, não de qualidade
O que dá pra afirmar é o desenho de cada modo e o que cada um exige da sua plataforma, e isso já resolve a escolha na maioria dos casos
Veja também: skills que leem o código por você
Pra entrar no universo das skills agênticas partindo do zero, este vídeo do canal mostra uma skill que lê o seu código e desenha a arquitetura do projeto
Boa porta de entrada pra sentir como esse tipo de automação trabalha na prática
Conclusão
A régua cabe numa frase: tem subagente disponível e você quer soltar o plano? Vai de subagent-driven-development, com a revisão de dois estágios e a revisão final do branch fazendo a conferência
Plataforma sem subagentes ou vontade de aprovar cada etapa? executing-plans, sessão linear e checkpoints humanos
O próximo passo é bem direto: instala pelo marketplace oficial com /plugin install superpowers@claude-plugins-official, roda /superpowers:brainstorm, /superpowers:write-plan e /superpowers:execute-plan, e escolhe o modo de execução conforme a sua plataforma e o tanto que você quer acompanhar
Depois me conta qual dos dois virou o seu padrão, tô curioso 😀
até o próximo post!
Perguntas frequentes
Qual a diferença entre subagent-driven-development e executing-plans no Superpowers?
O subagent-driven-development despacha um subagente implementador novo pra cada tarefa, com contexto isolado e sob medida, além de revisão em dois estágios e uma revisão final de todo o branch. Já o executing-plans roda na sessão atual, tarefa a tarefa, com checkpoints humanos, e serve pra plataformas sem suporte a subagentes ou pra quem prefere sessão linear única.
Como instalar o Superpowers no Claude Code pelo marketplace oficial?
Dentro de uma sessão do Claude Code basta rodar /plugin install superpowers@claude-plugins-official, um único comando. O Superpowers foi aceito no marketplace oficial de plugins da Anthropic em 15 de janeiro de 2026, então esse caminho já vem pronto pra usar.
Os comandos /brainstorm, /write-plan e /execute-plan ainda funcionam no Superpowers?
Não, esses atalhos legados sem namespace foram removidos na versão 5.1.0. O caminho atual é usar /superpowers:brainstorm, /superpowers:write-plan e /superpowers:execute-plan, e qualquer tutorial que ainda ensine os comandos antigos tá desatualizado.
Por que o subagent-driven-development revisa a conformidade com a spec antes da qualidade do código?
Porque a revisão do modo por subagente tem dois estágios em ordem obrigatória: primeiro conformidade com a especificação, e só se ela passar é que começa a revisão de qualidade de código. Faz sentido, né? Não adianta discutir se o código tá bonito antes de confirmar que ele faz o que a spec pedia.
Onde ficam os arquivos de trabalho do modo por subagente no Superpowers?
Briefs de tarefa, relatórios do implementador, diffs de revisão e o ledger de progresso vivem no diretório .superpowers/sdd/ do working tree, que se auto-ignora no git. O workspace ainda é escopado por plano, em subdiretórios como .superpowers/sdd/<plan-basename>/, justamente porque um ledger sem identidade de plano já fez uma segunda execução herdar o progresso da anterior e pular tarefas em silêncio.
O que muda ao usar worktree do git junto com o Superpowers?
O Superpowers tem uma skill própria de git worktree que isola o trabalho em um branch novo, deixando o branch principal intocado. Isso vale pros dois modos de execução, e é uma camada extra de segurança pra quem já se ferrou rodando experimento direto no branch principal.
Formações
Formação SAAS com IA
Tire usas ideias do papel criando softwares com IA, integre pagamentos e lance seu projeto!
- 291 aulas
- 18 projetos
- 24h 17min
Blog | Mais populares
As diferenças de var, let e const
Como fazer redirecionamento com PHP
Neste artigo você vai aprender a como fazer redirecionamento com PHP, utilizaremos abordagens fáceis de entender e de aplicar Fala programador(a), beleza? Bora aprender mais […]
Checklist de segurança n8n VPS pública: guia essencial para proteger sua instalação
Checklist de segurança n8n VPS pública: guia essencial para proteger sua instalação A popularidade da automação de processos com o n8n está em alta, principalmente […]
