Mantenimiento de una biblioteca de prompts para Claude Code

No pierdas los buenos prompts

Los equipos con resultados inestables en Claude Code suelen escribir prompts nuevos cada día. Encuentran una instrucción útil, pero no guardan nombre, caso de uso, entradas, formato de salida ni prueba.

Este artículo continúa el checklist de review y el checklist de 30 minutos. El PDF gratuito enseña lo básico; la biblioteca de prompts conecta con el pack pago y con consultoría.

Un prompt, un objetivo

La primera regla es un prompt para una tarea. Pedir revisión, tests, documentación y refactor en la misma instrucción parece eficiente, pero crea fallos difíciles de diagnosticar.

{
  "id": "review-risk-finder",
  "owner": "platform",
  "useWhen": "A pull request changes behavior, data flow, or CTA routing.",
  "inputs": ["diff", "goal", "riskAreas"],
  "output": "Findings ordered by severity with file references.",
  "proof": "Run once on a known risky diff before adding it to the library."
}

Estos metadatos permiten reutilizar el prompt en un repositorio, artículo, producto o wiki interna. El campo “proof” separa una idea de un activo probado.

Plantilla base copiable

En prompts de review, fija objetivo, diff, riesgos y formato de salida. No pidas solo que mire el cambio; define qué cuenta como riesgo.

Eres revisor de riesgo real en producción.
Contexto:
- Objetivo: {{goal}}
- Diff: {{diff}}
- Áreas de riesgo: {{riskAreas}}

Devuelve primero los hallazgos.
En cada hallazgo incluye severidad, evidencia, impacto de usuario y arreglo mínimo.
Si no hay hallazgos, di qué revisaste y qué queda sin verificar.

La misma forma sirve para review, cambios de CTA, formularios y páginas de producto. Solo cambia “riskAreas”.

Error común: nombres vagos

Nombres como “good-review-prompt” o “debug-helper” no ayudan a encontrar nada. Usa nombres con uso y resultado: “review-risk-finder”, “build-log-first-failure”, “cta-copy-clarifier”.

También es un error guardar solo ejemplos exitosos. Guarda una entrada mala para entender dónde se rompe el prompt.

Agrega una validación pequeña

Cuando la biblioteca supera diez entradas, revisa campos obligatorios.

const required = ["id", "owner", "useWhen", "inputs", "output", "proof"];

export function validatePrompt(entry) {
  const missing = required.filter((key) => !entry[key]);
  return {
    ok: missing.length === 0,
    missing,
    ready: missing.length === 0 && entry.proof.includes("Run once"),
  };
}

Esto evita prompts sin dueño, sin uso claro o sin prueba. En un sitio de contenido, también aclara la ruta: PDF gratuito, pack de prompts y consultoría.

Siguiente paso

Usa el cheatsheet gratuito si aún aprendes hábitos básicos. Compra 50 Prompt Templates si necesitas prompts de review, debugging, refactor y documentación. Usa la consulta para gobernanza de equipo.