001 — Executive · Fundação: Monorepo, Documentação e Pipeline de PDF

Status: Concluído Aprovado por / em: Joseph Trupel — 2026-06-29

Decisões executivas

Estabelecer a fundação do boilerplate: o monorepo, a metodologia embutida (manifesto/), a documentação viva (.specs/), o site de documentação (Astro Starlight) e o pipeline de geração de PDF das ADRs. Esta é a base sobre a qual a stack da aplicação é montada (essa parte vive na ADR 002).

A regra que rege tudo é o Manifesto: tudo é ADR. Esta é a ADR de fundação — a primeira, que monta o próprio repositório.

Escopo

Entra agora

Manifesto completo em manifesto/ (read-only nos projetos).
Documentação viva em .specs/ (esta ADR, a ADR 002 e um exemplo didático).
Monorepo Turborepo + pnpm: apps/web, apps/docs, packages/*.
Site de documentação (Astro Starlight, tema Astra) renderizando manifesto/ + .specs/.
Geração de PDF das ADRs e do manifesto (md-to-pdf/Puppeteer) com identidade visual própria.
Scripts de orquestração (db:*, pdf, adr:pdf, docs:*) e de inicialização de projeto.
Identidade visual (logo).

Pode adiar

CI/CD, deploy, autenticação.

Fica de fora

A stack da aplicação (OpenAPI, Zustand, shadcn, testes) — é a ADR 002.
Qualquer regra de negócio — o boilerplate é neutro de domínio.

Prazos

Marco	Esperado	Real
Fundação montada e validada	2026-06-29	2026-06-29

Recursos a implementar

Monorepo com o manifesto versionado e a .specs/ como documentação viva.
Site Starlight publicando manifesto + .specs juntos, com identidade visual própria.
Pipeline de PDF idêntico ao usado nos projetos de referência.

Objetivos / KPIs

Tempo de bootstrap de um projeto novo ≈ 0: clonar, pnpm install, pnpm dev.
Documentação e PDFs gerados a partir de uma única fonte Markdown.

Módulos / áreas afetados

Todo o repositório — é a fundação. Sem impacto em projetos externos.

Referências e links

Criado por Joseph Trupel