04 — Requisitos e Histórias de Usuário story-agent → S-NNN · critério INVEST · BDD (Given/When/Then) · DoR 9 itens · DoD 12 itens ETAPA 04/17 story-agent 📋 Demanda do Brainstorm síntese aprovada pelo orchestrator epics + features ✍ story-agent Especialista em Requisitos cria histórias de usuário aplica INVEST em cada uma gera critérios de aceite BDD tier: standard (Sonnet/medium) 📝 User Story S-NNN estrutura obrigatória Como <persona>, quero <ação>, para <benefício>. prioridade: Must/Should/Could/Wont estimativa: story points (Fibonacci) ID único incremental por sprint Ao menos 1 AC por história antes de entrar no DoR 🧪 Critério de Aceite BDD Given / When / Then Given o usuário está autenticado When clica em "Salvar" Then os dados são persistidos múltiplos ACs por história são permitidos ✅ Aprovado DoR + DoD OK entra no backlog sprint planning pronto para dev CRITÉRIO INVEST — aplicado pelo story-agent em cada história I Independent sem dependência de outras histórias N Negotiable detalhes abertos à conversa V Valuable entrega valor ao usuário ou negócio E Estimable pode ser estimada em story points S Small cabe em 1 sprint (max 2 semanas) T Testable critério de aceite verificável Se algum critério falhar → story-agent refina antes de seguir DoR — DEFINITION OF READY · 9 itens história só entra no sprint quando todos marcados ✓ ① ID único atribuído (S-NNN) ② User Story no formato padrão ③ Todos os critérios INVEST atendidos ④ Ao menos 1 critério de aceite (BDD) ⑤ Dependências mapeadas e resolvidas ⑥ Estimativa em story points ⑦ Mockup ou wireframe referenciado ⑧ Prioridade MoSCoW definida ⑨ Revisado pelo Product Owner (humano) ⚠ GATE obrigatório O orchestrator bloqueia a execução se DoR ≠ 100%. Story incompleta volta para story-agent refinar. Nenhum agente de impl. recebe história sem DoR OK. Regra: "nunca implementar o que não está definido" DoD — DEFINITION OF DONE · 12 itens story só sai do sprint quando todos marcados ✓ ① Código implementado e revisado (4-eyes) ② Testes unitários ≥ 80% cobertura ③ Testes de integração passando ④ Critérios de aceite BDD verificados ⑤ Code review aprovado ⑥ Sem warnings/erros de lint ⑦ OWASP Top 10 verificado (security-agent) ⑧ LGPD/GDPR verificado (privacy-agent) ⑨ Documentação atualizada ⑩ PR merged na branch principal ⑪ CI/CD pipeline verde ⑫ GitHub Issue fechada com evidências Aprovação humana (lay-user) requerida para UX stories. Score mínimo de 7/10 no teste com lay-user. tech-review-agent valida ⑦ e ⑧ antes de merge. HIERARQUIA DE REQUISITOS 🎯 Epic Feature Feature Feature S-001 · S-002 · S-003 1 Epic → N Features → N User Stories (S-NNN) PRIORIZAÇÃO MoSCoW Must obrigatório MVP Should importante alta prioridade Could desejável se couber Won't não neste ciclo Sprint só carrega Must + Should prioritários. Could entra se capacidade sobrar após planning. Won't documentado no backlog para sprints futuros. story-agent define · orchestrator valida · PO aprova STORY POINTS · Fibonacci escala de estimativa utilizada: 1 trivial 2 3 simples 5 8 médio 13 complexo 21 dividir! ≥ 13 pts → dividir em histórias menores. Velocidade do time define capacidade de sprint. Planning poker: story-agent propõe · tech-review revisa Sem unidade de tempo — é esforço relativo, não horas OUTPUT DO STORY-AGENT 📄 backlog.md Todas as histórias S-NNN com prioridade e pontos 📄 sprint-planning.md Histórias selecionadas para o sprint corrente 📄 acceptance-criteria.md Todos os ACs em formato BDD por história 📄 dor-checklist.md DoR validado ✓ para cada story do sprint ETAPA 04 · story-agent → S-NNN · INVEST · BDD (Given/When/Then) · DoR 9 itens · DoD 12 itens · MoSCoW · Fibonacci REQUISITOS E HISTÓRIAS LEGENDA · CONCEITOS Documento de entrada / saída story-agent (ativo) Gate / Critério obrigatório Aprovado / Pronto para sprint DoR: Definition of Ready — pré-condições para a história entrar no sprint DoD: Definition of Done — critérios para considerar a história finalizada INVEST: Independent · Negotiable · Valuable · Estimable · Small · Testable — qualidade da história BDD: Behavior-Driven Development — critério de aceite em linguagem ubíqua: Given/When/Then S-NNN: formato de ID único de story (ex: S-001, S-042) — rastreável no GitHub Projects e backlog.md