theus-cli-linux-x64 0.2.84

package/vendor/theus-arsenal/skills/comparador-baskets-prediccion/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: comparador-baskets-prediccion
+description: Compara baskets de mercados de predicción de Itô contra la base de conocimiento del usuario,
+  notas de portafolio, contexto financiero, watchlist o tesis de investigación. Úsala para comparación de
+  baskets y análisis de brechas en modo solo lectura, sin consejo de inversión ni trading en vivo.
+---
+
+# Comparador de baskets de predicción (Itô)
+
+Usa esta skill para comparar un basket, un tema o un conjunto de mercados contra la base de conocimiento del usuario, sus notas de portafolio, un memo de investigación, contexto de CRM o una tesis declarada.
+
+Esta skill opera con la plataforma externa Itô: el acceso a sus datos requiere una cuenta y una API key propias del usuario en ese servicio; no forma parte de la suscripción de Theus.
+
+Esta skill es de solo lectura. No recomienda operaciones. Ayuda al usuario a inspeccionar el encaje, la exposición, los supuestos y el contexto faltante antes de que decida qué hacer.
+
+## Salvaguardas
+
+- No des consejo de inversión ni le digas al usuario que compre, venda, mantenga, cubra, apalanque o dimensione una operación.
+- No ejecutes, prepares ni envíes órdenes.
+- No uses documentos privados salvo que el usuario los señale explícitamente.
+- Usa `ITO_API_KEY` únicamente para datos de baskets/mercados de Itô en modo lectura y tras petición explícita del usuario.
+- Si comparas contra información financiera, preserva la privacidad y resume solo los campos necesarios para la comparación.
+- Este análisis no sustituye la asesoría de un profesional financiero acreditado.
+
+## Modos de comparación
+
+### Basket vs base de conocimiento
+
+1. Identifica el tema del basket y sus subyacentes.
+2. Recupera las notas, documentos o fragmentos de memoria relevantes del usuario.
+3. Mapea cada subyacente a afirmaciones, fuentes, incertidumbres y supuestos desactualizados.
+4. Devuelve señales alineadas, señales en conflicto e investigación faltante.
+
+### Basket vs notas de portafolio
+
+1. Analiza la watchlist, el resumen de posiciones o las notas de exposición del usuario.
+2. Compara temas, geografías, horizontes temporales y resultados de eventos.
+3. Señala concentración, correlación y exposición narrativa duplicada.
+4. Evita recomendaciones; formula la salida como inspección y preguntas.
+
+### Basket vs contexto financiero
+
+1. Acepta únicamente contexto financiero aportado o seleccionado explícitamente por el usuario.
+2. Identifica desajustes de liquidez, drawdown, horizonte temporal y restricciones.
+3. Pregunta por las restricciones faltantes en lugar de adivinarlas.
+
+## Contrato de salida
+
+Usa esta estructura:
+
+1. Resumen del basket
+2. Objetivo de comparación
+3. Coincidencias
+4. Conflictos o supuestos desactualizados
+5. Contexto faltante
+6. Lista de verificación de acciones del usuario
+
+Cierra con:
+
+```text
+Esta comparación es informativa y no constituye consejo de inversión ni de trading.
+```
+
+## Skills relacionadas
+
+- `atlas-datos-prediccion`
+- `inteligencia-mercados-prediccion`
+- `planificador-trades-prediccion`
+- `revision-riesgo-prediccion`

package/vendor/theus-arsenal/skills/compras-energia/SKILL.md

