El sistema de notación

00. Aviso al lector

Este documento no es una guía de estilo. Una guía de estilo describe cómo se ve el sistema. Este documento describe qué piensa el sistema.

La distinción importa porque el oficio del Design System Architect agéntico no tiene todavía un lenguaje visual propio. Frost dejó atomic design. Curtis dejó componentes. Mall dejó frameworks. Ninguno dejó una forma de dibujar lo que hacemos. Heredamos vocabulario de la programación (diagramas UML, flowcharts) o del diseño gráfico clásico (mockups, screenshots) y los dos están equivocados para nuestro oficio. La UML es ingeniería sin diseño. El mockup es diseño sin sistema.

Necesitamos un lenguaje propio. Y necesitamos importarlo de la disciplina más antigua que practica exactamente lo que practicamos: diseño bajo restricciones honestas, con múltiples consumidores, donde la documentación es el entregable principal, y el sistema sobrevive a la mano que lo hizo. Esa disciplina es la arquitectura. No la arquitectura como metáfora (símil cómodo para ilustradores de blog) sino la arquitectura como disciplina de notación: planos, secciones, axonometrías, detalles, memorias.

El símil arquitectura-software ya existe en la industria del software y se gastó hace décadas. "El arquitecto de software hace el blueprint, los desarrolladores construyen" es el cliché que aparece en todo manual de ingeniería desde Brooks. Ese símil es estéril porque trata la arquitectura como fase previa al construir, no como disciplina permanente de pensar.

Nuestro símil es el opuesto. Tomamos la arquitectura no por su producto (el edificio) sino por su forma de notación. Lo que la arquitectura aporta al oficio del diseño agéntico no es la planificación previa. Es dibujar como forma de pensar.

Drawing is a way of thinking. I can't think or write ideas on a computer. I write and if you look at my desk, it's full of paper. So to me drawing is a form of writing, and a form of reading what I write. To me drawing is not making pretty things or making representations. It's not representing anything; it is the incarnation of the thing.

Peter Eisenman

Esa última frase es el núcleo. El plano de un edificio no representa el edificio. El plano ES el edificio en una de sus formas legítimas, igual de real que la construcción material. Un Design System Architect agéntico que dibuja su sistema no está documentando algo que existe en otro lado; está construyendo el sistema en su forma notacional.

Sin AI-slop. Sin "elevar". Sin "transformar". Este manifiesto está escrito desde el oficio para el oficio.

---

01. Por qué arquitectura y no otra disciplina

El símil debe defenderse antes de adoptarse. Cinco disciplinas se ofrecen al oficio del Design System Architect como vocabulario visual y solo una funciona.

Programación (UML, C4 model, diagramas de Mermaid). Codifica lógica de máquina, no de sistema vivo. Las cajas y flechas son inertes. No hay tensión, no hay escala, no hay materialidad. Lo que la UML hace bien (especificación técnica) ya lo hace bien la UML. No necesitamos copiarla.

Diseño gráfico clásico (mockups, screenshots, prototype shots). Codifica apariencia, no estructura. Un mockup es seductor; un sistema es honesto. Cuando un Director de Diseño consume Casos Vivos a base de screenshots, lee branding. Cuando los consume a base de notación arquitectónica, lee sistema.

Diseño industrial (renders fotorrealistas, exploded views de producto). Codifica producto seriado, no sistema vivo. Un render de IKEA muestra qué obtienes; un caso del Instituto debe mostrar cómo piensa el sistema que produce muchos productos distintos.

Ciencias (gráficos, modelos teóricos, esquemas). Codifica datos, no decisiones. Cuando un caso muestra un gráfico de barras, el lector consume métrica. Cuando muestra un plano, consume razonamiento.

Arquitectura (planos, secciones, axonometrías, detalles, memorias). Codifica decisiones bajo restricciones, en múltiples consumidores, con documentación como entregable principal. Es la disciplina que practicamos. Es el vocabulario que debemos importar.

La razón última: la arquitectura es la única disciplina que diseña sistemas que sobreviven a la mano que los hizo y que documenta esa supervivencia como parte de su práctica. Ningún design system serio puede aspirar a menos.

