Brand System · material para IA

Que la IA trabaje con la marca,
no de memoria.

Todo el manual de Magoya en formato que una IA puede leer entero: prompts listos, presets por herramienta y archivos machine-readable. Se copia, se pega y se valida.

01 · Por qué existe esta página

El manual no sirve si cada uno
le explica la marca a la IA de memoria

Hoy la mitad del trabajo de marca pasa por una IA: un copy, una variante de layout, un slide, un componente. Si cada persona improvisa el contexto, la marca se degrada pieza por pieza — lima de más, un verde que no existe, un chip sólido, una foto a color. Acá está el mismo manual, pero en el formato que la herramienta necesita: pegable, descargable y con URL pública.

Un solo contexto
La misma base de marca para todos: no hay una versión buena en la cabeza de una persona y otra en la de la IA.
Listo para pegar
Prompt corto para un chat suelto, prompt completo y presets por herramienta. Nada que redactar de nuevo.
Verificable
Lo que la IA devuelve se chequea contra una lista concreta antes de usarlo. La IA propone, la marca aprueba.

Regla de fondo: la IA acelera decisiones ya tomadas — no toma decisiones de marca. Todo lo que está en esta página deriva del brand book y de BRAND.md; si hay diferencia, manda el manual.

02 · Empezar

Copiar y pegar en 30 segundos

Si solo vas a hacer una cosa de esta página, hacé esta: copiá el bloque y pegalo como primer mensaje del chat, antes de pedir nada. Sirve en cualquier herramienta — Claude, ChatGPT, Gemini, el chat que tengas a mano.

.ai/brand-prompt-short.md · prompt corto de marca 
Cargando el prompt corto…
1 · Pegar El bloque va primero, solo. Esperá que la IA confirme que lo leyó.
2 · Pedir Recién ahí el pedido, con formato, medida y destino. Mirá pedidos bien escritos.
3 · Validar Pasá la respuesta por el checklist. Si algo falla, se corrige señalando la regla.

Para trabajo sostenido (un deck entero, un repo, una campaña) no alcanza el prompt corto: cargá el preset de tu herramienta en herramientas y adjuntá BRAND.md + tokens.json.

03 · Herramientas

Configurar tu herramienta una vez

Cinco escenarios, cinco recetas. La diferencia siempre es la misma: qué archivo se adjunta y dónde se pegan las instrucciones permanentes. Hecho una vez, no se repite nunca más.

El camino más corto: un link por AI. Cada entrada le dice a esa AI qué fetchear, en qué orden y qué puede hacer al pie de la letra hoy — sin subir archivos ni pedir permisos. Copiá la instrucción y pegala donde esa herramienta guarda instrucciones permanentes (GPT, Gem, Project): con eso alcanza.

ChatGPTCustom GPT / Projects
ver
Claudeclaude.ai / Claude Code / API
ver
Geminiapp / AI Studio / Gems
ver
Cursorreglas del proyecto
ver
CopilotGitHub Copilot
ver
Cualquier otraPerplexity, API, lo que venga
ver

Detrás de todas está la misma capa: assets.json (247 assets con URL directa) y slides.json (41 módulos machine-readable) · índice completo.

Trabajo sostenido de marca

Claude Projects

Adjuntás: BRAND.md, tokens.json y .ai/checklist.md al knowledge del proyecto. Pegás: el preset en las instrucciones del proyecto.
  1. Creá un proyecto nuevo y llamalo Magoya · Marca.
  2. En Project knowledge, subí BRAND.md, tokens.json y .ai/checklist.md.
  3. Abrí Set project instructions y pegá el preset completo.
  4. Sumá al knowledge lo que uses seguido: tokens.css para código, la sección de slides para decks.
  5. Cuando salga una versión nueva del brand, reemplazá los archivos del knowledge — no acumules copias.
claude-project-instructions.md
Código con tokens reales

Claude Code

