# Kit Digital · Guía de marca y diseño

Guía para personas y para agentes de IA que generen interfaz, imágenes o textos de Kit Digital. Versión legible por máquina: `/brand/brand.json`. Tokens: `/brand/tokens.json` y `/brand/tokens.css`. Página: https://k1t.digital/marca/

Generado desde `agents.md` del sistema de diseño (v0.2.0-piloto, 15-nov-2026). Estado: borrador pendiente de revisión de Buzz Latam y aprobación del fondo.

Reglas para agentes de diseño, código y contenido que produzcan cualquier pieza de Kit Digital (k1t.digital y app.k1t.digital).
Estado: piloto, **pendiente de revisión humana** (Buzz Latam) y **aprobación del fondo**. Fecha de corte: 15-nov-2026.
Rutas relativas a esta carpeta (publicación prevista bajo `/marca`; no publicar sin el sí escrito del fondo).

## 0. Orden de lectura y precedencia
1. Este archivo. 2. `tokens.json` (fuente de verdad de valores). 3. `tokens.css` o `exports/tailwind/tailwind.config.js` según el destino. 4. `/marca/` para ver ejemplos vivos.
Precedencia: (1) instrucción expresa del fondo; (2) este sistema para la identidad de Kit Digital; (3) reglas generales de Buzz Latam: Brandbook 3.1 y Diseño humano con IA (bóveda, sección 10). Si dos reglas chocan, gana la de número menor. Si falta un dato, escribe «pendiente» y repórtalo; no lo completes.

## 1. Color · usa solo estos valores
| Token CSS | HEX | Función | Contraste medido |
|---|---|---|---|
| `--kd-color-base-texto` | `#131313` | Texto principal | 18.58:1 sobre `#FFFFFF` |
| `--kd-color-base-fondo` | `#FFFFFF` | Fondo único | — |
| `--kd-color-base-marca` | `#781AFE` | Acción principal, enlaces, foco | 6.22:1 sobre `#FFFFFF` |
| `--kd-color-base-neutro` | `#777676` | Solo bordes de campos e íconos. **Nunca texto, ni secundario** | 4.53:1 sobre `#FFFFFF` (componente) |
| `--kd-color-derivado-texto-secundario` | `#555555` | Único texto secundario: ayudas, leyendas, metadatos, cabeceras de tabla | 7.46:1 sobre `#FFFFFF` · 6.49:1 sobre `#F4ECFF` |
| `--kd-color-funcional-error` | `#B91C1C` | Errores (único funcional) | 6.47:1 sobre `#FFFFFF` |
| `--kd-color-derivado-marca-oscuro` | `#1E0442` | Hover del primario | 18.24:1 con `#FFFFFF` |
| `--kd-color-derivado-marca-suave` | `#F4ECFF` | Fondo de etiqueta, alerta info, fila activa | texto 16.18:1 · marca 5.41:1 |
| `--kd-color-derivado-borde-suave` | `#EBDCFE` | Borde decorativo | 1.30:1 (solo decorativo) |
| `--kd-color-derivado-error-suave` | `#FFF2F2` | Fondo de alerta de error | error 5.93:1 |

**Sí**
- Usa `#FFFFFF` como fondo en el 100 % de las pantallas, secciones y documentos.
- Usa `#781AFE` como único color de marca.
- Mide todo par nuevo con `python3 scripts/contraste.py`: texto ≥ 4.5:1, componentes ≥ 3:1.
- Escribe Pantone como «aproximado» (hoy: pendiente).

**No**
- No uses `#777676` como color de texto, ni siquiera secundario. El texto secundario es `#555555`.
- No uses `#EBDCFE` como borde de input, botón, casilla ni como único límite de un control.
- No uses degradados, fondos oscuros de sección, verdes ni azules.
- No uses `#5826DC` (morado de la app) junto a `#781AFE`.
- No agregues colores fuera de la tabla.

## 2. Tipografía
- Familias: **Inter** (toda la interfaz) e **IBM Plex Mono** (referencias, códigos, metadatos). Máximo 2 familias.
- Inter es provisional: **pendiente de aprobación del fondo**. Para PDF ejecutivos rige IBM Plex Sans (Brandbook 3.1, regla 0). El choque entre ambas queda pendiente; no lo resuelvas por tu cuenta.
- Pesos: 400, 500, 600. Máximo 3. El 700 solo existe en el wordmark del logo (exento).
- Escala cerrada (px / interlineado), Decisión Buzz Latam: 12/18 · 14/22 · 16/26 · 20/28 · 24/30 · 32/40 · 48/56. No uses 18, 40 ni 55 px (valores del sitio).
- Titulares ≥ 24px: interletrado −0.02em, peso 600.
- Cuerpo: 16px, interlineado 26px. Nunca cuerpo bajo 14px; 12px solo en metadatos.
- Montos, precios y tablas: `font-variant-numeric: tabular-nums` siempre.
- **No**: serif, manuscritas, Montserrat, Poppins, BwGradual (archivo DEMO en el sitio), Roboto, Roboto Slab, Playfair Display, Caveat, Geist, JetBrains Mono.

