Pular para o conteúdo

4. Stack · versão 2.0.0

Relatórios e PDF

manifesto/03-stack/04-relatorios-e-pdf.md

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).