¿Qué son los prompts como código?

Prompts como código es la práctica de guardar cada prompt como un archivo del repositorio, con su propósito, su horario, su modelo y su dueño por escrito, para versionarlo y revisarlo igual que el resto del código. El prompt corre tal como está escrito, con un horario o dentro de un pipeline, y deja de depender de que alguien se acuerde de pedirlo.

Cómo funciona

El prompt es un archivo Markdown con un encabezado corto y un cuerpo. Yo lo llamo prompt registrado. El encabezado declara un identificador, el tipo de rutina, la cadencia con su expresión cron, la zona horaria, el modelo y el nivel de esfuerzo, la audiencia, las fuentes que puede consultar, dónde se escribe la salida, dónde se publica, el contrato que fija su formato y la persona responsable.

El cuerpo dice qué medir, en qué orden y cómo redactar. Dos reglas hacen casi todo el trabajo. Medir, no recordar: cada cifra sale de un sistema vivo y declara su ventana de tiempo, y una fuente que no respondió se reporta como tal, nunca como cero. Escribir la nota y detenerse: el prompt nunca publica solo, y una persona lee el resultado primero.

Una tarea programada abre el archivo y lo ejecuta tal cual. Cada corrida produce un archivo nuevo con el siguiente número de versión. Una versión publicada no se edita. Se publica la siguiente.

Dónde aparece en el trabajo real

Mi equipo opera un agente de IA en producción para un grupo de educación superior, y necesitábamos reportes comparables semana con semana. Registramos tres: lo que frena al proyecto, un corte del trabajo dos veces por semana y un estado completo listo para el lunes. Cada uno se publica en una sola página cuyo enlace nunca cambia, con las versiones anteriores archivadas debajo. Una tabla pequeña, el registro de rutinas, tiene una fila por rutina, y un monitor puede leerla para saber qué debería estar corriendo y qué se detuvo en silencio.

El agente mismo sigue la misma idea. Un agente es un modelo envuelto en prompts, herramientas y reglas de negocio, y cambiar cualquiera de ellos mueve su comportamiento. Por eso sus casos de prueba se versionan en el repositorio junto al código, y un cambio de comportamiento se revisa junto con el cambio en lo que se espera de él.

Qué no es

No es una colección de frases ingeniosas ni el oficio de redactar prompts. Lo que importa es el registro: un archivo, un dueño, una versión y una revisión. Tampoco significa que el prompt actúe solo. En mi práctica, una persona lee la salida antes de que se publique.

Cuándo los necesitas

Cuando la misma pregunta tiene que hacerse igual más de una vez, o cuando un prompt puede cambiar lo que hace un sistema en producción. Empieza con un prompt. Córrelo a mano dos veces para que el formato se asiente. Después prográmalo, y deja que el registro te avise cuando se detenga.

Trabajo y evidencia

Evaluation gates for a multi-agent education system (se abre en una pestaña nueva)

Mi contribución: Construcción del harness de evaluación, calibración del juez LLM, aislamiento de casos y controles por ambiente.

Qué respalda: El caso público describe casos de referencia como código, un juez LLM calibrado y el harness de evaluación que los ejecuta, sobre agentes en Google Cloud.

Qué no demuestra: La cifra de más de 700,000 estudiantes describe la población atendida por el sistema. No mide usuarios simultáneos, solicitudes por segundo ni autoría individual de toda la plataforma. El código y los datos del cliente son privados.

Fuente revisada:

Preguntas frecuentes

¿Qué modelo debe usar un prompt programado?

Se elige por el tipo de trabajo que hace el prompt. En nuestra práctica, un prompt que genera acciones, como correr pruebas, medir sistemas vivos o publicar, corre con Opus en esfuerzo alto o máximo. Uno que solo documenta o inspecciona corre con Sonnet en esfuerzo alto, y el trabajo complejo, incierto o urgente se lleva el mejor modelo disponible.

¿Cómo se versionan las salidas de un prompt registrado?

Cada corrida escribe un archivo nuevo con el siguiente número de versión, y una versión publicada nunca se edita. El reporte tiene una sola página con un enlace estable. Su cabecera dice qué versión es, qué ventana cubre, cuándo se actualizó y qué prompt la produjo, y las versiones anteriores quedan debajo como subpáginas.

¿Cómo se prueba un cambio al prompt de un agente?

Con casos que viven en el repositorio junto al código. En el sistema en el que trabajo, un cambio de comportamiento y el cambio en lo que se espera de él llegan en el mismo pull request, y una compuerta de evaluación corre en el pipeline. En integración corre un conjunto de humo, y la regresión golden completa corre antes de que QA promueva.

¿Un prompt registrado todavía necesita a una persona?

Sí. Mientras el equipo no tenga una máquina siempre encendida, una persona dispara la corrida y revisa la nota. Cuando esa máquina exista, la corrida y la publicación serán automáticas y la revisión pasará a los comentarios de la página publicada. El prompt no cambia, solo cambia quién aprieta el botón.

Disponible para puestos senior de ingeniería de IA y proyectos por contrato, en remoto para Estados Unidos, México y Latinoamérica.