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

modos de execução do Superpowers Claude Code: subagente por tarefa ou lote
Resposta rápida

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
Formação Recomendada

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:

  1. /superpowers:brainstorm pra lapidar a ideia
  2. /superpowers:write-plan pra transformar a ideia em plano
  3. /superpowers:execute-plan pra 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.




Subscribe
Notify of
guest

0 Comentários
Oldest
Newest Most Voted

Formações

Formação SAAS com IA

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