GUIA PRÁTICO CÓDIGO5 · 11 AGO 2026
Menos “faça tudo”.
Mais método verificável.
Superpowers funciona melhor quando você chama a skill específica da etapa — não apenas o guia geral. Este mapa transforma seu histórico real em um jeito mais previsível de trabalhar com o Codex.
CACHE LOCAL
Instalada5.1.3
→Atual6.2.0
Desatualizado e não exposto na lista ativa desta conversa.
IDEIAPLANOTESTEPROVA
LEITURA DO HISTÓRICO LOCAL
Você usou bastante. Mas quase sempre pelo guarda-chuva.
Foram analisadas sessões atuais e arquivadas do Codex. Os números são solicitações identificáveis e deduplicadas; continuações automáticas e conteúdo sensível foram excluídos da leitura pública.
Onde apareceu
ACHADO PRINCIPAL
using-superpowers é a porta de entrada, não o processo completo.
Ela obriga o agente a procurar skills relevantes. Porém, marcar só esse guia não demonstra que brainstorming, plano, TDD, revisão e verificação realmente aconteceram.
ANTES
“Use Superpowers e corrija tudo.”
MELHOR
“Use systematic-debugging. Confirme a causa antes de editar.”
FLUXO RECOMENDADO
Chame a skill que muda o comportamento.
Nem toda tarefa precisa das seis etapas. Escolha a entrada pelo estado real do trabalho.
01Ideia ainda aberta
brainstorming
O agente investiga objetivo, restrições e alternativas antes de propor código.
Ver prompt pronto
Use superpowers:brainstorming. Quero criar [IDEIA]. Primeiro entenda o problema, questione premissas e apresente opções com trade-offs. Não implemente ainda.
02Direção já aprovada
writing-plans
A solução vira tarefas pequenas, com arquivos, contratos, testes e gates explícitos.
Ver prompt pronto
Use superpowers:writing-plans. Transforme o desenho aprovado em plano executável, com etapas curtas, arquivos reais, testes, rollback e critérios de conclusão.
03Projeto já tem alterações locais
using-git-worktrees
O trabalho fica isolado sem atropelar a branch ou os arquivos em andamento.
Ver prompt pronto
Use superpowers:using-git-worktrees. Antes de editar, confirme o estado do Git e proponha um worktree isolado. Preserve todas as mudanças locais existentes.
04Comportamento pode ser testado
test-driven-development
O teste falha primeiro, a correção mínima passa e só então vem a refatoração.
Ver prompt pronto
Use superpowers:test-driven-development. Escreva primeiro o teste que reproduz [BUG/REGRA], prove a falha, implemente o mínimo e valide regressões.
05Erro sem causa confirmada
systematic-debugging
O agente separa sintoma de causa raiz e evita mudanças por tentativa e erro.
Ver prompt pronto
Use superpowers:systematic-debugging. Investigue [SINTOMA] em modo read-only primeiro. Reproduza, trace a causa raiz, compare hipóteses e só proponha correção após evidência.
06Parece pronto
verification-before-completion
A conclusão depende de evidência atual: testes, build, runtime e requisito por requisito.
Ver prompt pronto
Use superpowers:verification-before-completion. Audite cada requisito contra evidência atual. Não aceite apenas relatório, log antigo ou teste parcial como prova.
EFEITO NA PRÁTICA
O que muda na resposta do agente.
Exemplos baseados nos padrões do seu histórico, resumidos sem expor dados privados.
COMO VOCÊ USOU
Você chamou o guia geral para descobrir se o problema estava na internet local ou no portal.
systematic-debugging + verification-before-completion
EFEITO ESPERADO
Medição em camadas: máquina → DNS → rota → CDN → origem → aplicação. A correção só entra depois da causa confirmada.
COMO VOCÊ USOU
Você pediu planejamento, integração pela API e proibição de escrita direta no banco.
brainstorming → writing-plans → TDD
EFEITO ESPERADO
Contrato explícito, idempotência, fixtures, erros previstos e implantação sem desviar para atalhos inseguros.
COMO VOCÊ USOU
Você combinou plano, checklist, auditoria visual e validação antes de gerar o lote.
writing-plans → execução → requesting-code-review
EFEITO ESPERADO
Primeira evidência vira canário; o lote só continua se posição, período, mídia e legibilidade forem aprovados.
COMO VOCÊ USOU
Você exigiu documentação, testes e publicação sem perder o fluxo existente.
worktree → TDD → verification → finishing-branch
EFEITO ESPERADO
Alteração isolada, CI verde, rollback conhecido e decisão clara entre PR, merge ou manter a branch.
PROMPT CURINGA
Para uma feature de risco médio
Use Superpowers nesta ordem: 1. brainstorming para confirmar objetivo, restrições e alternativas; 2. writing-plans depois da minha aprovação do desenho; 3. using-git-worktrees para isolar as mudanças; 4. test-driven-development durante a implementação; 5. verification-before-completion antes de declarar pronto; 6. finishing-a-development-branch para apresentar PR/merge/rollback. Preserve o estado atual. Não invente arquivos, APIs ou testes.
VERSÃO E ATUALIZAÇÃO
A instalação está atrás do repositório.
CACHE INSTALADO5.1.3
Contém 14 skills, mas o plugin não apareceu na lista ativa desta conversa. O cache existe; a ativação atual não está comprovada.
REPOSITÓRIO / CATÁLOGO6.2.0
- Revisão de SDD mais barata e mais estrita.
- Worktrees dentro do projeto, não no diretório global antigo.
- Workspace por plano para evitar contaminação entre execuções.
- Melhorias de empacotamento e integração com Codex.
Como atualizar com segurança
Use a área Plugins do Codex e atualize/reinstale o Superpowers pelo catálogo. Não copie arquivos manualmente sobre a pasta de cache: ela é gerenciada pelo aplicativo e muda de identificador a cada versão.