# Metodologia de Construção de Pranchas Piloto (Padrão-Ouro) **Diretriz Operacional do Visual Guide Pipeline (v3.0.0)** *Engenharia Editorial: Execução e Validação Manual Passo a Passo Antes da Automação* --- ## 1. Princípio Fundamental: "Fazer na Mão Antes de Automatizar" A automação prematura de pipelines de inteligência artificial é a principal causa de alucinações editoriais, layouts quebrados e rejeições mecânicas em gráficas como a Amazon KDP. > **Regra de Ouro:** > *Nunca automatize um processo cujo resultado você ainda não construiu, inspecionou, refinou e aprovou manualmente com os próprios olhos.* O objetivo desta metodologia é construir **uma única Prancha Piloto Padrão-Ouro (Golden Sample)** de ponta a ponta. Somente após a aprovação visual, clínica e mecânica do PDF real dessa prancha, os critérios validados são traduzidos em prompts de IA, contratos de dados JSON e scripts automatizados nos agentes especialistas. --- ## 2. O Roteiro de Validação Manual em 6 Etapas ```mermaid flowchart TD E1["Etapa 1: Dossiê Clínico e Demanda SEO
(Fontes Oficiais SBP/OMS e Dor das 3h)"] E2["Etapa 2: Arquitetura Cognitiva e Grade A4
(Modelo A/B/C/D e Gabarito Estrutural)"] E3["Etapa 3: Redação do Copywriting Bicolor
(30 a 45 palavras por bloco e verbos no imperativo)"] E4["Etapa 4: Geração e Teste do Ativo Visual
(Prompt sem texto embutido e paleta suave)"] E5["Etapa 5: Diagramação Vetorial Híbrida
(Template HTML/CSS -> PDF 300 DPI Real)"] E6["Etapa 6: Auditoria de Pré-Voo e Conversão em Código
(Homologação e Automação do Agente)"] E1 --> E2 --> E3 --> E4 --> E5 --> E6 ``` --- ### Etapa 1: Dossiê Clínico & Demanda de Busca (Agente 1 Manual) 1. **Escolha do Tópico Crítico:** Selecionar uma situação real de alta tensão (ex.: engasgo, cólicas noturnas, banho seguro, introdução alimentar). 2. **Consulta a Órgãos Oficiais:** Extrair diretrizes e recomendações práticas diretamente de entidades de autoridade (SBP, OMS, Ministério da Saúde). Nenhuma premissa sem fonte verificável é aceita. 3. **Mapeamento da "Dor das 3h da Manhã":** Identificar a dúvida exata e urgente que pais exaustos digitam no Google ou na Amazon. --- ### Etapa 2: Arquitetura Cognitiva & Gabarito (Agente 2 Manual) 1. **Seleção do Modelo de Mancha Gráfica:** - **Modelo A (Emergência/Triagem):** $60\%$ Visual, $20\%$ Texto, $20\%$ Respiro. - **Modelo B (Rotina/Procedimento):** $45\%$ Visual, $30\%$ Texto, $25\%$ Respiro. - **Modelo C (Compêndio/Tabelas):** $50\%$ Visual, $35\%$ Texto, $15\%$ Respiro. - **Modelo D (Protocolos Somáticos/BLW):** $55\%$ Visual, $25\%$ Texto, $20\%$ Respiro. 2. **Seleção do Gabarito (`template_type`):** - `summary_grid`, `central_infographic`, `binary_comparison`, `sequential_steps` ou `rapid_triage`. 3. **Travas Geométricas A4:** Garantir formato $210 \times 297\text{ mm}$ (ou $213,2 \times 303,4\text{ mm}$ com sangria de $3,2\text{ mm}$) e *safe zone* $\ge 9,6\text{ mm}$. --- ### Etapa 3: Redação do Copywriting Bicolor (Agente 3 Manual) 1. **Título Bicolor Obrigatório:** - **Contexto (`#243832` Verde-Petróleo):** Ancoragem do problema (ex.: *"Estação de troca segura:"*). - **Gancho (`#C06845` Terracota):** Benefício memorável / regra prática (ex.: *"ergonomia inteligente e a regra de uma mão que evita quedas"*). 2. **Contagem Rígida de Palavras:** - Cada bloco de texto explicativo deve conter estritamente entre **30 e 45 palavras**. - Passos sequenciais: máximo de $25$ palavras por passo, iniciados por verbo no imperativo. - Checklists: estritamente de **3 a 7 etapas**. 3. **Leitura em $\le 5$ Segundos:** Redação sem introduções narrativas, prolixidade ou notas analíticas de rodapé. --- ### Etapa 4: Geração e Teste do Ativo Visual (Agente 4 Manual) 1. **Técnica Visual Segura:** Aquarela didática escandinava ou ilustração técnica limpa sobre fundo `#FAF4EE`. 2. **Segurança Anatômica/Neonatal:** Zero nudez, zero exposição de partes íntimas em higiene, foco em materiais, fraldas limpas abertas e mãos de apoio adulto. 3. **Isolamento de Texto:** A imagem **jamais** pode conter palavras, parágrafos ou rótulos rasterizados. Toda tipografia será vetorial. --- ### Etapa 5: Diagramação Vetorial Híbrida & PDF Real (Engine Manual) 1. **Montagem HTML/CSS/SVG:** Criar o arquivo HTML da prancha com dimensões exatas de A4. 2. **Camadas Híbridas:** - *Camada Inferior:* Imagem ilustrativa em 300 DPI. - *Camada Superior Vetorial:* Cartões com cantos arredondados ($20\text{ px}$), ícones outline, títulos bicolores e textos pesquisáveis (`Ctrl+F`). 3. **Assinatura de Rodapé:** Ramo botânico (`bottom-left`), linha fina $0,75\text{ pt}$ e fólio `—— ( XX ) ——`. 4. **Compilação do PDF:** Gerar o PDF real em 300 DPI e inspecioná-lo no visualizador em escala 100%. --- ### Etapa 6: Auditoria de Pré-Voo & Conversão em Código 1. **Inspeção do Pré-Voo:** - Contraste WCAG 2.1 AA verificado ($> 4,5:1$ no texto, $> 3,0:1$ nos títulos). - Fontes $\ge 7,0\text{ pt}$. - Margens e sangria dentro da tolerância KDP. 2. **Conversão em Automação:** - O prompt que funcionou na Etapa 4 torna-se o template padrão do `agent_4_designer.py`. - Os limites de contagem e estilo refinados na Etapa 3 tornam-se as diretrizes do `agent_3_copywriter.py`. - As regras de renderização tornam-se a engine oficial do pipeline. --- ## 3. Matriz de Aceite da Prancha Padrão-Ouro | Critério | Método de Avaliação | Limite Obrigatório | Status | | :--- | :--- | :---: | :---: | | **Compreensão Visual** | Teste de 5 segundos | Mensagem principal absorvida em $\le 5\text{ s}$ | PENDENTE | | **Contagem de Palavras** | Contagem exata | $30 \le N \le 45$ palavras por bloco | PENDENTE | | **Contraste WCAG** | Medição fotométrica | $\ge 4,5:1$ texto normal / $\ge 3,0:1$ títulos grandes | PENDENTE | | **Integridade KDP** | Verificação mecânica | Sangria $3,2\text{ mm}$, Safe Zone $\ge 9,6\text{ mm}$, 300 DPI | PENDENTE | | **Qualidade da Impressão** | PDF real gerado em disco | Arquivo legível, vetorial nítido e pesquisável | PENDENTE |