ENGINEERING TEMPLATE · MICRO FLOW · ETAPA 03 / 17 demanda → orchestrator → story → usability → lay-user ×2 Planejamento e Brainstorm — Da Demanda à Especificação Fluxo de refinamento: demanda bruta → orchestrator processa → especialistas em paralelo → síntese → aprovação humana ENTRADA ORCHESTRATOR ESPECIALISTAS (PARALELO) SÍNTESE SAÍDA 📥 Demanda Bruta humano → texto livre "quero um app de X" 🧠 Orchestrator principal agent interpreta · prioriza · delega NUNCA implementa fork 📖 story-agent Épicos · Histórias formato INVEST S-NNN · Given/When/Then tier: deep (opus) 🎨 usability-agent UX personas · fluxos protótipos rápidos heurísticas Nielsen tier: standard (sonnet) join 🔀 Síntese orchestrator consolida conflitos resolvidos ✅ Aprovação Humana humano revisa + aprova DoR satisfeita? → sim → avança não → volta ao orchestrator DETALHES DE CADA AGENTE 🧠 Orchestrator — Regras 1. Recebe demanda em linguagem natural 2. Extrai: objetivo · escopo · restrições 3. Determina agentes necessários 4. Cria briefs individuais por agente 5. Despacha em paralelo (quando possível) 6. Aguarda → consolida → resolve conflitos 7. Apresenta síntese ao humano ⚠ NUNCA escreve código de produção ⚠ NUNCA faz commit direto tier: deep · modelo: opus 📖 story-agent — Output • Épicos de alto nível (E-NNN) • User Stories no formato: S-001: Como [ator] Quero [ação] Para [benefício] • Critérios INVEST: I·N·V·E·S·T • BDD: Given / When / Then • DoR checklist (9 itens) • DoD checklist (12 itens) tier: deep · modelo: opus 🎨 usability-agent — Output • User Personas (2-3 perfis) • Jobs-to-be-done (JTBD) • Pain points mapeados • User Journey (happy path) • Wireframes textuais / ASCII • Heurísticas Nielsen aplicadas • Accessibility checklist (WCAG) • Quick-action usability flag • Drawio sketch (opcional) tier: standard · modelo: sonnet 👤 lay-user ×2 — Validação Dois usuários leigos simulados: lay-user-1: perfil técnico leigo • entende termos básicos de apps • avalia clareza das histórias lay-user-2: perfil não-técnico • zero vocabulário técnico • valida se o valor é compreensível Feedback: confuso / ok / ótimo Score mínimo: 7/10 para avançar tier: light · modelo: haiku 🔀 Síntese Final • Merge: stories + UX • Conflitos resolvidos • Lay-user score ≥ 7 • DoR validada • Backlog ordenado • Wave 1 definida • Riscos mapeados • Proposta ao humano → aprovação ou iteração tier: deep · síntese opus ✅ Documentos Gerados • product-brief.md • user-stories.md • ux-personas.md • acceptance-criteria.md • dor-checklist.md • dod-checklist.md • backlog-wave1.yaml • lay-user-score.json Commitados em /docs/ → etapa 04: Requisitos 💡 POR QUE 2 LAY-USERS? O template usa dois agentes leigos simulados para garantir que as histórias de usuário sejam compreensíveis para pessoas não técnicas. lay-user-1 valida clareza técnica básica; lay-user-2 valida a proposta de valor. Ambos devem aprovar com score ≥ 7/10 antes de avançar para a etapa de Requisitos. 📋 DEFINITION OF READY (DoR) — 9 ITENS 1-Ator definido 2-Objetivo claro 3-Critérios aceitação 4-Estimativa SP 5-Dependências mapeadas 6-UX mockup aprovado 7-Lay-user score ≥ 7 8-Sem bloqueadores 9-Revisado pelo orchestrator PRÓX. → Etapa 04: Requisitos e Histórias de Usuário — S-NNN · INVEST · DoR 9 itens · DoD 12 itens · Given/When/Then LEGENDA Agente Ativo Fork / Join Aprovação Humana ETAPA 03/17 · Planejamento e Brainstorm — fork paralelo · lay-user ×2 · síntese orchestrator → story + usability → join → humano