Capstone: tu biblioteca de prompts profesional
Objetivos de este capítulo
- Estructurar una biblioteca versionada con fichas completas
- Implantar el ciclo de vida y la gobernanza de equipo
- Ensamblar todo lo aprendido en el curso en un sistema que perdura
La hora del gran ensamblaje
Nueve capítulos han llenado los bolsillos de Sofía: plantillas (capítulo 5), una asistente Plume (capítulo 6), una cadena newsletter (capítulo 7), un pipeline de extracción (capítulo 8), juegos de pruebas y un diario de versiones (capítulo 9). El problema ha cambiado de naturaleza: ya no es «cómo escribir un buen prompt», es «cómo encontrar, mantener y compartir cuarenta buenos prompts». Su nota de «prompts que funcionan» del capítulo 5 revienta por las costuras: duplicados, versiones caducadas, y la becaria que pregunta tres veces al día «¿cuál es el prompt bueno para las reseñas?».
Este capítulo capstone construye la respuesta: una biblioteca de prompts profesional — organizada, versionada, gobernada. La palabra puede sonar pomposa para una colección de textos; no lo es. Tus prompts codifican ahora semanas de iteraciones medidas: son un activo de la empresa, al mismo título que una base de conocimientos o un código fuente. Y un activo sin organización se deprecia — es incluso su pendiente natural.
La ficha de prompt: la unidad de base
Una biblioteca no es un montón de prompts: es un conjunto de fichas. La ficha empaqueta el prompt con todo lo necesario para usarlo, juzgarlo y hacerlo evolucionar sin su autor. Su contenido reúne todo el curso: la plantilla con campos {{ }} (capítulo 5), sus casos de prueba (capítulo 9), su contexto de uso, su responsable y su historial.
[FICHA — respuesta-resena-negativa — v4]
Qué: genera un borrador de respuesta a una reseña de cliente negativa, en el tono Planiresto.
Cuándo usarla: toda reseña ≤ 3 estrellas. NO para las amenazas jurídicas (→ transmitir a dirección).
Responsable: Sofía. Última actualización: 21/03.
PLANTILLA:
Eres la encargada de relación con clientes en Planiresto [...ver prompt completo...]
Reseña a tratar: {{reseña}}
Contexto eventual: {{historial del cliente, o «ninguno»}}
VALIDACIÓN: puntuación 80/90 en juego de pruebas resenas-test.md (15 entradas). Juez calibrado el 13/03.
EJEMPLO DE SALIDA EXITOSA: [pegar un ejemplo representativo]
CHANGELOG:
v4 (21/03) — ejemplos few-shot acortados + recordatorio del límite de palabras. 80/90.
v3 (18/03) — RECHAZADA: regresión en longitud.
v2 (14/03) — regla «no cuestionar la palabra del cliente». 75/90.
v1 (12/03) — versión inicial. 68/90.Cada apartado responde a una pregunta que algún día alguien hará. «Cuándo usarla» evita los usos fuera de perímetro — la causa número uno de los «tu prompt no funciona». «Validación» da la legitimidad: este prompt no es una opinión, es 80/90 en un juego de pruebas conocido. El changelog cuenta por qué la v4 es así — y le ahorra a tu sucesor volver a probar la v3 rechazada. Una ficha completa hace el prompt a prueba de orfandad: utilizable y mejorable incluso si su autor se va mañana.
Organizar: por tarea, no por técnica
¿Cómo ordenar cuarenta fichas? Por tarea de negocio, nunca por técnica. El usuario que busca piensa «tengo que responder a una reseña», no «necesito un few-shot con juez LLM». Las estanterías de Sofía: Redes sociales, Emails y newsletter, Reseñas y soporte, Datos y análisis, Interno. Cada ficha lleva un nombre orientado a la acción («respuesta-resena-negativa», «extraccion-leads-feria») — la regla del capítulo 5, convertida en convención de equipo.
En cuanto a la herramienta, la jerarquía de necesidades es simple. Solo: una carpeta de notas bien nombradas basta. En equipo: un espacio compartido (Notion, wiki, drive) con la ficha tipo como modelo obligatorio. En equipo técnico: un repositorio Git, donde cada modificación de prompt pasa por una revisión — el paralelo prompt/código se vuelve entonces literal. Sofía elige el espacio compartido: es donde el equipo ya vive. La mejor herramienta de biblioteca es la que se abre sin pensarlo.
El ciclo de vida: de la idea al archivo
Una biblioteca viva necesita estados explícitos, si no el borrador de ayer se hace pasar por la referencia de hoy. Cuatro estados bastan: borrador (en escritura, utilizable bajo tu propio riesgo), probado (pasado por un juego de pruebas, puntuación documentada), publicado (la versión de referencia, la que usa el equipo), archivado (reemplazado u obsoleto — conservado para el historial, nunca borrado: un prompt archivado documenta un callejón sin salida o una época).
flowchart LR B["Borrador: en escritura"] --> T["Probado: puntuación en juego de pruebas"] T --> P["Publicado: versión de referencia"] P --> A["Mejora propuesta"] A -->|"Vuelve a pasar el juego de pruebas"| T P --> X["Archivado: reemplazado, nunca borrado"]
La flecha más importante del diagrama es la vuelta «mejora propuesta → probado»: toda modificación de un prompt publicado vuelve a pasar el juego de pruebas antes de convertirse en la nueva referencia. Es el dique contra la degradación lenta — el compañero bienintencionado que «mejora» una formulación un martes y rompe silenciosamente los casos trampa. Con el ciclo, su mejora es bienvenida: será medida, y adoptada si gana. La evaluación del capítulo 9 no era un ejercicio: es el sistema inmunitario de la biblioteca.
La gobernanza: ligera pero real
Tres roles, no más. El responsable de ficha (su creador, por defecto): decide las modificaciones de su ficha y mantiene el changelog. La bibliotecaria — Sofía —: guarda la coherencia de conjunto, fusiona los duplicados, hace vivir la ficha tipo y anima la rutina. Los contribuidores — todo el mundo: usan, señalan los fallos (un comentario en la ficha basta) y proponen mejoras. Ninguna reunión, ningún comité: reglas de circulación, no una administración.
La rutina que sostiene el conjunto retoma la del capítulo 5, extendida al equipo: quince minutos el viernes. Cada uno traslada sus buenos prompts de la semana a borrador; la bibliotecaria repasa las señalizaciones; una ficha como mucho pasa de probado a publicado. Quince minutos — pero cada viernes. Sofía lo aprendió a su costa: la biblioteca estuvo a punto de morir en abril, cuando dos viernes saltados bastaron para que tres prompts volvieran a vivir en conversaciones privadas. La gobernanza es, ante todo, una cita cumplida.
Y cuando surge un desacuerdo — dos contribuidores convencidos de que su versión del prompt newsletter es la mejor — la biblioteca ya tiene su tribunal: el juego de pruebas. Nada de debate de opiniones en reunión: cada versión pasa las quince entradas, las puntuaciones deciden, el changelog registra. Es quizá el beneficio más subestimado de la evaluación del capítulo 9: no solo sirve para mejorar los prompts, pacifica su gobernanza.
Hacer trabajar al modelo sobre la propia biblioteca
Tu biblioteca es texto; y ahora sabes hacer analizar texto por un modelo. Bucle elegante: los prompts pueden mantener los prompts. Auditoría de coherencia, detección de duplicados, control de la ficha tipo — todo eso se delega, bajo tu supervisión:
Eres el auditor de una biblioteca de prompts de empresa. Aquí están nuestras fichas entre delimitadores:
--- FICHAS ---
{{contenido de las fichas, o la lista nombre + Qué + Cuándo usarla}}
--- FIN ---
Analiza e informa, en este orden:
1. DUPLICADOS: fichas que cubren la misma tarea — cita los nombres y la diferencia eventual.
2. CONTRADICCIONES: reglas de tono o de formato incompatibles entre fichas que deberían estar alineadas.
3. FICHAS INCOMPLETAS: apartados que faltan respecto a la ficha tipo — nombre de la ficha + apartado ausente.
4. ÁNGULOS MUERTOS: tareas recurrentes del equipo de comunicación sin ficha, según lo que las fichas existentes dejan adivinar.
Formato: 4 secciones, viñetas concisas, únicamente constataciones verificables — ninguna recomendación de reescritura.Fíjate en la última línea: el auditor constata, el humano decide — el reparto de roles de todo el curso, hasta en el mantenimiento. Sofía lanza esta auditoría cada fin de mes; la primera encontró dos duplicados y una contradicción de tono entre la ficha newsletter y la ficha LinkedIn, que ningún humano había notado.
La bibliotecaria virtual: la biblioteca que responde
Último ladrillo, y el más satisfactorio: transformar la biblioteca en interlocutora. Sofía configura un asistente dedicado — mismos mecanismos que en el capítulo 6: prompt de sistema, archivos de conocimiento — cuyo conocimiento adjunto es la exportación de las fichas publicadas (nunca los borradores), y cuya misión es orientar, no crear:
Eres la bibliotecaria de los prompts del equipo de comunicación de Planiresto. Tu conocimiento: las fichas publicadas de la biblioteca, adjuntas como archivos.
Misión: cuando se te describe una tarea, indicas LA ficha adecuada (su nombre, su «Cuándo usarla») y proporcionas su plantilla lista para rellenar, campos {{ }} incluidos.
Reglas:
- Recomiendas únicamente fichas publicadas existentes. No inventas nunca un prompt.
- Si ninguna ficha cubre la tarea, dilo y propón señalar esa carencia a Sofía — es una información valiosa, no un fracaso.
- Si dos fichas pueden valer, haz UNA pregunta para desempatar en lugar de elegir al azar.
- Recuerda sistemáticamente el perímetro de exclusión de la ficha si lo tiene, como las amenazas jurídicas para respuesta-resena-negativa.La becaria dejó de preguntar «¿cuál es el prompt bueno para las reseñas?»: la biblioteca empezó a responder sola. Y fíjate en la segunda regla, que cierra elegantemente el sistema: cada «ninguna ficha cubre esta tarea» reportado por la bibliotecaria virtual es un ángulo muerto detectado en condiciones reales — exactamente la sección 4 de la auditoría mensual, pero alimentada en continuo por el uso. La biblioteca ya no se limita a ser consultada: señala ella misma dónde debe crecer.
La palabra final: diez capítulos, una competencia
Mira el camino desde el post de LinkedIn fallido del capítulo 1. Sofía aprendió a estructurar una petición (contexto, tarea, formato), a mostrar con ejemplos, a exigir un razonamiento verificable, a encuadrar rol y salidas máquina, a capitalizar en plantillas. Luego cambió de escala: asistentes que llevan las reglas, cadenas que producen entregables enteros, pipelines que transforman el texto en datos, una evaluación que transforma la opinión en medida, y una biblioteca que transforma el conjunto en activo de equipo.
La progresión cabe en pocas palabras: del prompt al sistema. Un prompt exitoso vale una vez; una plantilla vale cada semana; una biblioteca probada y gobernada vale para todo un equipo, de forma duradera. Los modelos seguirán cambiando — tus fichas mencionarán otros nombres, tus juegos de pruebas darán otras puntuaciones. Pero la competencia que acabas de construir, formular con precisión, verificar con honestidad, capitalizar con método, es exactamente la que ganará valor a medida que estas herramientas se vuelvan más potentes. La biblioteca está abierta. Te toca escribir las fichas siguientes.
Contexto
Viernes, 14h: Sofía bloquea dos horas para fundar la biblioteca oficial del equipo de comunicación. El objetivo del capstone: estructurar el espacio, migrar los cinco mejores prompts del curso a fichas completas, hacer pasar el ciclo de vida al menos a una ficha, lanzar la primera auditoría automática, e instalar la rutina del viernes. El lunes, la becaria debe poder encontrar, comprender y usar una ficha sin hacer una sola pregunta.
Instrucciones
- Crea el espacio de tu biblioteca (notas, espacio compartido o repositorio) con 4-5 estanterías por tarea de negocio y la ficha tipo como modelo.
- Migra tus 5 mejores prompts del curso a fichas completas: Qué, Cuándo usarla, responsable, plantilla, validación, ejemplo de salida, changelog.
- Atribuye un estado a cada ficha (borrador, probado, publicado) — y haz pasar tu mejor ficha al estado publicado volviendo a pasar su juego de pruebas.
- Lanza el prompt de auditoría sobre tus fichas: trata al menos un duplicado, una contradicción o un apartado ausente detectados.
- Haz la prueba del huérfano: pide a un compañero usar una ficha publicada sin ninguna explicación oral, y anota lo que le bloqueó.
- Instala la rutina: 15 minutos recurrentes en el calendario del equipo, y designa al bibliotecario — probablemente tú.
En resumen
- Cuarenta buenos prompts plantean un nuevo problema: encontrar, mantener, compartir — la respuesta es una biblioteca, no un montón.
- La ficha es la unidad de base: qué, cuándo usarla, responsable, plantilla, validación con cifras, ejemplo de salida, changelog.
- Ordena por tarea de negocio, nunca por técnica: el usuario piensa «responder a una reseña», no «few-shot con juez».
- El ciclo de vida (borrador → probado → publicado → archivado) impone el juego de pruebas a toda modificación: es el sistema inmunitario de la biblioteca.
- Gobernanza ligera: un responsable por ficha, un bibliotecario, contribuidores — y sobre todo una rutina semanal cumplida.
- El modelo mantiene la biblioteca bajo supervisión: auditorías de duplicados y contradicciones, asistente de acogida apoyado en las fichas publicadas.
- Mide el valor en tiempo ganado y tasa de retoque, no en número de fichas.
- El hilo de los diez capítulos: del prompt al sistema — la competencia que queda cuando los modelos cambian.
Quiz — comprueba tu comprensión
1. ¿Qué contiene una ficha de prompt completa, más allá de la plantilla?
2. ¿Cómo organizar las estanterías de la biblioteca?
3. ¿Qué debe hacer toda mejora propuesta sobre un prompt publicado?
4. ¿Por qué archivar en lugar de borrar un prompt reemplazado?
5. ¿Cuál es el principal peligro que acecha a una biblioteca de equipo?
6. ¿Cómo medir el valor de la biblioteca ante la dirección?