Superpowers: fazer um agente de código seguir uma metodologia de desenvolvimento completa

Para quem

Veja Superpowers quando um agente de código precisa de uma metodologia completa de desenvolvimento de software. Definição oficial: Superpowers is a complete software development methodology for your coding agents, built on top of a set of composable skills and some initial instructions that make sure your agent uses them.

As competências disparam sozinhas; não se pede uma invocação especial. Serve quem já tem um agente de código e aceita «assinar o desenho primeiro e depois produzir um implementation plan». Se só quer um comando pontual e não aceita esse ritmo metodológico, não serve.

Página: https://github.com/obra/superpowers

Primeira tentativa em 3 minutos

A instalação muda com o harness. Na primeira tentativa use só este comando oficial:

/plugin install superpowers@claude-plugins-official

Pré-condições: este harness consegue executar o comando de plugin acima. Texto oficial: Installation differs by harness. If you use more than one, install Superpowers separately for each one. Nenhum diretório em disco está escrito; não invente um caminho.

Depois de instalar, não mude código de imediato. Peça primeiro ao agente para confirmar que as competências disparam sozinhas. Sinal de sucesso: o agente consegue reformular And because the skills trigger automatically, you don't need to do anything special.

Depois entregue um desenho já assinado (só leitura; não o deixe escrever) e peça só um implementation plan. Sinal de sucesso: o plano é claro o suficiente para um enthusiastic junior engineer with poor taste, no judgement, no project context, and an aversion to testing, e o repositório ainda não foi alterado. Se saltar o plano e mexer em ficheiros, pare.

Casos de uso

Caso 1: produzir um plano de implementação depois de assinar o desenho. O corpo diz: After you've signed off on the design, your agent puts together an implementation plan.... Entregue um desenho já acordado e peça só plano, sem implementação. Dá para confirmar que o plano é fino o suficiente para um júnior sem juízo, sem contexto de projeto e avesso a testes. A página não dá um nome de ficheiro de modelo; não invente.

Caso 2: depois de instalar, trabalhar por disparo automático. O corpo diz you don't need to do anything special. Your coding agent just has Superpowers. Serve, após a instalação, observar uma conversa de código normal para ver se a metodologia se aplica sozinha, sem gritar um nome de competência não escrito. Se só funcionar ao nomeá-lo à mão, a instalação neste harness ainda não pegou; vários harness instalam-se em separado.

Limites de uso

A mesma página também tem /add-plugin superpowers. É a formulação de outro harness, não o caminho principal da primeira tentativa; não estenda nenhum dos dois a todos os ambientes. Vários harness instalam-se em separado.

A metodologia assenta em composable skills e initial instructions. A página não enumera competências nem clientes; não acrescente nomes nem a reduza a um só agente.

Primeiro a assinatura do desenho, depois o plano de implementação. A página não autoriza começar sem assinatura.

Não há segredos, comando de desinstalação nem diretório local. Não complete passos de teste, estratégia de ramos ou ações de publicação não escritos.