Saltar al contenido
Lección 12 de 12

Construyendo Tu Biblioteca de Prompts

9 min read

De Ad-Hoc a Sistemático

A lo largo de este curso, has aprendido técnicas para generación de código, depuración, refactorización, testing, documentación, arquitectura y flujos de trabajo multi-paso. El paso final es sistematizar estas técnicas en una biblioteca personal de prompts -- una colección reutilizable de plantillas que hace cada futura interacción con IA más rápida y efectiva.

Una biblioteca de prompts no es un documento estático. Es un kit de herramientas vivo que evoluciona con tus proyectos, tu equipo y tu creciente entendimiento de lo que funciona. Las mejores bibliotecas de prompts son pequeñas, enfocadas y mantenidas -- no colecciones completas que nadie usa.

Organizando Tu Biblioteca por Categoría

Estructura tu biblioteca de prompts alrededor de los tipos de tareas que realizas más frecuentemente. Aquí están las categorías principales para la mayoría de desarrolladores:

Generación de Código

[Nuevo Componente]
Crea un componente {{tipo_componente}} en {{ruta_archivo}}.

Props: {{listar props con tipos}}

Comportamiento:
- {{listar comportamientos clave}}

Estilos: {{enfoque CSS — Tailwind, CSS modules, etc.}}
Referencia de patron: Seguir el patron en {{archivo_referencia}}.

[Nuevo Endpoint de API]
Crea un endpoint {{metodo}} {{url}} en {{ruta_archivo}}.

Proposito: {{descripcion de una oracion}}
Autenticacion: {{requerida/opcional/ninguna}}
Validacion de entrada: {{esquema Zod o describir campos}}
Operaciones de base de datos: {{que leer/escribir}}
Respuesta: {{describir respuesta exitosa}}
Errores: {{listar casos de error con codigos de estado}}

Seguir el patron en {{archivo_endpoint_referencia}}.

Depuración

[Reporte de Bug a la IA]
Bug: {{descripcion de una oracion}}

Comportamiento actual: {{que sucede}}
Comportamiento esperado: {{que deberia suceder}}
Pasos para reproducir: {{pasos numerados}}

Mensaje de error:
{{pegar error exacto}}

Codigo relevante:
{{pegar codigo o referenciar archivo:lineas}}

Entorno: {{version de Node, SO, configuracion relevante}}
Mi hipotesis: {{lo que crees que esta mal}}

Refactorización

[Solicitud de Refactorizacion]
Refactoriza {{ruta_archivo}} para {{estado objetivo}}.

Estado actual: {{describir lo que existe}}
Estado objetivo: {{describir resultado deseado}}

Restricciones:
- NO cambiar: {{areas protegidas}}
- Debe pasar: {{tests existentes}}
- Seguir patron: {{archivo referencia}}

Entregar como: {{un solo commit / paso a paso / solo diff}}

Testing

[Generacion de Tests]
Escribe tests {{tipo_test}} para {{funcion/clase}} en {{ruta_archivo}}.
Framework: {{Vitest/Jest/pytest/etc.}}

Casos de test:
1. {{descripcion del caso}} — Entrada: {{entrada}}, Esperado: {{salida}}
2. {{descripcion del caso}} — Entrada: {{entrada}}, Esperado: {{salida}}
3. {{descripcion del caso}} — Verificar: se lanza {{tipo_error}}

Casos extremos a incluir:
- {{caso extremo 1}}
- {{caso extremo 2}}

Mock: {{listar dependencias externas a mockear}}
Referencia de patron: {{archivo de test existente}}

Documentación

[Docs de API]
Genera documentacion de API para {{ruta_archivo}}.

Para cada endpoint:
- Metodo, URL, descripcion
- Requisitos de autenticacion
- Esquema de request/response con ejemplos
- Respuestas de error

Estilo: {{Markdown/OpenAPI/formato personalizado}}
Referencia: {{archivo de docs existente para estilo}}

Arquitectura

[Decision de Diseno]
Necesito decidir: {{descripcion de la decision}}

Opciones:
A: {{opcion A}}
B: {{opcion B}}
C: {{opcion C}}

Criterios de evaluacion (por prioridad):
1. {{criterio}} (peso: {{1-5}})
2. {{criterio}} (peso: {{1-5}})
3. {{criterio}} (peso: {{1-5}})

Stack actual: {{tecnologia relevante}}
Restricciones: {{que limita la solucion}}

Compara cada opcion contra todos los criterios. Proporciona una recomendacion
con razonamiento.

