Cómo carga el contexto Gemini CLI realmente
Tres niveles, concatenados en orden en cada prompt. ~/.gemini/GEMINI.md contiene los valores predeterminados globales. Desde el directorio de ejecución, la CLI sube hasta la raíz del proyecto (la carpeta con .git) recopilando los archivos GEMINI.md del proyecto. Los directorios de componentes pueden añadir los suyos propios para aportar contexto local. El comando /memory show imprime el resultado ensamblado textualmente, /memory refresh vuelve a escanear tras realizar ediciones, y @file.md dentro de cualquier GEMINI.md importa otro archivo, siendo válidas tanto las rutas relativas como las absolutas.
No hay coincidencia por relevancia en este flujo de trabajo: todo lo que se encuentra se carga siempre. Esto tiene sus pros y sus contras. Las notas extensas de exploración no deben estar en GEMINI.md, pero un contrato de diseño sí, porque el diseño se aplica a cada solicitud de UI y el error de *no* cargarlo es la deriva que usted busca corregir.
El modo de error sin un contrato
Pida a Gemini CLI que cree pantallas a lo largo de varias sesiones sin un contrato escrito y volverá a decidir el lenguaje visual cada vez: un nuevo color de acento, un espaciado ligeramente distinto, otra combinación de fuentes. No es porque el modelo sea deficiente, sino porque nada mantiene sus decisiones anteriores. El valor estadístico por defecto al que recurre es el mismo que comparten todos los modelos, razón por la cual las aplicaciones de IA sin guía convergen en el mismo aspecto.
Consistency check · Ad-hoc colors
The same plan card, built two ways in Ambient Sage.
Pricing
Everything a small team needs to ship a branded UI.
Pricing
Everything a small team needs to ship a branded UI.
La configuración
- 1
Instalar los tokens de un kit
Variables CSS semánticas o un tema de Tailwind en el repo, para que los nombres de los tokens se resuelvan en valores reales que el código pueda utilizar.
- 2
Añadir DESIGN.md en la raíz del proyecto
El sistema escrito completo: qué significa cada rol de color, la escala tipográfica, el espaciado, los motivos y las reglas de lo que no se debe hacer. Este es el archivo que mantiene la identidad a través de las sesiones.
- 3
Importarlo desde el GEMINI.md del proyecto
Una sección, principalmente una línea de importación. La jerarquía hace el resto: cada prompt en el proyecto lleva ahora el contrato.
- 4
Verificar con /memory show
Ejecútelo una vez y lea la salida. Si el contenido de DESIGN.md no aparece, la ruta de importación es incorrecta, y ningún prompt solucionará lo que nunca se cargó.
# Design system
@DESIGN.md
- Use only the semantic tokens defined above; never a literal hex
value or an ad-hoc font.
- Type, spacing, and radii come from the scales in DESIGN.md.
- If a needed value has no token, stop and ask.Mantenga el archivo global fuera de él
Design contracts are per-project by nature. Put the import in the project GEMINI.md, not ~/.gemini/GEMINI.md, or every repo you open inherits one product's brand.
Opcional: MCP, para que Gemini pueda aplicar kits por sí mismo
Gemini CLI es compatible con servidores MCP a través de ~/.gemini/settings.json. Con el servidor de Identity Forge registrado, el agente puede buscar en el catálogo del kit, leer sistemas de tokens completos y escribir el archivo DESIGN.md y los tokens en el repositorio mediante una llamada a herramienta, evitando que tenga que ensamblar los archivos manualmente:
npx --yes identityforge@latest install --client geminiUn DESIGN.md completo, listo para importar
Cada kit de Identity Forge exporta el archivo del que depende esta configuración: 28 tokens semánticos en modo claro y oscuro, tipografía, espaciado, motivos y reglas para el agente.
¿Tiene Gemini CLI una funcionalidad de sistema de diseño?
No de forma nativa. El mecanismo es su jerarquía de contexto de GEMINI.md: los archivos se cargan en cada prompt y la sintaxis de importación @file.md integra un DESIGN.md directamente en ese contexto. Junto con los tokens instalados, cubre lo que haría una funcionalidad nativa.
¿Dónde se coloca el archivo GEMINI.md?
Tres niveles: ~/.gemini/GEMINI.md de forma global, un GEMINI.md en (o por encima de) el directorio de trabajo del proyecto y archivos opcionales por subdirectorio. Todos los archivos encontrados se concatenan en ese orden en cada prompt. Las reglas de diseño deben situarse en el nivel del proyecto.
¿Cómo compruebo que las reglas de diseño se hayan cargado realmente?
/memory show imprime el contexto concatenado exacto que se envía al modelo; el contenido de su DESIGN.md debería aparecer ahí. Tras editar los archivos, /memory refresh vuelve a escanear. Esta comprobación detecta casi cualquier error de configuración, que suele ser una ruta de importación incorrecta.
¿Por qué no pegar todo el sistema de diseño directamente en GEMINI.md?
Funcionaría, pero fragmentaría la fuente de verdad: el sistema viviría en dos lugares una vez que también lo necesite para otros agentes o documentación humana. Mantener DESIGN.md como el artefacto único e importarlo con @DESIGN.md garantiza que cada herramienta y cada compañero de equipo lean el mismo archivo.
¿Puede Gemini CLI aplicar un kit de Identity Forge?
Sí. Sin MCP, el comando de CLI identityforge apply <kit> escribe el DESIGN.md y los tokens en el repositorio. Con el servidor MCP registrado en ~/.gemini/settings.json, Gemini puede buscar, previsualizar y aplicar kits por sí mismo durante una sesión.