SkillProgramaçãoSíntese
Escrever Planos de Implementação
Transforma uma spec em um plano de implementação completo, dividido em tarefas pequenas e verificáveis, com caminhos de arquivo exatos e código em cada passo. Use quando há requisitos para uma tarefa multi-etapas, antes de tocar no código.
Ações
PerfilDev
ProfundidadeAlta
IdiomaInglês (skill original)
Objetivo
Em uma frase.
Escrever planos de implementação abrangentes, assumindo que o engenheiro tem zero contexto sobre a base de código e gosto questionável. Documenta tudo o que ele precisa: quais arquivos tocar em cada tarefa, o código, os testes, a documentação que talvez precise consultar e como validar o resultado. Todo o plano é decomposto em tarefas pequenas, seguindo DRY, YAGNI, TDD e commits frequentes.
Aplicação
Quando
faz sentido.
Usar
- Já existe uma spec ou documento de requisitos (vindo de design-brainstorming) e a implementação precisa ser decomposta.
- A tarefa é multi-etapas, envolvendo múltiplos arquivos, testes e commits.
- Você quer um plano que possa ser executado por outra sessão ou por um subagente sem contexto prévio.
Não usar
- Mudança trivial (correção de typo, config de uma linha) — faça direto.
- A spec ainda não existe — rode design-brainstorming primeiro.
Prompt
Instruções
para a IA.
### Checagem de escopo e estrutura de arquivos
Se a spec cobre subsistemas independentes, sugira quebrá-la em planos separados — cada plano deve produzir software funcional e testável por si só. Antes de definir tarefas, mapeie quais arquivos serão criados ou modificados e a responsabilidade de cada um. Cada arquivo tem uma responsabilidade clara; arquivos que mudam juntos ficam juntos, separados por responsabilidade e não por camada técnica.
### Granularidade das tarefas
Cada passo é uma única ação de 2 a 5 minutos, no ciclo TDD: escrever o teste que falha, rodar para confirmar a falha, implementar o mínimo para passar, rodar de novo para confirmar e commitar. Cada tarefa lista os arquivos exatos (criar, modificar com linhas, testar) e traz código completo e comandos com saída esperada.
### Sem placeholders
Todo passo deve conter o conteúdo real. "TBD", "TODO", "adicione tratamento de erro apropriado" ou "similar à Tarefa N" são falhas de plano — repita o código, pois o engenheiro pode ler as tarefas fora de ordem.
### Autorrevisão e handoff
Ao terminar, verifique a cobertura da spec (cada requisito mapeia para uma tarefa?), procure placeholders e confira consistência de tipos e assinaturas entre tarefas. Salve o plano em
Se a spec cobre subsistemas independentes, sugira quebrá-la em planos separados — cada plano deve produzir software funcional e testável por si só. Antes de definir tarefas, mapeie quais arquivos serão criados ou modificados e a responsabilidade de cada um. Cada arquivo tem uma responsabilidade clara; arquivos que mudam juntos ficam juntos, separados por responsabilidade e não por camada técnica.
### Granularidade das tarefas
Cada passo é uma única ação de 2 a 5 minutos, no ciclo TDD: escrever o teste que falha, rodar para confirmar a falha, implementar o mínimo para passar, rodar de novo para confirmar e commitar. Cada tarefa lista os arquivos exatos (criar, modificar com linhas, testar) e traz código completo e comandos com saída esperada.
### Sem placeholders
Todo passo deve conter o conteúdo real. "TBD", "TODO", "adicione tratamento de erro apropriado" ou "similar à Tarefa N" são falhas de plano — repita o código, pois o engenheiro pode ler as tarefas fora de ordem.
### Autorrevisão e handoff
Ao terminar, verifique a cobertura da spec (cada requisito mapeia para uma tarefa?), procure placeholders e confira consistência de tipos e assinaturas entre tarefas. Salve o plano em
docs/superpowers/plans/AAAA-MM-DD-.md e ofereça as duas opções de execução: subagentes (recomendado, via subagent-driven-development) ou execução inline (via executing-plans).Constelação
Onde
ela vive.
Bundles que incluem
Execução
Como usar
com IA.
- 01Copie a skill (botão "Copiar skill para IA", no topo): o texto copiado já é a skill completa, não um resumo.
- 02Abra o Claude ou Claude Code e cole — a IA recebe todas as instruções e fica pronta para a tarefa.
- 03Prefere usar como arquivo reutilizável? Baixe o .zip e coloque o
SKILL.mdem.claude/skills/(Claude Code) ou anexe o arquivo no Claude (claude.ai).