# Regras Gerais Permanentes — Visual Guide Pipeline (v3.0.0)

Este documento centraliza as diretrizes, restrições e regras mecânicas inegociáveis para a produção de Guias Visuais A4 e livros físicos Amazon KDP. Apenas regras confirmadas e consolidadas devem constar neste arquivo.

---

## 1. Engenharia Mecânica de Impressão (Amazon KDP)

1. **Formato Padrão:** A4 Retrato ($210 \times 297\text{ mm}$ ou $8.27 \times 11.69\text{ polegadas}$).
2. **Proporção da Página (Aspect Ratio):** Fixada em $0.7064$.
3. **Sangria (Bleed):** Obrigatória de $3,2\text{ mm}$ ($0.125\text{ pol}$) em topo, base e borda externa para pranchas com elementos que tocam a borda.
4. **Margem de Segurança (Safe Zone):** Mínimo absoluto de $9,6\text{ mm}$ ($0.375\text{ pol}$) a partir do corte para todos os textos e elementos críticos.
5. **Gutter (Margem Interna Progressiva):**
   - 24 a 150 páginas: mínimo $9,6\text{ mm}$ ($0.375\text{ pol}$).
   - 151 a 300 páginas: mínimo $12,7\text{ mm}$ ($0.500\text{ pol}$).
   - 301 a 500 páginas: mínimo $15,9\text{ mm}$ ($0.625\text{ pol}$).
   - Acima de 500 páginas: mínimo $20,3\text{ mm}$ ($0.800\text{ pol}$).
6. **Resolução de Imagem e Ativos:** Estritamente $300\text{ DPI}$ efetivos no tamanho final de impressão; proibido redimensionamento que degrade para menos de 300 DPI.
7. **Espessura Mínima de Linhas (Hairlines):** Linhas e traços vetoriais com espessura mínima de $0,75\text{ pt}$ ($0,26\text{ mm}$ / 3 pixels em 300 DPI) para evitar que sumam na impressão física.
8. **Texto na Lombada:** Permitido apenas para livros com 79 páginas ou mais; abaixo de 79 páginas, a lombada deve ser lisa.

---

## 2. Tipografia e Legibilidade

1. **Tamanho Mínimo de Fonte:** Nunca inferior a $7,0\text{ pt}$ para legendas, notas e avisos de rodapé.
2. **Corpo de Texto Recomendado:** $9,0\text{ pt}$ a $10,5\text{ pt}$.
3. **Títulos Principais:** Bicolores em estilo Editorial Serif contemporâneo ($24,0\text{ pt}$).
4. **Subtítulos e Seções:** Clean Sans-Serif ($14,0\text{ pt}$).
5. **Contraste Mínimo WCAG 2.1 AA:**
   - Texto normal ($< 18\text{ pt}$): razão de contraste mínima de $4,5:1$ contra o fundo.
   - Texto grande ($\ge 18\text{ pt}$ ou $\ge 14\text{ pt}$ bold): razão mínima de $3,0:1$.
   - Componentes visuais e caixas de destaque: razão mínima de $3,0:1$.

---

## 3. Copywriting e Carga Cognitiva

1. **Teto de Palavras por Bloco:** Máximo de $30$ a $45$ palavras por bloco instrucional ou cartão de conteúdo.
2. **Tempo Máximo de Ação:** Informação crítica compreensível em até $5$ segundos.
3. **Título Bicolor Obrigatório:**
   - Primeira parte (Contexto/Ação): `#243832` (Verde Floresta Escandinavo).
   - Segunda parte (Gancho/Benefício/Tempo): `#C06845` (Terracota Editorial).
4. **Voz e Tom:** Verbos no imperativo afirmativo, instrução direta, ausência de jargões herméticos ou ambíguos.
5. **Checklists e Passos:** Entre $3$ e $7$ itens ordenados de forma lógica e sequencial.

---

## 4. Rigor Científico e Conformidade de Conteúdo

