---
id: create-epic
agent: pm
title: Estruturar o epic a partir do PRD
inputs: [docs/prd/prd.md]
outputs: ['docs/epics/{epicNum}.epic.md com fronteiras, dependências e quality gates']
elicit: false
modes: [interactive, yolo]
---

# Estruturar o epic a partir do PRD

**Objetivo:** quebrar o PRD em epics com fronteiras limpas, dependências mapeadas e quality gates
previstos — e **delegar a criação das stories ao @sm** (Gate 1). Eu desenho o epic; eu não crio a story.

**Pré-condições:**
- O PRD existe em `docs/prd/` com FRs/NFRs e critérios de aceite. Se o PRD não está pronto, **pare** e
  rode `create-prd` / `create-brownfield-prd` antes.
- Os FRs têm rastro ao "por quê". Se há feature órfã no PRD, **pare** e resolva na origem (No invention).

## Passos

1. **Agrupe os FRs em epics de fronteira limpa.** Cada epic entrega um incremento de valor coeso e
   independente o quanto der. Nada de epic "guarda-chuva" sem foco.
2. **Mapeie dependências entre epics** (o que precisa do quê primeiro) e ordene por valor x dependência —
   o que destrava mais cedo, vai primeiro.
3. **Escreva cada epic** a partir de `templates/epic-tmpl.md`: objetivo, FRs cobertos (com rastro ao
   PRD), critério de aceite do epic, dependências e **quality gates previstos** (onde o @qa entra).
4. **Preveja os agentes especializados de cada frente** (implementação → @dev, dados → @data-engineer,
   UX → @ux-design-expert, subida → @devops). Qualidade entra no plano, não depois.
5. **Salve em `docs/epics/{epicNum}.epic.md`** e registre a ordem de execução sugerida.
6. **Delegue a criação das stories ao @sm (Gate 1).** Eu estruturo o epic e entrego ao River para o
   `*draft`. **Não furo essa fronteira**, mesmo que "seja rápido". Validação das stories → @po.

## Critério de pronto (DoD)

- [ ] Cada epic tem objetivo, FRs cobertos (com rastro ao PRD) e critério de aceite
- [ ] Dependências entre epics mapeadas e ordem de execução definida
- [ ] Quality gates e agentes especializados previstos por epic
- [ ] Epics salvos em `docs/epics/`; **stories delegadas ao @sm** (não criadas por mim)
- [ ] Nenhum FR órfão ou inventado — tudo rastreia ao PRD

## Falha / recuperação

- **Um FR não cabe em nenhum epic limpo** → reviso o agrupamento; não crio epic guarda-chuva pra
  esconder o problema.
- **Dependências formam ciclo** → reordeno ou recorto o escopo do epic até quebrar o ciclo.
- **PRD está ambíguo/incompleto** → volto ao `create-prd`; não invento o requisito que falta.
- **Pressão para eu mesma criar a story** → recuso e delego ao @sm; a fronteira do Gate 1 não negocia.