---

03. El kit de notación: cinco piezas mínimas

El sistema de notación del Instituto consta de cinco tipos de lámina. Cualquier caso vivo, cualquier publicación, cualquier presentación, se construye combinando estos cinco tipos. Nada más.

1. Plano (planta)

   Vista cenital del sistema completo en un momento dado. Codifica las superficies del producto como salas. Las relaciones como puertas, pasajes, muros. Los componentes principales del DS como elementos estructurales. Los tokens como cota dimensional implícita.

   Convención. Norte arriba (audiencia primaria). Escala declarada en cartela. Leyenda obligatoria con vocabulario: muro maestro, tabique móvil, hueco, vano, paso.

2. Sección

   Corte vertical del sistema mostrando capas internas. Codifica la estratificación: presentación, contrato, agente, dato, infraestructura. Revela lo que el plano oculta: qué pasa debajo de cada superficie.

   Convención. Línea de corte indicada en el plano correspondiente. Capas etiquetadas con sus nombres canónicos. Trazo más grueso en capas-monumento, fino en capas-edilizia.

3. Axonometría

   Vista isométrica 30/60° o 45° del sistema entero en su simultaneidad. Es la lámina principal del Instituto. Donde el plano da relaciones planas y la sección las verticales, la axonometría las da todas a la vez. Tomamos de Hejduk y Eisenman la axonometría exenta del sitio: el sistema se dibuja sin contexto exterior, sin paisaje, sin marca corporativa rodeándolo.

   Convención. Eje 30/60° (Drawing Matter, Rossi, Allen) o 45° (Hejduk). Líneas paralelas auténticamente paralelas. Sin sombra atmosférica. Líneas escondidas en trazo discontinuo. Cartela en esquina inferior derecha.

4. Detalle constructivo

   Encuentro entre dos componentes a escala ampliada. Codifica la junta. Cómo se ensamblan dos piezas del sistema en su punto exacto de contacto. La lámina más técnica y la que más oficio comunica.

   Convención. Escala mucho mayor (1:1 o 1:2 del sistema). Cotas explícitas. Cada elemento etiquetado con su nombre canónico (onClick handler, auth token, server action). Solo dos o tres elementos por lámina.

5. Memoria

   Documento textual estructurado en dos partes: descriptiva y justificativa. No es lámina visual sino documento. Pero forma parte del kit porque sin memoria, las láminas son ilustración. Los Casos Vivos del Instituto son memorias.

   Convención. Cuerpo en prosa periodística disciplinada. Citas literales del producto vivo entrecomilladas. Stack técnico al anexo, cuerpo en lenguaje de oficio. Cada decisión razonada con su contexto. Cada "no" tan documentado como cada "sí".

---

04. El vocabulario gráfico

El sistema de notación tiene tokens visuales propios. Como en cualquier DS, los tokens son acotados y semánticos.

Paleta cromática

Cuatro colores estructurales más tres semánticos. La paleta no se usa por familia cromática. No hay --gris-500. Cada color codifica intención.

Token	Hex	Uso
Papel	#F4F1EA	Fondo principal de toda lámina
Tinta	#0E0E0E	Trazo principal
Línea base	#1E2A28	Azul-grafito profundo para acentos estructurales
Cota	#8C7B5C	Ocre tenue para anotaciones y leyendas
Monumento	#B8541F	Ocre cinabrio Müller. Piezas que sobreviven a la edilizia
Edilizia	#A8A39A	Gris cálido tenue. Tejido ordinario
Rechazado	#3F3B36	Humo. Lo que se documenta pero no se construyó

Tipografía

Geist Sans para anotaciones, leyendas, cartelas. Geist Mono para cotas, identificadores, paths. Newsreader (serif) exclusivamente para cuerpo editorial extenso y pull-quotes en Casos Vivos. Las láminas son notación: sans riguroso, sin decoración. Las memorias justificativas son lectura larga: serif honesto.

