Especificación del Genoma
El formato JSON del Genoma 2.2, sus esquemas y sus reglas de versión.
En esta página
El Genoma es el documento JSON de una marca en Nömad: quién es la organización, cómo se ve, qué piensa y cómo habla. Es la fuente que leen Nödo, el servidor MCP y la API, y de la que salen BRAND.md, DESIGN.md, brand.json y los design tokens. Esta especificación es pública y versionada para que cualquier herramienta pueda leerlo y validarlo.
Partes
| Miembro | Qué contiene |
|---|---|
schemaVersion, revision | Versión mayor del formato y revisión del documento. Siempre presentes. |
metadata | Ficha de la organización: tipo, sector, sede, tamaño, modelos de negocio, idiomas y canales de contacto públicos. |
visualIdentity | Logotipos, colores, tipografías y manuales compuestos desde la Biblioteca de la marca. Solo lectura en el Genoma. |
strategy | La estrategia en quince secciones, escrita en el idioma principal de la marca. |
assertions | Qué datos del núcleo ha confirmado una persona (desde 2.1). |
provenance | De dónde salen la ficha y la identidad visual. |
Esquemas
JSON Schema draft 2020-12, servidos con CORS abierto. Las URL versionadas no cambian una vez publicadas; el alias sigue a la última versión 2.x.
| Documento | URL |
|---|---|
| Genoma 2.2 | https://docs.nomad.ooo/schemas/genome/v2.2.json |
| Genoma 2.x (alias estable) | https://docs.nomad.ooo/schemas/genome/v2.json |
brand.json (nomad-brand/1) | https://docs.nomad.ooo/schemas/brand/1.json |
Versiones
schemaVersionguarda solo la versión mayor (2). La versión de la especificación es mayor.menor: esta es la 2.2.- Las versiones menores solo añaden: campos opcionales, secciones o valores de enumeración nuevos. Dentro de una versión mayor nada se quita, se renombra ni cambia de tipo.
- Quitar o cambiar algo exige una versión mayor nueva, con su propio
schemaVersiony su propio esquema. - Valida con el esquema más reciente de la versión mayor del documento (el alias
v2.json). revisiones un contador por documento que sube con cada cambio guardado. Úsalo para saber si el Genoma cambió desde tu última lectura.
Cómo leerlo
- Solo
schemaVersionyrevisionestán siempre. Cualquier otro miembro puede faltar: una sección aún sin generar, un documento anterior o un extracto. Si falta, no lo inventes. - Ignora los miembros que no conozcas y trata un valor de enumeración desconocido como
otherounknown. - Una cadena vacía significa «desconocido». El literal
NO DISPONIBLEmarca un campo que se dejó sin rellenar por falta de pruebas. - Solo los datos con
assertions.<ruta>.state = confirmedson la verdad de la marca; el resto son propuestas que una persona aún no ha confirmado. - Los textos de
strategyestán enmetadata.primaryLanguage; los nombres de campo y los valores de enumeración, en inglés.
Historial
| Versión | Cambios |
|---|---|
| 2.2 | Añade, sin quitar nada: el posicionamiento de April Dunford en positioning (alternatives, uniqueAttributes con valor y prueba, bestFitCustomer) y la frase «solo nosotros» (onlyness); en verbalSystem, por qué la marca trata como trata (addressReason) y frases de ejemplo en cada extremo de las escalas de tono (toneAnchors); y provenance.generation, la copia corregida al generar. |
| 2.1 | Primera versión pública de la especificación. Incluye assertions (estado de confirmación del núcleo), la voz ejecutable de verbalSystem (address, voiceExamples, sayDontSay, conventions, channelGuide) y la oferta con nombre en commercial.offerings. |
Actualizado el 1 de enero de 1970