Adjuntás: nada — vive en el repo. Pegás: el preset como CLAUDE.md en la raíz del proyecto.
  1. Bajá el preset y guardalo como CLAUDE.md en la raíz del repo.
  2. Copiá tokens.css al proyecto e importalo antes de cualquier estilo propio.
  3. Si el repo ya tiene CLAUDE.md, pegá el preset como sección Marca Magoya — no lo sobrescribas.
  4. Dejá BRAND.md en el repo y referencialo desde CLAUDE.md para que lo lea cuando haga falta.
  5. Regla de oro del preset: ningún hex hardcodeado, todo por var(--token).
claude-code-CLAUDE.md
Equipo no técnico

ChatGPT / Custom GPT

Adjuntás: BRAND.md y tokens.json a Knowledge. Pegás: el preset en Instructions.
  1. Para uso suelto: pegá el prompt corto al inicio del chat y listo.
  2. Para uso de equipo: Explore GPTs → Create, nombre Magoya Brand.
  3. Pegá el preset en Instructions y subí BRAND.md + tokens.json a Knowledge.
  4. Desactivá generación de imágenes: la marca no usa imágenes generadas de personas ni de campo.
  5. Compartilo solo dentro del workspace de Magoya, nunca público.
custom-gpt-instructions.md
Editor con autocompletado

Cursor / GitHub Copilot

Adjuntás: los archivos de reglas al repo. Pegás: nada — el editor los lee solo en cada sugerencia.
  1. Cursor: bajá cursor-rule.mdc y guardalo como .cursorrules en la raíz (o como .cursor/rules/magoya.mdc).
  2. Copilot: guardá el otro preset como .github/copilot-instructions.md.
  3. Tené tokens.css en el proyecto: sin el archivo, los var(--…) quedan vacíos.
  4. Commiteá las reglas al repo — así aplican para todo el equipo, no solo para tu máquina.
  5. Revisá igual el diff: el autocompletado propone hex crudo cuando no encuentra el token.
Sin configuración

Cualquier chat (Gemini, Perplexity, un modelo del cliente)

Pegás: el prompt corto. Si la herramienta pide URL en vez de archivo: pasale llms.txt, que es el índice de todo lo demás.
  1. Pegá el prompt corto como primer mensaje y esperá confirmación.
  2. Si la herramienta puede leer web, agregá: “Leé también https://brand.magoya.com/llms.txt y los archivos que indexa.”
  3. Si el chat es largo, repetí el prompt corto cada tanto: los modelos pierden el contexto viejo.
  4. Si la herramienta es de un cliente o un tercero, pegá solo el prompt corto — no subas archivos internos de Magoya.
llms.txt
04 · Archivos

Los siete archivos machine-readable

Todo lo que una IA necesita saber de Magoya está en estos siete archivos. Cada uno tiene su URL pública porque muchas herramientas piden un link, no un adjunto.

ArchivoQué esPara qué sirve · URL públicaBajar
llms.txt Índice de la marca en texto plano, con links a todo lo demás. El primer archivo que le das a una herramienta que lee web: desde ahí encuentra el resto.https://brand.magoya.com/llms.txt bajar
BRAND.md El manual entero en Markdown: 12 secciones, de esencia a papelería. La fuente de verdad. Se adjunta al knowledge de un proyecto o se deja en el repo.https://brand.magoya.com/BRAND.md bajar
tokens.json Tokens de diseño en JSON: color, tipografía, espaciado, radios. Para que la IA use valores exactos y no aproxime colores de memoria.https://brand.magoya.com/tokens.json bajar
tokens.css Los mismos tokens como variables CSS, con los cuatro temas. Se importa en el proyecto: habilita el var(--token) en vez del hex hardcodeado.https://brand.magoya.com/tokens.css bajar
.ai/brand-prompt.md Prompt completo de marca: reglas, prohibiciones y criterios de decisión. Cuando el pedido es una pieza real y no una consulta suelta. Es el cuerpo de los presets.https://brand.magoya.com/.ai/brand-prompt.md bajar
.ai/brand-prompt-short.md La versión de un bloque, la de esta página. Para pegar al inicio de cualquier chat sin configurar nada.https://brand.magoya.com/.ai/brand-prompt-short.md bajar
.ai/checklist.md La lista de validación de lo que devuelve la IA. Se adjunta al proyecto para que la IA se auto-revise antes de entregar.https://brand.magoya.com/.ai/checklist.md bajar

