4. Stack · versão 2.0.0
Relatórios e PDF
Ao fechar uma ADR, os arquivos 005-relatorio-tecnico.md e 006-relatorio-executivo.md são
escritos pela IA e convertidos em PDF por um script do projeto.
Fluxo de fechamento
IA escreve 005-relatorio-tecnico (commits, testes, arquivos tocados, decisões, tarefas vinculadas)→ IA escreve 006-relatorio-executivo (resumo humano: Entregue · Impacto · Próximos passos)→ IA roda o script de geração de PDF→ IA commita tudo (e, com o Gestor, move a tarefa para Revisão)→ IA avisa: "PDFs prontos para envio"Com o Gestor, os relatórios chegam ao cliente pela Documentação do projeto (o
006 sempre; o resto com a liberação da parte técnica). Mandar os PDFs por outro canal — Discord,
e-mail — é opcional e manual: não há webhook nem envio automático.
O script
Cada projeto tem o seu scripts/generate-tecnico.mjs (pnpm adr:pdf <NNN-slug>). Ele converte os
seis arquivos da ADR (e os .md de resources/) em PDF, um por arquivo e um consolidado, em
.specs/adr/<NNN-slug>/pdf/, com a identidade visual do projeto.
O script é do projeto, não do Manifesto: a identidade visual muda de um para outro. O jhowdev,
origem do Manifesto, mantém a versão de referência, e os modelos de projeto Manifesto e Monorepo
a trazem com a marca num arquivo só, scripts/marca.mjs (ver
Ferramentas padrão). O jhowdev também gera o PDF do próprio Manifesto (pnpm pdf).