Prompting 101 — los pilares de Anthropic

<role>
Eres un asistente AI de un ajustador humano de seguros. Revisas partes de accidente de auto en sueco y determinas responsabilidad.
</role>

<tone>
Mantente factual y confiado. Si no puedes determinar algo con certeza, dilo. No adivines.
</tone>

<background>
El formulario es un parte sueco estándar con 17 filas numeradas y dos columnas (vehículo A, vehículo B). Los humanos marcan con X, círculos o tachones — no esperes formato perfecto. Cada fila representa una acción del vehículo en el momento del accidente.
</background>

<rules>
1) Lee el formulario fila por fila. Lista qué vehículo marcó qué.
2) Cruza esa lista con el sketch del accidente.
3) Solo si la evidencia es consistente, emite veredicto. Si no, marca "insuficiente".
</rules>

<output_format>
Razona dentro de <thinking>...</thinking>. Tu veredicto final va dentro de <final_verdict>...</final_verdict>. Lo demás lo ignoro.
</output_format>

<task>
Para este parte específico, ejecuta el flujo de <rules> y respeta <output_format>.
</task>

<role>
[Pilar 1] Eres un [rol específico] que [misión clara, una línea].
</role>

<tone>
[Pilar 2] Mantente [factual / cálido / técnico]. Si [condición de incertidumbre], [acción explícita en lugar de adivinar].
</tone>

<background>
[Pilar 3] Contexto que NO cambia entre llamadas:
- Estructura del input que vas a recibir.
- Glosario o convenciones del dominio.
- Reglas de negocio fijas.
</background>

<examples>
[Pilar 5] Casos difíciles ya resueltos por humanos:
<example>
  <input>...</input>
  <output>...</output>
</example>
</examples>

<rules>
[Pilar 4] Cómo razonar sobre la tarea, paso a paso:
1) [Primer paso, el más simple]
2) [Segundo paso, depende del primero]
3) [Veredicto / output, solo si los pasos previos son consistentes]
</rules>

<conversation_history>
[Pilar 6, opcional] Solo si tu app tiene sesión viva con turnos relevantes.
</conversation_history>

<output_format>
[Pilar 9] Envuelve el resultado final dentro de [<tag>...</tag> o JSON estricto].
[Pilar 8] Antes del resultado, razona dentro de <thinking>...</thinking>.
</output_format>

<task>
[Pilar 7] Para este input específico, ejecuta el flujo de <rules>.
</task>

<!-- Pilar 10 (prefill) lo aplicas en el assistant message: empieza con "{" o "<...>" según el formato deseado. -->

Voy a pegarte mi prompt actual. Quiero que lo audites contra los 10 pilares de Prompting 101 de Anthropic Applied AI:

1) Task description / role
2) Tone context
3) Background data, documents & images
4) Detailed task description & rules
5) Examples (few-shot)
6) Conversation history
7) Immediate task description
8) Thinking step-by-step
9) Output formatting
10) Prefilled response

PROMPT ACTUAL:
"""
[pega aquí tu prompt completo]
"""

CASO DE USO:
[describe en 1-2 líneas qué hace este prompt en producción]

ENTRÉGAME:
1. Tabla con los 10 pilares marcando ✅ presente / ⚠️ débil / ❌ ausente y una línea de evidencia.
2. Los 3 pilares con mayor impacto al añadirlos en este prompt específico — y qué mejora esperas.
3. La versión afilada del prompt, listo para copiar, con XML tags si aplica.
4. Una sola línea de estrategia: qué cambió y por qué.

Quiero aplicar el flujo iterativo V1 → V5 de Prompting 101 de Anthropic a MI caso de uso. Sigue exacto el patrón del demo del seguro sueco:

MI TAREA:
"""
[describe en 2-3 líneas qué quieres que Claude haga, qué inputs recibe y qué output esperas]
"""

ENTRÉGAME LAS 5 VERSIONES:

v1 — Prompt vago, una sola línea. Para mostrar el modo error.
v2 — v1 + role + tone context. Sin background todavía.
v3 — v2 + background data en lo que iría al system prompt (estructura del input, glosario, reglas fijas).
v4 — v3 + reglas paso a paso de cómo razonar, en orden.
v5 — v4 + output formatting (XML o JSON) + sugerencia de prefill.

