Planos de Implementação

Visão Geral

Escreva planos de implementação abrangentes assumindo que o engenheiro não tem nenhum contexto sobre nossa base de código e um gosto questionável. Documente tudo o que eles precisam saber: quais arquivos tocar para cada tarefa, código, testes, documentação que eles podem precisar verificar, como testar. Dê a eles o plano inteiro em tarefas pequenas. DRY. YAGNI. TDD. Commits frequentes.

Assuma que eles são um desenvolvedor habilidoso, mas sabem quase nada sobre nosso conjunto de ferramentas ou domínio do problema. Assuma que eles não conhecem muito bem um bom design de testes.

Anuncie no início: "Estou usando a habilidade writing-plans para criar o plano de implementação."

Contexto: Isso deve ser executado em uma árvore de trabalho dedicada (criada pela habilidade brainstorming).

Salve os planos em: docs/plans/YYYY-MM-DD-<feature-name>.md

Granularidade de Tarefas Pequenas

Cada etapa é uma ação (2-5 minutos):

• "Escreva o teste que falha" - etapa
• "Execute-o para garantir que ele falha" - etapa
• "Implemente o código mínimo para fazer o teste passar" - etapa
• "Execute os testes e certifique-se de que eles passam" - etapa
• "Commit" - etapa

Cabeçalho do Documento do Plano

Todo plano DEVE começar com este cabeçalho:

# [Feature Name] Implementation Plan

> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.

**Goal:** [One sentence describing what this builds]

**Architecture:** [2-3 sentences about approach]

**Tech Stack:** [Key technologies/libraries]

---

Estrutura da Tarefa

### Task N: [Component Name]

**Files:**
- Create: `exact/path/to/file.py`
- Modify: `exact/path/to/existing.py:123-145`
- Test: `tests/exact/path/to/test.py`

**Step 1: Write the failing test**

```python
def test_specific_behavior():
    result = function(input)
    assert result == expected

Step 2: Run test to verify it fails

Run: pytest tests/path/test.py::test_name -v Expected: FAIL with "function not defined"

Step 3: Write minimal implementation

def function(input):
    return expected

Step 4: Run test to verify it passes

Run: pytest tests/path/test.py::test_name -v Expected: PASS

Step 5: Commit

git add tests/path/test.py src/path/file.py
git commit -m "feat: add specific feature"

## Lembre-se
- Caminhos de arquivo exatos sempre
- Código completo no plano (não "adicione validação")
- Comandos exatos com saída esperada
- Referencie habilidades relevantes com a sintaxe @
- DRY, YAGNI, TDD, commits frequentes

## Entrega da Execução

Após salvar o plano, ofereça a escolha de execução:

**"Plano completo e salvo em `docs/plans/<filename>.md`. Duas opções de execução:**

**1. Guiado por Subagente (esta sessão)** - Eu despacho um novo subagente para cada tarefa, reviso entre as tarefas, iteração rápida

**2. Sessão Paralela (separada)** - Abra uma nova sessão com executing-plans, execução em lote com pontos de verificação

**Qual abordagem?"**

**Se Guiado por Subagente for escolhido:**
- **SUB-HABILIDADE REQUERIDA:** Use superpowers:subagent-driven-development
- Permaneça nesta sessão
- Novo subagente para cada tarefa + revisão de código

**Se Sessão Paralela for escolhida:**
- Guie-os a abrir uma nova sessão na árvore de trabalho
- **SUB-HABILIDADE REQUERIDA:** Nova sessão usa superpowers:executing-plans

## Quando Usar
Esta habilidade é aplicável para executar o fluxo de trabalho ou ações descritas na visão geral.

## 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 de especialistas.
- Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem faltando.