Versionado de prompts: historial, comparar y revertir
Un buen prompt rara vez se escribe de una sola vez. Ajustas la redacción, añades una restricción, cambias un ejemplo y, tres ediciones después, el resultado es peor que al principio y sin forma clara de volver atrás. El versionado de prompts guarda una instantánea de cada cambio importante, para que puedas comparar lo que tenías con lo que tienes, restaurar la versión que de verdad funcionaba y ver qué edición marcó la diferencia en lugar de adivinar.
Cambiaste un prompt que funcionaba, la calidad bajó y necesitas revertir a la redacción exacta que tenías la semana pasada.
Dos personas editan el mismo prompt compartido y necesitas un historial que muestre quién cambió qué, cuándo y por qué.
Estás probando dos formas de redactar un prompt de sistema y quieres conservar ambas versiones en paralelo en vez de sobrescribir una.
Una actualización del modelo (por ejemplo, de Claude 3.5 a una versión más reciente) cambió el comportamiento de tu prompt y quieres bifurcar una versión específica para ese modelo sin perder la original.
Estás iterando rápido y quieres etiquetar un punto de control que sabes que funciona antes de volver a experimentar.
Errores a evitar
Sobrescribir la versión que funciona en el mismo sitio. En cuanto pegas la nueva redacción sobre la anterior, pierdes la que de verdad funcionaba. Guarda una instantánea antes de cada edición importante, no cuando ya te arrepientes.
Versionar el texto del prompt pero no el contexto que lo rodea. El modelo, la temperatura y las {variables} que rellenaste forman parte del resultado, así que regístralos en cada versión o la instantánea no se podrá reproducir.
Escribir notas vagas como «prompt mejorado». Seis versiones después no sabrás qué cambio arregló la salida en JSON. Anota qué cambiaste y por qué, no solo que algo cambió.
Tratar cada pulsación de tecla como una versión nueva. El historial se llena de ruido. Crea una versión en puntos de control reales (una redacción que probaste, un arreglo que publicaste), no cada vez que mueves una coma.
Prompts para copiar
01
Redactar una entrada de changelog
Eres un ingeniero de prompts que mantiene una biblioteca de prompts versionada. Compara la versión anterior y la nueva de mi prompt e redacta una entrada de changelog para la nueva versión. ANTERIOR: {old_prompt}. NUEVA: {new_prompt}. Da formato a la entrada así: una etiqueta de versión con versionado semántico teniendo en cuenta que la última versión fue {last_version}, un resumen de una línea, una lista con viñetas de lo que cambió y una nota sobre si el cambio rompe la compatibilidad para quien reutilice este prompt. Máximo 120 palabras y estrictamente factual. No elogies el cambio.
02
Explicar cómo se comportan dos versiones
Eres un revisor de QA de prompts. Aquí tienes dos versiones del mismo prompt. VERSIÓN A: {version_a}. VERSIÓN B: {version_b}. Supón que ambas se ejecutan con esta entrada: {test_input}. Sin ejecutar nada, predice en qué se diferenciaría la salida del modelo entre A y B, centrándote en el formato, el tono, el nivel de detalle y cualquier restricción que una imponga y la otra omita. Presenta las diferencias en una tabla con las columnas Aspecto, Versión A, Versión B. Termina con una frase que indique qué versión es más segura para publicar en {use_case} y por qué.
03
Recomendar un incremento de versión
Mantienes prompts versionados con versionado semántico (MAYOR.MENOR.PARCHE). La versión actual es {current_version}. Este es el cambio que hice: {change_description}. Decide si corresponde un incremento MAYOR, MENOR o PARCHE con estas reglas: MAYOR significa que la forma o el comportamiento de la salida cambia de un modo que rompe a los usuarios existentes; MENOR significa una nueva capacidad añadida manteniendo la compatibilidad con versiones anteriores; PARCHE significa un arreglo de redacción o claridad sin cambio de comportamiento. Responde solo con el nuevo número de versión, el tipo de incremento y una justificación de una frase.
04
Revisar un cambio antes de guardarlo
Eres un revisor meticuloso que aprueba cambios en un prompt compartido. Revisa la edición siguiente antes de que la guarde como una versión nueva. VERSIÓN ACTUAL: {current_prompt}. EDICIÓN PROPUESTA: {new_prompt}. OBJETIVO de la edición: {goal}. Comprueba si hay instrucciones que ahora se contradicen, restricciones eliminadas por error, {placeholders} que ya no se resuelven y ampliación del alcance más allá del objetivo indicado. Devuelve un veredicto de APROBAR o SOLICITAR CAMBIOS y luego una lista breve con viñetas de los problemas ordenados por gravedad. Si eliges SOLICITAR CAMBIOS, propón el arreglo más pequeño que resuelva cada problema.
05
Crear pruebas de regresión para una versión
Estás configurando pruebas de regresión para que las versiones futuras de un prompt no se rompan en silencio. Aquí tienes el prompt: {prompt}. Su función es: {intended_behavior}. Genera 6 casos de prueba que cualquier versión futura deba seguir superando. Para cada uno, indica un nombre corto, la entrada que se le da y una condición de aprobación que describa qué debe contener o qué nunca debe contener la salida. Cubre el caso normal, un caso límite con {variables} ausentes y un caso diseñado para hacer que el prompt rompa su formato de salida. Devuelve los casos como una lista numerada.
Cómo guardarlos en PromptAtlas
Crea una carpeta para cada trabajo o canal.
Añade etiquetas claras para buscar después.
Convierte los detalles cambiantes en variables.
Guarda versiones mejores en lugar de sobrescribir intentos útiles.
Exporta tu biblioteca cuando necesites una copia.
Preguntas frecuentes
¿Qué es el versionado de prompts?
El versionado de prompts consiste en guardar un historial de un prompt a medida que cambia con el tiempo, de modo que cada edición importante se convierte en una instantánea que puedes ver, comparar y restaurar. Aplica la idea del control de versiones del código a la redacción de tus prompts.
¿En qué se diferencia el versionado de prompts de simplemente guardar copias?
Guardar copias te da archivos sueltos; el versionado te da una línea de tiempo. Una herramienta de versionado vincula las instantáneas a un mismo prompt, muestra la diferencia entre ellas, registra por qué cambió cada una y te deja revertir con un clic en lugar de rebuscar entre «prompt-final-v3-de-verdad-final.txt».
¿Debería usar versionado semántico (v1.2.0) para los prompts?
Puedes, y ayuda cuando otras personas dependen del prompt. Una regla sencilla: sube el número mayor ante un cambio de comportamiento que rompe la compatibilidad, el menor cuando añades una capacidad y el de parche para ajustes de redacción. Para prompts personales, las marcas de tiempo y etiquetas cortas suelen bastar.
¿Qué debería registrar además del texto del prompt?
Registra el modelo y los ajustes para los que se escribió, una nota breve sobre qué cambió y por qué e, idealmente, una entrada de ejemplo con la salida que obtuviste. Ese contexto es lo que te permite entender por qué una versión antigua se comportaba como lo hacía cuando vuelves a ella meses después.
{A}
Crea tu biblioteca de prompts
Guarda los prompts que funcionan, añade variables, conserva versiones y encuéntralos en segundos.