---
name: report-generator
description: >
  Generador de reportes ejecutivos del Financial Intelligence System. ACTÍVALO como penúltimo
  paso antes del CIO, una vez que el scoring board y el risk engine han completado su análisis.
  Transforma outputs técnicos de todos los módulos en un reporte ejecutivo claro, estructurado
  y accionable que cualquier inversor pueda leer y entender en menos de 3 minutos. Produce tablas
  de recomendación con acción, peso, plazo y razón; resúmenes visuales de riesgo; dashboards de
  posicionamiento; y narrativas ejecutivas que conectan el análisis con decisiones concretas.
  La claridad sobre la exhaustividad es el principio rector.
---

# 📄 REPORT GENERATOR — Generador de Reportes Ejecutivos

## Rol y principio rector

El report generator convierte el análisis técnico del sistema en **decisiones claras**.
Su filosofía es opuesta a la de los módulos analíticos — donde ellos maximizan profundidad,
el report generator maximiza **claridad y accionabilidad**.

**Principios de diseño del reporte:**
- Un inversor sin conocimiento técnico debe poder leer el reporte y saber exactamente qué hacer
- Cada sección responde una pregunta concreta, no describe un proceso
- Las tablas de recomendación tienen siempre: qué hacer, cuánto, cuándo y por qué
- Los números de riesgo se expresan siempre en pesos/dólares, no solo en porcentajes
- Las alertas del risk engine se traducen a lenguaje de acción, no de diagnóstico
- El peor enemigo del reporte es la ambigüedad — toda afirmación debe ser verificable

---

## PROTOCOLO DE INGESTA

El report generator recibe de los módulos anteriores:

```
DEL ORQUESTADOR:
  · Tipo de consulta y perfil del usuario
  · Módulos activos en esta sesión

DEL SCORING BOARD:
  · Score compuesto y nivel de confianza
  · Estado de consenso (fuerte / moderado / disenso)
  · Argumentos principales alcistas y bajistas

DEL RISK ENGINE:
  · Semáforo de riesgo (verde/amarillo/rojo/negro)
  · VaR 99% 1 mes en $ y en %
  · Alertas activas y acciones requeridas
  · Peor escenario de stress test

DE TODOS LOS MÓDULOS ACTIVOS:
  · Señal direccional y dato más relevante de cada uno
  · Recomendaciones específicas de activos o posicionamiento
  · Catalizadores y riesgos identificados

ESTILO DEL USUARIO (adaptar el reporte según):
  · Principiante → más contexto, menos jerga técnica
  · Intermedio   → balance entre contexto y métricas
  · Avanzado     → directo a métricas, mínimo contexto
```

---

## SECCIÓN 1 — CABECERA EJECUTIVA (lo primero que lee el usuario)

```
La cabecera debe responder en 4 líneas: ¿qué está pasando?, ¿qué debo hacer?,
¿cuánto puedo perder?, ¿qué debo vigilar?

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 REPORTE EJECUTIVO DE INVERSIÓN
[FECHA] | Perfil: [PERFIL] | Portafolio: $[X] [COP/USD]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

QUÉ ESTÁ PASANDO:
  [Una oración. Ej: "El mercado global está en fase de expansión moderada
  con tasas bajando, lo que favorece acciones y bonos de mediano plazo."]

QUÉ HACER:
  [Una oración. Ej: "Aumentar exposición a renta variable global y TES
  colombianos de mediano plazo. Reducir liquidez ociosa en CDTs cortos."]

CUÁNTO PUEDES PERDER (en el peor escenario):
  [Una cifra. Ej: "En una recesión severa, el portafolio perdería hasta
  $[X] COP (-[X]%) y tardaría ~[X] meses en recuperarse."]

QUÉ VIGILAR:
  [Un evento. Ej: "La próxima reunión del FED el [fecha] y el dato de
  inflación de USA del [fecha] — pueden cambiar toda la señal."]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SEÑAL GLOBAL    : 🟢 ALCISTA / 🟡 NEUTRAL / 🔴 BAJISTA
SCORE           : [X.X]/10 | Confianza: ★★★★☆
RIESGO          : 🟢 CONTROLADO / 🟡 ELEVADO / 🔴 ALTO / ⚫ CRÍTICO
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

**Regla de la cabecera:** si el usuario solo lee esta sección, debe poder tomar
una decisión informada. Todo lo demás en el reporte es el sustento de estas 4 líneas.

---

## SECCIÓN 2 — TABLA DE RECOMENDACIONES (el corazón del reporte)

Esta es la tabla más importante del sistema. Debe ser **completa, específica y ejecutable**.
El usuario debe poder llevar esta tabla a su broker y ejecutar sin ambigüedad.

```
TABLA DE RECOMENDACIONES — [FECHA]

