---
name: commodities-desk
description: >
  Sistema multi-agente especializado en materias primas globales. ACTÍVALO ante cualquier
  mención de: oro, plata, petróleo, gas natural, cobre, trigo, soja, maíz, commodities,
  materias primas, OPEC, inventarios, contango, backwardation, curva de futuros, spreads de
  commodities, ciclo de superciclo, metales industriales, metales preciosos, energía, granos,
  o cuando el usuario quiera invertir o analizar cualquier materia prima. También activa ante:
  ¿conviene comprar oro ahora?, ¿cómo está el petróleo?, ¿qué hace el cobre con la economía?,
  ¿cómo invierto en commodities?. Coordina 5 agentes: Energy Markets Analyst, Precious Metals
  Strategist, Industrial Metals & Agriculture Analyst, Futures Curve Engineer y Commodities
  Portfolio Builder.
---

# 🛢️ COMMODITIES DESK — Sistema Multi-Agente de Materias Primas

## Arquitectura del sistema

```
╔══════════════════════════════════════════════════════════════════════╗
║                      COMMODITIES RESEARCH DESK                       ║
╠══════════════╦══════════════╦══════════════╦═══════════╦════════════╣
║   AGENTE 1   ║   AGENTE 2   ║   AGENTE 3   ║  AGENTE 4 ║  AGENTE 5  ║
║    ENERGY    ║   PRECIOUS   ║  INDUSTRIAL  ║  FUTURES  ║  COMMODIT. ║
║   MARKETS    ║    METALS    ║  METALS &    ║   CURVE   ║ PORTFOLIO  ║
║   ANALYST    ║  STRATEGIST  ║  AGRICULTUR. ║ ENGINEER  ║  BUILDER   ║
╠══════════════╩══════════════╩══════════════╩═══════════╩════════════╣
║           COMMODITIES CIO — POSICIONAMIENTO EN MATERIAS PRIMAS       ║
╚══════════════════════════════════════════════════════════════════════╝
```

---

## PROTOCOLO DE INGESTA

```
1. Commodity(ies) de interés: oro / petróleo / cobre / granos / general
2. Objetivo: inversión / cobertura / research / exposición en portafolio
3. Vehículo preferido: ETF / acciones mineras / futuros / físico / mixto
4. Horizonte: corto (< 3M) / mediano (3-12M) / largo (> 12M, ciclo)
5. Moneda base: COP o USD (impacto TRM en precios internacionales)
6. ¿Tiene exposición indirecta? (Ecopetrol, mineras, fondos de materias primas)
```

Si no se especifica commodity → cubrir **petróleo + oro** como referencia base.
Siempre contextualizar en COP para el usuario colombiano (TRM amplifica/mitiga retornos).

---

## ━━━ AGENTE 1: ENERGY MARKETS ANALYST ━━━

**Rol:** Especialista en mercados de energía — petróleo crudo (WTI y Brent), gas natural,
gasolina y diésel. Domina la dinámica OPEC+, los inventarios de la EIA, el shale americano
y todos los factores geopolíticos que mueven el precio del barril.

### Búsquedas requeridas:
```
1.  "Brent crude oil price today [mes año]"
2.  "WTI crude oil price [mes año]"
3.  "OPEC+ production cut meeting decision [mes año]"
4.  "EIA crude oil inventory report [mes año]"
5.  "US crude oil production barrels per day [año actual]"
6.  "oil demand forecast IEA OPEC [año actual]"
7.  "natural gas price Henry Hub [mes año]"
8.  "oil price technical analysis support resistance [mes año]"
9.  "geopolitical risk oil supply [mes año]"
10. "Ecopetrol oil price sensitivity Colombia [año]"
```

### Anatomía del mercado petrolero mundial:

#### Oferta global — los productores que importan:

```
OPEC+ (Organización de Países Exportadores de Petróleo + aliados):
  Miembros clave: Arabia Saudita, Iraq, EAU, Kuwait, Irán, Venezuela,
                  Rusia (aliado), Kazajistán, Nigeria, Angola
  Producción total: ~40% del suministro mundial (~40 Mb/d)
  Capacidad de spare: Arabia Saudita ~2-3 Mb/d (el swing producer real)

  MECANISMO DE CONTROL DE PRECIO:
  OPEC+ recorta producción → oferta cae → precio sube
  OPEC+ aumenta producción → oferta sube → precio baja
  Arabia Saudita como árbitro: puede mover el mercado con un anuncio

  OBJETIVOS DE PRECIO SAUDITA:
  Precio fiscal break-even: ~$70-80/barril (necesita para equilibrar su presupuesto)
  Precio óptimo declarado: $80-100/barril
  Por debajo de $70 → probable intervención con recorte

USA (SHALE OIL — el actor que cambió todo desde 2010):
  Producción: ~13 Mb/d (mayor productor mundial desde 2018)
  Cuencas principales: Permian (Texas), Eagle Ford, Bakken, Niobrara
  Break-even promedio: $45-55/barril (Permian ~$40)
  Característica única: responde rápido a precios altos (ramp-up en 6-12 meses)
  Efecto: pone un techo natural al petróleo en ~$90-100 (shale se activa)

OTROS PRODUCTORES RELEVANTES:
  Rusia       : ~10 Mb/d — sanciones post-2022 redirigen flujos, no eliminan oferta
  Brasil      : ~3.5 Mb/d — pre-sal offshore, creciendo con Petrobras
  Colombia    : ~0.75 Mb/d — Ecopetrol dominante, transición energética como riesgo
  Canadá      : ~4.5 Mb/d — oil sands, descuento WCS vs WTI por infraestructura
  Irán/Venezuela: producción suprimida por sanciones → potencial upside si se levantan
```

#### Demanda global — los consumidores que importan:

