Specifications¶

Cada especificação é o registro completo de uma funcionalidade nova ou de uma mudança em funcionalidade existente: a dor, a jornada pretendida (desktop e mobile), as regras de negócio, a autorização e o contrato de API — nesta ordem, porque cada parte só se escreve depois que a anterior passa pelo portão correspondente. Ver o fluxo completo no CLAUDE.md da raiz, seção "Specs de feature", e o template em ../doc-templates/specification.md.

Numeração: os IDs (SPEC-0001…SPEC-0054) são os mesmos números que as pastas spec/NNNN-slug/ e as branches spec/NNNN-slug sempre usaram — preservados na migração de 2026-08-30 para não quebrar as ~200 citações cruzadas entre specs ("a RN7 da 0038 diz que…"). Não existe SPEC-0029: o número nunca foi usado, não é conteúdo perdido.

SPEC-0035 e SPEC-0045 diziam em-implementacao até 2026-09-26, e agora dizem concluida. A migração de 2026-08-30 preservou o texto original de cada cabeçalho em vez de corrigi-lo silenciosamente — fidelidade que fazia sentido na migração e deixou de fazer depois, porque duas specs no ar marcadas como abertas se leem como trabalho pendente. O Git fecha as duas: a 0035 entrou pelo commit 6753bab (feat(api,web,e2e,spec 0035)) e a 0045 pelo merge 6d3e165. O mapa da migração segue em ../metadata/migration-map.yaml.

O status de cada documento existe em quatro lugares — o status: do front matter, a tabela de cabeçalho do próprio arquivo, a linha desta tabela e a entrada em ../metadata/catalog.yaml. O scripts/docs_lint.py confere que o catálogo e os arquivos existem e combinam, mas não compara os quatro status entre si: foi assim que a 0048, a 0049, a 0053 e a 0054 ficaram com valores diferentes em lugares diferentes até 2026-09-26. Ao fechar uma spec, mude os quatro.