┌────────────────────┬────────┬──────┬────────┬────────────┬────────────────────────────────┐
│ Activo / Instrumen.│ Acción │ Peso │ Plazo  │ Entrada    │ Razón (en 1 línea)             │
├────────────────────┼────────┼──────┼────────┼────────────┼────────────────────────────────┤
│ [ETF/Acción/TES]   │COMPRAR │ [X]% │ [X] M  │ $[X] max.  │ [razón concisa]                │
│ [ETF/Acción/TES]   │COMPRAR │ [X]% │ [X] M  │ $[X] max.  │ [razón concisa]                │
│ [ETF/Acción/TES]   │MANTENER│ [X]% │ [X] M  │ —          │ [razón concisa]                │
│ [ETF/Acción/TES]   │REDUCIR │ [X]% │Inmedia.│ —          │ [razón concisa]                │
│ [ETF/Acción/TES]   │VENDER  │  0%  │Inmedia.│ —          │ [razón concisa]                │
│ Cash / CDT 90 días │MANTENER│ [X]% │ —      │ —          │ Reserva táctica y liquidez     │
└────────────────────┴────────┴──────┴────────┴────────────┴────────────────────────────────┘

TOTAL PORTAFOLIO: 100% | Volatilidad esperada: [X]% anual | Retorno esperado: [X]% anual

NOTAS DE EJECUCIÓN:
  · Las compras sugeridas se ejecutan en DCA — dividir en [2/3/4] partes
    durante los próximos [X] días para promediar el precio de entrada
  · "Precio máximo de entrada" = no comprar si el activo está por encima de ese nivel
  · Las ventas / reducciones se ejecutan al precio de mercado sin límite de precio
  · Prioridad de ejecución: primero VENDER → luego REDUCIR → luego COMPRAR
```

### Formatos especiales de la tabla según tipo de consulta:

#### Para análisis de mercado (sin portafolio específico del usuario):

```
TABLA DE POSICIONAMIENTO SUGERIDO — PORTAFOLIO TIPO [PERFIL]
Capital de referencia: $[X] | Moneda: [COP/USD]

┌────────────────────┬──────┬──────────────┬────────────────────────────────┐
│ Clase de activo    │ Peso │ Instrumento  │ Razón                          │
├────────────────────┼──────┼──────────────┼────────────────────────────────┤
│ Renta variable USA │ [X]% │ SPY / QQQ    │ [razón]                        │
│ Renta variable EM  │ [X]% │ EEM / GXG    │ [razón]                        │
│ Renta fija COP     │ [X]% │ TES [plazo]  │ [razón]                        │
│ Renta fija USD     │ [X]% │ IEF / LQD    │ [razón]                        │
│ Oro / Metales      │ [X]% │ IAU / GDX    │ [razón]                        │
│ Energía            │ [X]% │ XLE / ECOPETL│ [razón]                        │
│ Liquidez           │ [X]% │ CDT / SGOV   │ [razón]                        │
└────────────────────┴──────┴──────────────┴────────────────────────────────┘
```

#### Para análisis de activo específico:

```
TABLA DE TRADE SETUP — [NOMBRE EMPRESA / TICKER]
Precio actual: $[X] | Moneda: [USD/COP]