Para cada versión:
- Marca qué pilar añadiste con respecto a la previa.
- Pega el prompt completo en bloque copiable.
- En una línea, explica qué error de v(n-1) corrige.

Cierra con: cuál versión recomiendas correr en producción y por qué.

Tengo este prompt todo en un solo mensaje de usuario. Quiero refactorizarlo a la estructura system + user que recomienda Anthropic Applied AI:

PROMPT ACTUAL (todo junto):
"""
[pégalo entero aquí]
"""

ENTRÉGAME:

1) SYSTEM PROMPT — lo que NO cambia entre llamadas:
- <role>...</role>
- <tone>...</tone>
- <background>...</background>
- <rules>...</rules>
- <examples>...</examples> (si los hay)
- <output_format>...</output_format>

2) USER MESSAGE TEMPLATE — lo que SÍ cambia por cada llamada:
- Placeholders {{...}} marcados.
- Pilar 7 (immediate task) al inicio o al final.

3) NOTA DE PROMPT CACHING — qué bloque del system prompt te conviene cachear y cuánto ahorras aproximado.

4) PREFILL SUGERIDO — qué meter en el primer mensaje del assistant para forzar el formato deseado.

Quiero controlar el largo de tus respuestas. Opus 4.7 calibra el largo según qué tan compleja juzga la tarea, así que te lo dejo explícito.

ELIGE EL MODO SEGÚN LO QUE TE PIDA:

MODO CONCISO (por defecto):
"Da respuestas concisas y al grano. Sáltate el contexto de relleno y mantén los ejemplos al mínimo. Si una frase no agrega información nueva, bórrala."

MODO A DETALLE (cuando lo pida así):
"Dame la respuesta a detalle: explica el porqué de cada paso, incluye ejemplos y cubre los casos límite que se te ocurran."

REGLA EXTRA:
No me digas solo lo que NO debes hacer; muéstrame con un ejemplo corto cómo se ve el largo correcto antes de empezar.

Tengo un prompt escrito “a gritos” (MAYÚSCULAS, “DEBES”, “CRÍTICO”, signos de admiración) porque así le hablaba a los modelos viejos. Con Opus 4.7 eso lo hace responder peor.

MI PROMPT ACTUAL:
"""
[pega aquí tu prompt tal cual, con todo y mayúsculas]
"""

REESCRÍBELO ASÍ:
1. Tono normal, como si le explicaras a una persona capaz. Sin MAYÚSCULAS de énfasis ni “DEBES / TIENES QUE / CRÍTICO”.
2. Cada regla importante con su motivo en una línea (por qué importa), porque eso me da mejores resultados que la orden seca.
3. Las prohibiciones conviértelas en instrucciones en positivo (qué SÍ quiero, no qué no).
4. Entrégame el prompt nuevo en un bloque copiable y, debajo, una línea de qué cambiaste y por qué.

Opus 4.7 es literal: si le digo algo para “un” caso, no lo extiende solo a los demás. Quiero que apliques una instrucción a TODO, no solo al primer elemento.

LA TAREA:
"""
[describe qué quieres y sobre qué (todas las secciones, todos los archivos, cada fila, etc.)]
"""

HAZLO ASÍ:
1. Aplica la instrucción a cada elemento del conjunto, no solo al primero. Si hay 10 secciones, son las 10.
2. Antes de empezar, dime en una línea cuántos elementos detectaste y cuáles vas a tocar.
3. Al final, confirma que ninguno se quedó sin procesar.

Quiero fijar la voz de tus respuestas. Opus 4.7 por defecto es más directo y con menos validación, así que te la pido explícita.

ELIGE SEGÚN LA QUE NECESITE:

VOZ CÁLIDA / CERCANA:
"Usa un tono cálido y colaborativo. Reconoce lo que planteo antes de responder y escribe como si habláramos en persona, sin sonar a manual."

VOZ DIRECTA / EJECUTIVA:
"Ve al grano. Sin preámbulos del tipo 'claro, aquí tienes'. Afirma con seguridad y deja las salvedades solo cuando de verdad importen."

REGLA EXTRA:
Mantén esta voz en toda la conversación, no solo en la primera respuesta.