~/okil/brand/spec.v6.md·edit · 2026.05.26
mainbuild a7c3f9stable
// okil_spec.mdv6.0 stable
$ cat spec.v6.md | head -n 1

OKIL /
BRAND SPEC

// café de especialidad operado
// bajo lógica de software.
código
okil/brand
versión
v6.0 stable
autor
okilcafe.mx
fecha
2026.05.26
hash
a7c3f9d
licencia
internal · all rights
// previewF·01 carpintero
// el pájaro carpinteromarca principal
section§01philosophy

FILOSOFÍA / EL SISTEMA

El café habla solo. La marca solo se asegura de que llegue en su mejor versión. Sin vocabulario que nadie te explicó, sin adjetivos vacíos — solo buen grano, tueste preciso y ganas de compartirlo.

§01.1raíz

// nombre

Okil significa pájaro carpintero. Un animal de oficio puro: lee la madera antes del primer golpe, mide la fuerza, repite hasta que cede exactamente donde debe. Esa misma lógica aplicada al café.

// pillar 01

LEER

Antes de intervenir, entender. El carpintero lee la madera antes del primer golpe. Nosotros leemos el grano: origen, densidad, humedad, cosecha.

// pillar 02

MEDIR

Margen estricto. Controlamos el tueste al grado exacto. Un grado de más cambia todo — por eso nunca improvisamos.

// pillar 03

REPETIR

Un gran café que pasa una sola vez es suerte. Que pase siempre es el sistema. La precisión sin repetibilidad es accidente.

okil.input
$ okil --describe
name: okil  // pájaro carpintero
origin: oficio → sistema → taza
function: input(grano) → output(sabor)
philosophy: leer · medir · repetir
$ _
section§02wordmark

WORDMARK / OKIL

La marca se imprime como un bloque de código. JetBrains Mono en su peso más sólido — el peso del compilador. Tracking abierto justo lo necesario para que cada letra respire sin perder cohesión. Las dos barras // son su firma: marcan principio y fin de un comentario en casi cualquier lenguaje.

§02.1construcción

// construcción

El wordmark vive entre dos slashes // carmesí. El margen lateral mínimo equivale a la altura de la x — el x-height. Nada se acerca más.

↑ x-height = clear space↑ x-height↑ x-height↓ x-height = clear space// OKIL //
wordmark.css/* tokens */ --wm-font "JetBrains Mono", ui-monospace, monospace; --wm-weight 700; --wm-tracking 0.02em; --wm-transform uppercase; --wm-clear-min 1ex; /* equivale a la x-height */ --wm-accent "// " crimson weight 500;
§02.2escala

// escala

El wordmark funciona desde una etiqueta de bolsa hasta una fachada. Mínimo: 16px / 4mm impreso. Bajo ese tamaño, los slashes se omiten y el monospace mantiene la lectura.

//OKIL//64 px · primario
//OKIL//36 px · subtítulo
OKIL24 px · interfaz
OKIL14 px · fajilla
section§03palette

PALETA / 4 TOKENS

Cuatro colores. Ninguno opcional. Crema y papel son los planos sobre los que la marca habita. Tinta es la línea, el texto, la estructura. Carmesí es la cresta — aparece una vez por composición, nunca como decoración.

