---
id: story-tmpl
kind: template
agent: sm
produces: docs/stories/{epicNum}.{storyNum}.story.md
---

# Story {epicNum}.{storyNum}: {título curto da story}

**Status:** Draft
**Epic:** {epicNum} — {nome do epic}
**Estimativa:** {pontos ou esforço}

## Story

Como **{persona/papel}**, quero **{ação/capacidade}**, para **{benefício/resultado}**.

## Critérios de Aceite

> Cada AC é testável e rastreável a um FR/NFR. Numerados — o @dev marca um por vez, o @qa rastreia.

1. {critério verificável — dado/quando/então quando ajudar}
2. {...}

## Tasks / Subtasks

> Decomposição técnica que o @dev executa. Cada subtask aponta para o(s) AC(s) que satisfaz.

- [ ] {task} (AC: {n})
  - [ ] {subtask}
- [ ] {task} (AC: {n})

## Dev Notes

> TUDO que o @dev precisa, extraído da arquitetura/spec pelo @sm — para o @dev NÃO ter que abrir
> outros docs. Inclui: arquivos/módulos a tocar, padrões a seguir, contratos/interfaces, gotchas.
> Cada afirmação técnica cita sua fonte (`docs/architecture/...`, `docs/specs/...`). Sem fonte = não
> entra (No Invention).

- {contexto técnico com fonte}

## Testing

> Como provar cada AC. O @dev não marca um AC sem o teste verde correspondente.

- **Estratégia:** {unit / integração / e2e}
- **Casos:** {cenários, incl. caminho de erro e edge cases}
- **Comando:** {como rodar a suíte da área}

## Dev Agent Record

> Preenchido SÓ pelo @dev durante a implementação. As seções acima são travadas após validação do @po.

### File List
{arquivos criados/modificados — o rastro do que foi tocado}

### Completion Notes
{decisões de implementação, dívidas registradas, desvios e porquês}

### Change Log
| Data | Mudança | Autor |
|---|---|---|
| {data} | {o quê} | @dev |