---
asset_id: SK-EH-ROITracker-v01
tipo: SK — Skill
status: v01 · skill activo
owner: Emilio Heredia
intellibank: IB-EH-EmilioHeredia / PB-EH-Project-Bank / PB-EH-SherpaX-Kit / Skills
proposito: Skill que produce/actualiza el ROI Tracker · spreadsheet con instrumentación dual del valor que el sistema SherpaX produce. Mide outcomes (cuantitativo) Y decision quality (cualitativo del proceso). Diseñado para responder honestamente "¿esto está dando valor o solo se ve activo?".
fecha_creacion: 2026-05-12
output_tipo: .xlsx (spreadsheet con múltiples hojas)
parametros_requeridos:
  - periodo: "init" / "monthly" / "quarterly" / "annual"
parametros_opcionales:
  - foco: room específico (MFI · MediaNanny · etc.)
duracion_ejecucion: 10-30 min
tags: [SK, skill, ROITracker, instrumentacion, decision-quality, outcomes, xlsx]
---

# Skill · ROI Tracker

## Instrumentación dual del valor que produce el sistema

---

## §1 · Para qué sirve

Genera o actualiza el **ROI Tracker** · un spreadsheet con instrumentación que mide DOS dimensiones del valor del sistema SherpaX:

### Dimensión 1 · Outcomes (cuantitativo)
- Tiempo invertido en cada room.
- Tiempo recuperado (estimación · vs operar sin sistema).
- Decisiones tomadas y resultado a 30/90/180 días.
- Performance financiera (cuando aplique · ej. MFI).
- Activos producidos (count + tipo).

### Dimensión 2 · Decision Quality (cualitativo del proceso)
- % de decisiones que respetaron la ola emocional.
- % de decisiones con razonamiento explícito documentado.
- % de destellos esplécnicos capturados (Canal 32-54).
- % de patrones del Brain OS aplicados antes de decidir.
- % de filtros HD aplicados explícitamente.
- Lag time entre destello capturado y aplicación en decisión.
- % de decisiones revisadas en destilación trimestral con post-mortem honesto.

**Por qué medir ambas:** sin medir process, una racha de buenos outcomes hace creer que el sistema funciona cuando puede ser solo suerte. Sin medir outcomes, una racha de mala suerte hace abandonar un proceso que sí funciona. Las dos métricas juntas son el único feedback honesto.

---

## §2 · Cuándo invocarlo

- **Init** · una sola vez al instalar (Misión M6 del Mission Pack · primer mes).
- **Mensual** · primer lunes del mes con datos del mes anterior.
- **Trimestral** · cierre de trimestre con análisis profundo.
- **Anual** · revisión integral del año.

---

## §3 · Cuándo NO invocarlo

- ❌ Antes del primer mes completo (no hay datos suficientes).
- ❌ Para tomar decisiones operativas día a día (es para retrospección · no para operación).
- ❌ Para presentar a terceros sin sanitizar (contiene cifras y procesos confidenciales).

---

## §4 · Inputs necesarios

| Input | Requerido | Descripción |
|---|---|---|
| Acceso al vault completo | ✅ | EmilioX cuenta archivos · clasifica decisiones · evalúa quality |
| Período a medir | ✅ | "init" · "monthly" · "quarterly" · "annual" |
| Tracker previo (si existe) | ❌ | Si es update · usa tracker anterior como base |
| Foco | ❌ | Filtrar por room específico |

---

## §5 · Procedimiento de ejecución

### Paso 1 · Recolección de datos

EmilioX recorre el vault y cuenta:

**Por cada room operativo:**
- Número de docs de cada tipo (MEMO · BRIEF · DEST · LEC · RPT · etc.).
- Fechas de cada doc (inferir tiempo invertido).
- Decisiones marcadas como tales (frontmatter o contenido).

**Por cada decisión:**
- ¿Tiene razonamiento documentado? (busca campo · sección · keyword "razonamiento").
- ¿Menciona ola emocional respetada? (frontmatter `ola_emocional_aplicada` o keyword).
- ¿Tiene filtro HD explícito? (mención de Canal 32-54 · 29 · GK · etc.).
- ¿Tiene outcome capturado a 30/90/180 días? (busca timestamps de seguimiento).

**Por cada destello esplécnico (`DEST-`):**
- ¿Se capturó literal sin justificar?
- ¿Tiene fecha y contexto?
- ¿Tiene seguimiento (¿se confirmó? ¿se descartó?)?

**Por cada lección destilada (`LEC-`):**
- ¿Se generó al cierre de algún ciclo?
- ¿Se promovió alguna a regla inmutable?

### Paso 2 · Cálculo de métricas

EmilioX calcula:

**Métricas de outcomes:**
- Total docs producidos por mes · trend.
- Tiempo estimado invertido (usar 30 min default por doc · ajustable).
- Tiempo recuperado vs baseline (usando estimación de 60% de coordinación recuperada · proxy).
- Por room: ratio docs producidos / sesiones operativas.

**Métricas de decision quality:**
- % decisiones con razonamiento documentado.
- % decisiones con ola emocional respetada.
- % decisiones con filtro HD aplicado explícitamente.
- Promedio de destellos capturados por mes.
- Promedio de Canal 29 filtrados por mes.
- Lag time promedio destello → aplicación.

**Métricas de salud del sistema:**
- ¿Ritmos canónicos se ejecutaron? (semanal · mensual · trimestral).
- ¿Hay drift (semanas sin actividad)?
- ¿Hay rooms abandonados (sin actividad >30 días)?
- ¿Hay rooms saludables (actividad consistente)?

