Saltar al contenido
Lección 12 de 12

Construyendo Tu Biblioteca de Prompts

9 min read

De Ad-Hoc a Sistematico

A lo largo de este curso, has aprendido tecnicas para generacion de codigo, depuracion, refactorizacion, testing, documentacion, arquitectura y flujos de trabajo multi-paso. El paso final es sistematizar estas tecnicas en una biblioteca personal de prompts -- una coleccion reutilizable de plantillas que hace cada futura interaccion con IA mas rapida y efectiva.

Una biblioteca de prompts no es un documento estatico. 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 pequenas, enfocadas y mantenidas -- no colecciones completas que nadie usa.

Organizando Tu Biblioteca por Categoria

Estructura tu biblioteca de prompts alrededor de los tipos de tareas que realizas mas frecuentemente. Aqui estan las categorias principales para la mayoria de desarrolladores:

Generacion de Codigo

[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}}.

Depuracion

[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}}

Refactorizacion

[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}}

Documentacion

[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 rapidamente los marcadores de posicion. Algunos desarrolladores prefieren [VARIABLE] o $VARIABLE -- elige una convencion y mantente con ella.

Las variables mas comunmente 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 tecnologico relevante
  • {{lista_restricciones}} -- cosas que la IA no debe cambiar
  • {{framework_test}} -- Vitest, Jest, pytest, etc.

Donde Almacenar Tus Prompts

CLAUDE.md

El almacenamiento mas accesible para plantillas de prompts que usas en cada sesion. Agrega una seccion 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 automaticamente en cada interaccion, asegurando consistencia.

Skills de Claude Code

Los skills son archivos markdown en el directorio .claude/skills/ de tu proyecto que Claude Code carga automaticamente cuando son relevantes. Crea archivos de skills para tus flujos de trabajo mas 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 especificos del proyecto, manten un archivo simple en tu maquina. Un archivo de texto plano o una nota en tu app de notas preferida funciona bien. La clave es que puedas encontrarlos y copiarlos rapidamente.

Organiza por frecuencia de uso, no por categoria. Los prompts que usas diariamente deben estar arriba. Los prompts que usas mensualmente deben estar mas abajo.

Evolucionando Tu Biblioteca

Rastrea Lo Que Funciona

Cuando un prompt produce salida excelente al primer intento, guardalo. Cuando un prompt requiere multiples rondas de correccion, nota lo que faltaba y mejoralo. Con el tiempo, tus plantillas se vuelven cada vez mas precisas.

Mantiene un sistema de puntuacion simple:

  • El prompt produjo salida correcta al primer intento: mantener tal cual
  • El prompt necesito una correccion: agregar el detalle faltante a la plantilla
  • El prompt necesito multiples correcciones: reescribir la plantilla
  • El prompt falla consistentemente: investigar si la tarea necesita descomposicion

Retira Lo Que No Funciona

Elimina prompts que nunca usas o que consistentemente producen resultados pobres. Una biblioteca mas pequena de prompts efectivos es mas valiosa que una biblioteca grande de prompts mediocres. Revisa tu biblioteca trimestralmente y elimina todo lo que no hayas usado en los ultimos 3 meses.

Adapta a Actualizaciones de Herramientas

Las herramientas de IA mejoran constantemente. Un prompt que necesitaba asistencia extensiva con un modelo anterior podria funcionar perfectamente con una version mas corta en un modelo nuevo. Cuando actualices tus herramientas de IA, prueba tus prompts mas usados y simplifica donde sea posible.

Compartiendo Con Tu Equipo

Cuando tu equipo estandariza prompts compartidos, varias cosas mejoran:

  • Consistencia en code review: El codigo 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 esta 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

Aqui hay cinco prompts que puedes empezar a usar inmediatamente. Copialos, llena las variables e itera.

1. Implementacion Rapida 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. Investigacion 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. Generacion 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 Dias

Construye tu biblioteca personal de prompts en una semana:

Dia 1: Guarda los 3 prompts que mas usaste hoy. Anota que funciono y que necesito correccion.

Dia 2: Crea plantillas a partir de los prompts de ayer. Reemplaza valores especificos con {{variables}}.

Dia 3: Agrega 2 nuevas plantillas para tareas que haces semanalmente pero que aun no has convertido en plantilla.

Dia 4: Prueba tus plantillas en tareas reales. Refina las que produzcan resultados inconsistentes.

Dia 5: Agrega contexto especifico del proyecto a tu CLAUDE.md basandote en patrones que notaste esta semana.

Dia 6: Comparte tus 3 mejores plantillas con un companero de equipo. Obtiene su feedback e incorpora mejoras.

Dia 7: Revisa tu biblioteca. Deberias tener 8-12 plantillas. Elimina las que no te ahorren tiempo. Organiza por frecuencia de uso.

Despues de esta semana, tendras una biblioteca de prompts funcional que acelera cada interaccion con IA. Sigue refinandola, y en un mes te preguntaras como trabajabas sin ella.