---
id: story-dod-checklist
kind: checklist
agent: dev
gate: Definition of Done
decision: "qualquer item crítico (1-7) FALHO → NÃO PRONTO; todos OK → Ready for Review"
---

# Story DoD Checklist (Definition of Done)

> O @dev (Dex) roda isto antes de setar a story como `Ready for Review`. Não é sobre "tentei" — é sobre
> "entreguei e provei". Veredito binário: **READY FOR REVIEW** (todos os críticos passam) ou **NÃO PRONTO**
> (lista do que falta). Story que vai para o @qa sem passar aqui volta como retrabalho.

## Críticos — qualquer falha aqui = NÃO PRONTO

- [ ] 1. **Todos os ACs atendidos** — cada critério de aceite da story tem implementação correspondente;
      nenhum AC ficou sem cobertura ou foi parcialmente entregue.
- [ ] 2. **Todas as tasks/subtasks `[x]`** — cada checkbox marcado tem código + teste por trás; nenhum
      `[x]` marcado por adiantamento ("testo depois").
- [ ] 3. **Testes escritos e verdes** — caminho feliz + casos de erro/borda cobertos; a suíte inteira
      (`*run-tests`) roda e passa, sem teste pulado/skip sem justificativa.
- [ ] 4. **Lint e validações passando** — lint/typecheck verdes; zero erro novo introduzido por esta story.
- [ ] 5. **Regressão completa rodada** — TODOS os testes do projeto executados (não só os da story) e
      nenhuma regressão; nada quebrou no que já funcionava.
- [ ] 6. **File List completa e correta** — todo arquivo criado, modificado ou deletado está listado;
      nada de tocar arquivo fora da File List sem registrá-lo.
- [ ] 7. **Sem invenção / sem dependência não aprovada** (Constituição Art. IV) — nada implementado fora
      do escopo da story; nenhuma dependência nova entrou sem aprovação explícita.

## Não-críticos — falha vira nota em Completion Notes, não bloqueio

- [ ] 8. **CodeRabbit rodado** — review automático executado; CRITICAL corrigido no lugar (máx. 2
      iterações). Achados de menor severidade ficam documentados, não pendentes silenciosos.
- [ ] 9. **Menor caminho respeitado** — sem super-construção; reusou padrões/utilitários já existentes
      antes de criar estrutura nova.
- [ ] 10. **Dev Agent Record preenchido** — Debug Log, Completion Notes e Change Log refletem o que foi
      feito, decisões tomadas e qualquer débito conhecido deixado para o @qa.
- [ ] 11. **Fronteiras respeitadas** — só editei minhas seções da story (Dev Agent Record, checkboxes,
      File List, Status); AC/escopo/Dev Notes/Testing intocados. Schema → @data-engineer; UI →
      @ux-design-expert; push/PR → @devops.

## Decisão

**Veredito:** READY FOR REVIEW / NÃO PRONTO
**Críticos (1-7):** {n}/7 OK
**Não-críticos (8-11):** {n}/4 OK
**Pendências (se NÃO PRONTO ou notas para o @qa):**
- {item — o que falta ou que débito conhecido segue para review}

> Se READY FOR REVIEW: seto `Status: Ready for Review` e HALTO. Eu **não** dou push — quem sobe é o @devops.
> Se NÃO PRONTO: volto ao loop de implementação; não passo problema crítico conhecido adiante.