Protocolo de Errores — "Declarar en Voz Alta"
La pila de cómputo + motor es nueva y se mueve. Cada fallo recibe este protocolo. Nunca encubras un error para mantener una campaña en marcha: un error tragado es peor que una etapa bloqueada. Un mecanismo confabulado (inventar por qué el motor hizo algo) es el peor modo de fallo: los peores momentos de la campaña han sido eventos de conciliación, comportamiento de precios y comportamiento de presupuesto confabulados. Verifica, no asumas.
Precedente: un error de sobre-despliegue de totalBudget (un libro con un presupuesto del 40% desplegó ~96% del NAV en el arranque en frío) se detectó exactamente de esta manera e invalidó semanas de resultados. La lección general es poner en cuarentena todos los resultados afectados por un defecto del motor y volver a ejecutar solo después de corregir el comportamiento.
Los cinco pasos (aplicar en cada fallo)
- Detente y caracteriza — ¿es configuración (mía), datos (del lado de la fuente) o motor (NexusTrade)? Reproduce mínimamente — el trabajo/backtest más pequeño que aún lo muestre.
- Regístralo inmediatamente en el
CAMPAIGN_LOG.mdde la ejecución bajo un encabezado⚠️ BUG/ISSUE: síntoma, IDs de reproducción, esperado vs observado, hipótesis actual (etiquetada hipótesis), qué bloquea. - Si es un error real de motor/datos, redacta un documento de transferencia
<NOMBRE>_BUG.mden el directorio de la ejecución, siguiendo el modelo de la plantilla enreferences/BUG_TEMPLATE.md(resumen de una línea, esperado vs observado, reproducción con IDs, hipótesis principal, alternativas a descartar, dónde mirar, impacto en los resultados). - Pon en cuarentena los resultados afectados — marca cada backtest/estudio que se ejecutó antes de la corrección como sospechoso/inválido. Vuelve a ejecutar después de la corrección. Si el error infló el apalancamiento, tanto los rendimientos como las reducciones están inflados y cualquier gen de barrido que haya tocado puede no ser diferenciador — revalida todo.
- Díselo al humano, de manera prominente, en el chat. Los errores son un entregable al mismo nivel que el resultado comercial del episodio, no una vergüenza que ocultar.
Qué NO es un error (fallos de señal honesta — no los registres)
- Un pliegue que devuelve
NoEligibleCandidate= una señal honesta, no un error. Amplía la validación; no elimines los pisos de certificación. - Un nombre muerto / aún no listado (por ejemplo, SNDK en 2022) que está ausente o en una lista de rechazo sin valores inventados = comportamiento correcto. Que el motor invente un valor de precio/indicador para un nombre que no cotizó SÍ es un error (ver engine-sanity).
- Un objetivo de conciliación de un solo tick = la estrategia en vivo acumula el resto durante los rebalances diarios — dilo, no lo rediagnostiques como un error (ver deploy-gate).
Lista de verificación "Verifica, no asumas"
Antes de escribir cualquier afirmación sobre el comportamiento del motor en un entregable, respáldala con uno de: query_backtest_events / query_portfolio_events, una conditionFieldAudit, o una reproducción mínima. "El motor probablemente…" no es evidencia.