// $ink
tinta · #1D1D1D
--ink#1D1D1D
rollínea · texto
uso95%
// $cream
crema · #F2EEE3
--cream#F2EEE3
rolfondo principal
usopapel base
// $paper
papel · #EAE3D2
--paper#EAE3D2
rolsuperficies
usosecciones
// $crimson
carmesí · #D32F2F
--crimson#D32F2F
rolacento único
uso≤ 5%
palette.tokens.css/* primary tokens — versión final, no derivados */ :root { --ink #1D1D1D; // estructura, tipografía, líneas --cream #F2EEE3; // papel principal --paper #EAE3D2; // papel de cuerpo, fajillas --crimson #D32F2F; // acento crítico, cresta } /* console family — solo para fajillas operativas */ :root { --console #0E0E0E; --console-text #E6E1D4; --console-accent var(--crimson); --console-ok #3FB950; }
section§04typography

TIPOGRAFÍA / 2 FAMILIAS

Una jerarquía estricta. JetBrains Mono es la marca, los títulos, los datos, todo lo que debe leerse como código. IBM Plex Sans es la voz larga, los párrafos descriptivos, lo que no necesita parecer técnico. Ninguna otra familia entra al sistema.

displayjetbrains 700
OKIL
64–200 px
jetbrains-mono 700
tracking -0.02em
h2jetbrains 700
SECCIÓN
42 px
jetbrains-mono 700
uppercase
h3jetbrains 600
// subtítulo
24 px
jetbrains-mono 600
bodyplex sans 400
El cuerpo de párrafo respira en sans serif para no fatigar al lector.
16 px
plex-sans 400
line-height 1.6
captionjetbrains 500
// METADATOS · ETIQUETAS
11 px
jetbrains-mono 500
tracking 0.28em
codeplex mono 400
$okil --build && echo"ok"
13 px
plex-mono 400
uso: terminales
section§05families

FAMILIAS / CINCO PERFILES

Cinco bolsas estables — no por finca, sino por perfil de taza. La operación es radicalmente simple: cinco SKU en almacén, una fajilla variable por lote. Una nueva finca jamás rompe el sistema; entra en la familia que su proceso le dicta.

F·01house · blend · pilar

CARPINTERO

Blend de la casa · pilar diario.

El blend de todos los días. Equilibrado, suave, consistente. La taza que recibe a quien recién entra a la cafetería y a quien viene cada mañana.

cup· CACAO · NUEZ · CARAMELO
F·02honey · dulce · capas

VETA

Proceso honey · el grano absorbe capa a capa.

Los anillos de la veta registran capas de tiempo, agua y estación. El proceso honey reproduce esa lógica: el grano seca con parte de su pulpa, absorbiendo dulzor anillo a anillo, sin prisa.

cup· MIEL · DURAZNO · CARAMELO
F·03lavado · limpio · preciso

PLUMA

Proceso lavado · el trazo limpio.

El trazo de una pluma: ligero, preciso, sin interferencia. El proceso lavado retira toda la pulpa antes del secado — lo que queda es el grano en su forma más pura, revelando altitud, variedad y terroir sin intermediarios.

cup· CÍTRICO · ALMENDRA · TÉ BLANCO
F·04natural · fermentado · intenso

CRESTA

Proceso natural · salvaje, intenso.

Naturales y fermentaciones largas. Frutos rojos, vino, intensidad. La taza que despierta. La cresta del ave: una sola punta de color sobre toda la silueta.

cup· FRESA · VINO · FRUTOS ROJOS
F·05rare · 1/1 · exótico

VUELO

Edición rara · el ave deja la madera.

Lote rarísimo. Una vez al año. El evento: cuando el ave despega del tronco. Varietales exóticos — Gesha, Sidra, Chiroso — y procesos experimentales que sólo se sostienen en pequeñas cantidades.

cup· GESHA · SIDRA · CHIROSO
section§06anatomy

ANATOMÍA /BOLSA & FAJILLA

La bolsa pertenece a una familia. La fajilla pertenece a un lote. La identidad técnica del paquete vive impresa en masa; el dato variable del lote vive en una fajilla negra estilo consola que se imprime el día que el lote llega.

// bolsa · fijo
  • headerfamilia · sistema · gramaje
    F·02 · OKIL.SYS · 340G
  • blueprinticono de la familia con grid + crop marks + registro
  • wordmarkOKIL en monospace, flanqueado por //
  • familianombre del perfil + código VETA · F·02
// fajilla · variable
  • prompt$ okil --read-lot /chiapas-26
  • origenpaís · región · finca · productor
  • varietaltypica, bourbon, gesha, etc
  • procesolavado, honey, natural, fermentación
  • altitudmetros sobre el nivel del mar
  • tuestefecha y perfil
  • batch#0026_A — identificador único
lote.print.sh#!/usr/bin/env bash # Imprime la fajilla del lote actual en la térmica del barra. # Se ejecuta al recibir el lote, una vez por cosecha. okil --read-lot "/chiapas-26" \ --format console \ --device thermal-58 \ | awk '{print}' \ | lpr -P okil_bar [ ok ] "lote chiapas-26 impreso · #0026_A"
section§07voice

VOZ / CÓDIGO COMENTADO

La voz de Okil es la de un comentario de código bien escrito: preciso, breve, útil. Sin adjetivos sobrantes, sin lenguaje romántico, sin "experiencia inolvidable". Habla en presente. Documenta más que describe.

sí · documentar
// chiapas '26 · proceso lavado · 1450 msnm
$ extract --grind 22 --water 92°C --ratio 1:16
cup: cítrico, miel, almendra · acidez media
// el blend de la casa cambió: ver F·01 v6.1
no · adornar
una experiencia única e inolvidable de café
descubre las notas mágicas de nuestro grano
pasión, dedicación y amor en cada taza
despierta tus sentidos con sabores exóticos
una joya de la naturaleza en forma de café
el elixir que transforma tu mañana
§07.1canales

// registro por canal

El registro varía según el canal, no según el público. La voz es siempre técnica — lo que cambia es la densidad de datos.

etiqueta fajilla: // datos crudos, sin frase. batch id, origen, proceso.
instagram: // una línea técnica + silencio. sin hashtags.
menú en barra: // familia + varietal + altitud + notas de taza.
sitio web: // spec completo por lote. doc viva, versionada.
$ _
section§08constraints

RESTRICCIONES / 6 REGLAS

El sistema sobrevive por lo que se prohíbe, no por lo que se permite. Estas restricciones son contratos — si una pieza las rompe, no es Okil aunque diga "okil".

×

NO rotar el wordmark

OKIL se lee horizontal. Vertical, en círculo o inclinado deja de ser código y se vuelve decoración.

×

NO usar carmesí decorativo

El acento aparece una vez por composición. En la cresta. En el slash de un wordmark. Nunca en bloques de fondo.

×

NO mezclar familias de iconos

Los blueprints viven dentro de su marco con grid + crop marks. Sacarlos del marco destruye el sistema.

×

NO introducir nuevas tipografías

JetBrains Mono + IBM Plex Sans. Otra familia rompe la legibilidad del sistema como código.

×

NO agregar emojis ni íconos UI

El sistema usa cinco blueprints. No hay corazones, no hay tazas, no hay granos. Los símbolos son los oficiales.

×

NO inventar familias nuevas

Existen cinco. Si surge un perfil que no entra, entra al sistema como una versión de una familia existente, no como F·06.

section·license

LICENCIA / USO INTERNO

Este sistema de identidad es un activo propietario de OKIL. Su uso está estrictamente regulado por las restricciones del §08. Cualquier reproducción fuera de los parámetros aquí definidos requiere autorización escrita de Okil.

·01alcance

// alcance de uso

license.md## PERMITIDO Materiales de comunicación oficiales de OKIL Producción de empaque, fajillas y señalética Adaptaciones dentro de los parámetros de este documento Reproducción interna para operación de la cafetería ## PROHIBIDO Sublicenciamiento o cesión a terceros sin autorización escrita Modificación del wordmark, paleta o blueprints fuera de este spec Uso en materiales que no representen la marca OKIL Creación de familias adicionales (ver §08) Derivados que alteren la paleta, tipografía o sistema de familias
·02tipografías

// licencias de tipografía

fonts.license# tipografías de terceros — licencia de uso libre JetBrains Mono licencia: Apache License 2.0 autor: JetBrains s.r.o. uso en: wordmark, títulos, código, etiquetas, UI IBM Plex Sans licencia: SIL Open Font License 1.1 autor: IBM Corp. uso en: cuerpo de texto, párrafos descriptivos IBM Plex Mono licencia: SIL Open Font License 1.1 autor: IBM Corp. uso en: bloques de terminal, código de ejemplo [ ok ] "todas las tipografías permiten uso comercial sin restricción"
·03copyright

// derechos de autor

copyright.md# © 2026 okilcafe.mx · todos los derechos reservados marca: OKIL titular: okilcafe.mx registro: en trámite · México · clase 43 (servicios de café) wordmark: OKIL + sistema de doble slash // blueprints: F·01–F·05 · diseño original · © 2026 # versión de este documento spec: v6.0 stable · build a7c3f9d · 2026.05.26 autor: Okil siguiente rev: cuando se incorpore F·01 v6.1 (blend actualizado)