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.