13 KiB
Dossiês e boletins Solla sóbrios e analíticos — listas, análise (o que fez × o que defende) e consulta rápida (cidade · instituição · tema)
Status: rascunho Atualizado em: 2026-09-22 Issue: #1251 Priority: P2 Impeccable: C — redesenho de superfície existente (três variantes da mesma família, dossiê + boletim), sem fluxo novo; design hi-fi obrigatório no gate Design UI: docs/plans/dossies-sobrios-analiticos-ui-design.html Appetite: ~4–5 dias eng; uma linguagem visual nova para dossiês e boletins, com a dimensão "o que defende" e consulta rápida Responsável: —
Intenção
O humano achou o layout dos dossiês exagerado: quadrados um do lado do outro, cartões, selos coloridos, seção de gráficos. Quer um documento sóbrio, fácil de ler, organizado em listas, com mais análise do conteúdo, para que o leitor encontre rápido a informação sobre Jorge Solla de que precisa. O pedido é repaginar o design dos dossiês do zero — e o boletim modelo entra junto (decisão do gate, 2026-09-22). Além disso, o dossiê deve analisar não só o que Solla fez, mas o que ele fala e defende para aquele recorte: derivado dos registros, com pesquisa extra de notícias datadas e trechos do acervo de falas sobre o que ele defende ali. Hoje o dossiê é um inventário visual; a prioridade inverte: primeiro a leitura (o que fez, o que defende, o que se destaca, o que falta), depois a evidência completa, sempre com fonte.
Persona e fluxo
- Persona / contexto: assessoria, gabinete e comunicação, na mesa ou em viagem, consultando no celular ou no notebook antes de uma fala, de uma resposta pública ou de um texto.
- Job principal: em segundos, achar o que Jorge Solla fez e o que defende naquele recorte, com fonte e fase, e saber o que não foi encontrado.
- Fluxo desejado: abre o dossiê, lê "O essencial" e entende o recorte em uma página; desce por era com a mesma anatomia; consulta a tabela quando quer o item exato; lê o que ele defende e confere a fonte; fecha sabendo as lacunas.
- Anti-goals de produto: não virar peça de campanha nem material publicável; não virar dashboard, infográfico ou relatório de vaidade; não virar inventário sem leitura; não preencher análise com inferência; não atribuir a Solla uma defesa que não tem registro.
Esboço de fluxo (C)
[abre o dossiê] → [capa + índice] → [O essencial: leitura do recorte (fez + defende)]
→ [era A/B/C: leitura + tabela Objeto/Valor/Ano/Fase/Esfera/Fonte + o que defende com lastro]
→ [região · lacunas · notícias · acervo · fontes] → [achou o dado com fonte e fase] | [confirmou a lacuna]
Design UI (C)
- Design UI (gate):
docs/plans/dossies-sobrios-analiticos-ui-design.html— cenas do dossiê (três variantes) e do boletim modelo sóbrio, no mesmo artefato (decisão do gate: um hi-fi da família).
Objetivo e aceite
- Um só desenho para as três variantes (cidade, instituição, tema): mesma linguagem visual e mesma anatomia de leitura, no dossiê e no boletim modelo.
- Listas e tabelas são a espinha — sem grade de quadrados lado a lado, cartões decorativos, selos coloridos (esfera e fase viram texto/coluna) ou a seção de "Gráficos consolidados".
- O dossiê abre pela análise: "O essencial" (o que Solla fez, o que defende, o que se destaca, o que falta) + leitura por era + leitura entre eras (concentração, instrumentos, continuidade/ruptura, lacunas que pesam), sempre leitura dos registros com fonte — nunca inferência nem fato novo.
- Dimensão nova "o que Solla defende": posições, prioridades e compromissos para o recorte, derivados de itens com fonte + pesquisa extra de notícias datadas e trechos do acervo de falas (fala/trecho identificado); análise derivada, com a mesma régua de lastro — sem registro, é lacuna.
- Boletim modelo no mesmo redesenho: 1 página A4, linguagem de público eleitor, sóbrio e list-based, mantendo rótulo "Modelo — insumo interno", sem declaração de fontes e sem CTA; herda apenas fatos com fonte do dossiê e ganha um bloco "O que Solla defende" (1–2 defesas curtas com lastro, exibidas como os fatos do boletim — sem linha de fonte).
- Consulta rápida: índice e âncoras no PDF e no companion
.md, anatomia constante por era, cabeçalho corrente com seção e folha; o.mdespelha a estrutura. - Nada some e os guardrails seguem intactos: sem fonte não publica; fase por valor (autorizado/empenhado/liquidado/pago/restos); esfera explícita e nunca somada; leitura relativa; atribuição de emenda só com autoria checada; PII mínima; artefato gitignored; defeso (insumo interno, sem CTA).
Dados (intenção)
- Vou apresentar dados? Sim, superfície neste item — o dossiê é leitura de registros com fonte.
- Decisões desbloqueadas: a comunicação escolhe o que citar e priorizar na fala/texto; escolhe o que falta buscar (lacuna vira pauta de pesquisa); a coordenação vê a cobertura do recorte para decidir onde investir levantamento.
- Forma: adiada ao plano de implementação — restrições aqui: leitura relativa/local (nunca % estadual absoluto); valor sempre com fase; esfera explícita por item, recortes nunca somados; números em tabelas e na prosa, sem gráficos decorativos; toda análise (fez e defende) rastreável a item/trecho com URL+data.
Dados da decisão (literais)
- ID C209 · slug
dossies-sobrios-analiticos· arquivodocs/plans/dossies-sobrios-analiticos.md. - Donos da engine (o redesenho acontece neles, sem fork):
scripts/lib/dossieUnit.mjs,scripts/lib/dossieBlocks.mjs,scripts/lib/dossieRender.mjs,scripts/lib/dossiePack.mjs,scripts/lib/dossieCareer.mjs; builders finosscripts/build-dossie-solla-cidade.mjs,scripts/build-dossie-solla-instituicao.mjs,scripts/build-dossie-solla-tema.mjs; PDF viascripts/lib/buildPdf.mjs. - Boletim agora em escopo:
scripts/lib/dossieBulletin.mjsescripts/lib/dossieBulletinRender.mjs; os três hi-fi de boletim antigos (docs/plans/dossie-solla-{cidade,instituicao,tema}-boletim-ui-design.html) ficam no repo como registro e são superados pelo novo artefato. - Boletim × defende (literal): o bloco "O que Solla defende" do boletim traz 1–2 defesas curtas derivadas de item/notícia/trecho com lastro; sem registro = bloco omitido (nunca inventa); sem linha de fonte visível e sem CTA (regras do boletim).
- Redação e skills:
.opencode/agent/dossie-solla-{cidade,instituicao,tema}-redacao.md; seções "Conteúdo do dossiê" de.agents/skills/dossie-solla-cidade/SKILL.md,.agents/skills/dossie-solla-instituicao/SKILL.md,.agents/skills/dossie-solla-tema/SKILL.md. - Dimensão "o que defende" (literais de produto): derivada de itens com fonte + notícias datadas + trechos do acervo de falas sobre o recorte; todo trecho de fala entra com identificação (título/data ou id do trecho); sem notícia datada/trecho identificado = lacuna explícita; nunca atribuir defesa sem registro; a análise é leitura dos registros, não opinião do pipeline.
- Design novo (gate; supersede os hi-fi de dossiê e boletim antigos, que ficam no repo como registro):
docs/plans/dossies-sobrios-analiticos-ui-design.html. - Âncoras/seções a preservar (renomear só o que o design exigir): capa, carta, trajetória, resumo, síntese, era A/B/C, região, lacunas, notícias, acervo, fontes; nas variantes, abrangência e títulos/honrarias; nova: "o que defende". "Gráficos consolidados" deixa de existir.
- Regras fixas do desenho: sem marca de campanha (documento institucional neutro); sem imagens nem placeholders de imagem; fase e esfera como texto/coluna, nunca selo colorido.
Direção no codebase (hipótese)
- Áreas prováveis: os módulos
scripts/lib/dossie*.mjs(conteúdo, render, paginação), os três builders, os três agentes de redação e as três SKILLs; precedentes de conteúdo emdocs/plans/dossie-solla-{cidade,instituicao,tema}-impl.mde no dossiê real de Miguel Calmon. O relatório de cidade (C163) é precedente de documento sóbrio, sem copiar o dono. - "O que defende" reusa a pesquisa existente: o checklist por era ganha itens de posições/defesas e o acervo já é extraído por recorte nos três pipelines — a análise deriva dos mesmos JSONs, sem segundo pipeline de pesquisa.
- Risco de acoplamento: o boletim lê só o ledger de fatos do dossiê e tem folhas próprias — agora redesenhado, mas sem herdar análise/fatos novos; os specs que fixam o layout atual (render, instituição, tema, pack, blocks, bulletin e skills de lote) precisam ser atualizados pelo impl; a guarda de fit A4 e a paginação ficam como estão.
Dependências
- Nenhuma dura. Soft com C210 (
briefing-capacitacao-solla): o briefing consome o dossiê — inclusive a dimensão "o que defende" que nasce aqui; C210 não bloqueia este item. - Coordenação de arquivos com C210: os dois itens tocam as três SKILLs de dossiê e os specs de lote — C209 reescreve as seções de conteúdo; C210 adiciona o ponteiro para a skill de briefing. Rebase esperado; sem bloqueio (a ordem de merge segue a prioridade: C210 é P1).
- Soft/registro: Issue #1139 (C189, bloqueada) — se o redesenho eliminar caps, o débito da C188 pode ficar moot; anotar, não bloquear.
Fora de escopo
- Briefing de capacitação (C210) — entregável novo, item próprio; é o C210 que liga o briefing ao fluxo das skills de dossiê. Este item só garante que o dossiê tem os fatos e as defesas que ele consome.
- Relatório de cidade (C163); qualquer schema, migration ou escrita em banco; qualquer mudança de URL público.
- Campanha, publicação, peça publicável e kit de marca 1313.
Rabbit holes de produto
- "Só falta um gráfico". Completar com charts devolve o que o humano rejeitou e puxa dependência nova. Corte: números em tabela e prosa; se algo só se entende visualmente, decide o design, não a engine.
- "Já que sobrou espaço, busca mais dado / faz um hi-fi por variante". Vira nova pesquisa e família rachada. Corte: lê os registros existentes (o "defende" usa notícia datada + acervo); um hi-fi da família com cenas por variante.
- "Reescreve o paginador" e "aplica a marca da campanha". Otimização de engine disfarçada de design e peça de campanha em defeso. Corte: mecanismo de medição/paginação atual; documento neutro.
- "O que defende" vira opinião editorial. Elogio/inferência de posição sem registro. Corte: defesa só com notícia datada ou trecho identificado; sem registro, lacuna.
Questões em aberto (produto)
- Onde mora "o que defende" no dossiê? Opções: A) seção própria (leitura + lista de posições/trechos com fonte), destacada também no essencial | B) diluído dentro de cada era. Recomendação: A — é a nova leitura que o humano pediu e precisa de lugar próprio e indexável. (assumido — validar no design)
- (decidido no gate, 2026-09-22: o boletim ganha "O que Solla defende" — 1–2 defesas curtas com lastro, sem linha de fonte.)
- Nome da seção? Opções: A) "O que Solla defende" | B) "O que ele diz" | C) "Posições e defesas". Recomendação: A — direto e fiel ao pedido.
- (decididos no gate 2026-09-22: um item design+análise; boletim incluído; gráficos fora; documento neutro sem marca; um hi-fi da família; índice + âncoras.)
Referências
- Dossiê real de exemplo:
docs/research/dossie-solla-cidade/miguel-calmon-2026-09-21-dossie.pdf+ companion.md(checkout principal); páginas atuais em/tmp/opencode/dossie-mc/pg-*.png. - Planos da família:
docs/plans/dossie-solla-cidade.md,docs/plans/dossie-solla-cidade-impl.mde os pares de instituição e tema. - Acervo de falas:
src/collections/Speech.ts,src/lib/speechFacets.ts(18 áreas),src/utilities/speech/speechListFilters.ts; extração read-only do recorte pelo extrator do C163. AGENTS.md(artefato gitignored, defeso);.agents/skills/plan-issue/ui-design-html.md(gate de design); GitHub Issue #1139; plano irmãodocs/plans/briefing-capacitacao-solla.md(C210).
Self-score (shaping, gate ≥4)
- Fatia = um outcome verificável? Sim — a família de dossiês/boletins relida como documento sóbrio e analítico (fez + defende), com design novo no gate. — 5/5
- Appetite declarado e a intenção cabe nele? Sim — 4–5 dias para um motor/linguagem (não três), com cortes declarados (gráficos, C163, briefing em item próprio, busca nova). — 4/5 (o "defende" com lastro e o port do boletim são os trechos que mais consomem quota).
- Persona + job + aceite claros (sem jargão de stack)? Sim — assessoria/comunicação, "achar em segundos o que fez e o que defende, com fonte e lacuna", aceite por seções e guardrails. — 5/5
- Direção no codebase é hipótese (não contrato técnico)? Sim — caminhos como pista; forma de render/paginação adiada ao impl. — 4/5 (a lista de donos e âncoras orienta o port sem prescrever solução).
- Zero decisões duras de engenharia no plano? Sim — sem schema, sem nomes de função, sem stack de chart; os literais são valores de produto/arquivo. — 5/5
Total 23/25 (média 4,6/5) — passa o gate ≥4/5.