Guidelines de la librería

Las guidelines son archivos que se añaden a una librería publicada de Figma para dar al agente de Figma el contexto que no puede deducir de los componentes ni de la documentación: tus patrones y tus antipatrones. Es la primera función de Figma pensada para escribir reglas de uso que un agente lea.

En esta página

• Qué son
• Qué archivos admite
• Qué escribir
• Un ejemplo
• Subirlas y mantenerlas
• Lo que todavía no sabemos
• En resumen

Qué son

Las guidelines dan al agente de Figma contexto sobre una librería que no puede obtener de sus elementos ni de su documentación, para que cree diseños que reflejen mejor el sistema. Pueden describir patrones establecidos y antipatrones que evitar. Se unen a una librería publicada, y cuando alguien pide al agente diseñar con esa librería, el agente las recibe automáticamente (Figma: About guidelines).

Figma las anunció en Config India 2026, junto con otras funciones para sistemas de diseño (Figma: What's new from Config India 2026).

Qué archivos admite

• Formatos: Markdown (.md), texto (.txt) o JSON (.json).
• Nombres que Figma sugiere: overview.md, guidelines.md, components.md, examples.md, anti-patterns.md, best-practices.md.
• Tamaño: de tres a ocho archivos centrados en un tema, con menos de 100 KB entre todos. El máximo por librería es de 200 KB.
• Sin repeticiones: la misma indicación en varios archivos alarga el procesamiento y el consumo de créditos.

Fuente: Figma: About guidelines.

Qué escribir

La ayuda de Figma pide centrarse en lo que el agente no puede deducir:

• Errores frecuentes y antipatrones.
• Decisiones difíciles sobre qué componente o patrón usar.
• Escenarios para las decisiones ambiguas: una descripción, un ejemplo de lo que sí, uno de lo que no y el motivo.
• Una recomendación clara. Las reglas sin excepciones se escriben como absolutas; las excepciones se describen para que no choquen con la regla.
• Huecos de la documentación: colores (roles semánticos y combinaciones que evitar), espaciado (escala y cuándo usar cada paso) y radios (qué valor va con qué componente).

Un ejemplo

# Antipatrones

## Dos acciones principales en la misma vista
- Descripción: un formulario con "Guardar" y "Publicar" como botones principales.
- Sí: "Publicar" como `Button variant=primary` y "Guardar" como `variant=secondary`.
- No: dos `Button variant=primary`.
- Motivo: la acción principal tiene que ser una sola para que se reconozca.

## Placeholder en lugar de etiqueta
- Descripción: un campo de formulario sin etiqueta visible.
- Sí: `TextField` con `label` siempre visible.
- No: el texto de la etiqueta dentro del placeholder.
- Motivo: el placeholder desaparece al escribir y no lo anuncian todos los lectores de pantalla.

Subirlas y mantenerlas

1. Abre el archivo de Figma Design que contiene la librería.
2. En el menú del archivo, ve a Library → Manage guidelines…
3. Pulsa Upload y elige los archivos.
4. Pulsa Apply changes.

Para cambiarlas, en el mismo menú, cada archivo tiene opciones para renombrarlo, sustituirlo o borrarlo; después, Apply changes. El agente deja de usar las instrucciones de los archivos borrados. Durante la beta, los archivos los creas y los subes tú; el agente puede ayudarte a redactarlos, pero no los guarda (Figma: About guidelines).

Lo que todavía no sabemos

• Si llegan por el servidor MCP. La ayuda habla del agente de Figma. La documentación del servidor MCP no menciona las guidelines (Figma: Figma MCP server). Para los agentes de código, las reglas tienen que llegar por otra vía: instrucciones para el MCP y archivos del repositorio.
• Figma Make. En Make, las guidelines se gestionan en cada archivo de Make, y las de una librería de Figma Design no se usan al crear un Make kit (Figma: About guidelines).

Fuentes

• Figma: About guidelines
• Figma: What's new from Config India 2026
• Figma: Figma MCP server