Instrucciones para agentes (prompting agents)
El lector es un modelo capaz pero sin tu contexto. Di qué debe ser cierto al final y por qué, y deja que planifique el camino: una ruta escrita para un trabajo que el modelo puede planificar se sigue fielmente, incluidos los pasos erróneos. El empaquetado varía —resumen, transferencia, skill—, pero la escritura no.
Lo esencial
Qué incluir. La prueba de la línea: ¿podría el lector deducir esto de la tarea y su entrenamiento? Los hechos que no puede buscar, las convenciones del usuario, contratos, restricciones duras y criterios de finalización no pasan la prueba y se quedan. Las rutas para trabajos planificables la pasan y se eliminan. Una lista de verificación de criterios es un estado final; una lista de pasos es una ruta.
Autocontenido. Una sesión nueva solo lee el prompt y el disco. Cada mensaje lleva el conjunto completo de reglas vigentes con los cambios aplicados en su lugar —nunca "como antes, más estos cambios"— y cada documento repite cada regla permanente de la que depende, nunca "como en el documento padre".
El porqué, expresado positivamente. El modelo generaliza a partir de razones, por lo que cada regla lleva su propia razón ("una línea continua por párrafo, porque el cuadro de chat interpreta un salto de línea como intencional"). Indica el comportamiento deseado; una prohibición arrastra el comportamiento prohibido al contexto y lo hace más accesible, por lo que solo se usa como barrera dura, acompañada del objetivo positivo. El lenguaje de presión (DEBE, CRÍTICO, mayúsculas) activa respuestas excesivas en los modelos actuales; escribe "usa X cuando…".
Palabras clave en un solo lugar, sin inoperantes. Una palabra que el modelo ya conoce (recibos, niebla de guerra, bucle cerrado) es mejor que una frase; el término propio del usuario es mejor que ambos. Cada significado vive en un solo lugar. Una frase que el lector obedece por defecto cuesta carga sin decir nada: elimina la frase, no palabras de ella.
Anatomía del prompt
- Intención — el objetivo mayor, a quién sirve, qué permite la salida; el modelo la gasta en las microdecisiones que el prompt nunca alcanza.
- Estado final — qué existe cuando se termina, con qué propiedades, y qué puede hacer ahora el usuario. Verificable y exhaustivo: "cada archivo modificado contabilizado" fuerza trabajo adicional que "genera una lista de cambios" no. El formato del entregable vive aquí; es una propiedad, no un procedimiento.
- Restricciones duras — lo inviolable: fuentes de solo lectura, presupuestos, terminología, procedencia. Las restricciones declaradas por el usuario, tal como fueron declaradas —nunca tus propios valores predeterminados de economía.
- Puntos de control — el único lugar donde la prescripción sigue siendo válida: cuándo pausar para el humano (una acción destructiva o irreversible, un cambio de alcance real, información que solo ellos poseen) y qué está fuera del alcance.
- Cláusula de libertad — licencia para reestructurar y objetar. Ante ambigüedades, toma decisiones de rutina y expón el supuesto; pregunta cuando la respuesta pueda evitar un problema posterior, como interpretaciones que lleven a trabajos materialmente diferentes o una elección costosa de deshacer. El usuario agradece esas preguntas. En una ejecución desatendida, la pregunta se convierte en una regla con un valor seguro por defecto aplicado, y el trabajo continúa.
- Comprobaciones — en cada resumen: antes de informar finalización, audita cada afirmación contra un artefacto de esta sesión, y di claramente qué no está verificado; esto elimina casi por completo los informes de estado inventados.
Los pasos ordenados tienen su lugar cuando el orden importa (una migración, un protocolo de seguridad) o cuando omitir un paso es el fallo; allí, una lista de verificación que el lector copie y marque es mejor que un texto en prosa.
Antes de enviar
¿Podría algún procedimiento numerado convertirse en una frase de estado final? ¿Cada línea restante es una restricción, punto de control, regla de verificación o especificación del entregable? ¿Alguna frase permite al lector detenerse, ralentizar o reducir el alcance por una razón que el usuario no declaró? ¿El lector habría tenido que estar en esta conversación para actuar según ella?
Ramificaciones
- Mensaje de una sola vez para un lector que puedas modelar (despacho de subagente, prompt para otra sesión, transferencia, mensaje a una IA externa) →
references/briefs.md - Resumen para una ejecución desatendida, sus memorandos de puntos de control y reglas, secuenciación bajo una ventana de cierre →
references/autonomous-runs.md - Documento duradero (skill, CLAUDE.md, documento de referencia), y cuándo pasar una construcción de skill al
skill-creatorde Anthropic →references/skills-and-docs.md - Elegir el modelo o nivel de esfuerzo del lector, o escribir para Haiku o Fable en lugar de Opus →
references/models.md