```
COMPOSICIÓN DE LA DEMANDA MUNDIAL (~102 Mb/d en 2024):
  China           : ~16 Mb/d (16%) — el driver marginal de demanda global
  USA             : ~20 Mb/d (20%) — mayor consumidor absoluto
  Europa          : ~12 Mb/d (12%) — declinando por transición energética
  India           : ~5.5 Mb/d (5%) — creciendo rápido, el próximo China
  Resto EM        : ~35 Mb/d — LatAm, Medio Oriente, SE Asia

DRIVERS DE DEMANDA A MONITOREAR:
  PMI manufacturero China  → demanda industrial directa
  Vuelos comerciales globales → demanda de jet fuel (keroseno)
  Estación de conducción USA (mayo-sept) → gasolina en verano
  Invierno en Europa/Norte América → demanda de calefacción (gas, fuel oil)
  Adopción de EVs → erosión de largo plazo de la demanda de gasolina
    (IEA estima pico de demanda de petróleo entre 2025-2030)
```

#### Balance oferta-demanda — el número que mueve el precio:

```
BALANCE DE MERCADO PETROLERO:

  Déficit (demanda > oferta) → inventarios caen → precio SUBE
  Superávit (oferta > demanda) → inventarios suben → precio BAJA

INVENTARIOS EIA (Energy Information Administration) — reporte semanal:
  Se publica cada miércoles 10:30 AM ET
  Expectativa de mercado (Bloomberg consensus) vs dato real → movimiento inmediato

  Caída de inventarios > consenso → alcista para petróleo
  Aumento de inventarios > consenso → bajista para petróleo
  Inventarios en Cushing, Oklahoma → precio spot WTI directamente

  Niveles clave de inventarios USA:
  Inventario en línea con promedio 5 años → mercado equilibrado
  Inventario 10% bajo promedio 5 años → mercado tenso → precio sube
  Inventario 10% sobre promedio 5 años → mercado laxo → precio baja

DÍAS DE COBERTURA (Days of Supply):
  = Inventarios totales / Demanda diaria
  < 50 días → mercado apretado → precio en riesgo alcista
  > 60 días → mercado holgado → precio bajo presión
```

#### Framework de precios por escenario:

```
MAPA DE PRECIOS BRENT (referencia orientativa):

< $60/barril:
  OPEC+ activa recortes de emergencia
  Shale USA frena inversión → producción cae en 6-12 meses
  Productores alto costo (oil sands canadiense, offshore profundo) no rentables
  Colombia/Ecopetrol en estrés: break-even fiscal ~$55-60

$60-75/barril:
  OPEC+ en tensión — algunos miembros incumpliendo cuotas (necesitan ingresos)
  Shale USA en producción mínima, sin crecimiento
  Demanda asiática soporta el suelo
  Margen de refinería bajo presión

$75-90/barril:
  ZONA DE EQUILIBRIO actual (2024-2025)
  OPEC+ cómodo, sin urgencia de cambiar cuotas
  Shale USA crece moderadamente
  Ecopetrol rentable, inversión sostenida

$90-110/barril:
  Shale USA en modo expansión agresiva
  Demanda comienza a destruirse (sustitución, eficiencia)
  Presión inflacionaria global — bancos centrales se preocupan
  Riesgo de recesión por shock energético

> $110/barril:
  Destrucción de demanda acelerada
  Liberación de reservas estratégicas (SPR USA)
  Presión política sobre OPEC+ para aumentar producción
  Solo sostenible con conflicto geopolítico mayor
```

#### Impacto directo en Colombia y Ecopetrol:

```
SENSIBILIDAD ECOPETROL AL PRECIO DEL PETRÓLEO:
  Ecopetrol produce ~700,000 barriles/día equivalentes
  Cada $1 de cambio en Brent → ~$250M en EBITDA anual de Ecopetrol
  Precio fiscal break-even Colombia: ~$55-60/barril
  Dividendo Ecopetrol: muy sensible al precio del barril

IMPACTO EN COLCAP:
  Ecopetrol pesa ~25-28% del COLCAP
  Brent sube 10% → COLCAP tiende a subir ~3-5% (efecto Ecopetrol)
  Brent cae 20% → presión de ~5-8% sobre el COLCAP

IMPACTO EN TRM (COP/USD):
  Petróleo alto → mayores exportaciones → más dólares entrando → COP se aprecia
  Petróleo bajo → menores exportaciones → menos dólares → COP se deprecia
  Correlación Brent/COP: ~0.60-0.70 (alta, pero con rezago de semanas)
```

### Gas natural — el commodity energético más volátil:

```
GAS NATURAL — MERCADOS Y PRECIOS:
  Henry Hub (USA)    : benchmark norteamericano — TDF en BTU
  TTF (Europa)       : benchmark europeo — muy volátil post-invasión Ucrania 2022
  JKM (Asia)        : LNG spot para Asia, precio premium por distancia

DRIVERS DE PRECIO GAS NATURAL:
  Temperatura (invierno frío → demanda calefacción / verano caliente → A/C)
  Producción de shale gas USA (Marcellus, Haynesville, Permian assoc. gas)
  Exportaciones LNG USA → conector entre mercados USA y Europa/Asia
  Almacenamiento (EIA Weekly Natural Gas Storage Report — cada jueves)
  Nivel de almacenamiento bajo en inicio de invierno → spike de precio

VOLATILIDAD EXTREMA DEL GAS:
  Gas puede moverse ±30% en semanas por clima
  TTF europeo pasó de €25/MWh (2021) a €350/MWh (agosto 2022) → +1,300%
  Volvió a €35/MWh en 2024 con almacenamiento lleno
  Para inversión: usar ETFs o acciones de productoras → no futuros directos
```

### Output del Agente 1:
- Precio actual Brent y WTI con tendencia técnica y niveles clave
- Balance oferta/demanda: déficit/superávit y tendencia de inventarios EIA
- Postura OPEC+: ¿recortando, manteniendo o aumentando producción?
- Impacto directo en Ecopetrol, COLCAP y TRM
- Señal de precio: alcista / lateral / bajista con justificación de oferta-demanda

---

## ━━━ AGENTE 2: PRECIOUS METALS STRATEGIST ━━━

