Lo mínimo para no perderse en el resto del curso: qué es un agente, qué ve el modelo mientras trabaja y qué piezas se le añaden. Cada pieza tiene después su tema; aquí va solo lo justo.
El modelo (LLM) es quien escribe: recibe texto y genera texto, token a token. Un token es un trozo de palabra, unos 4 caracteres. Todo se mide en tokens: lo que cabe, lo que se paga y lo que se gasta del plan.
Tres cosas del modelo que condicionan todo lo demás:
Un agente es un modelo metido en un bucle con herramientas: decide un paso, lo hace con una herramienta, mira el resultado y vuelve a decidir, hasta terminar. Un chat te da texto; el agente actúa y ve las consecuencias: si el test falla, lee el error y corrige el código.
./mvnw test, git diff).El contexto es todo lo que ve el modelo en una petición. Como no tiene memoria, en cada turno se le manda entero:
AGENTS.md (sección 4).La ventana de contexto es lo máximo que cabe: hoy, entre 200.000 tokens y un millón según el modelo.
La conversación crece en cada turno: un fichero leído se queda dentro hasta el final de la sesión. Y cuanto más llena está la ventana, peor trabaja el modelo: se le olvida lo que se dijo al principio, mezcla instrucciones y se equivoca más. Pasa mucho antes de llegar al tope.
/clear y empieza otra vez con lo necesario.
/context, o siempre a la vista con claude-hud; OpenCode lo enseña en la cabecera de la sesión./clear. Lo de la tarea anterior solo estorba./compact: el resumen lo hace el modelo y no sabe qué era lo importante (por qué).AGENTS.md, skills y MCP ocupan sitio en todas las sesiones antes de escribir nada.Un markdown en la raíz del repositorio con las instrucciones fijas del proyecto: lo que le contarías a un compañero nuevo el primer día. Se carga entero en todas las sesiones, así que tiene que ser pequeño. Lo leen todos los agentes (Claude Code, OpenCode, Codex, Cursor…).
# Pedidos API REST de pedidos. Compilar y probar: `./mvnw verify`. - Los importes son `BigDecimal` con escala 2; nunca `double`. - Antes de crear cualquier clase, lee `.claude/skills/arquitectura/SKILL.md`.
Qué entra y qué no: AGENTS.md.
Una skill es una carpeta con un SKILL.md que le dice al agente cómo se hace una tarea concreta en tu equipo: revisar un PR, crear un endpoint, escribir una spec.
.claude/skills/revisar-pr ├── SKILL.md <- las instrucciones, con nombre y descripción arriba └── checklist.md <- material de apoyo
Del contexto solo ocupa el nombre y la descripción; el resto entra cuando la tarea encaja. Por eso se pueden tener muchas sin llenar la ventana. Cómo se escriben: Skills.
Un servidor MCP (Model Context Protocol) le da al agente herramientas nuevas: abrir un navegador y ver la página que acaba de maquetar, consultar la documentación actual de una librería, lanzar consultas a la base de datos de desarrollo. Se escribe un servidor y lo usa cualquier agente.
Cuáles se instalan y cómo: MCP.
| El problema que tienes | Lo que necesitas |
|---|---|
| «Tengo que repetirle lo mismo en cada sesión» | Una línea en AGENTS.md |
| «Cada vez lo hace distinto» | Una skill |
| «Se inventa los datos» o «no puede consultarlo» | Un servidor MCP |
| «Se llena el contexto en tareas grandes» | Un subagente |
| «No sé por dónde empieza» | Ninguna: falta especificación (SDD) |
AGENTS.md y las skills. Son ficheros de texto y arreglan la mitad de los problemas que la gente intenta resolver montando un agente. MCP cuando de verdad haya que salir fuera.