Escrita de Planos

Fonte: obra/superpowers

Visão Geral

Esta habilidade fornece uma estrutura para dividir o trabalho em tarefas claras e acionáveis com critérios de verificação.

Princípios de Divisão de Tarefas

1. Tarefas Pequenas e Focadas

• Cada tarefa deve levar de 2 a 5 minutos
• Um resultado claro por tarefa
• Verificável de forma independente

2. Verificação Clara

• Como você sabe que está pronto?
• O que você pode verificar/testar?
• Qual é o resultado esperado?

3. Ordenação Lógica

• Dependências identificadas
• Trabalho paralelo sempre que possível
• Caminho crítico destacado
• Fase X: A verificação é sempre a ÚLTIMA

4. Nomeação Dinâmica na Raiz do Projeto

• Arquivos de plano são salvos como {task-slug}.md na RAÍZ DO PROJETO
• Nome derivado da tarefa (ex: "adicionar auth" → auth-feature.md)
• NUNCA dentro de pastas .claude/, docs/ ou temporárias

Princípios de Planejamento (NÃO Modelos!)

🔴 SEM modelos fixos. Cada plano é ÚNICO para a tarefa.

Princípio 1: Mantenha-o CURTO

Regra: Se o plano for maior que 1 página, está muito longo. Simplifique.

Princípio 2: Seja ESPECÍFICO, Não Genérico

Regra: Cada tarefa deve ter um resultado claro e verificável.

Princípio 3: Conteúdo Dinâmico Baseado no Tipo de Projeto

Para NOVO PROJETO:

• Qual stack de tecnologia? (decidir primeiro)
• Qual é o MVP? (funcionalidades mínimas)
• Qual é a estrutura de arquivos?

Para ADIÇÃO DE FUNCIONALIDADE:

• Quais arquivos são afetados?
• Quais dependências são necessárias?
• Como verificar se funciona?

Para CORREÇÃO DE BUG:

• Qual é a causa raiz?
• Qual arquivo/linha mudar?
• Como testar a correção?

Princípio 4: Scripts São Específicos do Projeto

🔴 NÃO copie e cole comandos de script. Escolha com base no tipo de projeto.

Errado: Adicionar todos os scripts a cada plano Certo: Apenas scripts relevantes para ESTA tarefa

Princípio 5: A Verificação é Simples

Estrutura do Plano (Flexível, Não Fixa!)

# [Task Name]

## Goal
One sentence: What are we building/fixing?

## Tasks
- [ ] Task 1: [Specific action] → Verify: [How to check]
- [ ] Task 2: [Specific action] → Verify: [How to check]
- [ ] Task 3: [Specific action] → Verify: [How to check]

## Done When
- [ ] [Main success criteria]

É isso. Sem fases, sem subseções, a menos que realmente necessário. Mantenha o mínimo. Adicione complexidade apenas quando exigido.

Notas

[Quaisquer considerações importantes]

---

## Melhores Práticas (Referência Rápida)

1. **Comece com o objetivo** - O que estamos construindo/corrigindo?
2. **Máximo de 10 tarefas** - Se mais, divida em vários planos
3. **Cada tarefa verificável** - Critérios claros de "pronto"
4. **Específico do projeto** - Sem modelos de copiar e colar
5. **Atualize conforme avança** - Marque `[x]` quando concluído

---

## Quando Usar
- Novo projeto do zero
- Adicionando uma funcionalidade
- Corrigindo um bug (se complexo)
- Refatorando vários arquivos

## Limitações
- Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
- Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão especializada.
- Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem faltando.