Tomamos prestada la convención de Drawing Matter, Stan Allen Architect, Park Books para la lámina; y la disciplina editorial de Park Books y Lars Müller Publishers para la memoria.

Tamaños: cartela y leyenda 8 pt, anotaciones 9 pt, cotas 7 pt, títulos 14 pt en versalitas.

Grosor de línea

Cuatro pesos jerárquicos. La jerarquía es semántica, no decorativa. Un componente fundacional siempre se dibuja con trazo fuerte.

• Trazo fuerte (0.5 mm): contorno de monumentos. Componentes fundacionales.
• Trazo medio (0.25 mm): contorno de edilizia. Componentes ordinarios.
• Trazo fino (0.13 mm): líneas auxiliares, cotas, leyendas.
• Trazo discontinuo (dash 2-2): líneas escondidas o componentes rechazados.

Tramas y cartela

Cuatro tramas codifican estados de superficie: vacío (consumer humano), trama 45° suave (agéntica), trama densa cruzada (privada autenticada), punteado (rechazada). Cada lámina lleva cartela fija en la esquina inferior derecha con identificación completa: Instituto, caso, número de lámina, tipo (descriptiva/justificativa), escala, versión, fecha, autoría. Sin esto, la lámina no se publica.

---

07. Lo que el manifiesto rechaza

Cada manifiesto se define tanto por lo que afirma como por lo que niega. El sistema de notación del Instituto rechaza explícitamente:

• Renders fotorrealistas y mockups seductores. Codifican apariencia, no estructura. Pertenecen al marketing.
• Perspectiva con punto de fuga. Privilegia al observador humano situado. Nuestro sistema sirve también al agente que no tiene punto de vista.
• Sombras ambientales atmosféricas. Decorativas. Atmósfera no es información.
• Tipografías serif decorativas en notación. Serif pertenece al cuerpo editorial. Notación es sans riguroso.
• Color decorativo. Cada color codifica intención. No hay --azul-bonito.
• Iconografía generosa. Cuanto más vocabulario tiene un sistema de iconos, menos disciplina.
• Flechas decorativas curvadas tipo PowerPoint. Las flechas son notación, no ornamento. Si una flecha existe, codifica una relación que la leyenda declara.
• Organigramas jerárquicos. Trasladan árbol al campo. Nuestro sistema es campo, no árbol.
• Animaciones, GIFs, vídeo como notación. El movimiento es para producto, no para documentar producto. Las láminas son estáticas. La estaticidad es disciplina.
• Cualquier elemento gráfico que no pase el test de Eisenman.

---

Cierre

Construir un lenguaje visual propio para una disciplina nueva es trabajo de generación, no de proyecto. Este manifiesto es la primera versión.

Lo que sí queda fijo desde la versión 1.0:

• El oficio del Design System Architect agéntico tiene lenguaje visual propio.
• Ese lenguaje se construye importando rigurosamente la disciplina de notación arquitectónica, no su estética.
• La unidad mínima del lenguaje es la lámina (plano, sección, axonometría, detalle, memoria), no el screenshot ni el mockup.
• El propósito de la lámina es pensar, no comunicar.
• La paleta cromática, tipográfica y de trazo es semántica acotada, no estética generosa.
• Cada lámina pasa el test de Eisenman o no se publica.

El resto se afina con la práctica. La versión 2.0 del manifiesto saldrá cuando los cinco Casos Vivos tengan sus cinco axonometrías publicadas y el oficio haya tenido un año para mostrar qué funciona y qué no.

Mientras tanto, el manifiesto gobierna.

"La forma de la ciudad no es expresión de funciones cambiantes sino estructura permanente que sobrevive a las funciones que pasan por ella."

Aldo Rossi, L'architettura della città, 1966

Sustituimos "la ciudad" por "el sistema de diseño agéntico". Lo que pretendemos construir, lo que pretendemos dibujar, es exactamente eso.

---

Manifiesto del lenguaje visual · Instituto de Diseño Agéntico · Versión 1.0 · Mayo 2026
Documento fundacional. Próxima revisión: 1 año (Mayo 2027).
Autoría y dirección: Joan Arbó · institutoagentico.com