umbrales-semaforo
Úsalo cuando haya que definir el éxito de una campaña, experimento o KPI (antes de lanzarlo), o cuando haya que calificar un número en verde/ámbar/rojo y no exista umbral escrito. También cuando algui
SKILL.mddocs/recibido/2026-08-20-junior-metodo-y-conocimiento/skills/umbrales-semaforo/SKILL.md
GitHubUmbrales y semáforo: dos cortes, sin trampa
Un umbral definido después de ver el resultado no es un umbral: es una racionalización. Este skill fija cómo se ponen, cómo se aplican y cuándo (no) se mueven.
0. Antes de empezar
search_cerebro("umbrales vigentes")— si ya existe umbral para esa métrica, se APLICA, no se rediseña.get_kpisde los últimos 4+ periodos para calibrar (excluyendo periodos marcados anómalos o no comparables).- Al fijar un umbral nuevo:
save_cerebro_notecon los cortes, el razonamiento, la fecha de revisión y quién lo aprobó.
1. La estructura: dos cortes → tres colores
- Mínimo aceptable: por debajo = ROJO. Caer ahí significa que algo se rompió.
- Línea de mejora: alcanzarla = VERDE. Se gana superando lo mejor ya demostrado.
- Entre ambos = ÁMBAR: aceptable, sin celebrar.
- Sin dato = GRIS ("n/d"), nunca rojo. Dos periodos seguidos sin dato = rojo de tubería (culpa del sistema de medición, con dueño).
2. Reglas de calibración
| Regla | Cómo se aplica |
|---|---|
| Calibrar solo con periodos limpios | Los periodos bajo anomalía declarada se excluyen y se dice que se excluyeron |
| La mediana histórica cae en ÁMBAR | El umbral empuja, no consagra: si la mediana quedara en verde, el umbral premia el statu quo |
| Verde = superar lo mejor demostrado | La línea de mejora se ancla en el máximo real observado, no en un deseo |
| El cero crónico no se consagra | Si una métrica lleva semanas en 0, su mínimo aceptable es ≥1: vivir en rojo es la presión correcta para arreglar el eslabón, no un castigo |
| n<3 periodos limpios = umbral provisional | Se marca "provisional", con confianza declarada y fecha de recalibración |
| Umbral de decisión ANTES del resultado | Para experimentos: el gate se firma antes del levantamiento (pre-registro), con la forma "si <X pasa Y, si >Z pasa W" |
3. Cuándo se mueven (y cuándo no)
Los umbrales quedan congelados hasta su revisión programada (trimestral por defecto) o hasta un cambio estructural declarado y documentado (cambio de mezcla de tráfico por diseño, redefinición de la métrica, pivote de formato). Nunca se mueven en caliente por una mala semana — ni por una buena. Si un periodo anómalo pinta todo rojo, el semáforo lo dice y el umbral no se toca.
4. Ejemplo bueno y malo (datos FinZen reales)
- Bueno: el gate del trial se firmó ANTES de leer el dato: "% de FREE que choca el techo: <5% mata el mecanismo, >15% mata la tesis del empaque", con predicción escrita (<5%). Cualquier resultado tiene interpretación pactada de antemano.
- Bueno: seguidores netos semanales con historial +34/+39/+46 → mínimo +20 (la mitad del ritmo demostrado = algo se rompió), mejora +50 (supera la mejor semana). La mediana (+39) queda en ámbar: empuja.
- Malo: una métrica hermana llevaba 4 semanas en 0 y la tentación era "umbral: 0 está bien mientras crece views". Se rechazó: mínimo +1, rojo permanente hasta romper el cero, con decisión de formato programada si no rompe en la revisión.
Anti-patrones
- Fijar o ajustar el umbral en la misma sesión en que se lee el resultado que lo incumple.
- Calibrar incluyendo el periodo anómalo "porque es el más reciente".
- Semáforo verde por default cuando falta el dato.
- Umbral sin fecha de revisión ni razonamiento escrito (queda imposible de auditar).
- Copiar umbrales de benchmarks externos sin pasar por el histórico propio.
Formato de entrega
Por métrica: mínimo aceptable · línea de mejora · base observada (conteos y periodos usados) · razonamiento en 1-2 líneas · confianza · fecha de revisión. Si es provisional, decirlo en la misma línea. El conjunto se guarda en el Cerebro y el semáforo posterior solo referencia, no rediscute.