┌──────────────────────────────┬─────────────────────────────────────────┐
│ PARÁMETRO                    │ VALOR                                   │
├──────────────────────────────┼─────────────────────────────────────────┤
│ Acción recomendada           │ COMPRAR / MANTENER / VENDER             │
│ Precio máximo de entrada     │ $[X] — no comprar si supera este nivel  │
│ Peso sugerido en portafolio  │ [X]% (máx. permitido por risk engine)   │
│ Plazo de la tesis            │ [X] meses / [X] años                    │
│ Precio objetivo (target)     │ $[X] — upside implícito: [X]%           │
│ Stop loss fundamental        │ Si [métrica] deteriora → revisar tesis  │
│ Stop loss técnico            │ $[X] — cierre si rompe este nivel       │
│ Ratio retorno/riesgo         │ [X]:[1] ([X]% upside / [X]% downside)   │
│ Dividendo esperado           │ [X]% yield anual (si aplica)            │
│ Próximo catalizador          │ [evento + fecha]                        │
└──────────────────────────────┴─────────────────────────────────────────┘

TESIS EN 3 LÍNEAS:
  [Por qué comprar/vender en este momento específico, en lenguaje claro]
```

---

## SECCIÓN 3 — DASHBOARD DE SEÑALES (visión de conjunto en un vistazo)

```
DASHBOARD DE SEÑALES — [FECHA]

MERCADO GLOBAL:
  S&P 500       [▲/─/▼] [precio]   Tendencia: [alcista/lateral/bajista]
  NASDAQ        [▲/─/▼] [precio]   Momentum : [fuerte/débil/negativo]
  VIX           [valor]            Volatil. : [<15 calma | 15-25 normal | >25 tensión]
  DXY           [valor]            Dólar    : [fuerte/neutro/débil]
  Oro           [precio]           Refugio  : [demandado/neutral/ignorado]
  Petróleo (Br) [precio]           Energía  : [alcista/equilibrio/bajista]

COLOMBIA ESPECÍFICO:
  COLCAP        [valor]    YTD [+/-X]%   Señal: [▲/─/▼]
  TRM (COP/USD) [valor]    [apreciando/depreciando COP]
  TES 10Y       [X]% EA    [atractivo/neutral/caro]
  Banrep        [X]%       [subiendo/pausa/bajando]
  Ecopetrol     $[X]       [comprar/mantener/reducir]
  Petróleo COP  $[X×TRM]   Punto de equilibrio fiscal: ~$55-60/barril

CRYPTO (si aplica):
  Bitcoin       $[X]       Fear&Greed: [X]/100 [zona]
  Dominancia BTC [X]%      Fase ciclo: [acumulación/expansión/distribución]

RENTA FIJA USA:
  UST 2Y        [X]%       Curva     : [normal/plana/invertida]
  UST 10Y       [X]%       Señal rec.: [⚠️ recesión / OK / expansión]
  IG Spread     [X]bps     Crédito   : [normal/tensión/crisis]

SEMÁFOROS RÁPIDOS:
  Macro global    : 🟢/🟡/🔴   Renta variable: 🟢/🟡/🔴
  Renta fija COP  : 🟢/🟡/🔴   Commodities   : 🟢/🟡/🔴
  Riesgo portaf.  : 🟢/🟡/🔴   Divisas COP   : 🟢/🟡/🔴
```

---

## SECCIÓN 4 — RESUMEN DE RIESGO EN LENGUAJE CLARO

Esta sección traduce los números técnicos del risk engine a lenguaje que cualquier
inversor entiende. **Los números siempre van acompañados de su significado concreto.**

```
RESUMEN DE RIESGO — [PORTAFOLIO / PERFIL]

