Saltar a contenido

Scheduled routines pattern (para trading)

Patrón de disparo en horarios fijos alineados al ciclo del mercado US. Cada disparo es una sesión independiente que lee memory, hace una acción acotada, y escribe resultados. Implementación de referencia: entities/claude-code-routines.

Horarios típicos (US Central Time, weekdays only)

Routine Hora Qué hace
Pre-market 06:00 Research noticias, catalysts, earnings del día. Draft de trade ideas. No ejecuta. Notifica solo si urgente.
Market open 08:30 Ejecuta los trades planificados en pre-market. Setea trailing stops 10%. Notifica si tradea.
Midday 12:00 Corta losers que cayeron -7%. Tightens stops en winners.
Close 15:00 Registra PnL del día. Actualiza posiciones.
Weekly review Vie 16:00 Grade del bot (A-F). Propone ajustes a estrategia. Post-mortem de la semana.

NYSE horario: 9:30–16:00 ET = 8:30–15:00 CT. Por eso el video usa CT.

⚠️ Límite crítico: mínimo 1 hora entre runs

Según docs oficiales de Claude Code Routines, cron expressions más frecuentes que cada 1 hora son rechazadas. Los 4 horarios fijos de arriba son viables (están separados >1h cada uno). Pero NO es viable monitorear el mercado minuto-a-minuto con Routines.

Workaround para monitoreo más frecuente:

  1. API trigger — script externo (propio cron OS o webhook de un data provider) POSTea a /fire endpoint para iniciar una session on-demand. Sirve para reacciones event-driven (alerta de precio, news event).
  2. Scheduled task local (no remote) — en la máquina del usuario con cron < 1h. Requiere máquina encendida.
  3. Híbrido: remote routines para las 4-5 rutinas principales + webhook externo para eventos.

Principios de diseño

  • Idempotencia: si la routine se dispara dos veces, la segunda no debe romper cosas.
  • Guardrails en cada step: el pre-market no ejecuta; el close no abre posiciones; etc. Ver concepts/trading-guardrails.
  • Acotar tokens: cada routine tiene un budget (§context-budget). Si se acerca al límite, truncar research.
  • Fallback notificación: si la routine falla, notificar al usuario (no silencio).

Alternativas de scheduling

  • Claude Code Routines — default del video.
  • cron OS-level + CLI de Claude (claude -p "...") — más control, más fragilidad.
  • GitHub Actions cron — gratis con límites; latencia mayor (minutos) no sirve para market-open-sensitive.
  • Temporal / Airflow — overkill para un solo agente.

Para este proyecto, Claude Routines + fallback cron = buena combinación (si Anthropic cae, cron dispara).

Relaciones