# Prompt Improvement Guide — QuadShip **Propósito:** checklist que todo prompt de imagen de QuadShip debe pasar antes de llegar a la generación. Se usa manualmente hoy; cuando exista un consumidor automatizado leerá este mismo archivo sin cambios de formato. **Fuente canónica de tokens:** `02_brand_kit/QuadShip_brand_guide.html`. La extracción `QuadShip_brand_guide.md` es derivada y, ante diferencia, prevalece el HTML. Este guía es la mitad de corrección y checklist; las exclusiones están en `QuadShip_negative_prompt_block.md` y no se duplican aquí como hechos de marca. ## 1. Paleta — hex exactos | Rol | Hex | Fuente y estado | |---|---|---| | Primario | `#B4442A` | Formulario (orden 1). Aprobado; prioriza sobre CSS. | | Secundario | `#13233A` | Formulario (orden 2) y SVG. Aprobado; prioriza sobre CSS. | | Acento y enlace | `#E8714F` | CSS accent / link. Documentado como acento; no como primario. | | Fondo de página | `#1B2E47` | CSS background. | | Texto principal | `#B4C2D1` | CSS textPrimary. | | Hairline de guía | `#294765` | CSS secondary; no es secundario de marca. | No se documentan tints, shades, gradientes, transparencias, ratios ni pesos de paleta. No usar "colores de marca" sin hex. ## 2. Tipografía en imagen | Uso | Familia | Estado | Especificación | |---|---|---|---| | Display / heading | Archivo | Aprobada (CSS) | h1 89.6px, h2 64px. Pesos no documentados. | | Body | Atkinson Hyperlegible Next | Aprobada (CSS) | Body 17.92px. Pesos no documentados. | | Mono / asset | Atkinson Hyperlegible Mono | Archivo entregado sin token en CSS | Uso no documentado. No usar sin regla. | No inventar pesos, tracking, line-height ni fallbacks oficiales. Los binarios de fuente existen en `02_brand_kit/fonts` pero no se incrustan. ## 3. Qué verificar en CADA prompt de imagen - [ ] Cita los hex exactos de la sección 1 (no "colores de marca"). - [ ] Si hay texto en la imagen, especifica familia (Archivo para títulos, Atkinson Hyperlegible Next para cuerpo) y no usa Mono sin regla. - [ ] El logo, si aparece, se incorpora desde los SVG entregados y no se reconstruye ni se genera. - [ ] Composición y encuadre definidos: punto focal único y estructura clara, coherente con el carácter observado (diagramas, bloques, jerarquía). - [ ] No contradice las exclusiones de `QuadShip_negative_prompt_block.md`. - [ ] Si la pieza muestra una persona, referencia por nombre la hoja de perfil planificada correspondiente (ver sección 6); si no, no añadir personas. - [ ] No promete disponibilidad, fecha, precio, seguridad absoluta, métricas, clientes ni escasez en el texto de la imagen. - [ ] Idioma del texto en imagen: español. ## 4. Voz de marca en prompts **Palabras de tono documentadas:** no hay una lista de 3–5 palabras aprobada. El campo `voice` del formulario está vacío. Carácter observado (no aprobado como tono oficial): sobrio, técnico, de control, con franqueza sobre los límites. Implicaciones visuales observadas: - Sobrio: sin decoración orgánica ni ilustración; fondo oscuro y jerarquía clara. - Técnico: diagramas, cajas y lenguaje de sistema. - Franco: no exagerar con efectos ni promesas visuales; el acento naranja marca acción y foco. Frases de marca observadas (textuales, no confirmadas como lema): "precisión, aislamiento y calma"; "El control, en tus manos" (tagline no confirmado como oficial). ## 5. Copy en imagen - Idioma: español. - Tuteo, como en el sitio ("tu aplicación"). Observado, no regla aprobada. - Evitar textos que prometan disponibilidad o fecha, y cualquier cifra de rendimiento o uptime (el sitio las descarta). - Logo y texto: usar el SVG entregado; no generar wordmarks ni logos dentro de la imagen. - Tratamiento de precio o claims: no documentado; no se usa. ## 6. Alineación de persona | Persona planificada | Registro | Nunca | |---|---|---| | Perfil 1 · El Desarrollador Independiente que Opera su Propio Servidor (`QuadShip_DesignSheet_ElDesarrolladorIndependienteQueOperaSuPropioServidor`) | Técnico, individual, control sobre su propio servidor. | Presentarlo como cliente real o testimonio; mostrarlo con prueba social inventada. | | Perfil 2 · El Equipo Pequeño que Comparte la Responsabilidad de Operar (`QuadShip_DesignSheet_ElEquipoPequenoQueComparteLaResponsabilidadDeOperar`) | Equipo de 2 a 10 personas, reglas compartidas y trazabilidad. | Inventar roles, tamaños de empresa o cargos no documentados. | Las hojas están planificadas y no existen. No referenciarlas como adjuntas hasta que su PNG exista. No se crean personas más allá de estos dos perfiles. ## 7. Cumplimiento sectorial No hay requisitos de cumplimiento sectorial documentados para QuadShip (no es un servicio médico ni de salud; no hay claims regulados en los insumos). No se importan restricciones de otros sectores. Cualquier requisito legal o de contenido debe documentarse antes de aplicarlo; ver Huecos. ## 8. Formato y técnico - Relaciones de aspecto, tamaños en píxeles y reglas de maquetación: no documentados. - Retícula base: 4 (baseUnit). Radio de esquinas: 4px (borderRadius). Estos son tokens de sistema documentados y pueden citarse. - Logo: solo SVG entregados (`logos/QuadShip-logo-horizontal.svg`, viewBox 677.5 × 120.0; `logos/QuadShip-logo-square.svg`, viewBox 32 × 32). - Sin reglas de compositing documentadas más allá de las del logo en la guía (sin rotar, sin efectos, sin separar símbolo y wordmark en la horizontal). ## 9. Rostros y personas - No hay fotografía ni personas en los insumos actuales. La representación de personas no está documentada como requisito. - Si una pieza incluye personas, usar la hoja planificada del perfil correspondiente y no crear rostros de clientes reales ni testimonios. - No inventar requisitos de naturalismo, edad, etnia ni vestuario. ## 10. Transformaciones típicas (antes → después) _Ejemplos construidos para ilustrar correcciones basadas en tokens documentados. No son historial de prompts reales._ 1. **Antes:** "Usa los colores de marca, fondo oscuro y botón naranja." **Después:** "Fondo `#1B2E47`, superficie `#13233A`, texto `#B4C2D1`, botón primario `#B4442A`, acento `#E8714F` para foco y enlace." 2. **Antes:** "Logo de QuadShip arriba a la izquierda, con sombra suave." **Después:** "Logo horizontal de `logos/QuadShip-logo-horizontal.svg` en su versión original, sin sombra, sin efectos, sin rotación, arriba a la izquierda." 3. **Antes:** "Titular en una tipografía moderna grande que diga 'Disponible ya'." **Después:** "Titular en Archivo. Texto del titular: 'La dirección está definida. El lanzamiento, todavía no.' No mostrar fecha ni disponibilidad." ## 11. Patrones de prompt que funcionan para esta marca _Vacía en la creación. No hay prompts reales de QuadShip revisados. Completar con ejemplos reales y su procedencia (fecha o ciclo y pieza)._ ## 12. Patrones débiles conocidos para esta marca _Vacía en la creación. No hay defectos documentados en prompts ni imágenes de QuadShip. Cada hallazgo debe registrar fecha o ciclo y referencia._ ## Huecos - **Lista de tono:** no hay 3–5 palabras de voz aprobadas; el campo `voice` está vacío. La sección 4 usa carácter observado y no lo presenta como aprobado. - **Tagline:** "Tu aplicación, en línea. El control, en tus manos." proviene de la captura del sitio y no está confirmado como oficial. - **Conflictos de paleta:** CSS (`#E8714F` como primario, `#294765` como secundario) contra formulario (`#B4442A`, `#13233A`). Se prioriza el formulario; la decisión final la confirma el cliente. - **Versiones del logo:** sin versión clara, oscura ni monocroma; sin fondos permitidos; sin tamaño mínimo ni espacio libre numérico. - **Tipografía:** sin pesos, tracking, line-height, fallbacks ni uso oficial de Atkinson Hyperlegible Mono. Licencia y disponibilidad web no documentadas. - **Formatos y relaciones de aspecto:** no documentados. No hay mix de contenido ni piezas recurrentes. - **Cumplimiento:** no hay requisitos legales, sectoriales ni de contenido documentados. - **Personas:** conjunto no confirmado (`"confirmed": false`); hojas planificadas sin PNG. - **Documentos truncados:** el marketing brain y la guía declaran truncamiento de los documentos 00–07; los 05, 06 y 07 suministrados aparecen completos. Discrepancia sin resolver. - **Secciones 11 y 12:** vacías por falta de prompts reales y defectos observados. Su estado queda en Huecos hasta tener evidencia. - **Marca hermana, versión y aprobación de la guía:** no documentadas.