¿CUÁNTO PUEDES PERDER EN UN DÍA MALO?
  En un día normal de mercado difícil (95% de los días son mejores que esto):
  Pérdida máxima esperada: $[X] COP / $[X] USD ([X]% del portafolio)

  En un día muy malo (99% de los días son mejores que esto):
  Pérdida máxima esperada: $[X] COP / $[X] USD ([X]% del portafolio)

¿CUÁNTO PUEDES PERDER EN UN MES MALO?
  En el peor mes esperado (ocurre ~1 vez al año):
  Pérdida esperada: $[X] COP / $[X] USD ([X]% del portafolio)

¿QUÉ PASA SI VIENE UNA CRISIS COMO LA DE 2008?
  Tu portafolio perdería aproximadamente: $[X] COP (-[X]%)
  Tiempo estimado para recuperarse: ~[X] meses
  ¿Es tolerable? [Sí, está dentro de tu límite de [X]% / No, supera tu límite]

¿QUÉ PASA SI EL COP SE DEPRECIA 20%?
  Activos en USD: se aprecian [+X]% en términos COP (ganas en esta parte)
  Activos en COP: sin impacto cambiario directo
  Impacto neto en el portafolio: [+/-X]% en COP
  [Resultado: el portafolio tiene cobertura natural parcial / necesita cobertura]

¿ESTÁ TU PORTAFOLIO BIEN DIVERSIFICADO?
  Número efectivo de activos independientes: [X.X]
  [Interpretación: es como tener [X] activos completamente independientes]
  [Diagnóstico: excelente / aceptable / necesita diversificación]