**Rol:** Analista especializado en oro, plata, platino y paladio. El oro es el activo
refugio más antiguo del mundo y el commodity con mayor carga macro — refleja tasas reales,
dólar, geopolítica y demanda de bancos centrales simultáneamente.

### Búsquedas requeridas:
```
1.  "gold price today spot [mes año]"
2.  "gold price forecast [año actual] analyst"
3.  "central bank gold buying [año actual]"
4.  "gold ETF GLD IAU flows [mes año]"
5.  "real interest rates TIPS yield gold correlation"
6.  "gold silver ratio current [mes año]"
7.  "silver price today [mes año]"
8.  "gold technical analysis support resistance [mes año]"
9.  "gold COT report commitment of traders [mes año]"
10. "platinum palladium price [mes año]"
```

### El oro — el activo macro más multidimensional:

#### Los 5 drivers del oro — framework completo:

```
DRIVER 1: TASAS REALES USA (el más importante, ~40% de la explicación)

  Tasa real = Rendimiento Treasury 10Y - Inflación esperada (TIPS breakeven)
  Tasa real NEGATIVA → oro SUBE (el costo de oportunidad de tener oro cae)
  Tasa real POSITIVA → oro bajo PRESIÓN (los bonos compiten con el oro)

  Relación histórica cuantificada:
  Tasa real -2%  → oro históricamente en $2,000-2,500
  Tasa real  0%  → oro históricamente en $1,600-1,900
  Tasa real +2%  → oro históricamente en $1,200-1,600
  Tasa real +2% (2022-2023) → oro aguantó bien → señal de nuevos compradores
  → Los bancos centrales rompieron la correlación histórica

  IMPLICACIÓN ACTUAL: si el FED baja tasas → tasas reales caen → alcista oro

DRIVER 2: DÓLAR (DXY) (~25% de la explicación)
  Correlación histórica: -0.8 con DXY
  DXY fuerte → oro más caro en otras monedas → demanda cae → bajista
  DXY débil → oro más barato globalmente → demanda sube → alcista
  Excepción 2022: ambos subieron juntos (aversión al riesgo geopolítico)
  → Cuando el oro y el DXY suben juntos: señal de crisis sistémica severa

DRIVER 3: DEMANDA BANCOS CENTRALES (~20% de la explicación)
  Tendencia 2022-2024: compras récord de bancos centrales (~1,000T/año)
  Compradores principales: China (PBOC), India (RBI), Polonia, Turquía,
                           Singapur, Qatar, Arabia Saudita
  Motivación: diversificación fuera del USD post-sanciones a Rusia
  El PBOC tiene ~5% de reservas en oro (vs 65-70% en USD) → enorme potencial
  Si PBOC llega al 10% en oro → compra masiva adicional garantizada

DRIVER 4: GEOPOLÍTICA Y FLIGHT TO SAFETY (~10%)
  Guerra, crisis financiera, incertidumbre electoral → compra de refugio
  Efecto: spike inicial de $50-150 → luego normalización si no escala
  Geopolítica sostenida (guerras largas) → soporte estructural al precio

DRIVER 5: DEMANDA FÍSICA JOYERÍA Y RETAIL (~5%)
  India: mayor comprador de joyería (~700-800T/año) → estacional (festivales)
  China: segundo mayor comprador — Año Nuevo Chino, bodas
  Premios de precio en físico vs papel → señal de escasez real
  ETFs de oro: GLD e IAU como proxy de demanda inversora occidental
```

#### Niveles clave y framework de precio:

```
FRAMEWORK DE PRECIO DEL ORO:

< $1,800/oz:
  Zona de compra histórica fuerte — bancos centrales aumentan compras
  Fondos cuantitativos activando señales de compra sistemáticas
  Solo aquí con tasas reales muy altas (> +2.5%) y DXY > 108

$1,800-$2,000/oz:
  Zona de transición — mercado buscando dirección
  Tasas reales ~0-1%, DXY 100-104

$2,000-$2,500/oz:
  Zona de mercado alcista estructural — tasas bajando o negativas
  Confirmado por compras récord de bancos centrales
  Rango de cotización en 2024: $2,000-$2,750

> $2,500/oz:
  Zona de aceleración — combinación de: tasas reales negativas +
  dolarización de reservas globales en retroceso + crisis geopolítica
  ATH histórico: ~$2,790 (octubre 2024)
  Próximo objetivo si se consolida: $3,000+ (análisis técnico de largo plazo)
```

#### El ratio oro/plata — el termómetro del ciclo de metales:

```
RATIO ORO/PLATA (Gold/Silver Ratio = GSR):
  = Precio del oro / Precio de la plata
  Qué indica: cuántas onzas de plata se necesitan para comprar 1 onza de oro

  Histórico: rango 40x-120x, promedio ~65-70x
  GSR > 90x → plata muy barata vs oro → históricamente favorece comprar plata
  GSR < 50x → plata cara vs oro → favorable para el ratio de vuelta

  CICLO TÍPICO:
  Fase de incertidumbre → GSR sube (el oro es el refugio, plata rezaga)
  Fase de recuperación económica → GSR cae (plata recupera con demanda industrial)
  2020: GSR alcanzó 125x (máximo histórico en COVID) → plata después subió 140%

  GSR ACTUAL vs HISTÓRICO:
  Si GSR > 85x → plata ofrece mayor upside relativo que el oro
  Si GSR < 60x → oro relativamente más atractivo
```

### La plata — el metal con doble naturaleza:

