report-live-release-engineer
Operar e evoluir o Report Live Afinz/GaaS com build imutável, certificação, publicação no único Google Sheets/Slides vivo, rollback, QA visual e contratos de dados. Usar ao alterar report-sync, report
SKILL.md.claude/skills/report-live-release-engineer/SKILL.md
GitHubReport Live Release Engineer
Tratar o deck como destino de publicação, nunca como fonte de verdade. Preservar um único Sheet e um único Slides vivo.
Começar
- Localizar o workspace
ACALENDARIO APP. - Ler integralmente os arquivos obrigatórios em
references/project-map.md. - Inspecionar
git status; preservar alterações alheias. - Identificar a fase pedida:
audit,build,certify,publishourollback. - Não tocar no deck vivo durante
audit,buildoucertify.
Audit
- Comparar código, migrations, Master Deck Spec, vault e último run.
- Verificar CT-1 a CT-9, especialmente missing, SUM/SUM, iso-dias, CPA nomeado e cutoff.
- Tratar prontidão, confiança e elegibilidade como estados independentes e coerentes.
- Inspecionar PDF ou thumbnails para qualquer afirmação visual.
- Registrar achados por slide e por arquétipo.
Build
- Adquirir ou respeitar idempotência por perfil, período e hashes.
- Gerar manifesto, tabs, ações, narrativa e blueprints.
- Persistir fontes, hashes e artefato no bucket privado.
- Não escrever no Sheets/Slides.
- Reusar IDs determinísticos por
slide_instance_id.
Certify
- Executar validações estruturais e editoriais.
- Bloquear publicação se houver erro
blockingouerror. - Reprovar linha posicional incompleta, null→0, delta contra missing, slide bloqueado como render e narrativa vazia.
- Comparar com a publicação anterior e produzir diff legível.
- Usar golden run e chaos run quando o renderer ou contrato mudar.
Publish
- Exigir artefato certificado.
- Adquirir lock exclusivo por deck.
- Gravar o Sheet, reconstruir/atualizar slides, substituir narrativas e exportar PDF.
- Registrar
report_publicationse marcar a anterior comosuperseded. - Liberar lock em
finally. - Entregar link vivo, run, publication version, hash e resultado das validações.
Rollback
- Selecionar publicação histórica certificada.
- Revalidar o artefato.
- Reaplicar o blueprint sem consultar ou recalcular as fontes.
- Registrar motivo, publicação revertida e nova publicação.
Design e storytelling
- Usar tema claro Afinz.
- Aplicar tokens e arquétipos; não criar layout ad hoc por parceiro.
- Corpo mínimo 11 pt; anexo 9 pt.
- Usar lima apenas para takeaway/total.
- Não aceitar dump monoespaçado como tabela final.
- Um slide precisa responder pergunta, decisão, evidência e limite de leitura.
Segurança
- Nunca expor secrets.
- Não aplicar migrations nem fazer deploy em produção sem autorização explícita.
- Antes de promoção, verificar RLS, advisors e compatibilidade com runs legados.
- Em recuperação legada, exigir opt-in explícito.
Handoff
Atualizar Afinz-CRM-Midia-Vault/08-Engenharia/Report-Live-Versionamento-e-Publicacao.md com estado, evidência, pendências e próximo passo. Não usar o chat como única fonte de verdade.
PPTX/PDF sob demanda e migração da gaas-loop
A parte de render da gaas-loop foi preservada em legacy-render/WORKFLOW.md, como registro de 28/09/2026, não como contrato atual. Antes de gerar PPTX/PDF, conferir renderer, filas e RPCs em origin/main. Não assumir que dependências descritas como ausentes em setembro continuam ausentes. Não executar a antiga parte loop. Usar gaas-growth-loop-operator para Fila e atualização de notas.