.specs/

.specs/

Documentação viva do projeto. Nesta pasta vive o trabalho do dia a dia, gerado durante o desenvolvimento. A metodologia que rege tudo isto está em manifesto/.

Neste boilerplate, .specs/ já é real: traz a ADR de fundação 001-fundacao-boilerplate/, que montou o próprio monorepo, e um exemplo didático preenchido em 000-exemplo-modulo-tarefas/.

Estrutura

.specs/
├── adr/      ← unidades de trabalho (foco do dia a dia)
├── notes/    ← anotações humanas — a IA ignora (ver notes/CLAUDE.md)
└── readme.md ← este arquivo

Outras pastas surgem quando uma ADR as cria — por exemplo, .specs/model/ (modelos de dados, quando uma ADR de banco justificar) ou .specs/stack/ (decisões técnicas próprias do projeto). Não se adianta estrutura que ainda não é necessária.

ADRs

Toda unidade de trabalho é uma ADR em .specs/adr/NNN-slug/. Veja o fluxo completo em manifesto/02-fluxo-adr/.

ADR	O que é
000-exemplo-modulo-tarefas	Exemplo didático preenchido (conteúdo fictício).
001-fundacao-boilerplate	Executada. Fundação: monorepo, manifesto, .specs, site de docs (tema Astra) e pipeline de PDF.
002-stack-aplicacao-openapi	Executada. Stack da aplicação: OpenAPI + Scalar, Zustand, shadcn/ui, tipos gerados, testes, Prisma.

Este readme explica a estrutura conforme ela cresce. Listar todas as ADRs aqui é opcional — faça se ajudar a navegação, não como obrigação.

Documentação viva (site)

Tanto o manifesto/ quanto a .specs/ são publicados como site (Astro Starlight, tema Astra) e PDF, a partir do mesmo conteúdo Markdown. Ver apps/docs e os scripts em scripts/.