1. **Zero Alucinação Científica:** Uso estrito de evidências de fontes de autoridade oficiais configuradas (ex.: SBP, OMS, Ministério da Saúde).
2. **Classificação Explícita de Evidência:** Cada orientação deve possuir nível atribuído (`CONSENSO`, `EVIDÊNCIA`, `ORIENTAÇÃO_PRÁTICA` ou `INCERTEZA`).
3. **Segurança e Proteção de Menores:** Proibição irrestrita de nudez neonatal, poses vulneráveis ou exposição íntima nas ilustrações pedagógicas.
4. **Isolamento de Texto nas Imagens de IA:** Modelos generativos nunca devem embutir texto nas ilustrações; textos são renderizados exclusivamente na camada vetorial SVG/HTML.

---

## 5. Governança e Arquitetura do Pipeline

1. **Fluxo em 10 Etapas:** Todas as pranchas passam pela StateMachine oficial de 10 etapas.
2. **Travas Fail-Fast:**
   - Etapa 3 (Copywriting): Bloqueio imediato se contagem de palavras $>45$ ou ausência de título bicolor.
   - Etapa 4 (Wireframe): Bloqueio imediato se margens ou áreas de respiro violarem safe zone KDP.
3. **Imutabilidade de Artefatos:** Agentes não reescrevem dados históricos de outros agentes sem registro explícito no manifesto.
4. **Encerramento Obrigatório:** Toda sessão deve executar o protocolo de encerramento em 6 etapas antes da conclusão.

---

## 6. Governança de Dimensionamento e Decisão de Páginas pelo Agente

1. **Autonomia com Justificativa:** O agente responsável pela arquitetura da informação (Agente 2) ou o Orquestrador tem autonomia para definir a quantidade final de páginas do guia/MVP com base no escopo temático, densidade visual e canal primário.
2. **Extensão de Referência Ideal (24 Páginas):**
   - Para o MVP de guias práticos/emergenciais (Modelo A), **24 páginas é o tamanho de referência ideal**, pois atinge a trava mecânica mínima do Amazon KDP Impresso (*Standard Color*), viabiliza versão física local e garante percepção de "manual completo" sem causar fadiga cognitiva à mãe.
   - **Flexibilidade Não-Mandatória:** O agente **não é obrigado** a cravar 24 páginas em todas as situações. O guia pode ter 16, 20, 28 páginas ou compêndios de 80 páginas, desde que a escolha seja deliberada e coerente com a finalidade.
3. **Comunicação Mandatória ao Usuário:** Sempre que o agente definir ou alterar o número de páginas de um guia, ele **deve declarar e informar explicitamente ao usuário sua decisão**, detalhando a justificativa técnica/editorial adotada (ex.: formato digital exclusivo vs. compatibilidade com impressão gráfica).

---

## 7. Arquitetura da Informação: Procedimentos de Execução vs. Conteúdo Educativo e de Ensino

1. **Princípio do Campo Visual Único (Exclusivo para Procedimentos de Execução Motora):**
   - A regra de manter o fluxo no mesmo campo visual (sem obrigar a virar a página) **aplica-se estritamente aos ciclos de execução física imediata** onde o cuidador está com as mãos ocupadas atuando no bebê (ex.: os 5 golpes interescapulares seguidos das 5 compressões torácicas no desengasgo, ou ciclos de RCP). O objetivo é puramente ergonômico e de segurança mecânica.
   - Para procedimentos de execução com alta exigência de detalhes anatômicos, deve-se priorizar a **Página Dupla Espelhada (*Spread*)**, aproveitando a visão panorâmica contínua ($420 \times 297\text{ mm}$) com o guia aberto.
2. **Liberdade de Expansão de Páginas para Conteúdo de Ensino e Orientação:**
   - O guia possui dupla finalidade: é uma ferramenta de ação em emergências e um compêndio didático de **ensino, conscientização e prevenção**.
   - Conteúdos de orientação clínica, diagnóstico diferencial, preparo de alimentos (BLW), intoxicações, prevenção de acidentes, banho seguro, sono e cuidados cotidianos **não estão restritos a uma única página**.