## 3. Espaciado, grilla y forma
- Base 4px (Decisión Buzz Latam). Usa solo: 4, 8, 12, 16, 20, 24, 32, 40, 48, 64, 80, 120px.
- Contenedor 1140px · 12 columnas · medianil 24px · margen lateral 24px · quiebres 1024px y 767px.
- Radio único: 4px (Decisión Buzz Latam). Los tokens `--kd-radius-sm|md|lg|pill` se conservan por compatibilidad y todos valen 4px.
- Alto de botón e input: 48px (40px en la variante chica).
- Sin sombras ni degradados (Brandbook 3.1; Diseño humano H11). `--kd-shadow-sm|md|lg` valen `none` y solo existen por compatibilidad.

## 4. Componentes
**Botón primario**: texto exacto «Cotizar». Fondo `#781AFE`, texto `#FFFFFF`, Inter 600 16px, alto 48px, relleno horizontal 28px, radio 4px. Hover `#1E0442`. Foco: contorno 2px `#781AFE`, separación 2px. **Uno por pantalla.**
**Botón secundario**: WhatsApp u otra acción secundaria. Fondo `#FFFFFF`, borde 2px y texto `#781AFE`. Nunca con el mismo peso visual que «Cotizar». Ícono `mensaje` + texto «WhatsApp»; no dibujes el logo de WhatsApp.
**Enlace**: `#781AFE` subrayado, para acciones terciarias.
**Input**: etiqueta visible arriba (Inter 500 14px), borde 1px `#777676`, radio 4px, alto 48px. Foco: contorno 2px `#781AFE`. Error: borde 2px `#B91C1C` + ícono `alerta` + texto que diga cómo corregir.
**Tabla**: cabecera Inter 500 12px `#555555` en mayúsculas con filete inferior 1px `#131313`; filas con filete 1px `#EBDCFE`; cifras alineadas a la derecha y tabulares; referencias en IBM Plex Mono; línea «Fuente:» y «Fecha de corte:» debajo.
**Tarjeta**: fondo `#FFFFFF`, borde 1px `#EBDCFE`, radio 4px, relleno 24px, título Inter 600 20–24px, sin sombra.
**Alerta**: info = fondo `#F4ECFF` + borde izquierdo 4px `#781AFE`; error = fondo `#FFF2F2` + borde izquierdo 4px `#B91C1C`; confirmación = fondo blanco + borde 1px `#777676`. Siempre ícono + título + texto.
**Navegación**: barra blanca de 72px, filete inferior `#EBDCFE`, enlaces Inter 500 14px `#131313`, activo con subrayado 2px `#781AFE`. «Cotizar» al extremo derecho, WhatsApp a su izquierda.

## 5. Iconografía
- Usa solo `assets/icons/*.svg` (24 íconos). Grilla 24×24, área viva 20×20, trazo 1.5px, extremos y uniones redondeados, sin relleno, `currentColor`.
- Tamaños: 16px (auxiliar), 20px (botones), 24px (tarjetas, navegación).
- Ícono sin texto: `aria-label` obligatorio. No mezcles con Font Awesome ni con íconos del tema.

## 6. Logo
- Archivos: `assets/logo/kit-digital-logo-positivo.svg|png` (sobre blanco), `kit-digital-logo-negativo.svg|png` (solo sobre `#1E0442` o más oscuro), `kit-digital-simbolo-*.png`, `kit-digital-wordmark-*.svg|png`.
- Área de protección: ½ del alto del símbolo en cada lado. Mínimo en pantalla: símbolo 24px de alto, logo completo 98px de ancho.
- No deformes, rotes, recolorees, sombrees, reordenes ni reescribas el nombre con otra fuente. No amplíes el símbolo sobre 512px (es raster; vector maestro pendiente).
- No uses `logos-actuales/logos/invierte-asset-kitdigital.svg`: es una maqueta en Arial, no el logo oficial.