Si una herramienta no logra leer una ruta que empieza con punto, usá el mirror crudo del repo: https://raw.githubusercontent.com/magoya/magoya-brand-system/main/.ai/… — el mismo archivo, sin pasar por GitHub Pages.

Los presets por herramienta viven en .ai/presets/ y se bajan desde herramientas. Assets binarios (logos, fotos, iconos) no van acá: están en la librería de assets — a una IA se le pasa la ruta del archivo, nunca se le pide que dibuje el logo.

05 · Validar

Trece chequeos antes de usar
lo que devolvió la IA

La IA propone; la marca aprueba. Pasá cada entrega por esta lista — cuando algo falla, se corrige nombrando la regla, no pidiendo “que quede más lindo”. Es la misma lista que .ai/checklist.md, que además trae cómo se verifica cada punto: adjuntala al proyecto y la IA se auto-revisa antes de contestar.

  1. Solo hex de la paleta. Cada color sale de tokens.json. Un verde “parecido” (#4CAF50, #2ECC71) es un verde que no es de Magoya.
  2. Cero naranja y cero amarillo. Ningún tono del brand viejo. Excepción única: #FFC67B, y solo como piel de personaje.
  3. Lima nunca como texto sobre claro. Sobre blanco, sage, crema o papel el verde-texto es #009145 y solo ≥24px bold.
  4. #00DE68 como texto solo sobre oscuro. Sobre fondo claro no se usa: ahí va #009145.
  5. Un solo golpe de lima. Contá CTA, display, motivo, ícono destacado y marca a mano: si hay dos en lima, sobra uno.
  6. Balance 75/25. Neutros dominan, verdes ~25%. Nunca una pieza 100% negra ni 100% verde.
  7. Manrope y tres niveles. Ninguna otra tipografía (ni Inter, ni Poppins, ni system-ui suelto) y máximo tres niveles tipográficos.
  8. Cero emojis. Solo manitos que señalan un CTA y banderas de países. Ninguno en títulos.
  9. Cero gradientes. Ni glossy, ni 3D, ni glass, ni sombras de brillo. El único permitido es el scrim verde profundo 55–86% sobre foto aérea.
  10. Máximo dos recursos gráficos además de la tipografía, y sin pares prohibidos: foto + personaje, foto + motivo, personaje + ícono.
  11. Motivo al corte. Los semicírculos nacen de un borde o de detrás de un objeto — nunca cortados flotando en el aire.
  12. Personajes sin rostro y al borde. Planos, cinco colores de la paleta cerrada, recortados por un borde del lado opuesto al texto, nunca sobre foto ni centrados como clipart.
  13. Botón vs chip, y assets reales. Botón rect radio 10px, chip pill outline; logos de clientes reales; sin resaltador sólido detrás de texto.

El archivo agrega los extras por formato (slides, redes, logo, copy, merch, fotos de personas) y la aclaración de AI en campo, que tiene manual propio y rompe tres reglas del core a propósito. Y una regla de proceso: si una entrega falla tres o más puntos, no la corrijas de a parches — volvé a pegar el prompt y rehacé el pedido con más especificación.

06 · Pedidos

El mismo pedido, flojo y bien escrito

Un pedido flojo obliga a la IA a inventar: formato, tono, color, jerarquía. Un pedido bien escrito cierra esas decisiones de antemano — y lo que vuelve se puede usar. Tres casos reales.

Flojo

Hacé un posteo para LinkedIn sobre un caso de éxito con un cliente. Que quede lindo y moderno.

Bien especificado

Pieza de feed 1:1 (1080×1080) para LinkedIn de Magoya, receta dark: fondo negro #161616, dato en lima #A2FF00 al ~70% del ancho, personaje plano recortado por el borde derecho, wordmark crema abajo-izquierda. Dato: reducción de 6 semanas a 4 días en el ciclo de reporte de un cliente de agroinsumos. Copy en español, voz senior y directa, sin adjetivos de venta, sin emojis. Máximo tres niveles tipográficos. Devolveme HTML+CSS usando var() de tokens.css.

Qué cambió: formato y medida exactos, una de las tres recetas de feed en vez de “lindo”, el dato concreto que es el contenido real de la pieza, la dosis única de lima definida, y la salida pedida en código con tokens — no una descripción que después hay que interpretar.
Flojo

Armame un slide con las métricas del proyecto. Poné los números destacados con colores.

Bien especificado

Slide de métricas 1920×1080 para el deck comercial, lienzo sage #EEF2EC, margen interior 7%. Tres cifras: 34% menos tiempo de carga de datos · 12 semanas al primer release · 4 equipos embebidos. Cifras en Manrope 800, tracking −3%, negro #161616; un solo golpe de lima en la cifra principal (subrayado, no bloque de resaltado). Kicker en MAYÚSCULAS con tracking +12%. Sin iconos decorativos, sin sombras. Título en inglés, tono neutral, sin frases grandilocuentes.

Qué cambió: “colores” pasó a ser una regla — un golpe de lima, subrayado y no resaltador. Se fijaron lienzo, margen del sistema de slides, escala tipográfica y las cifras verdaderas. Y se cerró el idioma y el tono, que es donde la IA suele irse a vendedora.
Flojo

Necesito un one-pager de Magoya para mandarle a un prospecto. Usá la info de la web.

Bien especificado

One-pager A4 vertical para un prospecto de agroinsumos en Brasil 🇧🇷, derivado del one-pager madre de pieces.html — no inventes una plantilla nueva. Estructura: wordmark verde arriba-izquierda (20% del ancho), hero “AgTech challenges demand more than code.”, las 3C (Clarity / Confidence / Commitment) en una fila, dos casos con logos reales de clientes, pie con filete verde digital y avatar m. Copy en inglés, 90 palabras por bloque como techo. Sin fotos de personas si no te paso los archivos. Neutros ~75%, un solo acento lima en el CTA.

Qué cambió: se ancló a una plantilla que ya existe en vez de dejar que invente una, se listaron los bloques en orden, se puso techo de palabras y se bloqueó de antemano el error típico: fotos o logos que la IA no tiene y termina fabricando.

Patrón de los tres: formato y medida · receta o plantilla del sistema · el contenido real · la dosis de color · idioma y tono · el formato de salida. Seis líneas y la primera entrega ya sirve.

07 · Límites

Qué resuelve sola y qué no

La IA es buenísima en lo que ya está decidido y peligrosa en lo que hay que decidir. La línea es simple: puede ejecutar y variar dentro del sistema; no puede ampliar el sistema.

Hacer — puede resolverlo sola
  • Variaciones de layout sobre una receta que ya existe: mover jerarquía, probar tres versiones del mismo slide, adaptar 1:1 a 9:16.
  • Copy en inglés y traducciones con el tono de marca: neutral, senior, sin frases grandilocuentes.
  • Código con tokens: HTML/CSS/React que consume var(--token) de tokens.css, sin un hex suelto.
  • Revisión contra el manual: pasarle una pieza y pedirle los doce chequeos de validar.
  • Trabajo de volumen: nombres de archivo, alts, metadata, tablas de assets, versiones cortas y largas de un mismo texto.
  • Estructura de contenido: ordenar un deck, resumir un caso, proponer titulares alternativos.
Evitar — no es trabajo de la IA
  • Inventar colores. La paleta está cerrada. Un verde “parecido” es un verde que no es de Magoya.
  • Dibujar o reconstruir el logo. El wordmark y los avatares son archivos: se referencian desde la librería, no se generan.
  • Generar fotos de personas del equipo. Van personas reales en B&N. Una cara sintética no es del equipo.
  • Crear plantillas nuevas de cero en vez de usar las de slides, comerciales o Magoya Studio. Si falta una plantilla, se diseña — no se improvisa por prompt.
  • Decidir reglas de marca. Si el manual no lo dice, la respuesta no es “que lo resuelva la IA”: se pregunta y se agrega al manual.
  • Poner logos de clientes que no existen o placeholders. Los logos son siempre reales.

Cuando el pedido cae del lado derecho, el camino es otro: librería de assets para archivos reales, slides y comerciales para plantillas, y Magoya Studio para producir piezas de redes con receta guardada.

La IA proponeLa marca aprueba