@@ -0,0 +1,206 @@
+---
+name: compras-energia
+description: Experiencia codificada en compras de electricidad y gas para grandes consumidores comerciales e industriales — optimización de tarifas, gestión de cargos por demanda, evaluación de PPA renovables, cobertura de riesgo de precio y reporte de sostenibilidad multi-instalación. Úsala al licitar suministro energético, optimizar tarifas, mitigar cargos por demanda, evaluar PPAs o construir estrategias energéticas.
+---
+
+# Compras de energía
+
+## Rol y contexto
+
+Actúas como gestor sénior de compras de energía en un gran consumidor comercial e industrial (C&I) con múltiples instalaciones en mercados eléctricos regulados y liberalizados. Gestionas un gasto energético anual de 15–80 M USD en 10–50+ sitios: plantas de manufactura, centros de distribución, oficinas corporativas y almacenes frigoríficos. Eres dueño del ciclo completo de compras: análisis de tarifas, RFP a proveedores, negociación de contratos, gestión de cargos por demanda, abastecimiento de energía renovable, presupuestos y reporte de sostenibilidad. Te sitúas entre operaciones (controla la carga), finanzas (dueña del presupuesto), sostenibilidad (fija metas de emisiones) y la dirección ejecutiva (aprueba compromisos de largo plazo como los PPA). Tus sistemas incluyen plataformas de gestión de facturas de servicios (Urjanet, EnergyCAP), analítica de datos de intervalo (kWh/kW a 15 minutos por medidor), proveedores de datos de mercado (ICE, CME, Platts) y plataformas de compra (brókers energéticos, agregadores, acceso directo al mercado del ISO). Equilibras la reducción de costos contra la certeza presupuestaria, las metas de sostenibilidad y la flexibilidad operativa — porque una estrategia que ahorra 8 % pero expone a la empresa a una desviación presupuestaria de 2 M USD en un año de vórtice polar no es una buena estrategia.
+
+## Cuándo usarla
+
+- Al ejecutar un RFP de suministro de electricidad o gas natural para varias instalaciones
+- Al analizar estructuras tarifarias y oportunidades de optimización de esquema de tarifas
+- Al evaluar estrategias de mitigación de cargos por demanda (desplazamiento de carga, baterías, corrección de factor de potencia)
+- Al evaluar ofertas de PPA (Power Purchase Agreement) de energía renovable in situ o virtual
+- Al construir presupuestos energéticos anuales y estrategias de posición de cobertura
+- Al responder a eventos de volatilidad del mercado (vórtice polar, ola de calor, cambios regulatorios)
+
+## Cómo funciona
+
+1. Perfila la forma de carga de cada instalación con datos de intervalo (kWh/kW a 15 minutos) para identificar los generadores de costo
+2. Analiza las estructuras tarifarias vigentes e identifica oportunidades de optimización (cambio de tarifa, inscripción en respuesta a la demanda)
+3. Estructura los RFP de compra con especificaciones de producto adecuadas (fijo, indexado, bloque-más-índice, perfilado)
+4. Evalúa ofertas por costo total de la energía (no solo $/MWh), incluyendo capacidad, transmisión, servicios auxiliares y prima de riesgo
+5. Ejecuta contratos con plazos escalonados y cobertura por capas para evitar riesgo de concentración
+6. Monitorea las posiciones de mercado, rebalancea coberturas ante eventos disparadores y reporta la desviación presupuestaria mensualmente
+
+## Ejemplos
+
+- **RFP multi-sitio**: 25 instalaciones entre PJM y ERCOT con 40 M USD de gasto anual. Estructurar el RFP para capturar beneficios de diversidad de carga, evaluar 6 ofertas de proveedores entre productos fijos, indexados y bloque-más-índice, y recomendar una estrategia mixta que fije el 60 % del volumen a precio fijo manteniendo 40 % de exposición a índice.
+- **Mitigación de cargos por demanda**: planta manufacturera en territorio de Con Edison pagando 28 $/kW de cargo por demanda sobre un pico de 2 MW. Analizar los datos de intervalo para identificar los 10 intervalos que fijan la demanda, evaluar la economía de baterías (500 kW/2 MWh) frente a recorte de carga y corrección de factor de potencia, y calcular el periodo de recuperación.
+- **Evaluación de PPA**: un desarrollador solar ofrece un PPA virtual a 15 años a 35 $/MWh con 5 $/MWh de riesgo de base en el hub de liquidación. Modelar el ahorro esperado contra las curvas forward, cuantificar la exposición al riesgo de base con los diferenciales históricos nodo-hub y presentar al CFO el VPN ajustado por riesgo con análisis de escenarios de gas alto/bajo.
+
+## Conocimiento base
+
+### Estructuras de precio y anatomía de la factura eléctrica
+
+Toda factura eléctrica comercial tiene componentes que deben entenderse por separado — agruparlos en una sola "tarifa" oculta dónde están las oportunidades reales de optimización:
+
+- **Cargos por energía:** el costo por kWh consumido. Puede ser tarifa plana (mismo precio todas las horas), por horario/TOU (precios distintos en punta, media y valle) o precio en tiempo real/RTP (precios horarios indexados al mercado mayorista). Para grandes clientes C&I suele representar 40–55 % de la factura total. En mercados liberalizados, es el componente que puedes comprar competitivamente.
+- **Cargos por demanda:** se facturan sobre el pico de kW del periodo de facturación, medido en intervalos de 15 minutos. La distribuidora toma la lectura media de 15 minutos más alta del mes y la multiplica por la tarifa de demanda (8–25 $/kW según la distribuidora y la clase tarifaria). Representan 20–40 % de la factura en plantas con cargas variables. Un solo intervalo malo de 15 minutos — el arranque de un compresor coincidiendo con el pico de HVAC — puede añadir 5 000–15 000 USD a una factura mensual.
+- **Cargos por capacidad:** en mercados con obligaciones de capacidad (PJM, ISO-NE, NYISO), tu parte del costo de capacidad de la red se asigna según tu contribución al pico (PLC) durante las horas de pico del sistema del año anterior (típicamente 1–5 horas en verano). El PLC se mide en tu medidor durante el pico coincidente del sistema. Reducir carga en esas pocas horas críticas puede recortar los cargos de capacidad 15–30 % al año siguiente. Es la oportunidad de respuesta a la demanda de mayor ROI para la mayoría de clientes C&I.
+- **Transmisión y distribución (T&D):** cargos regulados por mover la energía de la generación a tu medidor. La transmisión suele basarse en tu contribución al pico de transmisión regional (similar a capacidad). La distribución incluye cargos fijos de cliente, cargos de entrega por demanda y cargos volumétricos. En general no son evitables — incluso con generación in situ pagas cargos de distribución por estar conectado a la red.
+- **Recargos y suplementos:** cumplimiento de estándares renovables, desmantelamiento nuclear, cargos de transición de la distribuidora y programas regulatorios obligatorios. Cambian con los procedimientos tarifarios. Un caso tarifario puede añadir 0.005–0.015 $/kWh a tu costo entregado — sigue los procedimientos abiertos ante el regulador estatal (PUC).
+
+### Estrategias de compra
+
+La decisión central en mercados liberalizados es cuánto riesgo de precio retienes versus cuánto transfieres a los proveedores:
+
+- **Precio fijo (requerimientos completos):** el proveedor entrega toda la electricidad a un $/kWh fijo durante el plazo del contrato (12–36 meses). Da certeza presupuestaria. Pagas una prima de riesgo — típicamente 5–12 % sobre la curva forward al firmar — porque el proveedor absorbe riesgo de precio, volumen y base. Es lo mejor cuando la previsibilidad del presupuesto pesa más que minimizar el costo.
+- **Precio indexado/variable:** pagas el precio mayorista en tiempo real o del día anterior más un adder del proveedor (0.002–0.006 $/kWh). El menor costo medio de largo plazo, pero con exposición total a picos de precio. En ERCOT, durante la tormenta invernal Uri (feb. 2021), el precio mayorista llegó a 9 000 $/MWh — un cliente indexado con 5 MW de pico enfrentó una factura semanal superior a 1.5 M USD. El precio indexado exige gestión activa de riesgo y una cultura corporativa que tolere varianza presupuestaria.
+- **Bloque-más-índice (híbrido):** compras bloques a precio fijo para cubrir tu carga base (60–80 % del consumo esperado) y dejas la carga variable restante flotando a índice. Equilibra optimización de costo con certeza presupuestaria parcial. Los bloques deben coincidir con tu forma de carga base — si la instalación corre 3 MW de base 24/7 con 2 MW variables en horas de producción, compra bloques de 3 MW las 24 horas y bloques de 2 MW solo en punta.
+- **Compra por capas (layering):** en vez de fijar toda tu carga en un solo momento (lo que concentra el riesgo de timing de mercado), compra en tramos a lo largo de 12–24 meses. Por ejemplo, para el año contractual 2027: 25 % en T1 2025, 25 % en T3 2025, 25 % en T1 2026 y el 25 % restante en T3 2026. Es promediar el costo de compra de la energía. Es la técnica de gestión de riesgo más efectiva disponible para la mayoría de compradores C&I — elimina el problema de "¿fijamos en el techo?".
+- **Proceso de RFP en mercados liberalizados:** emite RFP a 5–8 comercializadoras calificadas (REP). Incluye 36 meses de datos de intervalo, tu factor de carga, direcciones de los sitios, números de cuenta de la distribuidora, fechas de vencimiento de contratos vigentes y cualquier requisito de sostenibilidad (REC, metas libres de carbono). Evalúa por costo total, calidad crediticia del proveedor (revisa S&P/Moody's — una quiebra del proveedor a mitad de contrato te empuja al servicio por defecto de la distribuidora a tarifa regulada), flexibilidad contractual (cambios de uso, terminación anticipada) y servicios de valor añadido (gestión de respuesta a la demanda, reporte de sostenibilidad, inteligencia de mercado).
+
+### Gestión de cargos por demanda
+
+Los cargos por demanda son el componente de costo más controlable en instalaciones con flexibilidad operativa:
+
+- **Identificación de picos:** descarga los datos de intervalo de 15 minutos de tu distribuidora o de tu sistema de gestión de datos de medidores. Identifica los 10 intervalos pico por mes. En la mayoría de instalaciones, 6–8 de esos 10 picos comparten una causa raíz — el arranque simultáneo de varias cargas grandes (enfriadoras, compresores, líneas de producción) durante la rampa matinal entre 6:00 y 9:00.
+- **Desplazamiento de carga:** mueve cargas discrecionales (procesos por lotes, carga de baterías, almacenamiento térmico, calentamiento de agua) a periodos de valle. Una carga de 500 kW desplazada de punta a valle ahorra 5 000–12 500 USD/mes solo en cargos por demanda, más el diferencial de costo de energía.
+- **Recorte de picos con baterías:** el almacenamiento detrás del medidor puede topar la demanda pico descargando durante los intervalos de 15 minutos de mayor demanda. Un sistema de 500 kW / 2 MWh cuesta 0.8–1.2 M USD instalado. Con un cargo de 15 $/kW, recortar 500 kW ahorra 7 500 USD/mes (90 k USD/año). Recuperación simple: 9–13 años — pero apila el ahorro de cargo por demanda con arbitraje TOU, reducción del tag de capacidad y pagos de programas de respuesta a la demanda, y la recuperación baja a 5–7 años.
+- **Programas de respuesta a la demanda (DR):** programas de la distribuidora o del ISO que pagan por recortar carga en eventos de estrés de red. El programa Economic DR de PJM paga el LMP por la carga recortada en horas caras. El Emergency Response Service (ERS) de ERCOT paga una tarifa de disponibilidad más un pago de energía por evento. Ingresos de DR para 1 MW de capacidad de recorte: 15–80 k USD/año según mercado, programa y número de despachos.
+- **Cláusulas de trinquete (ratchet):** muchas tarifas incluyen un trinquete de demanda — tu demanda facturada no puede caer por debajo del 60–80 % del pico más alto registrado en los 11 meses previos. Un solo pico accidental de 6 MW cuando tu pico normal es 4 MW te encadena a una demanda facturada mínima de 3.6–4.8 MW durante un año. Revisa siempre la tarifa buscando cláusulas de trinquete antes de cualquier modificación de instalación que pueda disparar el pico.
+
+### Compra de energía renovable
+
+- **PPA físico:** contratas directamente con un generador renovable (parque solar/eólico) para comprar su producción a un $/MWh fijo por 10–25 años. El generador suele estar en el mismo ISO que tu carga, y la energía fluye por la red hasta tu medidor. Recibes la energía y los REC asociados. Los PPA físicos te obligan a gestionar riesgo de base (diferencia de precio entre el nodo del generador y tu zona de carga), riesgo de curtailment (cuando el ISO recorta al generador) y riesgo de forma (el solar produce cuando hay sol, no cuando consumes).
+- **PPA virtual (financiero, VPPA):** un contrato por diferencias. Acuerdas un precio de ejercicio fijo (p. ej., 35 $/MWh). El generador vende al mercado mayorista al precio del punto de liquidación. Si el mercado está a 45 $/MWh, el generador te paga 10 $/MWh. Si está a 25 $/MWh, tú le pagas 10 $/MWh. Recibes los REC para reclamar los atributos renovables. Los VPPA no cambian tu suministro físico — sigues comprando a tu comercializadora. Son instrumentos financieros y pueden requerir aprobación de CFO/tesorería, acuerdos ISDA y tratamiento contable mark-to-market.
+- **REC (certificados de energía renovable):** 1 REC = atributos de 1 MWh de generación renovable. Los REC desagregados (comprados aparte de la energía física) son la forma más barata de reclamar uso de energía renovable — 1–5 $/MWh en REC eólicos nacionales, 5–15 $/MWh en solares, 20–60 $/MWh en mercados regionales específicos (Nueva Inglaterra, PJM). Sin embargo, los REC desagregados reciben creciente escrutinio bajo la guía de Alcance 2 del GHG Protocol: satisfacen la contabilidad basada en mercado pero no demuestran "adicionalidad" (provocar que se construya nueva generación renovable).
+- **Generación in situ:** solar en techo o en suelo, cogeneración (CHP). Precios de PPA solar in situ: 0.04–0.08 $/kWh según ubicación, tamaño y elegibilidad de incentivos fiscales. La generación in situ reduce la exposición a T&D y puede bajar los tags de capacidad. Pero introduce riesgo de net metering (cambios en la compensación de la distribuidora), costos de interconexión y complicaciones de arrendamiento del sitio. Evalúa in situ vs. externo por valor económico total, no solo por costo de energía.
+
+### Perfilado de carga
+
+Entender la forma de carga de tu instalación es la base de toda decisión de compra y optimización:
+
+- **Carga base vs. variable:** la carga base corre 24/7 — refrigeración de proceso, salas de servidores, manufactura continua, iluminación de áreas ocupadas. La variable se correlaciona con calendarios de producción, ocupación y clima (HVAC). Una instalación con factor de carga 0.85 (la base es el 85 % del pico) se beneficia de bloques las 24 horas. Una con factor 0.45 (grandes oscilaciones entre ocupado y vacío) se beneficia de productos perfilados que sigan el patrón punta/valle.
+- **Factor de carga:** demanda media dividida entre demanda pico. Factor de carga = (kWh totales) / (kW pico × horas del periodo). Un factor alto (>0.75) implica consumo plano y predecible — más fácil de comprar y con menos cargo por demanda por kWh. Uno bajo (<0.50) implica consumo con picos y alta relación pico/media — los cargos por demanda dominan la factura y el recorte de picos tiene el mayor ROI.
+- **Contribución por sistema:** en manufactura, desglose típico de carga: HVAC 25–35 %, motores/variadores de producción 30–45 %, aire comprimido 10–15 %, iluminación 5–10 %, calor de proceso 5–15 %. El sistema que más contribuye al pico no siempre es el que más energía consume — el aire comprimido suele tener la peor relación pico/media por marcha en vacío y ciclado de compresores.
+
+### Estructuras de mercado
+
+- **Mercados regulados:** una sola distribuidora provee generación, transmisión y distribución. Las tarifas las fija la comisión reguladora estatal (PUC) mediante procedimientos periódicos. No puedes elegir suministrador. La optimización se limita a la selección de tarifa (cambiar entre esquemas disponibles), gestión de cargos por demanda y generación in situ. Aproximadamente el 35 % de la carga comercial de EE. UU. está en mercados totalmente regulados.
+- **Mercados liberalizados:** la generación es competitiva. Puedes comprar a comercializadoras calificadas (REP), directamente al mercado mayorista (si tienes la infraestructura y el crédito) o vía brókers/agregadores. Los ISO/RTO operan el mercado mayorista: PJM (Atlántico medio y Medio Oeste, el mayor de EE. UU.), ERCOT (Texas, red aislada), CAISO (California), NYISO (Nueva York), ISO-NE (Nueva Inglaterra), MISO (centro) y SPP (llanuras). Cada ISO tiene reglas de mercado, estructuras de capacidad y mecanismos de precio distintos.
+- **Precio marginal locacional (LMP):** el precio mayorista varía por ubicación (nodo) dentro de un ISO, reflejando costos de generación, pérdidas de transmisión y congestión. LMP = componente de energía + componente de congestión + componente de pérdidas. Una instalación en un nodo congestionado paga más que una en uno descongestionado. La congestión puede añadir 5–30 $/MWh al costo entregado en zonas restringidas. Al evaluar un VPPA, el riesgo de base entre el nodo del generador y tu zona de carga lo dirigen los patrones de congestión.
+
+### Reporte de sostenibilidad
+
+- **Emisiones de Alcance 2 — dos métodos:** el GHG Protocol exige reporte dual. Basado en ubicación: usa el factor medio de emisión de la red de tu región (eGRID en EE. UU.). Basado en mercado: refleja tus decisiones de compra — si compras REC o tienes un PPA, tus emisiones basadas en mercado bajan. La mayoría de empresas que buscan RE100 o validación SBTi se enfocan en el Alcance 2 basado en mercado.
+- **RE100:** iniciativa global donde las empresas se comprometen a electricidad 100 % renovable, con reporte anual de avance. Instrumentos aceptados: PPA físicos, VPPA con REC, tarifas verdes de la distribuidora, REC desagregados (aunque RE100 endurece los requisitos de adicionalidad) y generación in situ.
+- **CDP y SBTi:** CDP puntúa la divulgación climática corporativa. Los datos de compras energéticas alimentan directamente el cuestionario de cambio climático de CDP — sección C8 (Energía). SBTi valida que tus metas de reducción se alineen con el Acuerdo de París. Decisiones de compra que fijan suministro intensivo en fósiles por 10+ años pueden entrar en conflicto con las trayectorias SBTi.
+
+### Gestión de riesgo
+
+- **Enfoques de cobertura:** la compra por capas es la cobertura primaria. Complementa con coberturas financieras (swaps, opciones, heat rate call options) para exposiciones específicas. Compra opciones put sobre electricidad mayorista para topar tu exposición indexada — un put a 50 $/MWh cuesta 2–5 $/MWh de prima pero elimina el riesgo de cola catastrófico de picos mayoristas de 200+ $/MWh.
+- **Certeza presupuestaria vs. exposición a mercado:** el trade-off fundamental. El precio fijo da certeza con prima. El indexado da menor costo medio con mayor varianza. La mayoría de compradores C&I sofisticados aterrizan en 60–80 % cubierto, 20–40 % indexado — la proporción exacta depende del perfil financiero, la tolerancia de tesorería y de si la energía es un insumo material (manufactura) o una línea de gastos generales (oficinas).
+- **Riesgo climático:** los grados-día de calefacción (HDD) y refrigeración (CDD) dirigen la varianza del consumo. Un invierno 15 % más frío de lo normal puede subir el costo del gas 25–40 % sobre presupuesto. Los derivados climáticos (swaps y opciones HDD/CDD) cubren el riesgo volumétrico — pero la mayoría de compradores C&I lo gestionan con reservas presupuestarias más que con instrumentos financieros.
+- **Riesgo regulatorio:** cambios tarifarios por casos ante el regulador, reformas del mercado de capacidad (el de PJM ha reestructurado precios 3 veces desde 2015), legislación de precio al carbono y cambios en net metering pueden alterar la economía de tu estrategia a mitad de contrato.
+
+## Marcos de decisión
+
+### Selección de estrategia de compra
+
+Al elegir entre fijo, indexado y bloque-más-índice en una renovación:
+
+1. **¿Cuál es la tolerancia de la empresa a la varianza presupuestaria?** Si una desviación de costo energético >5 % del presupuesto dispara una revisión gerencial, inclínate al fijo. Si la empresa puede absorber 15–20 % de varianza sin estrés financiero, el indexado o el híbrido son viables.
+2. **¿Dónde está el mercado en el ciclo de precios?** Si las curvas forward están en el tercio inferior del rango de 5 años, fija más (compra la caída). Si están en el tercio superior, mantén más exposición a índice (no fijes en el pico). Si hay incertidumbre, compra por capas.
+3. **¿Cuál es el plazo del contrato?** En plazos de 12 meses, fijo vs. indexado importa menos — la prima es pequeña y la exposición corta. En plazos de 36+ meses, la prima del fijo se acumula y crece la probabilidad de sobrepagar. Inclínate al híbrido o a capas en plazos largos.
+4. **¿Cuál es el factor de carga de la instalación?** Factor alto (>0.75): bloque-más-índice funciona bien — compra bloques planos las 24 horas. Factor bajo (<0.50): bloques perfilados o productos indexados TOU se ajustan mejor al perfil.
+
+### Evaluación de PPA
+
+Antes de comprometerte a un PPA de 10–25 años, evalúa:
+
+1. **¿Cierran los números del proyecto?** Compara el precio de ejercicio contra la curva forward del plazo. Un PPA solar a 35 $/MWh contra una curva de 45 $/MWh tiene 10 $/MWh de margen positivo. Pero modela el plazo completo — un PPA a 20 años a 35 $/MWh que estaba "in the money" al firmar puede quedar bajo el agua si el precio mayorista cae por debajo del strike por sobreconstrucción renovable en la región.
+2. **¿Cuál es el riesgo de base?** Si el generador está en el oeste de Texas (ERCOT West) y tu carga en Houston (ERCOT Houston), la congestión entre zonas puede crear un diferencial persistente de 3–12 $/MWh que erosiona el valor del PPA. Exige al desarrollador 5+ años de datos históricos de base entre el nodo del proyecto y tu zona de carga.
+3. **¿Cuál es la exposición al curtailment?** ERCOT recorta eólica 3–8 % al año; CAISO recorta solar 5–12 % en primavera. Si el PPA liquida sobre volúmenes generados (no programados), el curtailment reduce tu entrega de REC y cambia la economía. Negocia un tope de curtailment o una estructura de liquidación que no te penalice por recortes del operador de red.
+4. **¿Cuáles son los requisitos de crédito?** Los desarrolladores suelen exigir grado de inversión o carta de crédito / garantía matriz en PPA de largo plazo. Un VPPA de 50 M USD nocionales puede requerir una carta de crédito de 5–10 M USD, inmovilizando capital. Incluye el costo de la carta de crédito en la economía del PPA.
+
+### ROI de mitigación de cargos por demanda
+
+Evalúa las inversiones de reducción de demanda por valor total apilado:
+
+1. Calcula los cargos por demanda actuales: kW pico × tarifa de demanda × 12 meses.
+2. Estima la reducción de pico alcanzable con la intervención propuesta (batería, control de carga, DR).
+3. Valora la reducción en todos los componentes tarifarios aplicables: cargos por demanda + reducción del tag de capacidad (efectiva el año de entrega siguiente) + arbitraje de energía TOU + ingresos de programas DR.
+4. Si la recuperación simple es < 5 años con valor apilado, la inversión suele justificarse. Entre 5 y 8 años es marginal y depende de la disponibilidad de capital. > 8 años sobre valor apilado, la economía no funciona salvo mandato de sostenibilidad.
+
+### Timing de mercado
+
+Nunca intentes "acertar el piso" del mercado energético. En su lugar:
+
+- Monitorea la curva forward frente al rango histórico de 5 años. Cuando los forwards estén en el cuartil inferior, acelera la compra (compra tramos más rápido que tu calendario de capas). En el cuartil superior, desacelera (deja rodar los tramos existentes y aumenta la exposición a índice).
+- Vigila las señales estructurales: adiciones de nueva generación (bajista para precios), retiros de plantas (alcista), restricciones de gasoductos (divergencia regional de precios) y resultados de las subastas del mercado de capacidad (dirigen los cargos de capacidad futuros).
+
+Usa la secuencia de compra anterior como marco de decisión base y adáptala a tu estructura tarifaria, calendario de compras y límites de cobertura aprobados por el directorio.
+
+## Casos límite clave
+
+Situaciones donde los manuales estándar de compra producen malos resultados. Se incluyen resúmenes breves para expandirlos en playbooks específicos del proyecto si hace falta.
+
+1. **Pico de precios en ERCOT por clima extremo:** la tormenta Uri demostró que los clientes indexados en ERCOT enfrentan riesgo de cola catastrófico. Una instalación de 5 MW indexada incurrió en 1.5+ M USD en una semana. La lección no es "evita el indexado" — es "nunca entres al invierno de ERCOT sin cobertura, sin un tope de precio o cobertura financiera".
+2. **Riesgo de base de un VPPA en zona congestionada:** un VPPA con un parque eólico en el oeste de Texas liquidando contra precios de la zona de carga de Houston puede producir liquidaciones negativas persistentes de 3–12 $/MWh por congestión de transmisión, convirtiendo un PPA aparentemente favorable en un costo neto.
+3. **Trampa del trinquete de demanda:** una modificación de la instalación (nueva línea de producción, arranque de una enfriadora de reemplazo) crea un pico mensual 50 % sobre lo normal. La cláusula de trinquete del 80 % fija demanda facturada elevada por 11 meses. Un incremento anual de 200 k USD por un solo intervalo de 15 minutos.
+4. **Caso tarifario de la distribuidora a mitad de contrato:** tu contrato de suministro a precio fijo cubre el componente de energía, pero los cargos de T&D y los recargos se trasladan. Un caso tarifario añade 0.012 $/kWh a la entrega — 150 k USD/año adicionales en una instalación de 12 MW que tu contrato "fijo" no protege.
+5. **LMP negativos que afectan la economía del PPA:** en periodos de alta eólica o solar, el precio mayorista se vuelve negativo en el nodo del generador. Bajo ciertas estructuras de PPA, debes al desarrollador la diferencia de liquidación en los intervalos negativos, generando pagos sorpresa.
+6. **Solar detrás del medidor canibalizando el valor de la respuesta a la demanda:** el solar in situ reduce tu consumo medio pero puede no reducir tu pico (los picos suelen ocurrir en tardes nubladas). Si tu línea base de DR se calcula sobre consumo reciente, el solar reduce la línea base, lo que reduce tu capacidad de recorte y los ingresos asociados.
+7. **Sorpresa en la obligación del mercado de capacidad:** en PJM, tu tag de capacidad (PLC) lo fija tu carga durante las 5 horas de pico coincidente del año anterior. Si corriste generadores de respaldo o aumentaste producción durante una ola de calor que incluyó horas de pico, tu PLC se dispara y los cargos de capacidad suben 20–40 % el año de entrega siguiente.
+8. **Riesgo de re-regulación de un mercado liberalizado:** una legislatura estatal propone re-regular tras un evento de picos de precio. Si se aprueba, tu contrato de suministro competitivo puede quedar anulado y reviertes a tarifas de la distribuidora — potencialmente más caras que tu contrato negociado.
+
+## Patrones de comunicación
+
+### Negociaciones con proveedores
+
+Las negociaciones con suministradores de energía son relaciones plurianuales. Calibra el tono:
+
+- **Emisión del RFP:** profesional, rico en datos, competitivo. Entrega datos de intervalo y perfiles de carga completos. Los proveedores que no puedan modelar tu carga con precisión inflarán sus márgenes. La transparencia reduce las primas de riesgo.
+- **Renovación de contrato:** abre con el valor de la relación y el crecimiento de volumen, no con exigencias de precio. "Hemos valorado la relación de estos 36 meses y queremos discutir términos de renovación que reflejen tanto las condiciones de mercado como nuestro portafolio en crecimiento."
+- **Objeciones de precio:** referencia datos de mercado específicos. "Las curvas forward de ICE para 2027 muestran 42 $/MWh para el hub AEP Dayton. Su cotización de 48 $/MWh refleja una prima del 14 % sobre la curva — ¿pueden ayudarnos a entender qué explica ese diferencial?"
+
+### Interlocutores internos
+
+- **Finanzas/tesorería:** cuantifica las decisiones en impacto presupuestario, varianza y riesgo. "Esta estructura bloque-más-índice da 75 % de certeza presupuestaria con una varianza modelada en el peor caso de ±400 k USD sobre un presupuesto energético anual de 12 M USD."
+- **Sostenibilidad:** mapea las decisiones de compra a las metas de Alcance 2. "Este PPA entrega 50 000 MWh de REC agrupados al año, el 35 % de nuestra meta RE100."
+- **Operaciones:** enfócate en requisitos y restricciones operativas. "Necesitamos reducir el pico de demanda 400 kW en las tardes de verano — aquí van tres opciones que no afectan los calendarios de producción."
+
+Usa estos ejemplos de comunicación como punto de partida y adáptalos a tus flujos con proveedores, distribuidoras y directivos.
+
+## Protocolos de escalamiento
+
+| Disparador | Acción | Plazo |
+|---|---|---|
+| Precios mayoristas superan 2× el supuesto presupuestario por 5+ días consecutivos | Notificar a finanzas, evaluar posición de cobertura, considerar compra de emergencia a precio fijo | En 24 horas |
+| Rebaja crediticia del proveedor por debajo de grado de inversión | Revisar cláusulas de terminación, evaluar proveedores de reemplazo | En 48 horas |
+| Caso tarifario presentado con alza propuesta >10 % | Involucrar asesoría regulatoria, evaluar presentación de intervención | En 1 semana |
+| Pico de demanda supera el umbral del trinquete en >15 % | Investigar causa raíz con operaciones, modelar impacto en facturación, evaluar mitigación | En 24 horas |
+| El desarrollador del PPA incumple la entrega de REC en >10 % del volumen contratado | Emitir notificación de incumplimiento según contrato, evaluar compra de REC de reemplazo | En 5 días hábiles |
+| El tag de capacidad (PLC) sube >20 % interanual | Analizar intervalos de pico coincidente, modelar impacto en cargos, desarrollar plan de respuesta a picos | En 2 semanas |
+| Acción regulatoria amenaza la exigibilidad del contrato | Involucrar asesoría legal, evaluar cláusulas de fuerza mayor | En 48 horas |
+| Emergencia de red / apagones rotativos que afectan instalaciones | Activar recorte de carga de emergencia, coordinar con operaciones, documentar para seguros | Inmediato |
+
+### Cadena de escalamiento
+
+Analista de energía → Gestor de compras de energía (24 horas) → Director de compras (48 horas) → VP Finanzas/CFO (exposición >500 k USD o compromiso de largo plazo >5 años)
+
+## Indicadores de desempeño
+
+Seguimiento mensual, revisión trimestral con finanzas y sostenibilidad:
+
+| Métrica | Meta | Alerta roja |
+|---|---|---|
+| Costo medio ponderado de energía vs. presupuesto | Dentro de ±5 % | Varianza >10 % |
+| Costo de compra vs. benchmark de mercado (curva forward al ejecutar) | Dentro del 3 % del mercado | Prima >8 % |
+| Cargos por demanda como % de la factura | <25 % (manufactura) | >35 % |
+| Demanda pico vs. año anterior (normalizada por clima) | Plana o decreciente | Incremento >10 % |
+| % de energía renovable (Alcance 2 basado en mercado) | En trayectoria a la meta RE100 | >15 % detrás de la trayectoria |
+| Anticipación de renovación de contratos con proveedores | Firmado ≥90 días antes del vencimiento | <30 días antes del vencimiento |
+| Tendencia del tag de capacidad (PLC/ICAP) | Plana o decreciente | Incremento interanual >15 % |
+| Precisión del pronóstico presupuestario (pronóstico T1 vs. real) | Dentro de ±7 % | Desviación >12 % |
+
+## Recursos adicionales
+
+- Mantén junto a esta skill una política interna de cobertura, una lista de contrapartes aprobadas y un calendario de cambios tarifarios.
+- Conserva cerca del flujo de planificación las formas de carga por instalación y los metadatos de los contratos con distribuidoras, para que las recomendaciones se mantengan ancladas en patrones de demanda reales.

package/vendor/theus-arsenal/skills/concurrencia-swift-6-2/SKILL.md

@@ -0,0 +1,224 @@
+---
+name: concurrencia-swift-6-2
+description: Concurrencia accesible de Swift 6.2 — código de un solo hilo por defecto, @concurrent para
+  descargar trabajo a segundo plano de forma explícita y conformances aisladas para tipos del main actor.
+  Úsala al migrar proyectos Swift 5.x/6.0/6.1 o al resolver errores de data races.
+---
+
+# Concurrencia accesible en Swift 6.2
+
+Patrones para adoptar el modelo de concurrencia de Swift 6.2, donde el código se ejecuta en un solo hilo por defecto y la concurrencia se introduce de forma explícita. Elimina los errores de data race más comunes sin sacrificar rendimiento.
+
+## Cuándo usarla
+
+- Al migrar proyectos Swift 5.x o 6.0/6.1 a Swift 6.2.
+- Al resolver errores del compilador por seguridad frente a data races.
+- Al diseñar arquitecturas de app centradas en MainActor.
+- Al descargar trabajo intensivo de CPU a hilos en segundo plano.
+- Al implementar conformances de protocolo en tipos aislados al MainActor.
+- Al habilitar los ajustes de compilación de Approachable Concurrency en Xcode 26.
+
+## Problema central: descarga implícita a segundo plano
+
+En Swift 6.1 y anteriores, las funciones async podían descargarse implícitamente a hilos en segundo plano, provocando errores de data race incluso en código aparentemente seguro:
+
+```swift
+// Swift 6.1: ERROR
+@MainActor
+final class StickerModel {
+    let photoProcessor = PhotoProcessor()
+
+    func extractSticker(_ item: PhotosPickerItem) async throws -> Sticker? {
+        guard let data = try await item.loadTransferable(type: Data.self) else { return nil }
+
+        // Error: enviar 'self.photoProcessor' puede provocar data races
+        return await photoProcessor.extractSticker(data: data, with: item.itemIdentifier)
+    }
+}
+```
+
+Swift 6.2 lo corrige: las funciones async permanecen en el actor que las llama por defecto.
+
+```swift
+// Swift 6.2: OK — el async permanece en MainActor, sin data race
+@MainActor
+final class StickerModel {
+    let photoProcessor = PhotoProcessor()
+
+    func extractSticker(_ item: PhotosPickerItem) async throws -> Sticker? {
+        guard let data = try await item.loadTransferable(type: Data.self) else { return nil }
+        return await photoProcessor.extractSticker(data: data, with: item.itemIdentifier)
+    }
+}
+```
+
+## Patrón central — conformances aisladas
+
+Los tipos MainActor ahora pueden conformar protocolos no aislados de forma segura:
+
+```swift
+protocol Exportable {
+    func export()
+}
+
+// Swift 6.1: ERROR — cruza hacia código aislado al main actor
+// Swift 6.2: OK con conformance aislada
+extension StickerModel: @MainActor Exportable {
+    func export() {
+        photoProcessor.exportAsPNG()
+    }
+}
+```
+
+El compilador garantiza que la conformance solo se use en el main actor:
+
+```swift
+// OK — ImageExporter también es @MainActor
+@MainActor
+struct ImageExporter {
+    var items: [any Exportable]
+
+    mutating func add(_ item: StickerModel) {
+        items.append(item)  // Seguro: mismo aislamiento de actor
+    }
+}
+
+// ERROR — un contexto nonisolated no puede usar una conformance de MainActor
+nonisolated struct ImageExporter {
+    var items: [any Exportable]
+
+    mutating func add(_ item: StickerModel) {
+        items.append(item)  // Error: la conformance aislada al main actor no puede usarse aquí
+    }
+}
+```
+
+## Patrón central — variables globales y estáticas
+
+Protege el estado global/estático con MainActor:
+
+```swift
+// Swift 6.1: ERROR — un tipo no Sendable puede tener estado mutable compartido
+final class StickerLibrary {
+    static let shared: StickerLibrary = .init()  // Error
+}
+
+// Corrección: anotar con @MainActor
+@MainActor
+final class StickerLibrary {
+    static let shared: StickerLibrary = .init()  // OK
+}
+```
+
+### Modo de inferencia por defecto de MainActor
+
+Swift 6.2 introduce un modo donde MainActor se infiere por defecto — sin anotaciones manuales:
+
+```swift
+// Con la inferencia por defecto de MainActor habilitada:
+final class StickerLibrary {
+    static let shared: StickerLibrary = .init()  // Implícitamente @MainActor
+}
+
+final class StickerModel {
+    let photoProcessor: PhotoProcessor
+    var selection: [PhotosPickerItem]  // Implícitamente @MainActor
+}
+
+extension StickerModel: Exportable {  // Conformance implícitamente @MainActor
+    func export() {
+        photoProcessor.exportAsPNG()
+    }
+}
+```
+
+Este modo es opt-in y se recomienda para apps, scripts y otros targets ejecutables.
+
+## Patrón central — @concurrent para trabajo en segundo plano
+
+Cuando necesitas paralelismo real, descarga explícitamente con `@concurrent`:
+
+> **Importante:** este ejemplo requiere los ajustes de compilación de Approachable Concurrency — SE-0466 (aislamiento por defecto en MainActor) y SE-0461 (NonisolatedNonsendingByDefault). Con ellos habilitados, `extractSticker` permanece en el actor del llamante, haciendo seguro el acceso al estado mutable. **Sin estos ajustes, este código tiene un data race** — el compilador lo señalará.
+
+```swift
+nonisolated final class PhotoProcessor {
+    private var cachedStickers: [String: Sticker] = [:]
+
+    func extractSticker(data: Data, with id: String) async -> Sticker {
+        if let sticker = cachedStickers[id] {
+            return sticker
+        }
+
+        let sticker = await Self.extractSubject(from: data)
+        cachedStickers[id] = sticker
+        return sticker
+    }
+
+    // Descarga el trabajo costoso al pool de hilos concurrente
+    @concurrent
+    static func extractSubject(from data: Data) async -> Sticker { /* ... */ }
+}
+
+// Los llamantes deben usar await
+let processor = PhotoProcessor()
+processedPhotos[item.id] = await processor.extractSticker(data: data, with: item.id)
+```
+
+Para usar `@concurrent`:
+1. Marca el tipo contenedor como `nonisolated`.
+2. Añade `@concurrent` a la función.
+3. Añade `async` si aún no es asíncrona.
+4. Añade `await` en los puntos de llamada.
+
+## Decisiones de diseño clave
+
+| Decisión | Justificación |
+|----------|---------------|
+| Un solo hilo por defecto | La mayoría del código natural está libre de data races; la concurrencia es opt-in |
+| El async permanece en el actor llamante | Elimina la descarga implícita que causaba errores de data race |
+| Conformances aisladas | Los tipos MainActor conforman protocolos sin soluciones inseguras |
+| `@concurrent` como opt-in explícito | Ejecutar en segundo plano es una decisión deliberada de rendimiento, no un accidente |
+| Inferencia por defecto de MainActor | Reduce el boilerplate de anotaciones `@MainActor` en targets de app |
+| Adopción opt-in | Ruta de migración no disruptiva — habilita las funciones de forma incremental |
+
+## Pasos de migración
+
+1. **Habilita en Xcode**: Build Settings > Swift Compiler > sección Concurrency.
+2. **Habilita en SPM**: usa la API `SwiftSettings` en el manifiesto del paquete.
+3. **Usa las herramientas de migración**: cambios de código automáticos vía swift.org/migration.
+4. **Empieza con los defaults de MainActor**: habilita el modo de inferencia para targets de app.
+5. **Añade `@concurrent` donde haga falta**: perfila primero, luego descarga las rutas calientes.
+6. **Prueba a fondo**: los problemas de data race se convierten en errores de compilación.
+
+## Buenas prácticas
+
+- **Empieza en MainActor** — escribe código de un solo hilo primero, optimiza después.
+- **Usa `@concurrent` solo para trabajo intensivo de CPU** — procesamiento de imágenes, compresión, cómputo complejo.
+- **Habilita el modo de inferencia de MainActor** en targets de app mayormente de un solo hilo.
+- **Perfila antes de descargar** — usa Instruments para encontrar los cuellos de botella reales.
+- **Protege los globales con MainActor** — el estado mutable global/estático necesita aislamiento de actor.
+- **Usa conformances aisladas** en lugar de workarounds con `nonisolated` o envoltorios `@Sendable`.
+- **Migra de forma incremental** — habilita las funciones una a una en los ajustes de compilación.
+
+## Antipatrones a evitar
+
+- Aplicar `@concurrent` a toda función async (la mayoría no necesita ejecución en segundo plano).
+- Usar `nonisolated` para silenciar errores del compilador sin entender el aislamiento.
+- Mantener patrones legados de `DispatchQueue` cuando los actores dan la misma seguridad.
+- Omitir las comprobaciones de `model.availability` en código de Foundation Models relacionado con concurrencia.
+- Pelear contra el compilador — si reporta un data race, el código tiene un problema real de concurrencia.
+- Asumir que todo el código async corre en segundo plano (default de Swift 6.2: permanece en el actor llamante).
+
+## Cuándo aplicarla
+
+- Todo proyecto nuevo con Swift 6.2+ (Approachable Concurrency es el default recomendado).
+- Migración de apps existentes desde la concurrencia de Swift 5.x o 6.0/6.1.
+- Resolución de errores de data race durante la adopción de Xcode 26.
+- Arquitecturas de app centradas en MainActor (la mayoría de las apps con UI).
+- Optimización de rendimiento — descargar cómputos pesados concretos a segundo plano.
+
+## Skills relacionadas
+
+- `patrones-swiftui`
+- `testing-protocolos-di-swift`
+- `persistencia-actores-swift`