Context engineering para agents de código
Los agents no recuerdan tu proyecto; leen lo que les pones delante. Los buenos resultados vienen de lo que el modelo ve: instrucciones claras, los archivos correctos, un plan y tareas lo bastante pequeñas como para verificarlas.
Qué es
Context engineering es decidir qué entra en la del modelo y en qué forma. Más texto no es mejor: un contexto largo y ruidoso hace que el modelo pase por alto instrucciones y cuesta más. El objetivo es el contexto más pequeño que contenga todo lo necesario para hacer bien la tarea.
Un archivo de instrucciones del proyecto
La mayoría de los harnesses lee un archivo en la raíz del repositorio al inicio de cada sesión. se ha vuelto una convención común entre herramientas; Claude Code lee CLAUDE.md (que puede apuntar a AGENTS.md). Pon en él lo que un compañero nuevo y con experiencia necesitaría el primer día, y mantenlo corto.
# Notas del proyecto para agents de código
## Comandos
- Instalar: `npm ci`
- Probar (ejecutar antes de cada commit): `npm test`
- Lint y tipos: `npm run lint && npm run typecheck`
## Convenciones
- TypeScript strict. Sin `any`. Prefiere funciones pequeñas y puras.
- Acceso a la base de datos solo mediante `src/db/*`; nunca armes SQL por concatenación de strings.
- Los nuevos endpoints necesitan una verificación de autorización y una prueba de "el usuario B no puede leer los datos del usuario A".
## Límites
- No edites `infra/` ni `.github/workflows/` sin preguntar.
- Nunca leas ni imprimas `.env` ni nada dentro de `secrets/`.
- Pregunta antes de añadir una dependencia.Método de trabajo
- Planifica primero: pide un plan (muchas herramientas tienen un de solo lectura), edítalo y luego apruébalo. Corregir un plan es más barato que corregir código.
- Tareas pequeñas: un cambio por sesión o branch, con una prueba que decida el éxito. Las tareas grandes y vagas producen diffs grandes y vagos.
- Señala ejemplos: "sigue el patrón de src/users/handler.ts" vale más que un párrafo de descripción.
- Indica la verificación: dile al agent cómo comprobar su propio trabajo (ejecuta esta prueba, este linter, este comando).
- Reinicia seguido: empieza una sesión nueva cuando el contexto se alargue o el agent se confunda, llevando solo las decisiones.
- Da herramientas, no ensayos: conecta un servidor o un script para una necesidad repetida (consultar la base de datos de staging en solo lectura, abrir un ticket) en lugar de pegar datos en el chat.
Skills, hooks y subagents
Además del archivo de instrucciones, los harnesses ofrecen puntos de extensión. Las skills empaquetan un procedimiento que el agent carga solo cuando es relevante. Los hooks ejecutan tu código en momentos fijos (antes de que corra una herramienta, después de una edición), que es el lugar confiable para imponer reglas que el modelo podría olvidar, como el formato o el bloqueo de un comando peligroso. Los subagents ejecutan una tarea enfocada en su propio contexto y devuelven un resumen, lo que mantiene limpia la conversación principal. Trata todo lo que un agent pueda ejecutar como código con tus permisos y revísalo como código.
Errores comunes
- Un archivo de instrucciones gigante lleno de reglas que el agent ignora. Corto y específico gana.
- Reglas que son solo prosa. Si nunca debe ocurrir, imponlo con permisos, hooks o CI, no con una frase.
- Secretos en las instrucciones o en logs pegados.
- Dejar que el contexto se llene de intentos fallidos. Empieza de nuevo con lo que aprendiste.
- Confiar en que el agent dice que las pruebas pasan sin ejecutarlas tú mismo.
conexiones en el mapa
- Cuándo usar quées seguido porContext engineering para agents de código
- Context engineering para agents de códigoescala haciaOrquestación y agents en paralelo
- Context engineering para agents de códigodefine las verificaciones deEl loop de verificación
actualizado el 14/10/2026 · fuentes para profundizar · reportar un error
en otros dominios
- Tool callingai-agentslas herramientas y los permisos deciden lo que el agente puede hacer
Estudia antes
Desbloquea
pon a prueba lo que entendiste
Cargando preguntas…