# NEXUS Templates — os esqueletos dos documentos

Um template é o **esqueleto** de um documento que uma task preenche: a estrutura que captura o que
importa, com placeholders `{assim}`. Se a task é o *como fazer*, o template é o *no que despejar*.
Padronizar o esqueleto é o que faz dois PRDs (ou duas stories) terem a mesma forma, revisáveis pelo
mesmo checklist.

## Formato canônico

Frontmatter YAML (metadados) + corpo Markdown com placeholders.

```markdown
---
id: story-tmpl
kind: template
agent: sm                     # agente que tipicamente preenche
produces: docs/stories/{epicNum}.{storyNum}.story.md   # onde o artefato preenchido mora
---

# {título do documento}

## {Seção}
{placeholder explicando o que vai aqui}
```

## Regras

- **Placeholders são `{kebab-ou-livre}`** — o que a task substitui. Toda seção tem um placeholder ou
  uma instrução curta do que entra.
- **Sem invenção embutida.** O template estrutura; ele não inventa conteúdo. O conteúdo vem da task,
  que rastreia a story/spec/objetivo.
- **NEXUS-nativo.** `produces:` aponta para `docs/{tipo}/` (artefato produzido). Nada de frameworks
  externos.
- **Revisável.** A estrutura do template casa com o checklist que o valida (ex.: `story-tmpl` ↔
  `story-draft-checklist`).

## Onde os artefatos preenchidos moram

| Template | Produz em |
|---|---|
| `story-tmpl` | `docs/stories/` |
| `prd-tmpl` / `epic-tmpl` | `docs/prd/` |
| `spec-tmpl` | `docs/specs/` |
| `architecture-tmpl` | `docs/architecture/` |
| `front-end-spec-tmpl` | `docs/design/` |
| `project-brief-tmpl` / `competitor-analysis-tmpl` / `market-research-tmpl` | `docs/research/` |
| `schema-design-tmpl` / `migration-plan-tmpl` / `rls-policies-tmpl` | `docs/data-models/` |