.specs/ — Spec-Driven Development

Contratos de entrega por feature. A spec vem antes do código.

Padrão completo: standards/SDD_STANDARD.md

O que é esta pasta

Estrutura por feature

.specs/
└── <feature-kebab>/
    ├── SPEC.md      # O quê + critérios de aceite
    ├── PLAN.md      # Como (arquivos, riscos, ordem)
    └── TASKS.md     # Checklist de implementação

Fluxo

1. Copie os templates para .specs/<feature-kebab>/.
2. Preencha SPEC.md e aguarde aprovação antes de codar.
3. Preencha PLAN.md e TASKS.md.
4. Implemente na branch feature/....
5. Verifique o PR contra os critérios de aceite da spec.
6. Atualize docs/ afetados no mesmo PR.

Quando usar

• Sim: feature nova, mudança de API/schema, backend, integração, automação IA.
• Não: fix trivial, chore, refactor sem mudança de comportamento, docs-only.

Templates

• SPEC_TEMPLATE.md
• PLAN_TEMPLATE.md
• TASKS_TEMPLATE.md