Fluxograma — miniSpec

miniSpec

Ecossistema completo do miniSpec: discovery, especificação (Intent → Scope → Tasks), apoio transversal (ADRs, testing-stack), execução orquestrada com os dois gates e braços pós-execução.

💡 Dica

Clique no diagrama para abrir em tela cheia. O caminho de reprovação está em vermelho — siga-o a partir de qualquer gate. Veja a legenda completa.

Fluxo principal (happy path)

1. Discovery (opcional): /agent-spec-pre-refinement recomenda miniSpec quando a complexidade é média.
2. Intent (O QUE/POR QUÊ) → Scope (COMO, com variante web/mobile/backend) → Tasks (task_plan + tasks individuais + .qa_context.md, testes delegados ao agent-spec-qa-test-generator).
3. Execução: para cada task, executor → Gate 1 (QA, único que executa testes) → Gate 2 (Tech Review) → git add determinístico.
4. Conclusão: todas as tasks aprovadas + Critérios de Conclusão Geral (build + testes) → /agent-spec-semantic-commit.

Fluxos alternativos (caminho vermelho)

• Gate 1 rejeita (críticos/altos) → Correção do executor com memória lazy → re-QA (máx 3 tentativas totais).
• Gate 2 rejeita (rejected/partial) → requires_qa_revalidation? decide: re-QA completo (lógica mudou) ou direto a novo Tech Review (só code-review).
• 3 tentativas esgotadas → Task Bloqueada (run continua nas demais).
• Débito médio/baixo → qa-observations.md → /agent-spec-debt-resolution gera v{N+1}-debits/ e re-executa via minispec-run-tasks.

📝 Nota

O miniSpec usa o mesmo motor de execução do SDD (lotes paralelos derivados, MAX_PARALLEL=4, guard de suítes E2E/integração que serializa os QAs). A diferença está na camada de especificação: Intent + Scope no lugar de PRD + Tech Spec.

📚 Aprofundamento na Referência

• miniSpec — Referência completa
• Pipeline — Visão Geral
• Legenda dos fluxogramas