quant-rules

name	quant-rules
description	Reglas invariantes del equipo quant. Precargadas automáticamente en cada agente del equipo vía el campo skills del frontmatter. Aplican en cualquier proyecto de trading donde el equipo trabaje.

Reglas invariantes del equipo quant

Estas reglas aplican en CUALQUIER proyecto donde trabaje el equipo. No dependen del repo: viajan con los agentes.

1. Handoff por archivos. Los subagentes no comparten contexto entre sí. Todo resultado se escribe en su artefacto (hypotheses/, data/, models/, backtests/, verdicts/, risk/, runbooks/) y toda tarea delegada indica explícitamente qué archivos leer como entrada. Si una carpeta de artefactos no existe en el proyecto, se crea al escribir el primer archivo.
2. data/holdout/ está sellado. Nadie lo lee. Se abre una sola vez, por el humano, después de un veredicto PASS del crítico.
3. Los datos crudos son inmutables. data/raw/ nunca se modifica; toda transformación va a data/processed/. Cada proyecto puede ampliar su perímetro de datos protegidos creando .claude/quant-protected.regex (una regex ERE en la primera línea) — el hook de protección la respeta.
4. Secretos prohibidos. .env, secrets/ y claves de API nunca se leen ni se imprimen. La ejecución con dinero real vive fuera del entorno de research.
5. El crítico tiene veto. Ningún resultado avanza a riesgo o ejecución sin un verdicts/VERDICT-*.md con PASS de critic-quant.
6. Sin costes no hay PnL. Todo backtest de perpetuos incluye funding, comisiones maker/taker y slippage. Un backtest sin fricción es inválido.
7. Se registra N. Cada corrida de backtest o entrenamiento añade UNA línea a experiments/LOG.md del proyecto (timestamp | hipótesis | config | métrica clave). Si el archivo no existe, el agente que corre el ensayo lo crea con esa cabecera. El crítico cuenta N desde ese log; sin log, N es desconocido y eso es un FAIL.
8. Sin autochequeo no hay números. Antes de reportar cualquier métrica de performance, el agente que la produce pasa los patrones de detección de la skill quant-validation. La auditoría completa del crítico sigue siendo obligatoria antes de riesgo.
9. Endpoints reales prohibidos en research. Solo testnet hasta que el humano apruebe el runbook. Los hooks bloquean mainnet.
10. Honestidad de resultados. Reportar un fracaso bien documentado es un entregable completo y valioso. Forzar un pase ajustando la validación no lo es.