### Paso 3 · Generación del spreadsheet

EmilioX produce/actualiza `CP-EH-ROI-Tracker-v0N.xlsx` con hojas:

1. **Dashboard** · vista ejecutiva con métricas clave del periodo.
2. **Outcomes-Mensual** · serie temporal de outcomes mes a mes.
3. **DecisionQuality-Mensual** · serie temporal de decision quality.
4. **Por-Room** · breakdown por room operativo.
5. **Decisiones-Detalle** · tabla con cada decisión + sus métricas.
6. **Destellos-Tracking** · tabla con destellos + su outcome a 30/90 días.
7. **Lecciones-Promovidas** · destilaciones que ascendieron a regla inmutable.
8. **Notas-Periodo** · texto con observaciones cualitativas del periodo.

### Paso 4 · Análisis cualitativo

EmilioX agrega texto en hoja `Notas-Periodo`:

- 3 patrones positivos detectados.
- 3 fricciones detectadas.
- 3 acciones recomendadas para próximo periodo.
- Diagnóstico honesto: ¿el sistema da valor real o solo se ve activo?

### Paso 5 · Captura al BrainOS

EmilioX agrega thought tipo `learning`:
> *"ROI Tracker actualizado al {fecha}. Tendencia outcomes: {↑/↓/→}. Tendencia decision quality: {↑/↓/→}. Diagnóstico del periodo: {síntesis}."*

---

## §6 · Output esperado

### Archivo
`CP-EH-ROI-Tracker-v0N.xlsx` (versionado por mes/trimestre).

### Ubicación
`IB-EH-EmilioHeredia/PB-EH-Project-Bank/PB-EH-MFI/MetaFactoria/reportes/roi-trackers/`

### Tamaño esperado
100-500 KB según volumen de decisiones acumuladas.

### Estructura de hojas
8 hojas según §5 paso 3.

### Visualizaciones incluidas
- Dashboard con KPIs principales (formato tarjetas).
- Series temporales (gráficos de línea).
- Distribución por room (gráfico de barras).
- Heatmap de actividad (cuándo hubo capturas vs cuándo no).

---

## §7 · Variaciones / parámetros opcionales

### Variación 1 · ROI Tracker init (primera vez)
```
"Ejecuta SK-ROITracker · período init."
```
→ Genera estructura inicial vacía con plantillas para alimentar.

### Variación 2 · ROI Tracker mensual
```
"Ejecuta SK-ROITracker · período monthly · mes 2026-06."
```
→ Actualiza con datos del mes específico.

### Variación 3 · ROI Tracker por room
```
"Ejecuta SK-ROITracker · foco MFI · período 90d."
```
→ Genera/actualiza tracker filtrado solo de un room.

### Variación 4 · ROI Tracker comparativa anual
```
"Ejecuta SK-ROITracker · período annual · comparar 2026 vs 2025."
```
→ Genera tracker con comparación inter-anual.

---

## §8 · Ejemplo de invocación

```
"EmilioX, ejecuta el skill ROITracker.
Período: monthly (mayo 2026).
Foco: vault completo (todos los rooms)."
```

EmilioX responde:
1. *"Ejecutando SK-EH-ROITracker · monthly · mayo 2026 · vault completo..."*
2. Recorre vault · cuenta · clasifica · calcula.
3. Reporta:
   > *"ROI Tracker actualizado en `CP-EH-ROI-Tracker-v05.xlsx`.
   > 
   > Outcomes mayo:
   > - Docs producidos: 47 (vs 31 en abril · +52%)
   > - Tiempo recuperado estimado: 18h (vs 12h abril)
   > - Decisiones tomadas: 12 (3 grandes · 9 medianas)
   > 
   > Decision quality mayo:
   > - 92% decisiones con razonamiento (vs 78% abril · ↑)
   > - 75% con ola emocional respetada (vs 62% abril · ↑)
   > - 100% con filtro HD aplicado (excelente)
   > - 8 destellos capturados (vs 3 abril · ↑)
   > 
   > Diagnóstico: el sistema está mejorando claramente en proceso. La consolidación de captura es real. Falta cerrar mejor el lag entre destello y aplicación (promedio 12 días · target 7 días).
   > 
   > Recomendación principal: agregar revisión semanal de destellos pendientes para acelerar aplicación."*

---

## §9 · Captura post-ejecución

EmilioX automáticamente:
1. Agrega thought `learning` al BrainOS con síntesis del tracker.
2. Si detectó tendencia preocupante (drift · friction recurrente) · agrega a `Lecciones-Activas.md`.
3. Si detectó patrón positivo · agrega a `Patrones-Canal-32-54.md` (cuando aplique).
4. Si recomienda acción concreta para próximo periodo · genera MEMO con la recomendación.

---

## §10 · Versionado del skill

- **v01** (este) · cuenta archivos manualmente · estima tiempo · genera xlsx básico.
- **v02** (futuro) · cuando haya BrainOS v2 (Supabase) · usa queries directos para conteos más precisos.
- **v03** (futuro) · agregar predicciones (forecasting de tendencias).

---

*Skill · ROI Tracker · v01 · 12 de mayo de 2026*
*Owner: Emilio Heredia · IntelliBank: IB-EH-EmilioHeredia / PB-EH-Project-Bank / PB-EH-SherpaX-Kit / Skills*