Risk Portfolio Manager - Control de Riesgos Impulsado por IA
Capa sistemática de gestión de riesgos que se sitúa entre la generación de señales y la ejecución de operaciones. Utiliza enfoques basados en datos para optimizar el tamaño de las posiciones, gestionar el riesgo de la cartera y automatizar acciones defensivas.
Principio Fundamental
El tamaño de las posiciones y la gestión de riesgos determinan la supervivencia a largo plazo. Ninguna operación individual debería amenazar la cartera.
Disparadores de Activación
Capacidades Principales
1. Motor de Dimensionamiento de Posiciones
<position_sizing> Métodos de Dimensionamiento:
interface PositionSizeRequest {
signal_strength: number; // 0-1 de meme-trader
token_risk_score: number; // 1-10 de detección de rug
current_portfolio: Portfolio;
market_regime: 'bull' | 'bear' | 'sideways' | 'volatile';
risk_tolerance: 'conservative' | 'moderate' | 'degen';
}
interface PositionSizeResult {
recommended_size_pct: number; // % de la cartera
recommended_size_usd: number;
max_allowed_size: number;
reasoning: string[];
risk_warnings: string[];
}
Criterio de Kelly (Modificado):
Tamaño Óptimo = (Tasa de Acierto * Ganancia Promedio - (1 - Tasa de Acierto) * Pérdida Promedio) / Ganancia Promedio
Tamaño Ajustado = Kelly * Multiplicador Fraccional (0.25-0.5 para seguridad)
Matriz de Dimensionamiento Ajustado al Riesgo:
| Tolerancia al Riesgo | Tamaño Base | Máx Posición Individual | Máx Exposición Correlacionada |
|---|---|---|---|
| Conservadora | 0.5-1% | 2% | 5% |
| Moderada | 1-2% | 4% | 10% |
| Degen | 2-5% | 10% | 25% |
Ajustes Basados en Señal:
Tamaño Final = Tamaño Base * Fuerza de Señal * (1 - Riesgo del Token / 20) * Multiplicador de Mercado
Donde:
- Fuerza de Señal: 0.5-1.5 (débil a fuerte)
- Riesgo del Token: 1-10 (más bajo es más seguro)
- Multiplicador de Mercado: 0.5 (volátil) a 1.2 (en tendencia)
Formato de Salida:
RECOMENDACIÓN DE TAMAÑO DE POSICIÓN
Token: $MEME
Fuerza de Señal: 8/10
Puntuación de Riesgo del Token: 4/10
Régimen de Mercado: BULL
TAMAÑO RECOMENDADO:
├─ Porcentaje: 2.3% de la cartera
├─ Cantidad: $460 (de cartera de $20,000)
├─ Máximo Permitido: $800 (límite del 4%)
└─ Ajustado al Riesgo: DENTRO DE LÍMITES
RAZONAMIENTO:
1. Señal fuerte (8/10) respalda un tamaño superior al promedio
2. Token de riesgo bajo-medio (4/10) permite asignación completa
3. El régimen de mercado alcista permite un dimensionamiento agresivo
4. Sin correlación con posiciones existentes
ADVERTENCIAS:
- Considere escalar la entrada (3 tramos) vs. entrada única
- Establezca stop-loss en -25% (pérdida máxima de $345)
</position_sizing>
2. Métricas de Riesgo de Cartera
<risk_metrics> Panel de Riesgo en Tiempo Real:
PANEL DE RIESGO DE CARTERA
═══════════════════════════════════════
POSICIONES (5 activas):
Token | Tamaño | PyG | Riesgo | Peso
$BONK | $4,200 | +$840 | 5/10 | 21%
$MEME | $3,100 | +$620 | 4/10 | 15.5%
$DOGE | $2,800 | -$140 | 3/10 | 14%
$WIF | $2,500 | +$1,250 | 6/10 | 12.5%
SOL | $7,400 | +$2,220 | 2/10 | 37%
───────────────────────────────────────
TOTAL | $20,000 | +$4,790 | | 100%
MÉTRICAS DE RIESGO:
├─ VaR Diario (95%): -$1,240 (-6.2%)
├─ Drawdown Máximo (30d): -18.3%
├─ Drawdown Actual: 0% (en máximos históricos)
├─ Ratio Sharpe (30d): 2.14
├─ Ratio Sortino: 2.87
├─ Beta respecto a SOL: 1.34
MATRIZ DE CORRELACIÓN:
BONK MEME DOGE WIF SOL
BONK 1.00 0.82 0.71 0.78 0.65
MEME 0.82 1.00 0.68 0.85 0.61
DOGE 0.71 0.68 1.00 0.59 0.54
WIF 0.78 0.85 0.59 1.00 0.72
SOL 0.65 0.61 0.54 0.72 1.00
RIESGO DE CONCENTRACIÓN:
├─ Posición Principal: 37% (SOL) - DENTRO DEL LÍMITE
├─ 3 Posiciones Principales: 72.5% - ALTO
├─ Índice Herfindahl: 0.23 - MODERADO
└─ Exposición a Memes: 63% - ALTO
ALERTAS:
⚠️ Alta correlación entre MEME y WIF (0.85)
⚠️ Concentración del sector meme por encima del 50%
Cálculos de Riesgo:
interface PortfolioRisk {
// Valor en Riesgo
var_95: number; // VaR diario con 95% de confianza
var_99: number; // VaR diario con 99% de confianza
cvar_95: number; // VaR condicional (déficit esperado)
// Riesgo de Rendimiento
sharpe_ratio: number;
sortino_ratio: number;
max_drawdown: number;
current_drawdown: number;
// Riesgo de Correlación
avg_correlation: number;
max_correlation: number;
correlation_cluster: string[]; // Grupos altamente correlacionados
// Riesgo de Concentración
herfindahl_index: number;
top_position_pct: number;
sector_concentrations: Record<string, number>;
}
function calculateVaR(
positions: Position[],
confidence: number = 0.95,
horizon_days: number = 1
): number {
// VaR histórico utilizando los últimos 30 días de rendimientos
const returns = getHistoricalReturns(positions, 30);
const portfolio_returns = calculatePortfolioReturns(returns, positions);
const sorted = portfolio_returns.sort((a, b) => a - b);
const index = Math.floor((1 - confidence) * sorted.length);
return sorted[index] * getPortfolioValue(positions) * Math.sqrt(horizon_days);
}
</risk_metrics>
3. Reequilibrio Dinámico
Marco de Asignación Objetivo:
interface AllocationTarget {
core_holdings: {
SOL: { target: 30, min: 20, max: 50 };
stablecoins: { target: 20, min: 10, max: 40 };
};
satellite_holdings: {
memes: { target: 30, min: 0, max: 50 };
defi: { target: 15, min: 0, max: 30 };
other: { target: 5, min: 0, max: 15 };
};
rebalance_threshold: 5; // % de desviación para activar
}
Salida de Reequilibrio:
RECOMENDACIÓN DE REEQUILIBRIO
Asignación Actual vs. Objetivo:
Categoría | Actual | Objetivo | Desviación | Acción
SOL | 37% | 30% | +7% | VENDER $1,400
Memes | 63% | 50% | +13% | VENDER $2,600
Estables | 0% | 20% | -20% | COMPRAR $4,000
OPERACIONES SUGERIDAS:
1. VENDER el 15% de la posición BONK ($630) → USDC
2. VENDER el 20% de la posición WIF ($500) → USDC
3. VENDER el 10% de la posición SOL ($740) → USDC
4. Mantener las posiciones MEME y DOGE
5. Convertir las ventas a un colchón de stablecoin USDC
PROYECCIÓN POST-REEQUILIBRIO:
├─ SOL: 31% (objetivo: 30%)
├─ Memes: 48% (objetivo: 50%)
├─ Estables: 21% (objetivo: 20%)
└─ Reducción de VaR: -18% (perfil de riesgo mejorado)
4. Acciones Defensivas Automatizadas
<defensive_actions> Sistema de Kill Switch:
interface KillSwitchConfig {
daily_loss_limit: number; // % de la cartera
weekly_loss_limit: number; // % de la cartera
position_loss_limit: number; // % por posición
drawdown_limit: number; // % desde el máximo
correlation_spike_action: 'alert' | 'reduce' | 'exit';
auto_execute: boolean;
}
const defaultKillSwitch: KillSwitchConfig = {
daily_loss_limit: 10, // Detener nuevas operaciones al -10% del día
weekly_loss_limit: 20, // Detener toda actividad al -20% de la semana
position_loss_limit: 30, // Cerrar automáticamente posición al -30%
drawdown_limit: 25, // Modo de emergencia al -25% desde el máximo
correlation_spike_action: 'alert',
auto_execute: false, // Requerir confirmación en Fase 1
};
Acciones Activadas:
| Disparador | Acción | Gravedad |
|---|---|---|
| Posición -25% | Advertencia de stop-loss | MEDIA |
| Posición -30% | Cierre automático (si está activado) | ALTA |
| Pérdida diaria -10% | Detener nuevas operaciones | ALTA |
| Pérdida semanal -20% | Salir a estables | CRÍTICA |
| Drawdown -25% | Liquidación de emergencia | CRÍTICA |
| Correlación > 0.95 | Reducir una posición | MEDIA |
Salida de Alerta:
🚨 ALERTA DE RIESGO: LÍMITE DE PÉRDIDA DIARIA PRÓXIMO
PyG del Día Actual: -8.7% ($-1,740)
Límite Diario: -10% ($-2,000)
Colchón Restante: $260
ACCIONES ACTIVADAS:
1. ⏸️ Ejecución de nuevas operaciones PAUSADA
2. ⚠️ Revisar todas las posiciones abiertas
3. 📊 Mayor frecuencia de monitoreo
RECOMENDADO:
- Revisar la posición de peor rendimiento (WIF: -15%)
- Considerar una salida parcial si la tendencia continúa
- NO promediar a la baja
Escriba RESUME para reactivar las operaciones
Escriba EXIT_ALL para liquidar posiciones
</defensive_actions>
5. Análisis de Escenarios
<scenario_analysis> Pruebas de Estrés:
interface StressScenario {
name: string;
market_move: {
sol: number; // % de cambio
memes: number; // % de cambio vs SOL
correlation_shift: number;
};
probability: number;
}
const stressScenarios: StressScenario[] = [
{
name: 'Caída Repentina de SOL -30%',
market_move: { sol: -30, memes: -50, correlation_shift: 0.2 },
probability: 0.05,
},
{
name: 'Rotación Fuera de Memes',
market_move: { sol: 0, memes: -40, correlation_shift: -0.1 },
probability: 0.10,
},
{
name: 'Continuación del Mercado Alcista',
market_move: { sol: 50, memes: 100, correlation_shift: 0 },
probability: 0.15,
},
{
name: 'Evento de Cisne Negro',
market_move: { sol: -60, memes: -80, correlation_shift: 0.3 },
probability: 0.01,
},
];
Salida de Prueba de Estrés:
RESULTADOS DE LA PRUEBA DE ESTRÉS
Valor Actual de la Cartera: $20,000
ESCENARIO | Impacto en Cartera | Probabilidad
Caída Repentina de SOL -30% | -$7,200 (-36%) | 5%
Rotación Fuera de Memes | -$5,040 (-25%) | 10%
Continuación Mercado Alcista | +$14,600 (+73%) | 15%
Evento de Cisne Negro | -$12,400 (-62%) | 1%
VALOR ESPERADO DE LA CARTERA:
├─ Caso Base: $20,000
├─ Esperado (ponderado por prob.): $22,340 (+11.7%)
├─ Peor Caso (99%): -$12,400 (-62%)
└─ VaR (95%, 30d): -$4,800 (-24%)
EVALUACIÓN DE RIESGO:
⚠️ Alta sensibilidad a la rotación de memes (escenario -25%)
⚠️ Exposición significativa a cisne negro (-62%)
✓ Valor esperado positivo en escenarios base
✓ Potencial alcista sustancial en caso alcista (+73%)
RECOMENDACIÓN:
Considere cubrir la exposición a memes con puts de SOL o reducir
la asignación a memes en un 10-15% para mejorar el perfil de riesgo.
</scenario_analysis>
Puntos de Integración
El Gestor de Riesgos proporciona a:
- meme-executor: Tamaños de posición aprobados, niveles de stop-loss
- meme-trader: Límites de posición, capital disponible
- Todos los skills: Estado de la cartera, alertas de riesgo
Uso en CLI
# Calcular tamaño de posición
npx tsx .claude/skills/risk-portfolio-manager/scripts/position-sizer.ts \
--signal 8 \
--risk-score 4 \
--portfolio-file ./portfolio.json \
--risk-mode moderate
# Obtener métricas de riesgo de cartera
npx tsx .claude/skills/risk-portfolio-manager/scripts/risk-metrics.ts \
--portfolio-file ./portfolio.json \
--include-correlation \
--var-confidence 95
# Recomendación de reequilibrio
npx tsx .claude/skills/risk-portfolio-manager/scripts/rebalancer.ts \
--portfolio-file ./portfolio.json \
--target-allocation ./targets.json \
--threshold 5
# Ejecutar pruebas de estrés
npx tsx .claude/skills/risk-portfolio-manager/scripts/stress-test.ts \
--portfolio-file ./portfolio.json \
--scenarios default \
--output-format detailed
# Verificar estado del kill switch
npx tsx .claude/skills/risk-portfolio-manager/scripts/kill-switch.ts \
--portfolio-file ./portfolio.json \
--check-status
Puertas de Calidad
<validation_rules>
- El dimensionamiento de posiciones requiere una puntuación de calidad >= 85% en los datos de precio
- Los cálculos de VaR requieren 30+ días de datos históricos limpios
- La matriz de correlación requiere datos de precio sincronizados
- Todas las recomendaciones incluyen niveles de confianza
- No se realiza dimensionamiento de posiciones sin verificación de detección de rug </validation_rules>
Manejo de Errores
<error_recovery>
- Datos de precio faltantes: Usar el último conocido + advertencia de desactualización
- Error de cálculo: Respaldo conservador (tamaño mínimo)
- Conflicto de kill switch: La seguridad gana (detener > continuar)
- Calidad de datos insuficiente: Rechazar dimensionamiento, solicitar actualización </error_recovery>
<see_also>
- references/risk-models.md - Fórmulas matemáticas
- references/allocation-templates.md - Carteras objetivo
- scripts/position-sizer.ts - Motor de dimensionamiento
- scripts/risk-metrics.ts - Cálculos de riesgo
- scripts/kill-switch.ts - Seguridad automatizada </see_also>