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 Claude Code
Domine Claude Code do absoluto zero até o avançado
- 114 aulas
- 4 projetos
- 9h 18min
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 Vibe Coding
Do Prompt ao Produto: Crie Software Real com IA
- 474 aulas
- 20 projetos
- 39h 27min
Blog | Mais populares
Superpowers wiki: o que a documentação explica sobre cada skill do framework?
A Superpowers wiki explica cada skill do framework: onde mora a documentação, o fluxo brainstorming, plano e os portões de aprovação humana.
Como o Superpowers revisa o código entre as tarefas e impede o agente de empilhar erro em cima de erro?
A revisão de código Superpowers roda entre as tarefas, não só no fim do plano: um subagente revisor evita que o Claude Code empilhe erro em cima de erro.
O que significa “ChatGPT network error” e como resolver
O “ChatGPT Network Error” é uma ocorrência frequente na rotina de muitos usuários do ChatGPT. Porém, poucos compreendem seu significado, quando esse erro surge, etc. […]