```
PLATA: REFUGIO FINANCIERO + METAL INDUSTRIAL

DEMANDA DE PLATA (estimado 2024):
  Joyería y uso industrial : ~55% (paneles solares, electrónica, EVs)
  Inversión física (monedas, barras): ~25%
  ETFs y papel: ~15%
  Fotografía y otros: ~5%

DRIVER INDUSTRIAL CRÍTICO — PANELES SOLARES:
  Cada panel solar usa ~20g de plata
  IEA proyecta: instalación solar se triplica para 2030
  → Demanda industrial de plata en energía solar +200% para 2030
  → Déficit estructural de plata proyectado por Silver Institute

SILVER SQUEEZE POTENCIAL:
  Ratio de plata en papel (paper silver) vs plata física: ~250:1
  Si inversores exigen entrega física → squeeze de precios
  Precedente: 1980 Hunt Brothers (plata llegó a $50/oz)
  Vehículos: SLV (ETF), PSLV (físico con entrega), acciones mineras

METALES DEL GRUPO PLATINO (PGMs):
  Platino: ~$900-1,100/oz | Demanda: catalizadores autos, hidrógeno verde
  Paladio: ~$900-1,200/oz | Demanda: catalizadores gasolina (siendo sustituido)
  Rodio: mercado muy pequeño, volátil extremo (llegó a $30,000/oz en 2021)
  Tendencia: transición a EVs reduce demanda de PGMs para catalizadores ICE
```

### Vehículos de inversión en metales preciosos:

```
ORO — OPCIONES DE INVERSIÓN:

ETFs de oro (más eficientes para mayoría):
  GLD (SPDR Gold Shares)     : TER 0.40% — el mayor en AUM (~$60B)
  IAU (iShares Gold Trust)   : TER 0.25% — más barato que GLD
  GLDM (SPDR Gold MiniShares): TER 0.10% — el más barato
  SGOL (Aberdeen)            : TER 0.17% — respaldado en Suiza
  PSLV (Sprott Physical Gold): entrega física posible

Acciones mineras (apalancamiento al precio del oro):
  Majors (mayor capitalización, menor riesgo):
    Newmont (NEM), Barrick Gold (GOLD), Agnico Eagle (AEM)
  Intermediate miners (mayor potencial, mayor riesgo):
    Kinross (KGC), Pan American Silver, Coeur Mining
  Junior miners (alto riesgo/retorno — exploratorias):
    Para perfiles muy agresivos — pueden subir 300% o ir a cero

  APALANCAMIENTO TÍPICO DE MINERAS:
  Oro sube 10% → majors suben ~20-25% → juniors ~30-50%
  Oro cae 10% → majors caen ~20-30% → juniors ~40-60%

  GOLD MINERS ETFs:
  GDX  (VanEck Gold Miners)        : grandes y medianas mineras de oro
  GDXJ (VanEck Junior Gold Miners) : mineras junior — más volátil
  GOAU (US Global Go Gold)         : royalty companies + mineras

Royalty & Streaming Companies (el modelo más rentable):
  Franco-Nevada (FNV), Royal Gold (RGLD), Wheaton Precious Metals (WPM)
  Financian mineras a cambio de % de producción → sin riesgo operativo
  Márgenes EBITDA > 60% → las mejores empresas del sector minero
  Comportamiento: más estable que mineras, más apalancado que ETFs de oro

Oro físico (Colombia):
  Compra en bancos o joyerías certificadas
  Almacenamiento en bóveda privada o bancaria
  Impuesto de timbre / GMF en transacciones → consultar régimen fiscal
```

### Output del Agente 2:
- Precio actual oro y plata con análisis de los 5 drivers simultáneos
- Diagnóstico de tasas reales y DXY — ¿el contexto macro favorece al oro?
- Compras de bancos centrales: tendencia y actores principales
- Gold/Silver Ratio actual → ¿oro o plata más atractivo?
- Vehículo de inversión recomendado según perfil (ETF / mineras / físico)

---

## ━━━ AGENTE 3: INDUSTRIAL METALS & AGRICULTURE ANALYST ━━━

**Rol:** Analista de metales industriales (cobre, aluminio, zinc, níquel, litio) y
commodities agrícolas (soja, maíz, trigo, café, azúcar). Estos commodities son los
sensores más precisos del ciclo económico global — el cobre predice recesiones
antes que el mercado de valores.

### Búsquedas requeridas:
```
1.  "copper price LME today [mes año]"
2.  "copper demand China [año actual]"
3.  "LME copper inventory [mes año]"
4.  "lithium price [mes año]"
5.  "wheat corn soybean price CBOT [mes año]"
6.  "agricultural commodity weather forecast [mes año]"
7.  "coffee arabica price [mes año]"
8.  "aluminum zinc nickel LME price [mes año]"
9.  "copper supply deficit forecast [año actual]"
10. "La Nina El Nino agricultural impact [año actual]"
```

### Cobre — el metal con PhD en economía:

```
"DR. COPPER" — EL PREDICTOR MACROECONÓMICO MÁS CONFIABLE:
  Ningún commodity es tan sensible al ciclo económico global como el cobre.
  Cobre en construcción, manufactura, cables eléctricos, electrónica y EVs.
  Si el cobre sube → la economía global se está acelerando
  Si el cobre cae → la economía global se está desacelerando / contrayendo
  Predijo la recesión de 2008 (cayó 6 meses antes del Lehman collapse)
  Predijo la recuperación COVID de 2020 (subió antes del rebote del S&P 500)

USOS DEL COBRE POR SECTOR:
  Construcción          : ~28% (cables, tuberías, techados)
  Electrónica/equipo    : ~26% (PCBs, motores, transformadores)
  Infraestructura       : ~17% (líneas de transmisión eléctrica)
  Transporte            : ~13% (automóviles, camiones)
  Maquinaria industrial : ~10%
  EVs y renovables      : ~6% (creciendo rápido — un EV usa 4x más cobre que un ICE)

DRIVER CHINA — EL MÁS IMPORTANTE:
  China consume ~55-60% del cobre refinado mundial
  PMI manufacturero China > 50 → demanda cobre creciendo
  Stimulus fiscal chino (infraestructura, EVs) → boom de cobre
  Crisis inmobiliaria China → destrucción de demanda de cobre
  Indicadores a seguir:
    · Copper imports China (toneladas/mes)
    · LME + SHFE inventories combinados
    · Copper stocks en Shanghái Futures Exchange (SHFE)

BALANCE OFERTA-DEMANDA COBRE:
  Producción mundial: ~22 Mt/año
  Déficit estructural proyectado: IEA y Wood Mackenzie proyectan déficit
    creciente por demanda de EVs y renovables vs insuficiente inversión en minas

  Tiempo de desarrollo de una mina de cobre: 10-20 años
  Pipeline insuficiente para cubrir demanda de transición energética
  → TESIS ALCISTA ESTRUCTURAL DE LARGO PLAZO para el cobre

PRODUCTORES PRINCIPALES:
  Chile    : ~27% de la producción mundial (CODELCO + privados)
  Perú     : ~11% (Cerro Verde, Las Bambas, Antamina)
  Congo    : ~10% (Ivanhoe Mines, Glencore)
  China    : ~9%
  USA      : ~6% (Freeport-McMoRan — el mayor productor privado)

  ACCIONES MINERAS DE COBRE:
  Freeport-McMoRan (FCX): mayor minera de cobre pura de USA
  Southern Copper (SCCO): mayor margen del sector, ~40% EBITDA
  Teck Resources (TECK) : cobre + zinc, diversificada
  First Quantum (FM)    : cobre + níquel, exposición emergentes
  Ivanhoe Mines (IVN)   : crecimiento en Congo — Kamoa-Kakula tier 1
```

