Píldoras de IA · 01 · Claude prompting playbook

12 patrones de prompting que sí merecen la pena

No son comandos secretos y no activan modos ocultos. Son formas de estructurar instrucciones para reducir ambigüedad, orientar el análisis y hacer que el resultado sea más comprobable.

Regla del documento: “respaldado” no significa “garantizado”. Los principios respaldados por Anthropic aparecen en su documentación. Algunos nombres, como Evidence First, son editoriales de @itsmarbuilds. Los marcos externos son métodos establecidos que pueden trasladarse al prompting, no features especiales de Claude.
8 respaldados directamente por Anthropic
4 marcos de razonamiento establecidos
12 prompts copiables
01

Few-shot

Anthropic

Enséñale ejemplos del resultado que quieres, en vez de esperar que adivine el patrón.

Úsalo cuando

Cuando quieres que una nueva pieza de código, texto o clasificación siga un patrón que ya existe.

Por qué tiene sentido

Anthropic describe los ejemplos como una de las formas más fiables de orientar formato, tono y estructura, y recomienda 3–5 ejemplos relevantes y variados.

Prompt listo para copiar
Quiero añadir un nuevo endpoint a este proyecto.
Antes de escribirlo, revisa estos tres endpoints existentes: [A], [B] y [C].
Usa como referencia su estructura, naming, validación y manejo de errores.
Después implementa el nuevo endpoint siguiendo ese patrón.
Límite: No copies un ejemplo malo sin darte cuenta. Los ejemplos tienen que representar de verdad el patrón que quieres.
Anthropic · Prompting best practices ↗
02

Evidence first

Anthropic

Haz que busque la evidencia antes de sacar la conclusión.

Úsalo cuando

Bugs, auditorías, research, documentos largos o cualquier pregunta donde una respuesta convincente pero inventada sea peligrosa.

Por qué tiene sentido

Anthropic recomienda no especular sobre código que Claude no ha abierto. En documentos largos también recomienda extraer primero los fragmentos relevantes y responder después.

Prompt listo para copiar
Antes de decirme cuál es la causa, investiga primero.
Abre los archivos relevantes y basa cada conclusión en lo que encuentres.
Si no tienes evidencia suficiente para afirmar algo, dilo explícitamente.
Límite: Tener una cita no convierte automáticamente la conclusión en correcta. La evidencia también puede estar incompleta o mal interpretada.
Anthropic · Prompting best practices / Reduce hallucinations ↗
03

Premortem

Método establecido

Imagina que el plan ya salió mal y busca por qué antes de ejecutarlo.

Úsalo cuando

Antes de una migración, deploy, refactor, lanzamiento o decisión con riesgo.

Por qué tiene sentido

El método premortem de Gary Klein parte precisamente de imaginar que un plan ha fallado para generar amenazas y obstáculos antes de ejecutarlo.

Prompt listo para copiar
Imagina que mañana este cambio ha roto producción.
Dame cinco posibles causas y, para cada una, qué puedo comprobar ahora para reducir ese riesgo.
Límite: Genera escenarios posibles, no predicciones. Claude puede proponer riesgos que no aplican.
Gary Klein · Premortem Method of Risk Assessment ↗
04

First principles

Marco de razonamiento

Deja de asumir que la solución actual es la única posible y vuelve a lo que realmente tiene que ser verdad.

Úsalo cuando

Cuando estás optimizando una solución heredada y sospechas que el problema está en el planteamiento original.

Por qué tiene sentido

El razonamiento desde primeros principios consiste en reducir el problema a hechos o restricciones fundamentales y razonar desde ahí. Elon Musk lo ha defendido públicamente frente a razonar solo por analogía.

Prompt listo para copiar
Olvida por un momento cómo está resuelto ahora.
1. ¿Qué objetivo necesitamos conseguir de verdad?
2. ¿Qué restricciones son realmente obligatorias?
3. ¿Qué cosas estamos dando por hechas solo porque ya se hacen así?
Con eso, reconstruye la solución más simple desde cero.
Límite: No garantiza que Claude identifique correctamente cuáles son los hechos fundamentales. Hay que verificar sus premisas.
TED 2013 · Elon Musk on first-principles reasoning ↗
05

Steelman

Marco de razonamiento

Obliga a construir la mejor versión del argumento contrario al tuyo.

Úsalo cuando

Decisiones de arquitectura, producto, estrategia o cualquier momento en el que ya estés muy convencida de una opción.

Por qué tiene sentido

Steelmanning es lo contrario de construir un hombre de paja: intenta representar la postura opuesta en su versión más fuerte antes de evaluarla.

Prompt listo para copiar
Estoy inclinándome por [OPCIÓN A].
Antes de recomendar nada, construye el mejor argumento posible a favor de [OPCIÓN B].
No inventes datos. Señala qué tendría que ser cierto para que B fuese la mejor decisión.
Límite: Claude puede fortalecer una postura hasta deformarla o añadir supuestos. Pídele que separe argumentos de hechos.
Argumentation literature · Steelmanning ↗
06

Scope fence

Anthropic

Dile explícitamente qué NO quieres que toque para evitar que convierta un fix en una reforma.

Úsalo cuando

Cambios pequeños, hotfixes, tareas en repos grandes o cuando Claude tiende a sobreingenierizar.

Por qué tiene sentido

La documentación actual de Anthropic incluye instrucciones específicas para evitar overengineering y mantener los cambios centrados en lo pedido.