3. **Proibição Expressa de Compressão Mutiladora de Dados:**
   - É expressamente vedado aos agentes resumir, podar ressalvas clínicas, omitir sinais de alerta ou achatar textos explicativos apenas para forçar o conteúdo a caber em uma única página.
   - Se um tema educativo demandar múltiplos conceitos para ser claro, profundo e eficaz, o arquiteto de informação (Agente 2) e o redator (Agente 3) **devem desdobrá-lo em 2, 3 ou mais pranchas sequenciais**, garantindo integridade técnica e excelência pedagógica.

---

## 8. Governança do Painel Visual Central & Alimentação Incremental (Zero-Token)

1. **Centralização Obrigatória no Painel (`docs/painel_visual/index.html`):** Toda entrega visual do projeto (pranchas piloto, diagramações A4/Spread, ativos aprovados e PDFs 300 DPI) deve compor de modo incremental o Painel Visual Central, servindo como estante permanente de consulta e gestão editorial.
2. **Proibição de Entregas Avulsas ou Reescrita Monolítica de HTML:** É vedado entregar pranchas soltas que se percam no histórico de chat ou gastar tokens reescrevendo `docs/painel_visual/index.html` a cada nova página.
3. **Contrato Incremental Offline (`pranchas/*.json` -> `pranchas_registry.js`):** Cada nova prancha deve ser registrada como um arquivo `.json` enxuto em `docs/painel_visual/pranchas/` e sincronizada deterministicamente via `python orchestrator.py --sync-hub` (ou automaticamente no encerramento da sessão via `sync_visual_hub`), garantindo abertura direta via `file:///` sem servidor local e sem bloqueio de CORS.

---

## 9. Fronteira Estrita de Projeto e Blindagem Anti-Contaminação (Zero Contaminação Externa)

1. **Soberania e Isolamento Absoluto:** O isual-guide-pipeline é um sistema 100% autônomo, desacoplado e autocontido. É terminantemente proibido aos agentes ler pastas ou arquivos fora da raiz deste workspace (incluindo diretórios irmãos em ../ ou caminhos externos de outros projetos).
2. **Vedação de Herança e Contaminação Cruzada:** É vedado importar, inferir ou misturar regras, dados, esquemas, ativos visuais, credenciais ou lógicas originárias de outros repositórios do usuário.
3. **Higienização de Referências em Interfaces e Documentos:** Nenhuma interface web, documentação técnica, prompt de agente ou comentário de código deve referenciar, comparar ou criar links para projetos externos alheios, preservando integridade, foco operacional e governança limpa.

---

## Novas Diretrizes e Regras Consolidadas

- **[Novo - 2026-10-30]** Respeitar safe zone de 9.6 mm e limite de 45 palavras por bloco *(Origem: Sessão 2026-10-30 (preflight))*
- **[Novo - 2026-10-30]** Autonomia do Agente para definir páginas: ideal de 24 páginas para MVP sem imposição rígida, com dever de comunicação explícita e justificada ao usuário.
- **[Novo - 2026-10-31]** Regra de página única restrita a procedimentos de execução motora contínua (mãos ocupadas); liberdade total de expansão para temas de ensino, orientação e prevenção, com proibição de compressão mutiladora de dados.
- **[Novo - 2026-10-31]** Proibição absoluta de mel em menores de 12 meses mesmo em ingestão de pilha-botão (trava anti-alucinação contra botulismo infantil) e inspeção oral obrigatória antes das ventilações na RCP pós-engasgo. *(Origem: Sessão 2026-10-31 (pesquisa_e_regras_clinicas))*
- **[Novo - 2026-10-31]** Toda entrega futura de pranchas, ilustrações ou PDFs 300 DPI deve alimentar incrementalmente o Painel Visual Central via docs/painel_visual/pranchas/*.json e python orchestrator.py --sync-hub, sendo proibido entregar pranchas avulsas/isoladas *(Origem: Sessão 2026-10-31 (planejamento_visual))*

- **[Novo - 2026-10-31]** Fronteira Estrita de Projeto (Zero Contaminação Externa): isolamento total do workspace, proibição de leitura de diretórios irmãos ou repositórios alheios e higienização completa de links/menções a outros projetos *(Origem: Sessão 2026-10-31 (higienizacao_e_blindagem))*