Contexto: archivo de reglas y MCP
Lección 20 de 26 del curso «Vibe coding». Gratis, con animaciones y un test.
El agente lo olvida todo
Ayer le explicaste al agente cómo funciona tu registro de entrenamientos. Hoy es una sesión nueva y otra vez no sabe nada. El contexto es todo lo que el agente ve en este momento: tu mensaje, los archivos abiertos y las instrucciones. Entre sesiones normalmente no recuerda nada. La solución es simple: escribir lo esencial en un archivo dentro del proyecto. El agente lo lee solo al empezar. Está a la izquierda del esquema.
AGENTS.md y sus parientes
AGENTS.md es un formato abierto: un archivo de texto simple en la raíz del proyecto, o sea, en su carpeta principal. Muchos agentes lo leen. Claude Code lee su propio CLAUDE.md, y Cursor tiene sus propios archivos de reglas. La idea es la misma: una guía para alguien nuevo en el equipo. La terminación .md significa Markdown, texto simple con títulos y listas. Puedes tener un archivo principal y en los demás solo remitir a él.
Qué escribir ahí
Las cuatro líneas del esquema son lo básico. Proyecto: una frase sobre qué es y para quién. Inicio: el comando que arranca el sitio en tu compu, por ejemplo npm run dev. Tests: el comando de pruebas, por ejemplo npm test. Nunca: claves en el código, commits directo a main. Puedes sumar estilo: «nombres claros, textos en español». Es como la nota que le dejas a quien te cubre el turno: breve y al grano.
Breve y verdadero
Un archivo de diez pantallas hace daño: se come el contexto y lo importante se pierde entre detalles. Uno que miente es peor. ¿Dice npm start, pero el proyecto arranca con npm run dev? El agente se equivocará una y otra vez. ¿Cambiaste algo en el proyecto? Actualiza el archivo o pídele al agente «actualiza AGENTS.md con lo que hicimos». Y nada de claves ahí: el archivo está en Git, y Git lo recuerda todo.
MCP: enchufes para el agente
MCP (Model Context Protocol) es una forma estándar de conectar servicios y herramientas a un agente. Como el USB: un solo tipo de conector, muchos aparatos distintos. A la derecha del esquema hay tres enchufes. GitHub: el agente lee tareas y PR. Base de datos: mira las tablas con datos. Navegador: abre tu sitio y presiona los botones solo. Cada conexión de estas se llama servidor MCP.
Conecta con cabeza
Un servidor MCP accede a todo lo que le abras. Instala solo los confiables: del propio servicio o de proyectos conocidos. Da el mínimo de permisos: a la base, solo lectura y mejor a una copia de prueba, no a los datos reales de los usuarios. La trampa: el texto que el agente lee vía MCP, como una página web, puede esconder órdenes para la IA. Por eso las acciones riesgosas las sigues aprobando tú.
Ponte a prueba
- ¿Para qué sirve el archivo AGENTS.md en un proyecto?
Respuesta correcta: El agente lo lee y conoce las reglas del proyecto. El agente olvida entre sesiones, y el archivo de reglas le da lo esencial: qué es el proyecto, cómo correrlo, qué está prohibido. Claves ahí nunca: el archivo está en Git. - ¿Qué es MCP?
Respuesta correcta: Un estándar para conectar servicios a un agente. MCP es como un USB para el agente: GitHub, una base de datos, un navegador y otras herramientas se conectan igual. - Conectas una base de datos al agente vía MCP. ¿Cómo se hace bien?
Respuesta correcta: Dar el mínimo de permisos: por ejemplo, solo lectura. Cuantos menos permisos, menos daño por un error del agente o una orden escondida. Mejor una copia de prueba que datos reales.