Menu
Cria planos de implementacao detalhados com tarefas de 2-5 minutos
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Refina ideias atraves de perguntas antes de implementar
Revisao sistematica de codigo focada em qualidade, padroes e manutencao
Captura e armazena licoes tecnicas de bug fixes ou decisoes arquiteturais
Decomposição de tarefas complexas em Roadmaps e Sprints
Workflow sistemático para versionamento, atualização de documentação e tagueamento seguro de releases.
Processo de 4 fases para encontrar causa raiz de bugs
| name | writing-plans |
| description | Cria planos de implementacao detalhados com tarefas de 2-5 minutos |
| triggers | ["criar plano","planejar implementacao","quebrar em tarefas","implementation plan"] |
| globs | ["docs/plans/*-implementation.md"] |
| steps | 4 |
| checkpoints | ["prerequisites_verified","tasks_defined","plan_documented","plan_approved"] |
| artifact | docs/plans/YYYY-MM-DD-<topic>-implementation.md |
| previous_skill | brainstorming |
| next_skill | test-driven-development |
docs/plans/YYYY-MM-DD-<topic>-implementation.mdtest-driven-developmentApos aprovacao do design, antes de iniciar implementacao.
Quebrar o trabalho em tarefas que um "desenvolvedor junior entusiasmado, sem contexto e avesso a testes" consiga seguir sem errar.
Cada tarefa deve ter no maximo 2-5 minutos de trabalho focado. Se leva mais que isso, quebre em tarefas menores.
Checkpoint: prerequisites_verified
Antes de criar o plano, verificar:
validation_check "file_exists" "docs/plans/*-design.md"
validation_check "tests_pass"
Checkpoint: tasks_defined
Para cada funcionalidade do design:
### Task N: [Descricao Breve]
**Arquivos:**
- `path/to/file.ext`
**Teste (escrever PRIMEIRO):**
```language
// Codigo do teste que deve falhar inicialmente
Implementacao:
// Codigo minimo para fazer o teste passar
Verificacao:
npm test -- path/to/test.spec.js
Resultado Esperado: Teste passa
Commit:
type(scope): descricao breve
- Adicionado teste para [feature]
- Implementado [feature] minimo
### Regras para Tarefas
- **Atomica**: Uma tarefa = uma mudanca completa
- **Testavel**: Sempre comeca com teste
- **Pequena**: 2-5 minutos no maximo
- **Independente**: Pode ser feita isoladamente (quando possivel)
### Criterios de Validacao
- [ ] Todas as funcionalidades do design tem tarefas
- [ ] Cada tarefa tem teste definido
- [ ] Cada tarefa tem tempo estimado <= 5 min
- [ ] Ordem de execucao faz sentido
---
## Step 3: Documentar Plano
**Checkpoint**: `plan_documented`
### Acoes
Criar documento em: `docs/plans/YYYY-MM-DD-<topic>-implementation.md`
### Template do Plano
```markdown
# [Nome da Feature] - Plano de Implementacao
**Data**: YYYY-MM-DD
**Design**: [link para documento de design]
**Autor**: AI Dev Superpowers
**Status**: Aguardando aprovacao
## Prerequisitos
- [ ] Design aprovado: `docs/plans/YYYY-MM-DD-<topic>-design.md`
- [ ] Dependencias instaladas
- [ ] Baseline de testes limpa
- [ ] Branch criada: `feature/<nome>`
## Tarefas
### Task 1: [Descricao]
[Detalhes conforme formato acima]
### Task 2: [Descricao]
[Detalhes conforme formato acima]
### Task 3: [Descricao]
[Detalhes conforme formato acima]
[... continuar para todas as tarefas]
## Criterios de Sucesso
- [ ] Todos os testes passando
- [ ] Cobertura >= 80%
- [ ] Code review aprovado
- [ ] Documentacao atualizada
## Estimativa Total
| Metrica | Valor |
|---------|-------|
| Total de tarefas | N |
| Tempo estimado | N x 5 min = X min |
| Complexidade | baixa/media/alta |
## Riscos Identificados
| Risco | Mitigacao |
|-------|-----------|
| ... | ... |
## Notas
[Observacoes adicionais]
Checkpoint: plan_approved
Cada tarefa DEVE comecar com teste. Sem excecoes.
Nao inclua tarefas para features "que podem ser uteis depois".
Se perceber duplicacao entre tarefas, refatore o plano.
Uma tarefa = um commit completo e funcional.
skill_add_artifact "writing-plans" "docs/plans/YYYY-MM-DD-<topic>-implementation.md" "plan"
skill_complete "writing-plans"
agent_handoff "architect" "backend" "Executar plano de implementacao" "<path>"
# Iniciar: test-driven-development
skill_fail "writing-plans" "Motivo da falha"
# Voltar para brainstorming se design inadequado
skill_init "writing-plans"
skill_set_steps "writing-plans" 4
# Step 1: Verificar prerequisitos
skill_advance "writing-plans" "Verificar prerequisitos"
validation_check "file_exists" "docs/plans/*-design.md"
validation_check "tests_pass"
skill_validate_checkpoint "writing-plans"
# Step 2: Definir tarefas
skill_advance "writing-plans" "Definir tarefas"
# ... criar lista de tarefas ...
skill_validate_checkpoint "writing-plans"
# Step 3: Documentar plano
skill_advance "writing-plans" "Documentar plano"
# ... criar documento ...
skill_validate_checkpoint "writing-plans"
# Step 4: Aprovar plano
skill_advance "writing-plans" "Aprovar plano"
# ... apresentar e obter aprovacao ...
skill_add_artifact "writing-plans" "docs/plans/2024-01-15-login-implementation.md" "plan"
skill_validate_checkpoint "writing-plans"
skill_complete "writing-plans"
agent_handoff "architect" "backend" "Implementar conforme plano" "docs/plans/2024-01-15-login-implementation.md"