004 — Tasks · Fundação: Monorepo, Documentação e Pipeline de PDF

004 — Tasks · Fundação: Monorepo, Documentação e Pipeline de PDF

Execução viva. Status: todo / doing / done / blocked.

Tarefas

#	Tarefa	Status
1	Migrar manifesto (identidade visual definida, docs/→.specs/)	done
2	Criar .specs/ (ADR 001, ADR 002, exemplo, notes)	done
3	Pipeline de PDF (ADR + manifesto) com identidade visual	done
4	Site Astro Starlight (tema Astra) com sync manifesto + .specs	done
5	Scripts de orquestração + init-project + README + CLAUDE.md	done
6	Identidade visual (logo PNG)	done

Bibliotecas instaladas (nome · versão · porquê)

Raiz (monorepo)

• md-to-pdf ^5.2.5 (+ Puppeteer transitivo) — geração de PDF das ADRs e do manifesto.
• turbo ^2.9.18 — orquestração do monorepo.

apps/docs

• @astrojs/starlight ^0.36 — site de documentação.
• astro ^5.14 — framework do site.
• starlight-theme-nova ^0.12 — tema Astra.
• sharp ^0.34 — processamento de imagens do site.

A stack da aplicação (Zustand, Zod, OpenAPI, Vitest, Prisma, shadcn) é instalada na ADR 002.

Decisões e contradições em execução

• sync-docs.mjs sincroniza duas fontes (manifesto/ e .specs/), reescrevendo links cross-source e injetando frontmatter nas ADRs (que não têm). Ignora notes/ e pdf/.
• Logo do projeto (a imagem original). Usada como está no site, no app e embutida em base64 no cabeçalho dos PDFs — sem recriação.
• PDF do manifesto ganhou capa com a logo; PDF da ADR mantém o layout de relatório (header/footer + paginação).

Estratégia da IA

• Agentes exploradores em paralelo para mapear o pipeline de PDF dos projetos de referência e o conteúdo do manifesto antes de construir.
• Instalações em background enquanto o código era escrito.
• Validação: sync + astro build (38 páginas), geração de PDF.