## 7. Contenido
- Español de El Salvador con voseo, como el sitio («Cotizá», «Escribinos»).
- Acción principal: «Cotizar». WhatsApp solo como acción secundaria.
- No menciones el servicio de comprobantes fiscales electrónicos ni a la autoridad tributaria en textos o ejemplos.
- No pongas métricas, testimonios, nombres ni logos de clientes.
- Precios: solo las cifras exactas publicadas, con su URL. En maquetas usa datos marcados «ejemplo» (p. ej. «$00.00 /mes · ejemplo»).
- Precios publicados en https://k1t.digital/#pricing (15-nov-2026): Solo $1/día · $30.41/mes · $365/año; Multi-canal $2/día · $60.83/mes · $730/año; Multi-sede $3/día · $91.25/mes · $1,095/año. app.k1t.digital publica otras cifras ($30, $60, $90, $120/mes): **pendiente de decisión del fondo**; hasta entonces no las copies.
- Nunca escribas la palabra la tercera persona del presente de «ir» (regla de Buzz Latam; la forma escrita solo aparece en agents.md del sistema) (tercera persona del presente de «ir»), ni suelta ni dentro de una frase. Reescribe con «se usa», «queda» o «irá». Revisa con `python3 scripts/qa.py`.
- Firma de Buzz Latam en documentos: solo nombres de pila.

## 8. Diseño humano (que no se note la IA)
- Cero texto dentro de imágenes generadas; todo texto es texto real.
- Cero personas generadas por IA. Máximo 1 imagen generada por pieza de marketing; en documentos ejecutivos, ninguna.
- Audita 5 categorías antes de entregar (imagen, texto, paleta por defecto, composición, redacción): se aprueba con 0 señales.
- Tu propia calificación no es aprobación. Marca la pieza «Pendiente de revisión humana».

## 9. Checklist de QA (todo «sí» o no se entrega)
- [ ] Fondos `#FFFFFF`; ningún color fuera de la sección 1.
- [ ] Contraste medido: texto ≥ 4.5:1, componentes ≥ 3:1 (`scripts/contraste.py`).
- [ ] Solo Inter e IBM Plex Mono; solo pesos 400, 500, 600.
- [ ] Tamaños de la escala 12/14/16/20/24/32/48; espaciados múltiplos de 4px de la lista; radio 4px; sin sombras.
- [ ] Un único botón primario «Cotizar» por pantalla; WhatsApp como secundario.
- [ ] Foco visible en todo control (contorno 2px `#781AFE`).
- [ ] Cifras tabulares en montos y tablas; sumas verificadas.
- [ ] Precios idénticos a la fuente con URL, o marcados «ejemplo».
- [ ] Sin servicios fiscales, métricas, testimonios ni clientes.
- [ ] Íconos solo del set; `aria-label` en íconos sin texto.
- [ ] Logo con área de protección y tamaño mínimo.
- [ ] Ortografía (tildes, eñes, signos de apertura) revisada; sin la palabra prohibida.
- [ ] Auditoría de IA con 0 señales.
- [ ] Pendientes listados, nada inventado.
- [ ] `python3 scripts/qa.py` sin fallas.
- [ ] Aprobación escrita del fondo antes de publicar.

## 10. Fuentes
- Sitio y CSS computado: https://k1t.digital/ · tema: https://k1t.digital/wp-content/themes/sastik/assets/css/style.css · fuentes del tema: https://k1t.digital/wp-content/themes/sastik/assets/css/custom-fonts.css · kit de Elementor: https://k1t.digital/wp-content/uploads/elementor/css/post-10.css · símbolo: https://k1t.digital/wp-content/uploads/2026/07/logo-icon.png
- App: https://app.k1t.digital/ · https://app.k1t.digital/build/assets/app-CGjZ2hKW.css
- Bóveda Buzz Latam › Sistema (`Bóveda Buzz Latam › Sistema › `):
  - «Brandbook en línea para agentes — investigación», sección 3.1 y regla 0 (IBM Plex Sans en PDF ejecutivos): `Bóveda Buzz Latam › Sistema › Brandbook en línea para agentes — investigación.md`.
  - «Diseño humano con IA — investigación», reglas H1–H16: `Bóveda Buzz Latam › Sistema › Diseño humano con IA — investigación.md`.
  - «Checklist previa a la aprobación» y «Plantilla de kit de marca»: `Bóveda Buzz Latam › Sistema › Checklist previa a la aprobación.md` · `Bóveda Buzz Latam › Sistema › Plantilla de kit de marca.md`.
  - «Proceso del sistema de diseño»: `Bóveda Buzz Latam › Sistema › Proceso del sistema de diseño.md`.
  - «Instrucción para Claude — configuración de diseño»: `Bóveda Buzz Latam › Sistema › Instrucción para Claude — configuración de diseño.md`.
- Tesis «Tipografía para interfaces de app: después de Helvetica» (14-nov-2026): `tesis de tipografía de Buzz Latam`.
- Decisión Buzz Latam (estándar común, 15-nov-2026): radio 4px, escala 12/14/16/20/24/32/48, espaciado en base 4.
- WCAG 2.2: https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html · https://www.w3.org/WAI/WCAG22/Understanding/non-text-contrast.html
- Formato de tokens: https://www.designtokens.org/
- Estructura de referencia: https://alg3pl.com/sistema

Prepara: Buzz Latam · Revisa: Buzz Latam · Aprueba: el fondo