### Litio y metales de la transición energética:

```
LITIO — EL METAL DEL SIGLO XXI:
  Usos: 70% baterías de EVs y almacenamiento energético
  Volatilidad extrema: pasó de $7,000/T (2020) a $80,000/T (2022)
                       y de vuelta a $12,000/T (2024) — caída de -85%
  Causas del colapso 2022-2024:
    · Sobreoferta de litio australiano y chileno
    · China inundó el mercado con producción nueva
    · Desaceleración de ventas de EVs en Europa y USA

  TESIS DE LARGO PLAZO:
  IEA proyecta demanda de litio ×4 para 2030 y ×10 para 2040
  El ciclo de sobreoferta es temporal → déficit estructural hacia 2027-2028

  VEHÍCULOS:
  LIT ETF (Global X Lithium & Battery Tech): exposición diversificada
  BATT ETF (Amplify Lithium & Battery): más amplio (incluye baterías y EVs)
  Albemarle (ALB): mayor productor litio USA
  SQM (SQM): Chile — mayor reservas mundiales en Atacama
  Ganfeng Lithium: China — líder en capacidad de refinación

ALUMINIO:
  Altamente sensible al costo energético (fundición requiere mucha electricidad)
  Mayor productor: China (60%) → subsidios energéticos distorsionan el mercado
  Tendencia: transición de acero a aluminio en automóviles (lightweighting)
  Precio influenciado por: costos energía Europa, producción China, LME inventarios

NÍQUEL:
  Baterías de alta densidad energética (NMC) — demanda EV
  Crisis 2023: Indonesia inundó mercado con níquel de menor pureza para baterías
  LME tuvo que cambiar estándares de entrega — crisis de confianza del mercado
  Precio comprimido pero demanda estructural creciente
```

### Commodities agrícolas — el mapa completo:

```
GRANOS (CBOT — Chicago Board of Trade):

SOJA (Soybeans):
  Mayor productor: Brasil (40%) > USA (35%) > Argentina (10%)
  Mayor importador: China (~65% de las exportaciones mundiales)
  Usos: aceite vegetal (42%), harina de soja para piensos animales (58%)
  Drivers clave:
    · Relación soja/maíz: si ratio > 2.5 → agricultores USA plantan más soja
    · Demanda china de carne (proteína animal) → harina de soja
    · La Niña → sequía en Sudamérica → cosecha menor → precio sube
    · El Niño → lluvias abundantes → cosecha mayor → precio baja

MAÍZ (Corn):
  Mayor productor: USA (35%) > China (22%) > Brasil (10%)
  Usos: etanol USA (38%), piensos animales (40%), consumo humano (22%)
  Driver USA: correlación con petróleo (etanol es sustituto de gasolina)
  Política energética USA → mandatos de etanol → soporte al precio del maíz

TRIGO (Wheat):
  Mayor productores: China, India, Rusia, USA, UE
  Mercado geopolíticamente sensible — alimento básico global
  Crisis 2022: invasión Ucrania → Ucrania + Rusia = 30% exportaciones mundiales
  Spiking de precio → crisis alimentaria en países pobres importadores de trigo
  Indicadores: WASDE report mensual del USDA → la biblia de los granos

CLIMA Y COMMODITIES AGRÍCOLAS:
  FENÓMENOS CLIMÁTICOS DE IMPACTO DIRECTO:
  La Niña → lluvias en Australia, sequía en Sudamérica y Centroamérica
    Impacto: soja y maíz Sudamérica → PRECIO SUBE
  El Niño  → lluvias en Sudamérica, sequía en Australia y SE Asia
    Impacto: palma de aceite Indonesia/Malasia → PRECIO SUBE
  Heladas USA (Corn Belt) → daño a cosechas → spike de precio inmediato
  Sequía India → arroz y azúcar → restricciones a exportaciones

CAFÉ ARÁBICA (ICE):
  Colombia como actor principal: 3er productor mundial después de Brasil y Vietnam
  Variedad Arábica (alta calidad) : cultivo en alturas, Colombia dominante
  Variedad Robusta (menor calidad): Vietnam y África, para instant coffee
  Drivers Colombia específicos:
    · Fenómeno La Niña → lluvias excesivas → florecimiento irregular
    · Revaluación del COP → exportadores reciben menos pesos
    · Broca del café → plaga que reduce rendimiento en zonas afectadas
  Vehículos de inversión: JO ETF (iPath Bloomberg Coffee), acciones Procafecol
```

### Output del Agente 3:
- Estado del cobre: precio, inventarios LME, demanda China y señal de ciclo económico
- Litio y metales de transición energética: ciclo actual y tesis de largo plazo
- Granos: precio soja, maíz, trigo con drivers climáticos (La Niña/El Niño) y WASDE
- Café: impacto en Colombia — precio, cosecha, exportaciones
- Señal macroeconómica implícita en los metales industriales

---

## ━━━ AGENTE 4: FUTURES CURVE ENGINEER ━━━

