Capa de agente
Divulgación progresiva
Por qué la documentación del sistema no se carga entera en el agente, qué piezas se cargan siempre, cuáles bajo demanda y cuáles en vivo, y cómo encaja cada una.
Última revisión:
Ya tienes Figma preparado, tokens con descripción, documentación en Markdown y componentes conectados. La capa de agente decide cómo encuentra el agente todo eso. La idea que la ordena es la divulgación progresiva: lo mínimo, siempre; el resto, cuando haga falta.
En esta página
- El contexto es un recurso limitado
- Tres momentos de carga
- Las piezas de la capa de agente
- En resumen
El contexto es un recurso limitado
Anthropic describe el contexto de un agente como un recurso finito con rendimientos decrecientes: a medida que se llena, la capacidad del modelo de recordar con precisión lo que contiene disminuye (Anthropic: Effective context engineering for AI agents). Por eso propone que los agentes mantengan referencias ligeras, como rutas de archivo, y carguen los datos en el momento en que los necesitan. Llama a eso divulgación progresiva.
Para un sistema de diseño, la consecuencia es clara: el agente no tiene que leer los cuarenta documentos de componentes al empezar. Tiene que saber que existen, dónde están y cuándo abrir cada uno.
Tres momentos de carga
Siempre
Al empezar cada sesión
- CLAUDE.md o AGENTS.md, Reglas que valen siempre y el mapa de docs/
Bajo demanda
Cuando la tarea lo pide
- Skills, Cuando la tarea coincide con su descripción
- Reglas por ruta, Al tocar archivos que coinciden
- Documentos de docs/, Cuando el agente los abre
En vivo
Cuando el agente llama a una herramienta
- MCP de Figma, Diseño, variables y Code Connect
- MCP de Storybook, Componentes, props e historias
Claude Code carga los archivos CLAUDE.md al empezar cada sesión (Claude Code: Memory). Las skills se cargan cuando la petición coincide con su descripción, o cuando se invocan con /nombre (Claude Code: Skills). Las reglas de .claude/rules/ con un campo paths se cargan solo cuando Claude trabaja con archivos que coinciden (Claude Code: Memory).
Las piezas de la capa de agente
| Pieza | Qué lleva | Página |
|---|---|---|
CLAUDE.md o AGENTS.md | Reglas no negociables, mapa de docs/, comandos | CLAUDE.md y AGENTS.md |
| Skills | Procedimientos de varios pasos: crear una pantalla, revisar una interfaz | Skills |
| Servidores MCP | Acceso en vivo a Figma y Storybook | Servidores MCP |
| Sistema publicado en Claude | El sistema para Claude Design y los chats de Claude | Claude Design |
| Project de Claude | El sistema para consultas del equipo | Projects de Claude |
Recomendación
Antes de escribir una línea en CLAUDE.md, pregúntate si el agente la necesita en todas las sesiones. Si solo la necesita para una tarea, va a una skill. Si solo para un tipo de archivo, a una regla por ruta. Si es el detalle de un componente, a su documento en docs/.
En resumen
- El contexto es limitado: el agente carga lo mínimo y abre el resto cuando lo necesita.
CLAUDE.mdse carga siempre; skills y reglas por ruta, bajo demanda; los MCP, en vivo.- Cada pieza de información va al momento de carga que le corresponde.