Prompt listo para copiar
Haz únicamente el cambio necesario para resolver esta tarea.
No añadas features, no refactorices código no relacionado y no crees abstracciones para necesidades hipotéticas.
Si detectas otra mejora, señálala aparte sin implementarla.
Límite: Demasiado scope fence puede impedir una corrección necesaria alrededor del cambio. Deja una vía para que Claude avise si algo adyacente es imprescindible.
Anthropic · Avoid over-engineering ↗
07

Output contract

Anthropic

Define qué significa una respuesta útil antes de pedirla.

Úsalo cuando

Cuando Claude suele darte una respuesta correcta pero con formato, profundidad o alcance equivocados.

Por qué tiene sentido

Anthropic recomienda instrucciones claras y explícitas, incluyendo formato de salida, restricciones y pasos cuando el orden importa.

Prompt listo para copiar
Quiero que el resultado tenga exactamente:
- diagnóstico en 3–5 frases
- archivos afectados
- cambio mínimo recomendado
- riesgos
- cómo verificarlo
No implementes todavía.
Límite: Un contrato demasiado rígido puede empobrecer una tarea abierta. Úsalo cuando el formato sí importa.
Anthropic · Be clear and direct ↗
08

Give the why

Anthropic

No des solo una regla. Explica por qué existe para que Claude pueda generalizarla.

Úsalo cuando

Reglas de estilo, seguridad, producto o arquitectura que Claude tendrá que aplicar en casos no previstos.

Por qué tiene sentido

Anthropic dice que aportar contexto o motivación ayuda a Claude a entender el objetivo y generalizar mejor la instrucción.

Prompt listo para copiar
No cambies el esquema de respuesta de esta API.
Motivo: hay dos clientes antiguos que dependen exactamente de ese contrato.
Puedes cambiar la implementación interna, pero la forma externa debe permanecer compatible.
Límite: El contexto tiene que ser verdadero y relevante. Una explicación inventada solo introduce otra fuente de error.
Anthropic · Add context to improve performance ↗
09

XML structure

Anthropic

Separa instrucciones, contexto y datos para que Claude no confunda unas cosas con otras.

Úsalo cuando

Prompts largos, múltiples documentos, ejemplos mezclados con instrucciones o inputs dinámicos.

Por qué tiene sentido

Anthropic recomienda etiquetas XML para prompts complejos porque reducen ambigüedad entre instrucciones, contexto, ejemplos e inputs.

Prompt listo para copiar
<instructions>
Analiza el bug y propón el cambio mínimo.
</instructions>

<context>
La API debe mantener compatibilidad hacia atrás.
</context>

<logs>
[PEGA AQUÍ LOS LOGS]
</logs>
Límite: No aporta gran cosa a una petición de dos líneas. Úsalo cuando de verdad haya bloques distintos que separar.
Anthropic · Structure prompts with XML tags ↗
10

Role prompting

Anthropic

Dale una perspectiva concreta cuando esa perspectiva cambie qué debe priorizar.

Úsalo cuando

Revisión especializada: seguridad, accesibilidad, performance, datos, legal, UX, etc.

Por qué tiene sentido

Anthropic indica que asignar un rol enfoca el comportamiento y el tono de Claude para un caso de uso.

Prompt listo para copiar
Revisa este cambio como un senior backend engineer centrado en fiabilidad.
Prioriza regresiones, condiciones de carrera, manejo de errores y observabilidad.
No evalúes estilo visual ni producto salvo que afecten al backend.
Límite: Decir 'eres el mejor experto del mundo' no añade conocimiento. El rol útil define perspectiva y prioridades, no grandiosidad.
Anthropic · Give Claude a role ↗
11

Tests first

Anthropic

Define cómo sabremos que funciona antes de dejar que Claude cambie el código.

Úsalo cuando

Features, bugs reproducibles, refactors y tareas agénticas largas.

Por qué tiene sentido

Anthropic recomienda que los agentes escriban pruebas antes de empezar y que las mantengan como criterio estructurado de progreso.

Prompt listo para copiar
Antes de implementar, define las pruebas que demostrarían que esta tarea está resuelta.
Incluye happy path, edge cases y regresiones relevantes.
Después implementa el cambio y ejecuta esas pruebas.
No cambies las pruebas solo para hacerlas pasar.
Límite: Los tests pueden estar mal diseñados. 'Pasar tests' no es lo mismo que resolver correctamente el problema.
Anthropic · Agentic coding guidance ↗
12

Red team

Método establecido

Pídele que intente romper tu idea en vez de ayudarte a defenderla.

Úsalo cuando

Planes, pitches, decisiones, threat modeling ligero y revisión adversarial previa.

Por qué tiene sentido

Red teaming es una práctica establecida de desafío estructurado de planes y supuestos. Aquí se adapta como marco de prompting, no como sustituto de una auditoría o un red team real.

Prompt listo para copiar
Haz de red team de este plan.
Busca supuestos débiles, casos límite, formas en las que podría fallar y qué evidencia falta.
Para cada crítica, propone una comprobación concreta.
No inventes vulnerabilidades ni hechos que no puedas sostener.
Límite: Una crítica generada por un LLM no equivale a una prueba adversarial ejecutada ni a una auditoría de seguridad independiente.
UK Ministry of Defence · Red Teaming Handbook ↗

Interactive version by @itsmarbuilds