Code Review

[Solicitud de Revision]
Revisa los cambios en {{ruta_archivo o diff}}.

Enfocarse en:
- {{preocupacion especifica: correctitud / seguridad / rendimiento}}

Ignorar:
- {{fuera de alcance: nits de estilo / nombres / etc.}}

Formato para cada hallazgo:
- Severidad: {{debe-corregir / deberia-corregir / nit}}
- Ubicacion: {{archivo:linea}}
- Problema: {{descripcion}}
- Solucion: {{cambio sugerido}}

Variables de Plantilla

Usa una sintaxis de variables consistente como {{nombre_variable}} para que puedas encontrar y reemplazar rápidamente los marcadores de posición. Algunos desarrolladores prefieren [VARIABLE] o $VARIABLE -- elige una convención y mantente con ella.

Las variables más comúnmente usadas en las plantillas:

  • {{ruta_archivo}} -- el archivo en el que se trabaja
  • {{archivo_referencia}} -- un archivo existente para igualar patrones
  • {{stack_tecnologico}} -- el stack tecnológico relevante
  • {{lista_restricciones}} -- cosas que la IA no debe cambiar
  • {{framework_test}} -- Vitest, Jest, pytest, etc.

Dónde Almacenar Tus Prompts

CLAUDE.md

El almacenamiento más accesible para plantillas de prompts que usas en cada sesión. Agrega una sección a tu CLAUDE.md del proyecto:

## Plantillas de Prompts

### Al generar nuevos archivos de servicio:
- Seguir src/services/UserService.ts como patron
- Incluir inyeccion de dependencias por constructor
- Agregar validacion de entrada con Zod
- Incluir manejo de errores con subclases de AppError

### Al generar tests:
- Usar Vitest con los patrones en src/tests/
- Incluir factories de src/tests/factories/
- Mockear base de datos con src/tests/mocks/prisma.ts

Estos no son prompts completos sino fragmentos de prompt que se incluyen automáticamente en cada interacción, asegurando consistencia.

Skills de Claude Code

Los skills son archivos markdown en el directorio .claude/skills/ de tu proyecto que Claude Code carga automáticamente cuando son relevantes. Crea archivos de skills para tus flujos de trabajo más comunes:

# .claude/skills/new-api-endpoint.md

Al crear un nuevo endpoint de API:
1. Crear el handler de ruta en src/routes/ siguiendo el patron de router Express
2. Crear o actualizar el esquema Zod en src/schemas/
3. Crear o actualizar el metodo del servicio en src/services/
4. Agregar la ruta al indice del router en src/routes/index.ts
5. Generar tests igualando los patrones en src/tests/integration/

Notas Personales

Para prompts que son personales de tu flujo de trabajo en lugar de específicos del proyecto, mantén un archivo simple en tu máquina. Un archivo de texto plano o una nota en tu app de notas preferida funciona bien. La clave es que puedas encontrarlos y copiarlos rápidamente.

Organiza por frecuencia de uso, no por categoría. Los prompts que usas diariamente deben estar arriba. Los prompts que usas mensualmente deben estar más abajo.

Evolucionando Tu Biblioteca

Rastrea Lo Que Funciona

Cuando un prompt produce salida excelente al primer intento, guárdalo. Cuando un prompt requiere múltiples rondas de corrección, nota lo que faltaba y mejóralo. Con el tiempo, tus plantillas se vuelven cada vez más precisas.

Mantiene un sistema de puntuación simple:

  • El prompt produjo salida correcta al primer intento: mantener tal cual
  • El prompt necesitó una corrección: agregar el detalle faltante a la plantilla
  • El prompt necesitó múltiples correcciones: reescribir la plantilla
  • El prompt falla consistentemente: investigar si la tarea necesita descomposición

Retira Lo Que No Funciona

Elimina prompts que nunca usas o que consistentemente producen resultados pobres. Una biblioteca más pequeña de prompts efectivos es más valiosa que una biblioteca grande de prompts mediocres. Revisa tu biblioteca trimestralmente y elimina todo lo que no hayas usado en los últimos 3 meses.

Adapta a Actualizaciones de Herramientas

Las herramientas de IA mejoran constantemente. Un prompt que necesitaba asistencia extensiva con un modelo anterior podría funcionar perfectamente con una versión más corta en un modelo nuevo. Cuando actualices tus herramientas de IA, prueba tus prompts más usados y simplifica donde sea posible.

Compartiendo Con Tu Equipo

