Ingeniería de prompts

Ingeniería de contexto: el 80 % del resultado

El prompt es la pregunta; el contexto es todo lo que el modelo sabe cuando la responde. Con los contextos de un millón de tokens, el reto ya no es que quepa, sino darle lo justo, ordenado y en el formato que mejor entiende.

Qué es el contexto

Todo lo que el modelo tiene delante en cada respuesta:

Instrucciones fijas: las de un Proyecto, un GPT, una skill o un fichero como CLAUDE.md o AGENTS.md.
Documentos: los que subes o los que traen las herramientas (búsqueda, conectores, MCP).
La conversación: tus mensajes y sus respuestas.
Memoria: si la aplicación la tiene activada, un resumen de lo que sabe de ti.

Cinco reglas

Lo estable, en instrucciones fijas. Quién eres, cómo escribes, tu sector y lo que nunca debe hacer van en el Proyecto o en el fichero de instrucciones, no repetido en cada mensaje.
Lo variable, en el mensaje. Lo concreto de esta tarea.
Menos y mejor. Diez documentos relevantes ganan a cien que lo son a medias: el ruido empeora las respuestas y encarece.
Con estructura. Títulos, etiquetas y una línea que diga qué es cada documento («Este es el contrato firmado; este, el borrador anterior»).
Conversaciones cortas por tarea. Cuando cambias de tema, abre otra: arrastrar una conversación larga mezcla contextos.

Instrucciones fijas que funcionan

Plantilla de instrucciones de proyecto

# Quién soy y para qué es este proyecto
[Rol, empresa o sector, y objetivo del proyecto en 2 frases.]

# Cómo quiero las respuestas
- Idioma y tono: [español de España, tú, directo].
- Extensión por defecto: [breve; amplía solo si lo pido].
- Formato: [listas y tablas cuando ayuden].

# Reglas
- Cita el documento y el apartado de donde sacas cada dato.
- Si algo no está en los documentos, dilo; no lo supongas.
- Nunca: [lo que no debe hacer].

# Documentos de este proyecto
- [nombre]: [qué es y para qué sirve].

Contexto para agentes de programación

Los agentes como Claude Code, Codex o Cursor leen un fichero de instrucciones en la raíz del repositorio. AGENTS.md es el formato abierto que entienden muchos agentes, y CLAUDE.md, el de Claude Code. Lo que más ayuda:

Los comandos para instalar, probar y arrancar.
Las convenciones del proyecto: estructura, nombres y estilo.
Las trampas: lo que parece obvio y rompe algo.
Qué no tocar y qué pedir antes de hacer.
Dónde está cada cosa (la fuente única de cada dato).

Tienes plantillas en el kit y un generador de AGENTS.md.

Memoria: útil, pero revísala

Las aplicaciones que recuerdan (ChatGPT, Claude o Gemini, según el plan y los ajustes) guardan datos tuyos entre conversaciones. Es cómodo, pero revisa de vez en cuando qué ha guardado y bórralo si hace falta. Para trabajo con datos sensibles, mejor un modo temporal o sin memoria.

Señales de que el contexto falla

Responde genérico: le falta contexto.
Se contradice o mezcla temas: le sobra o está desordenado; abre otra conversación.
Ignora una regla: está enterrada; súbela a las instrucciones fijas y hazla concreta.
Inventa datos de un documento: pídele la cita textual y el apartado.

Fuentes

Siguiente guía: Agentes, herramientas y MCP