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