plan

/fp:plan

Gera plano da Fase 2 - sempre pausa pedindo aprovação humana.

Argumentos

$ARGUMENTS - descrição da feature solicitada em texto livre. Exemplos:

• "adicionar endpoint de export CSV para /orders"
• "implementar autenticação por API key além do JWT existente"
• "adicionar rate limiting por IP no gateway"

Workflow

Passo 1 - Pre-flight

1. Verificar .first-plan/ existe e STATE.md indica fase >= discovered
2. Verificar se já há plano ativo (07-state/STATE.md em awaiting_approval ou executing):
   • Se sim, perguntar: "Plano está . Substituir? (sim/não)"
   • Não prosseguir sem confirmação
3. Verificar staleness: se muitos arquivos stale, recomendar /fp:refresh antes

Passo 2 - Verificação de duplicidade

Aplicar skill reconciliation:

1. Spawnar reconciliation-auditor com feature_query=<argumento>:

Task(
  subagent_type="reconciliation-auditor",
  description="Duplicate check for plan request",
  prompt="Audit feature: '<arg>'. Apply classification. Return status + evidence + recommendation."
)

1. Se status = IMPLEMENTED:

   • PARAR - perguntar ao usuário:

     Esta feature parece já implementada (<evidência>).
     
     Opções:
     A) Cancelar plano (a feature já existe)
     B) Modificar a feature existente em vez de criar nova
     C) Seguir com plano mesmo assim (pode estar errado a matriz)
     
     Qual? [A/B/C]
     

   • Não prosseguir sem decisão.

2. Se status = IN_PROGRESS:

   • Avisar: "Há trabalho em flight em /. Sugiro continuar nesse contexto em vez de plano novo."
   • Perguntar se quer prosseguir mesmo assim.

3. Se status = DRIFTED:

   • Perguntar: "A feature solicitada é justamente reconciliar o drift detectado em ?"

4. Se status = SPEC_ONLY ou NOT_STARTED ou nova: Prosseguir.

Passo 3 - Coleta de contexto relevante

Ler trechos relevantes da camada compilada:

• 01-topology/architecture.md - onde a feature se encaixa
• 01-topology/boundaries.md - se feature toca contratos
• 02-conventions/* - todas as convenções aplicáveis
• 03-reuse/INDEX.md - candidatos a reuse
• 04-domain/* - entidades e flows relevantes
• 05-risks/* - riscos em paths que provavelmente serão tocados
• 06-rationale/* - decisões a respeitar
• 07-state/in-flight.md - PRs/branches que podem conflitar
• 08-meta/questions.md - perguntas abertas relevantes