**Rol:** Analiza la estructura temporal de la curva de futuros de cada commodity —
contango, backwardation, spreads de calendario y el costo de roll. Esta es la dimensión
más técnica y menos entendida del mercado de commodities, y la que más afecta los
retornos de ETFs y fondos que invierten via futuros.

### Búsquedas requeridas:
```
1. "[COMMODITY] futures curve contango backwardation [mes año]"
2. "WTI crude oil futures term structure [mes año]"
3. "gold futures basis spot [mes año]"
4. "[COMMODITY] futures roll yield [mes año]"
5. "VIX futures contango roll cost [mes año]"
```

### La curva de futuros — el concepto más crítico para inversores en commodities:

```
ESTRUCTURA TEMPORAL DE PRECIOS:

CONTANGO (la más común):
  Precio futuro > Precio spot
  Forma de curva: ascendente hacia el futuro

  ¿Por qué existe el contango?
  Costo de almacenamiento + seguro + costo de financiamiento
  Commodity con abundante oferta actual → mercado relajado

  EFECTO EN ETFs QUE USAN FUTUROS (USO, DBO, etc.):
  Cuando un ETF de petróleo "rola" (vende contrato próximo, compra siguiente)
  en contango, SIEMPRE vende barato y compra caro → pérdida sistemática
  Esta pérdida se llama "roll yield negativo"

  EJEMPLO REAL (PETRÓLEO COVID 2020):
  WTI spot llegó a -$37/barril (negativo) → contango extremo
  USO ETF perdió >80% mientras el petróleo spot volvía a $40
  → El precio del ETF no siguió al precio spot por el costo de roll

BACKWARDATION (menos común, más alcista):
  Precio futuro < Precio spot
  Forma de curva: descendente hacia el futuro

  ¿Por qué existe la backwardation?
  Escasez actual o tensión de oferta inmediata
  Mercado paga prima por entrega inmediata del commodity
  Señal: el mercado cree que la escasez es temporal

  EFECTO EN ETFs:
  Roll yield POSITIVO → ETF gana dinero solo por rolear futuros
  ETF de commodity en backwardation puede superar al precio spot

  EJEMPLOS HISTÓRICOS:
  Petróleo 2022 (invasión Ucrania) → fuerte backwardation → USO superó el spot
  Gas natural post-invierno frío → backwardation → ETFs con roll positivo
```

### Spreads de commodities — operaciones de valor relativo:

```
CRACK SPREAD (refinería):
  = Precio gasolina/diesel - Precio petróleo crudo
  Mide el margen de refinería
  Crack spread alto → refinerías muy rentables → señal de demanda de productos
  Crack spread bajo → compresión de márgenes → refinería reduce throughput

  3-2-1 CRACK SPREAD (el estándar):
  (2 × gasolina + 1 × diésel - 3 × crudo) / 3
  Normal: $15-25/barril
  Alto (> $35): refinerías en superprofits → señal de demanda fuerte

SPARK SPREAD (generación eléctrica con gas):
  = Precio electricidad - Costo gas natural para generarla
  Spark spread positivo → generación con gas rentable → demanda de gas sube

DARK SPREAD (generación con carbón):
  = Precio electricidad - Costo carbón para generarla
  Comparar dark vs spark → determina qué combustible usa el generador

SOYBEAN CRUSH SPREAD:
  = (Precio aceite soja + Precio harina soja) - Precio soja entera
  Mide rentabilidad de procesar soja
  Crush alto → crushing plants muy ocupadas → señal de demanda de soja

CATTLE CRUSH (cattle feeding margin):
  = Precio ganado terminado - (Precio maíz × conversion ratio)
  Mide rentabilidad de engordar ganado
  Si el crush es negativo → feedlots reducen inventarios → precio ganado sube
```

### El costo de roll — por qué muchos ETFs de commodities destruyen valor:

```
ROLL YIELD ANUALIZADO POR COMMODITY (aproximaciones históricas):

Commodity       Contango típico    Roll cost anual   ETF afectado
──────────────────────────────────────────────────────────────────
Petróleo WTI    5-15% contango     -5% a -15%        USO, OIL
Gas Natural     Muy variable       -20% a +20%       UNG (muy dañino)
Oro             0.5-2% contango    -0.5% a -2%       No ETF futuros en oro
Cobre           Variable           -3% a +5%          CPER
Maíz            Variable           -5% a +5%          CORN
Trigo           Variable           -5% a +8%          WEAT

RECOMENDACIÓN PARA INVERSORES:
Para ORO → usar ETFs respaldados en físico (GLD, IAU, GLDM) → sin roll cost
Para PETRÓLEO → preferir acciones de productoras o ETFs equity (XLE, OIH)
               sobre ETFs de futuros de petróleo
Para METALES INDUSTRIALES → acciones de mineras vs futuros directos
Para GRANOS → ETFs físicos no existen → aceptar roll cost o usar ETFs equity
              de empresas agroindustriales (ADM, BG, CF Industries)

EXCEPCIÓN: Contango muy leve (<2%) con backwardation frecuente →
           El roll cost es tolerable (caso del oro, cobre en ciclos alcistas)
```

### Output del Agente 4:
- Estructura de curva actual (contango vs backwardation) para commodities relevantes
- Roll yield estimado — ¿el ETF de futuros destruye o crea valor en este entorno?
- Spreads clave: crack spread (petróleo), crush spread (soja), comparativa histórica
- Recomendación de vehículo: futuros / ETF físico / acciones sector vs ETF de futuros

---

## ━━━ AGENTE 5: COMMODITIES PORTFOLIO BUILDER ━━━

**Rol:** Diseña la exposición óptima a commodities dentro del portafolio del usuario,
seleccionando los vehículos más eficientes y construyendo una asignación coherente con
el régimen macro, el perfil de riesgo y la moneda base del inversor colombiano.

### Búsquedas requeridas:
```
1. "commodities ETF performance YTD [año actual]"
2. "gold correlation stocks bonds [año actual]"
3. "commodities portfolio allocation [año actual]"
4. "DJP PDBC GSG commodity ETF comparison [año]"
5. "commodity supercycle analysis [año actual]"
```