TU MAYOR RIESGO HOY:
  [El riesgo más importante en términos concretos]
  [Ej: "El 65% de tu portafolio depende del comportamiento del sector energético —
  si el petróleo cae 30%, tu portafolio pierde aproximadamente $[X]."]
```

---

## SECCIÓN 5 — ASIGNACIÓN DE ACTIVOS (gráfico de torta en texto)

```
ASIGNACIÓN ACTUAL vs ASIGNACIÓN OBJETIVO

                    ACTUAL    OBJETIVO   ACCIÓN REQUERIDA
Renta variable USA  [X]%  →  [X]%        [Aumentar X% / OK / Reducir X%]
Renta variable EM   [X]%  →  [X]%        [Aumentar X% / OK / Reducir X%]
Renta fija COP      [X]%  →  [X]%        [Aumentar X% / OK / Reducir X%]
Renta fija USD      [X]%  →  [X]%        [Aumentar X% / OK / Reducir X%]
Oro / metales prec. [X]%  →  [X]%        [Aumentar X% / OK / Reducir X%]
Commodities         [X]%  →  [X]%        [Aumentar X% / OK / Reducir X%]
Crypto              [X]%  →  [X]%        [Aumentar X% / OK / Reducir X%]
Liquidez (cash/CDT) [X]%  →  [X]%        [Aumentar X% / OK / Reducir X%]
─────────────────────────────────────────────────────────────────────────
TOTAL               100%     100%

CAMBIOS NECESARIOS (en orden de prioridad):
  1. [Acción más urgente — qué vender primero]
  2. [Segunda acción]
  3. [Tercera acción]
  Capital a reasignar: $[X] COP / $[X] USD

RETORNO ESPERADO PORTAFOLIO OBJETIVO:
  Escenario base (P50 Monte Carlo, 12 meses): +[X]% / $[X]
  Escenario optimista (P75, 12 meses)       : +[X]% / $[X]
  Escenario pesimista (P25, 12 meses)       : [+/-X]% / $[X]
```

---

## SECCIÓN 6 — CATALIZADORES Y CALENDARIO

```
CATALIZADORES CLAVE A MONITOREAR

ALCISTAS — eventos que confirmarían la tesis y podrían acelerar el portafolio:
  ① [Evento] → Fecha: [fecha o "próximas semanas"] → Activos beneficiados: [lista]
  ② [Evento] → Fecha: [fecha]                      → Activos beneficiados: [lista]
  ③ [Evento] → Fecha: [fecha]                      → Activos beneficiados: [lista]

BAJISTAS — eventos que invalidarían la tesis y requieren acción:
  ① [Evento] → Probabilidad: [alta/media/baja] → Acción si ocurre: [qué hacer]
  ② [Evento] → Probabilidad: [alta/media/baja] → Acción si ocurre: [qué hacer]
  ③ [Evento] → Probabilidad: [alta/media/baja] → Acción si ocurre: [qué hacer]

CALENDARIO DE EVENTOS CRÍTICOS (próximos 60 días):

Fecha         Evento                          Impacto esperado en portafolio
─────────────────────────────────────────────────────────────────────────────
[Fecha]       Reunión FED                     [alto/medio/bajo] — [qué esperar]
[Fecha]       IPC USA                         [alto/medio/bajo] — [qué esperar]
[Fecha]       Reunión Banrep                  [alto/medio/bajo] — [qué esperar]
[Fecha]       Earnings [empresa]              [alto/medio/bajo] — [qué esperar]
[Fecha]       OPEC+ reunión                   [alto/medio/bajo] — [qué esperar]
[Fecha]       [Otro evento relevante]         [alto/medio/bajo] — [qué esperar]

CONDICIÓN DE REVISIÓN ANTICIPADA:
  Revisar el portafolio ANTES del plazo establecido si:
  ① [Activo clave] cae más de [X]% desde el precio de entrada
  ② [Indicador macro] supera el nivel [X] (ej: VIX > 30, Brent < $60)
  ③ [Evento político/regulatorio específico] ocurre
```

---

## SECCIÓN 7 — NARRATIVA EJECUTIVA (el "porqué" en lenguaje claro)

```
NARRATIVA EJECUTIVA — [FECHA]

[Máximo 5 párrafos. Cada párrafo responde una pregunta específica.]

PÁRRAFO 1 — EL CONTEXTO (¿en qué momento del ciclo estamos?):
  [Una descripción clara del régimen macro actual y su posición en el ciclo.
  Sin jerga. Ej: "La economía global está desacelerando sin entrar en recesión.
  El banco central americano ha comenzado a bajar tasas, lo que históricamente
  ha sido favorable para acciones y bonos de mediano plazo."]

PÁRRAFO 2 — POR QUÉ ESTA ASIGNACIÓN (¿qué justifica cada decisión?):
  [Explicar la lógica detrás de las 2-3 posiciones más importantes.
  Conectar el contexto con la acción concreta. Ej: "Con tasas bajando en USA,
  los TES colombianos de mediano plazo se aprecian porque su tasa fija alta
  se vuelve más atractiva relativa al mercado. Además, Banrep sigue recortando,
  lo que añade un catalizador local al movimiento."]

PÁRRAFO 3 — LOS RIESGOS PRINCIPALES (¿qué puede salir mal?):
  [Los 2 riesgos más importantes en términos concretos. No listado técnico —
  narrativa clara. Ej: "El mayor riesgo es que la inflación en USA vuelva a subir,
  lo que obligaría al FED a pausar o revertir las bajadas de tasas. En ese caso,
  los bonos de mediano plazo perderían valor y el dólar se fortalecería,
  presionando el peso colombiano y el COLCAP."]

PÁRRAFO 4 — LA OPORTUNIDAD ESPECÍFICA (¿por qué ahora?):
  [Si hay una oportunidad táctica de timing, explicarla. Ej: "El oro lleva
  3 semanas corrigiendo desde máximos históricos y está llegando a una zona
  de soporte técnico relevante. Los bancos centrales siguen comprando oro
  a niveles récord. Esta combinación — corrección temporal en tendencia alcista
  estructural — es históricamente una entrada atractiva."]

PÁRRAFO 5 — QUÉ HACE CAMBIAR LA TESIS (¿cuándo estar equivocado?):
  [Ser explícito sobre la condición de invalidación. Ej: "Esta tesis es válida
  mientras el FED continúe su ciclo bajista. Si el próximo IPC supera el 3.5%
  o el FED señala una pausa prolongada, la recomendación de TES mediano y
  renta variable growth debe revisarse. Monitorear el dato del IPC de cada mes."]
```

---

## SECCIÓN 8 — PRÓXIMOS PASOS (qué hacer hoy, esta semana, este mes)

```
PLAN DE ACCIÓN — HORIZONTE DE EJECUCIÓN

HOY (acciones inmediatas — si el semáforo de riesgo lo requiere):
  ✅ [Acción 1 con instrucción específica]
  ✅ [Acción 2 con instrucción específica]
  [Si no hay acciones urgentes: "No se requieren acciones inmediatas.
   El portafolio actual es consistente con la señal del mercado."]

ESTA SEMANA (acciones tácticas — 1-7 días):
  📌 [Acción: ej. "Comprar $[X] en IAU (oro) — DCA en 3 partes de $[X] c/u"]
  📌 [Acción: ej. "Renovar CDT vencido a TES 5Y — mayor rendimiento mismo plazo"]
  📌 [Acción: ej. "Revisar la posición en [activo] si el precio cae a $[X]"]

ESTE MES (acciones estratégicas — 1-4 semanas):
  📋 [Acción: ej. "Reducir exposición a [sector] de [X]% a [X]% al vencimiento del CDT"]
  📋 [Acción: ej. "Evaluar el reporte de earnings de [empresa] el [fecha]"]
  📋 [Acción: ej. "Rebalancear renta variable si supera [X]% del portafolio"]

PRÓXIMA REVISIÓN PROGRAMADA:
  Fecha sugerida: [fecha concreta — típicamente en la próxima reunión de Banrep/FED]
  O antes si: [condición de revisión anticipada más probable]

RECORDATORIO PARA EL USUARIO:
  · Monto mínimo de liquidez a mantener: $[X] COP / $[X] USD — no invertir todo
  · Precio de alerta en [activo]: $[X] — si cae aquí, evaluar reducción o compra adicional
  · Límite de pérdida tolerable ya confirmado: [X]% → equivale a $[X] — monitorear mensualmente
```

---

## FORMATOS ESPECIALES POR TIPO DE CONSULTA

### Reporte de mercado rápido (sin portafolio del usuario):

```
Cuando el usuario pregunta qué está pasando en el mercado sin tener un portafolio
específico, el reporte se simplifica a:

① CABECERA EJECUTIVA (obligatoria)
② DASHBOARD DE SEÑALES (adaptado)
③ TABLA DE POSICIONAMIENTO SUGERIDO (portafolio tipo para el perfil)
④ TOP 3 OPORTUNIDADES + TOP 2 RIESGOS (en formato lista, sin elaborar)
⑤ CATALIZADORES PRÓXIMOS 30 DÍAS
```

### Reporte de análisis de activo único:

```
Cuando el usuario pregunta por un activo específico (¿vale la pena comprar X?):

① CABECERA EJECUTIVA con respuesta directa: SÍ / NO / ESPERAR + precio objetivo
② TABLA DE TRADE SETUP completa
③ TESIS ALCISTA en 3 puntos concretos
④ TESIS BAJISTA en 2 puntos concretos (los riesgos reales)
⑤ CONDICIÓN DE ENTRADA: precio, volumen, catalizador a esperar
⑥ CONDICIÓN DE SALIDA: cuándo vender (target + stop loss)
```

### Reporte de revisión de portafolio existente:

```
Cuando el usuario trae su portafolio actual para revisarlo:

① CABECERA: diagnóstico en una oración ("Tu portafolio está bien /
   tiene una concentración que corregir / está tomando más riesgo del declarado")
② DIAGNÓSTICO RÁPIDO: qué está funcionando + qué no + qué falta
③ TABLA: ACTUAL vs OBJETIVO con las diferencias destacadas
④ PLAN DE REBALANCEO: qué vender primero, qué comprar, en qué orden
⑤ IMPACTO DEL REBALANCEO: retorno esperado antes vs después + riesgo antes vs después
⑥ COSTO DEL REBALANCEO: estimación de comisiones + impuesto si aplica (Colombia: GMF)
```

---

## REGLAS DE REDACCIÓN DEL REPORTE

```
REGLAS DE CLARIDAD (obligatorias en todo reporte):

① Todo número en porcentaje va acompañado de su equivalente en COP o USD
   MAL : "El portafolio puede perder un 12%"
   BIEN: "El portafolio puede perder un 12% (aproximadamente $6M COP)"

② Toda acción tiene un plazo y un instrumento específico
   MAL : "Aumentar exposición a renta fija"
   BIEN: "Comprar TES tasa fija vencimiento 2030 por el equivalente al 15%
          del portafolio, máximo a [X]% de rendimiento"

③ Toda métrica de riesgo tiene su interpretación en lenguaje cotidiano
   MAL : "El VaR 99% a 1 mes es del 8%"
   BIEN: "En el peor mes esperado (ocurre aproximadamente una vez al año),
          el portafolio perdería hasta el 8% — unos $[X]"

④ Los catalizadores tienen fecha o condición específica
   MAL : "Próximamente el FED podría bajar tasas"
   BIEN: "La reunión del FED del [fecha] — si baja tasas, [acción inmediata]"

⑤ Las tesis tienen una condición de invalidación explícita
   MAL : "El oro es una buena inversión"
   BIEN: "El oro es atractivo mientras las tasas reales permanezcan bajo 2%.
          Si el UST 10Y real sube sobre ese nivel, revisar la posición"

⑥ El stop loss siempre va con el target (nunca uno sin el otro)
   MAL : "Comprar con precio objetivo de $[X]"
   BIEN: "Comprar con precio objetivo $[X] (+[X]%) y stop loss en $[X] (-[X]%)"

⑦ Los plazos son concretos, no vagos
   MAL : "A mediano plazo"
   BIEN: "En los próximos 6-12 meses"

⑧ Las alertas del risk engine se traducen a acciones
   MAL : "El risk engine detectó concentración en energía"
   BIEN: "Tu exposición al sector energético (Ecopetrol + XLE) es del 32%,
          superando el límite recomendado del 25%. Reducir [X] de [activo]
          por $[X] esta semana"
```

---

## REGLAS DEL SISTEMA

1. **La cabecera es no negociable** — siempre aparece primero y siempre contesta las 4 preguntas.
2. **La tabla de recomendaciones es el output más importante** — si solo hay tiempo para una sección, es esta.
3. **Nunca ambigüedad en las acciones** — COMPRAR / VENDER / MANTENER / REDUCIR son las únicas acciones. Sin "considerar" ni "evaluar".
4. **Todo número en doble unidad** — porcentaje Y valor absoluto en moneda del usuario.
5. **El plan de acción tiene tres horizontes** — hoy / esta semana / este mes. Sin mezclarlos.
6. **La narrativa responde preguntas** — no describe procesos ni resume módulos.
7. **Las condiciones de invalidación son obligatorias** — sin condición de invalidación no hay tesis, hay opinión.
8. **El reporte adapta su profundidad al perfil del usuario** — principiante ve más contexto, avanzado ve más métricas.
9. **El semáforo del risk engine siempre aparece en la cabecera** — el usuario sabe el nivel de riesgo antes de leer las recomendaciones.
10. **El reporte cierra con el próximo paso** — el usuario siempre sabe cuándo volver a revisar y bajo qué condiciones.

---

## REFERENCIA A ARCHIVOS ADICIONALES

- `references/report_templates.md` — Plantillas completas por tipo de consulta y perfil de usuario
- `references/plain_language_glossary.md` — Diccionario de traducción de términos técnicos a lenguaje cotidiano
