start-project

Start Project — Planejamento completo de projeto

Este skill analisa o escopo inteiro do projeto e propoe TODOS os milestones de uma vez, com estimativa de slices por milestone, dependencias entre milestones e ordem de execucao.

Pré-requisito

Nenhum — este e o primeiro comando em um projeto novo.

Processo

Etapa 1: Entender a Visão

Conduza uma conversa para entender o projeto. Pergunte:

1. O que é o projeto? (descrição em 1-2 frases)
2. Para quem? (público-alvo)
3. Quais as funcionalidades principais? (lista de features core)
4. Qual o stack desejado? (ou peça para o humano deixar você sugerir)
5. Há restrições? (prazo, budget, integrações obrigatórias)
6. O que NÃO é escopo? (o que explicitamente não será feito)

Registre tudo em .spec/PROJECT.md e .spec/REQUIREMENTS.md.

Etapa 2: Pesquisa (se codebase existente)

Se o projeto já tem código:

• Delegue ao subagent scout para mapear o que já existe
• Identifique o que pode ser reaproveitado vs o que precisa ser criado

Se é greenfield (sem código):

• Delegue ao subagent researcher para pesquisar o stack proposto
• Identifique libs, frameworks e padrões recomendados

Etapa 3: Propor Milestones

Com base na visão e pesquisa, proponha uma sequência de milestones.

Regras de decomposição de milestones:

• Cada milestone entrega uma versão usável do produto
• M001 deve ser o menor produto viável que pode ser demonstrado
• Milestones seguintes adicionam capacidades incrementalmente
• Cada milestone tem 4-10 slices estimados
• Ordene por valor entregue + risco (prove o mais arriscado cedo)
• Identifique dependências entre milestones

Padrão típico de milestones:

M001: Fundação + Feature Core (o minimo que funciona end-to-end)
M002: Features Secundárias (expande o que M001 fez)
M003: Polish + UX (melhorar o que existe)
M004: Escala + Operações (preparar para produção real)

Etapa 4: Apresentar Proposta

Apresente ao humano no formato:

📋 PROPOSTA DE PROJETO — [Nome]

🎯 Visão: [1 frase]
🛠 Stack: [tecnologias]

📦 MILESTONES PROPOSTOS:

  M001: [Título] — [estimativa de slices] slices
    Objetivo: [o que estará funcionando quando completo]
    Slices estimados:
      S01: [titulo breve]
      S02: [titulo breve]
      S03: [titulo breve]
    Risco: baixo/médio/alto
    Depende de: nenhum

  M002: [Título] — [estimativa] slices
    Objetivo: [o que adiciona sobre M001]
    Slices estimados:
      S01: [titulo breve]
      S02: [titulo breve]
    Risco: médio
    Depende de: M001

  M003: [Título] — [estimativa] slices
    ...

Total: X milestones, ~Y slices, ~Z tasks estimadas

Concorda? Quer ajustar a ordem, escopo ou quantidade?

AGUARDE aprovação antes de criar qualquer arquivo.

O humano pode:

• Aprovar como está
• Remover milestones ("M003 não precisa por agora")
• Adicionar milestones ("falta um de integrações")
• Reordenar ("M002 é mais prioritário que M001")
• Ajustar escopo de um milestone ("M001 deve incluir OAuth também")

Etapa 5: Criar Estrutura

Após aprovação:

1. Criar PROJECT.md e REQUIREMENTS.md (já parcialmente preenchidos)

2. Criar DECISIONS.md com decisões tomadas na conversa

3. Para o M001 (primeiro milestone), criar estrutura completa:

   • .spec/milestones/M001/CONTEXT.md com objetivo
   • .spec/milestones/M001/RESEARCH.md com findings da pesquisa
   • Iniciar a fase de pesquisa detalhada (como /start-milestone)

4. Para M002, M003, etc., criar apenas a estrutura mínima:

   • .spec/milestones/M0xx/CONTEXT.md com objetivo e scope
   • NÃO criar ROADMAP.md nem PLANs (esses vêm quando o milestone ativar)

5. Criar QUEUE.md com todos os milestones enfileirados:

# Fila de Milestones

## Em execução
- **M001:** [Título] — pesquisa em andamento

## Na fila
- **M002:** [Título] — aguardando M001
  Objetivo: [breve]
  Depende de: M001
  Prioridade: alta

- **M003:** [Título] — aguardando M002
  Objetivo: [breve]
  Depende de: M002
  Prioridade: média

6. Atualizar STATE.md com M001 como ativo

Etapa 6: Continuar para Pesquisa do M001

Após criar a estrutura, inicie automaticamente a pesquisa do M001:

• Rode scout + researcher
• Preencha RESEARCH.md
• Atualize STATE.md

Informe: "Projeto estruturado com X milestones. M001 está com pesquisa completa. Use /discuss para planejar o primeiro milestone."

Regras

• SEMPRE apresente a proposta de milestones ao humano antes de criar
• M001 DEVE ser o menor produto viável demonstrável
• Milestones futuros (M002+) recebem apenas CONTEXT.md — detalhes quando ativados
• Se o humano descreve algo que cabe em 1 milestone, crie apenas 1
• Se o projeto é enorme (10+ milestones estimados), agrupe e simplifique para 4-6
• Nunca comece a executar sem aprovação da proposta