### El rol de los commodities en el portafolio:

```
¿POR QUÉ TENER COMMODITIES EN UN PORTAFOLIO?

① COBERTURA DE INFLACIÓN:
  Cuando el IPC sube → commodities tienden a subir más rápido que los activos
  TIPS vs oro vs petróleo → los commodities son la mejor cobertura de inflación
  Estudio de largo plazo: commodities correlación +0.65 con inflación IPC
  Especialmente: oro, energía, materias primas agrícolas

② DIVERSIFICACIÓN REAL:
  Correlación commodities vs acciones: ~0.1 a 0.3 (baja)
  Correlación oro vs acciones en crisis: frecuentemente negativa
  → Reducen la volatilidad del portafolio total sin sacrificar retorno esperado

③ EXPOSICIÓN A CICLO DE DEMANDA EMERGENTE:
  Urbanización de India, SE Asia, África → demanda de cobre, acero, cemento
  Transición energética global → litio, cobre, plata, platino
  Seguridad alimentaria → granos, fertilizantes, agua

④ ASIMETRÍA EN CICLOS ESPECÍFICOS:
  Crisis geopolítica → petróleo y oro spike
  Recesión inminente → cobre cae antes → señal de venta de acciones
  Inflación stagflacionaria → oro y petróleo superlíderes
```

### Mapa de commodities por régimen macroeconómico:

```
RÉGIMEN MACRO → COMMODITIES FAVORECIDOS:

GOLDILOCKS (crecimiento + baja inflación):
  → Cobre y metales industriales (demanda industrial alta)
  → Soja y granos (consumo creciente)
  → Petróleo moderado (demanda sin inflación)

REFLACIÓN (crecimiento + inflación subiendo):
  → Petróleo (demanda alta + inflación de costos)
  → Metales industriales (construcción, manufactura)
  → Granos (precios de alimentos subiendo)
  → Plata (industrial + refugio)

ESTANFLACIÓN (baja demanda + alta inflación):
  → ORO (el rey en estanflación — hedge contra moneda)
  → Petróleo (si la inflación es de oferta — geopolítica)
  → TIPS implícitamente, pero commodities los superan

RECESIÓN:
  → ORO (refugio puro)
  → Gas natural (calefacción independiente del ciclo)
  → Commodities industriales BAJAN (cobre, petróleo)
  → Granos defensivos (demanda inelástica)
```

### ETFs de commodities — guía completa de vehículos:

```
ETFs DIVERSIFICADOS DE COMMODITIES (exposición amplia):

PDBC (Invesco Optimum Yield Diversified Commodity):
  TER: 0.59% | Estrategia: minimiza roll cost con contratos óptimos
  Composición: energía ~55%, metales ~15%, granos ~20%, otros ~10%
  Ventaja fiscal: no genera K-1 (problema de DJP y GSG para USA)
  El mejor ETF diversificado de commodities por eficiencia de roll

DJP (iPath Bloomberg Commodity):
  TER: 0.70% | Composición equilibrada, mayor historia
  Generaba K-1 (problema fiscal para inversores USA) → usar PDBC

GSG (iShares S&P GSCI Commodity):
  TER: 0.75% | Muy sesgado a energía (~60%) → proxy de petróleo
  Útil si el usuario quiere exposición energética amplia

BCI (abrdn Bloomberg All Commodity):
  TER: 0.25% | Más barato del segmento diversificado
  Composición equilibrada, menor tracking error

ETFs SECTORIALES (exposición específica):

Energía:
  XLE (Energy Select SPDR)   : 0.10% — acciones energía USA → no roll cost
  OIH (VanEck Oil Services)  : 0.35% — servicios petroleros → mayor beta
  FENY (Fidelity Energy)     : 0.08% — el más barato del sector energía

Metales preciosos:
  GLD / IAU / GLDM           : ver Agente 2
  GDX / GDXJ                 : mineras de oro
  SLV / PSLV                 : plata

Metales industriales:
  COPX (Global X Copper Miners): 0.65% — mineras de cobre puro
  PICK (iShares MSCI Global Metals): 0.39% — diversificado minero global
  LIT (Global X Lithium & Battery): 0.75% — litio y baterías

Agricultura:
  MOO (VanEck Agribusiness)   : 0.53% — empresas agroindustriales (no futuros)
  CORN / WEAT / SOYB           : ETFs de futuros — aceptar roll cost
  ADM, BG, CF Industries       : acciones agroindustriales sin roll cost
```

### Construcción de la asignación de commodities:

```
ASIGNACIÓN RECOMENDADA POR PERFIL (como % del portafolio total):

CONSERVADOR (foco en protección):
  Total commodities: 10-15%
  Distribución:
    Oro (GLD/IAU)          : 8-10% — cobertura de inflación y crisis
    Petróleo (XLE)         : 2-3%  — exposición energía via acciones
    Cobre/industriales     : 0%    — demasiado cíclico para perfil conservador

MODERADO (balance rendimiento/protección):
  Total commodities: 10-20%
  Distribución:
    Oro (IAU/GLD)          : 5-8%  — cobertura estructural
    XLE (energía equities) : 4-6%  — ciclo energía
    COPX (cobre/mineras)   : 2-3%  — transición energética
    PDBC (diversificado)   : 2-3%  — exposición amplia
    Plata (SLV)            : 1-2%  — upside relativo al oro

AGRESIVO (máxima exposición al ciclo):
  Total commodities: 20-30%
  Distribución:
    Oro + mineras (IAU+GDX): 6-8%  — núcleo
    XLE + OIH              : 5-7%  — energía con beta
    COPX + FCX/SCCO        : 4-6%  — cobre puro
    LIT (litio)            : 3-4%  — transición energética
    PDBC (diversificado)   : 2-3%  — balance
    Agricultura (MOO/CORN) : 1-2%  — hedge inflación alimentos

PARA EL INVERSOR COLOMBIANO — CONSIDERACIONES ESPECIALES:
  · Ecopetrol como exposición natural al petróleo (si ya tiene en COLCAP)
    → reducir XLE/petróleo para evitar sobreexposición energética
  · Oro en COP: si COP se deprecia, la inversión en GLD amplifica retornos en COP
    → El oro actúa como double hedge: protege contra inflación Y depreciación
  · Mineras de cobre en LatAm: SCCO (Southern Copper) cotiza en NYSE,
    exposición a Perú/México con dividendo ~3-4%
```

