# Princípios do fluxo (Spec-Driven)

- A spec é o contrato; a rastreabilidade é o produto. Cada etapa transforma um artefato no próximo.
- Pré-flight: Project Discovery configura o projeto; Risk Classification calibra rigor, gates, Agent Teams e evidências.
- Fluxo: Project Discovery → Risk Classification → Ideia → PRD → Tech Spec → Tasks → Refinement (opcional) → Execução → ADR → Review → Memória. **Não pule etapas e não misture responsabilidades.** A única etapa dispensável é o Refinement — pule-a apenas em features triviais e se o risco permitir.
- Em cada etapa, gere APENAS a saída esperada daquela etapa e preserve o contexto para a próxima.
- Autonomia com freios: pare nos checkpoints (após PRD, após Tech Spec, após Refinement quando houver risco, antes do merge/deploy) e peça aprovação humana explícita antes de avançar.
- Artifact store local: toda orquestração deve ter um diretório `docs/<slug-da-orquestracao>/`; quando integrações externas não estiverem completas, este diretório é a fonte canônica dos artefatos aprovados.
- Para cada etapa, delegue ao subagent especializado correspondente (`project-discovery`, `risk-classifier`, `idea`, `prd`, `techspec`, `tasks`, `refinement`, `execution`, `adr`, `review`, `memory`).
- Use Agent Teams somente quando paralelismo real compensar o overhead: TechSpec complexa, decomposição cross-layer, execução de tasks independentes ou review multidimensional.
- Em Agent Teams, o lead coordena e sintetiza; teammates não aprovam checkpoints humanos.
- Prefira automações por evento (Channels/webhooks) a polling; use scheduled tasks apenas para acompanhamento temporário.
- Quando artefatos forem materializados em Markdown, valide contratos com `.sdd/schemas/artifact-sections.json` e salve os aprovados com `sdd artifact ...` em projetos instalados.