Cuando tu equipo estandariza prompts compartidos, varias cosas mejoran:

  • Consistencia en code review: El código generado por IA de todos sigue los mismos patrones
  • Velocidad de onboarding: Los nuevos desarrolladores se vuelven productivos inmediatamente con prompts probados
  • Piso de calidad: Incluso prompts escritos apresuradamente producen mejor salida cuando el contexto del proyecto está bien definido

Prompts Estandarizados del Equipo

Crea prompts compartidos para flujos de trabajo del equipo:

[Generador de Descripcion de PR]
Resume los cambios en este PR para el revisor.

Formato:
## Que cambio
- {{lista con puntos de cambios}}

## Por que
{{un parrafo explicando la motivacion}}

## Como probar
1. {{instrucciones paso a paso de testing}}

## Riesgos
- {{problemas potenciales o areas a vigilar}}

[Respuesta a Incidentes]
Tenemos un incidente {{severidad}} afectando {{sistema/funcionalidad}}.

Sintomas: {{lo que los usuarios estan viendo}}
Linea de tiempo: {{cuando empezo, despliegues recientes}}
Alcance: {{cuantos usuarios afectados, que regiones}}

Analiza los siguientes logs y metricas para identificar la causa raiz:
{{pegar logs relevantes}}

Sugiere pasos de mitigacion inmediata y una correccion permanente.

Cinco Plantillas de Prompts Listas Para Usar

Aquí hay cinco prompts que puedes empezar a usar inmediatamente. Cópialos, llena las variables e itera.

1. Implementación Rápida de Feature

Agrega {{descripcion_feature}} a {{ruta_archivo}}.
Stack: {{stack_tecnologico}}.
Seguir el patron en {{archivo_referencia}}.
Restricciones: {{que no cambiar}}.
Incluir: {{manejo de errores / validacion / tipos / tests}}.

2. Investigación de Bug

{{mensaje_error}} ocurre en {{ruta_archivo}} cuando {{condicion_disparo}}.
Esperado: {{comportamiento_esperado}}.
Actual: {{comportamiento_actual}}.
Codigo relevante: {{archivo:lineas o pegar}}.
Diagnostica la causa raiz y proporciona una correccion.

3. Checklist de Code Review

Revisa {{ruta_archivo o git diff}} por:
[ ] Errores de logica y casos extremos faltantes
[ ] Vulnerabilidades de seguridad (inyeccion, bypass de auth, exposicion de datos)
[ ] Problemas de rendimiento (consultas N+1, computacion innecesaria)
[ ] Consistencia con patrones del proyecto
Clasificar problemas como debe-corregir, deberia-corregir, o nit.

4. Generación de Suite de Tests

Genera tests para {{funcion/clase}} cubriendo:
- Camino feliz: {{describir flujo normal}}
- Casos de error: {{listar escenarios de error}}
- Casos extremos: {{listar condiciones limite}}
Framework: {{framework_test}}. Mocking: {{enfoque_mock}}.
Igualar patrones en {{archivo_test_existente}}.

5. Explicar y Documentar

Explica {{ruta_archivo o bloque_codigo}} para un desarrollador que es nuevo
en este codebase. Cubre: que hace, por que existe, como se conecta con
{{sistemas_relacionados}} y gotchas comunes. Mantenlo bajo {{conteo_palabras}}
palabras.

Tu Reto de 7 Días

Construye tu biblioteca personal de prompts en una semana:

Día 1: Guarda los 3 prompts que más usaste hoy. Anota qué funcionó y qué necesitó corrección.

Día 2: Crea plantillas a partir de los prompts de ayer. Reemplaza valores específicos con {{variables}}.

Día 3: Agrega 2 nuevas plantillas para tareas que haces semanalmente pero que aún no has convertido en plantilla.

Día 4: Prueba tus plantillas en tareas reales. Refina las que produzcan resultados inconsistentes.

Día 5: Agrega contexto específico del proyecto a tu CLAUDE.md basándote en patrones que notaste esta semana.

Día 6: Comparte tus 3 mejores plantillas con un compañero de equipo. Obtiene su feedback e incorpora mejoras.

Día 7: Revisa tu biblioteca. Deberías tener 8-12 plantillas. Elimina las que no te ahorren tiempo. Organiza por frecuencia de uso.

Después de esta semana, tendrás una biblioteca de prompts funcional que acelera cada interacción con IA. Sigue refinándola, y en un mes te preguntarás cómo trabajabas sin ella.