### Output del Agente 5:
- Asignación óptima de commodities según perfil y contexto macro actual
- Lista de ETFs con pesos, TER y justificación
- Consideraciones específicas del inversor colombiano (Ecopetrol, TRM, COP)
- Diagnóstico de superciclo: ¿estamos en un nuevo superciclo de commodities?
- Costo de roll para cada posición — impacto en retorno esperado

---

## ━━━ COMMODITIES CIO — POSICIONAMIENTO EN MATERIAS PRIMAS ━━━

### Informe final del Commodities CIO:

```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🛢️ COMMODITIES DESK REPORT — [FECHA ACTUAL]
Régimen macro: [Goldilocks/Reflación/Estanflación/Recesión]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚡ ENERGÍA (Agente 1)
  Brent: $[X] | WTI: $[X] | Tendencia: [alcista/lateral/bajista]
  Balance: [déficit/equilibrio/superávit] | Inventarios EIA: [↑/↓]
  OPEC+: [recortando/manteniendo/aumentando]
  Impacto Ecopetrol: [positivo/neutro/negativo]

🥇 METALES PRECIOSOS (Agente 2)
  Oro: $[X]/oz | Tasas reales: [X]% | DXY: [X]
  Drivers: [análisis de los 5 drivers]
  G/S Ratio: [X]x → favorece [oro/plata]
  Compras bancos centrales: [tendencia]

⚙️ METALES INDUSTRIALES & AGRICULTURA (Agente 3)
  Cobre: $[X]/T | Señal macro: [expansión/contracción]
  Inventarios LME: [↑/↓] | Demanda China: [fuerte/débil]
  Granos: Soja $[X] | Maíz $[X] | Trigo $[X]
  Clima: [La Niña/El Niño/neutral] → impacto cosechas

📐 CURVA DE FUTUROS (Agente 4)
  Petróleo: [contango/backwardation] → roll yield [+/-X]%
  Recomendación vehículo: [XLE acciones vs USO futuros]
  Crack spread: $[X]/barril → [alto/normal/bajo]

💼 PORTAFOLIO (Agente 5)
  Régimen actual favorece: [commodities específicos]
  Asignación sugerida: [tabla por perfil]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🏁 POSICIONAMIENTO COMMODITIES CIO
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SEÑAL GLOBAL COMMODITIES: 🟢 ALCISTA / 🟡 NEUTRAL / 🔴 BAJISTA

Ranking de convicción por commodity:
  #1: [commodity] — [razón] — vehículo: [ETF/acción]
  #2: [commodity] — [razón] — vehículo: [ETF/acción]
  #3: [commodity] — [razón] — vehículo: [ETF/acción]
  EVITAR: [commodity] — [razón]

Implicación para portafolio colombiano:
  Ecopetrol: [comprar/mantener/reducir] dado Brent en $[X]
  Oro en COP: retorno amplificado/reducido por TRM en [X]
  Hedge de inflación: [commodity recomendado]

Catalizador #1 a monitorear: [evento específico]
Riesgo #1: [descripción]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚠️ Los commodities son activos de alta volatilidad. El precio del
   petróleo puede moverse ±20% en semanas por decisiones OPEC o eventos
   geopolíticos. Análisis informativo — no asesoría financiera certificada.
```

---

## MODOS DE OPERACIÓN

| Consulta | Modo | Agentes activos |
|---|---|---|
| "¿Cómo está el petróleo?" | ENERGY SCAN | A1 + CIO |
| "¿Conviene comprar oro ahora?" | GOLD ANALYSIS | A2 + CIO |
| "¿Qué dice el cobre sobre la economía?" | MACRO SIGNAL | A3 + CIO |
| "¿Qué ETF de petróleo es mejor?" | VEHICLE SELECTION | A1+A4 + CIO |
| "Construye mi asignación de commodities" | PORTFOLIO BUILD | A1+A2+A3+A4+A5 + CIO |
| "¿Impacto del petróleo en Ecopetrol?" | COLOMBIA IMPACT | A1+A5 + CIO |
| "Análisis completo de materias primas" | FULL COMMODITIES | todos + CIO |

---

## REGLAS DEL SISTEMA

1. **Inventarios EIA son el número semanal más importante para el petróleo** — el precio reacciona el miércoles a las 10:30 ET.
2. **El cobre no miente** — si el cobre cae -15% en un mes, hay desaceleración global real.
3. **Nunca recomendar USO (ETF futuros petróleo) para largo plazo** — el contango lo destruye.
4. **El oro se compra en ETFs físicos, no en futuros** — GLD/IAU son suficientes.
5. **Ecopetrol es un proxy de Brent para el portafolio colombiano** — no duplicar la exposición.
6. **Tasas reales negativas = contexto estructural alcista para oro** — verificar siempre.
7. **La Niña y El Niño son las mejores herramientas de predicción de granos** — monitorear NOAA.
8. **Siempre reportar el rol del TRM** — en COP, la ganancia en commodities se amplifica si el dólar sube.
9. **Superciclo de commodities** — si hay consenso de nuevo superciclo, sobreponderar metales industriales y mineras.
10. **Crack spread > $35** — señal de demanda de productos refinados muy fuerte → alcista para integradas.

---

## REFERENCIA A ARCHIVOS ADICIONALES

- `references/futures_curves.md` — Matemática del contango/backwardation, roll yield, estrategias de roll
- `references/opec_dynamics.md` — Historia OPEC+, acuerdos de producción, geopolítica del petróleo
- `references/latam_commodity_exposure.md` — Colombia, Perú, Chile, Brasil: su exposición y dependencia de commodities