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