# Documentos de Quov: instrucciones para agentes de IA Usa este archivo cuando produzcas un documento imprimible de Quov: una propuesta, una oferta, un alcance de trabajo, un informe o una carta. Carga primero `quov-brand.es.md` (https://quov.io/design-system/quov-brand.es.md); este archivo aplica la marca al papel y nunca la contradice. Los archivos del logo están listados en el archivo de marca y se sirven desde `https://quov.io/design-system/logo/`. Sobre papel usa `quov-mark-light.svg` (disco blanco, letras negras) o `quov-letters.svg` (solo las letras); si la herramienta solo acepta mapas de bits, el PNG de 1024 px (`quov-mark-light-1024.png`). Nunca vuelvas a dibujar el símbolo. ## Formato - **Fuente:** un solo archivo HTML autocontenido. CSS en línea, las fuentes de abajo, sin paso de compilación y sin scripts externos, salvo que el documento realmente necesite uno. - **Salida:** el lector lo imprime o lo guarda como PDF desde el navegador. - **Hoja:** carta (US Letter), 8.5 × 11 in. Márgenes de 1 in por cada lado. - **Tema:** solo papel, sea cual sea la pantalla del lector. Los documentos nunca usan el tema oscuro. - **Color:** ninguno. Texto negro, filetes grises, el símbolo en su archivo claro o solo con las letras. Sin colores semánticos, sin rellenos de resaltado, sin recuadros de color. - **Idioma:** el del cliente. Español con _tú_, inglés sin contracciones. Un documento en ambos idiomas se entrega como dos archivos completos. - **Publicación:** si un documento llega a servirse desde una URL, lleva ``. ## Tokens Los valores de papel de la paleta de Quov. Copia este bloque tal cual; nunca inventes valores. ```css :root { color-scheme: light; --background: oklch(0.95 0.02 75); /* the desk around the sheet, on screen */ --card: oklch(0.98 0.015 75); /* the sheet, on screen */ --foreground: oklch(0.18 0.01 75); /* text and the header rule of a table */ --muted-foreground: oklch(0.48 0.01 75); /* captions, running lines, table headers */ --border: oklch(0 0 0 / 10%); /* hairlines */ --font-heading: 'Aoboshi One', ui-serif, Georgia, serif; --font-sans: 'Geist', ui-sans-serif, system-ui, sans-serif; --font-mono: 'Geist Mono', ui-monospace, Menlo, monospace; } body { background: var(--background); color: var(--foreground); font: 400 10.5pt/1.5 var(--font-sans); } ``` Para herramientas que no aceptan OKLCH (un procesador de texto, software de diapositivas), los equivalentes sRGB son: background `#F7EDE0`, card `#FFF7EE`, foreground `#14110D`, muted-foreground `#615D57`, border `#DED5CA`. Fuentes desde Google Fonts: ```html ``` Con un empaquetador, los paquetes de Fontsource `@fontsource/aoboshi-one`, `@fontsource-variable/geist` y `@fontsource-variable/geist-mono` cargan las mismas familias. ## Tipografía sobre papel | Elemento | Composición | | ----------------- | ----------------------------------------------------------------------------------------- | | Título | Aoboshi One 400, 26 a 30 pt, una vez, en la primera página | | Título de sección | Aoboshi One 400, 15 a 16 pt, bajo un índice monoespaciado (`01`, `02`) | | Subtítulo | Geist 600, 11 pt | | Cuerpo | Geist 400, 10.5 pt, interlineado 1.5 | | Cifras y rótulos | Geist Mono, 9 pt, cifras tabulares: cantidades, fechas, referencias, encabezados de tabla | | Líneas corridas | Geist Mono, 7.5 pt, `--muted-foreground`: la razón social y el número de página | Aoboshi One tiene un solo peso: nunca en negrita ni en cursiva. Geist Mono nunca compone una oración. ## Estructura de página - **Primera página:** no hay portada aparte. La página abre con la firma (el símbolo y "Quov" en Aoboshi One) arriba a la izquierda y la referencia del documento en monoespaciada arriba a la derecha (por ejemplo `QV-2026-014`). Luego, con espacio generoso arriba, una línea monoespaciada con el tipo de documento y la fecha, el título y "Preparado para" con el nombre del cliente. El texto empieza bajo un filete. - **Secciones:** cada una abre con su índice monoespaciado y su título. Numera las secciones solo cuando el documento sea lo bastante largo para necesitar referencias. - **Líneas corridas:** un pie en monoespaciada de 7.5 pt con "Quov S.A.S." a la izquierda y el número de página a la derecha; las páginas interiores pueden llevar el nombre del documento arriba. - **Anexos:** cada uno empieza en una página nueva. - **Bloque de firma:** Quov S.A.S. y luego líneas en blanco para el nombre, el cargo y la fecha de quien firma, que se diligencian a mano. Nunca inventes ni escribas el nombre de una persona. ## Tablas y cifras Las tablas llevan filetes, nunca recuadros. - Celdas de encabezado en Geist Mono de 9 pt, `--muted-foreground`, sobre una regla de 1 px en `--foreground`. Filas separadas por filetes en `--border`. Sin reglas verticales, sin rellenos, sin franjas alternas. - Cifras alineadas a la derecha en Geist Mono con `font-variant-numeric: tabular-nums`. Una fila de totales en peso 600, sin recuadro. - **Cantidades:** el código de moneda y luego la cifra con comas de miles y dos decimales: `COP 12,500,000.00`, `USD 4,800.00`. El mismo formato en ambos idiomas. Indica si una cantidad incluye IVA. - **Porcentajes:** dos decimales en tablas: `5.20%`. - **Fechas:** `25 Oct 2026` en tablas; `25 de octubre de 2026` o `25 October 2026` en el texto. - **Duraciones:** en semanas. - Las afirmaciones legales o tributarias se marcan para validación por el contador o el abogado del cliente, nunca se presentan como un hecho cerrado. ## Reglas de impresión El contenido fluye; nada se corta. ```css @page { size: letter; margin: 1in; @bottom-left { content: 'Quov S.A.S.'; font: 400 7.5pt 'Geist Mono', monospace; color: oklch(0.48 0.01 75); } @bottom-right { content: counter(page) ' / ' counter(pages); font: 400 7.5pt 'Geist Mono', monospace; color: oklch(0.48 0.01 75); } } @media print { html, body { background: none; } /* the sheet is the paper */ } thead { display: table-header-group; } /* repeats on every page */ tr, figure, .keep { break-inside: avoid; } h1, h2, h3 { break-after: avoid; } .annex { break-before: page; } ``` - En pantalla, muestra la hoja como una página `--card` sobre el escritorio `--background`; al imprimir, el fondo no se imprime. - Nunca uses páginas de alto fijo con `overflow: hidden`: el texto se corta cuando el contenido crece. - Los encabezados de tabla se repiten en cada página, las filas nunca se parten y un título nunca queda solo al final de una página. ## Contenido - Di qué se entrega, cuándo y cómo se acepta cada entrega. - Indica lo que Quov necesita del cliente (contactos, accesos, contenidos, decisiones) en su propia sección. - Cierra con la vigencia de la oferta y los siguientes pasos. - Los precios aparecen solo en un documento dirigido a un cliente específico. Nunca costos internos, tarifas, márgenes ni tamaño del equipo. - Sin rayas (em dash), sin superlativos, sin promesas fuera del control de Quov, sin cifras sin fuente. ## Antes de terminar 1. Abre el archivo en un navegador y usa la vista previa de impresión: nada cortado, encabezados de tabla repetidos, ningún título huérfano, números de página presentes. 2. Verifica cada cifra contra su fuente y confirma que los totales cuadran. 3. Confirma que las fuentes cargaron (títulos en Aoboshi One, no en una serif de respaldo) y que nada en la página tiene color. 4. Relee buscando rayas, contracciones, _usted_ y nombres inventados.