4.4 ~40 min · Intermedio

⏰ Cron y tareas recurrentes

Programa agentes para que se ejecuten en intervalos definidos: revisiones diarias, informes automáticos y monitoreo continuo sin intervención humana.

⏰ Cron y programación

Cron es la sintaxis estándar de Unix para definir horarios de ejecución. Claude Code se integra con cron mediante la skill /schedule — defines la tarea en lenguaje natural y el sistema crea la rutina programada.

La skill /schedule permite crear agentes remotos que se ejecutan en intervalos definidos sin necesitar una terminal local abierta.

// Sintaxis cron: minuto hora día_del_mes mes día_de_la_semana

0 9 * * 1-5    → 9h, segunda a sexta
0 9 * * 1       → 9h todo domingo
*/30 * * * *    → a cada 30 minutos
0 0 * * *       → meia-noite todo dia
0 8 1 * *       → 8h no dia 1 de cada mês

// Com a skill /schedule (linguagem natural):
/schedule todo dia útil às 9h: revisar commits do dia anterior
/schedule toda segunda às 8h: gerar relatório semanal de métricas
/schedule a cada hora: verificar se há PRs aguardando review

⏰ Usa cron cuando

→ Horario fijo y predecible
→ La terminal puede estar cerrada
→ La tarea debe ejecutarse en producción
→ Múltiples días/semanas en el futuro

🔁 Usa /loop cuando

→ Polling durante una sesión activa
→ Intervalo corto (cada 5-30 min)
→ Monitoreo temporal
→ Quieres cancelar manualmente

🔁 Bucle e intervalo: el comando /loop

O /loop repite un slash command a intervalos definidos mientras la sesión está activa. Cada iteración es una ejecución independiente, sin acumulación de contexto entre rondas.

// Ejemplos de uso de /loop

/loop 5m /status
→ Verifica o status do projeto a cada 5 minutos

/loop 30m Verifique se há novos erros no log de erros do servidor
→ Prompt livre com auto-pace (Claude decide quando repetir)

/loop 1h /code-review
→ Code review a cada hora (útil em sessões longas de desenvolvimento)

// Cancelar: Ctrl+C (encerra o loop)
// Ver status: /status (mostra próxima execução)

⚠️ Cuidado con la presión de contexto

O /loop acumula contexto a lo largo de las iteraciones. Después de muchas rondas, el contexto se vuelve pesado y lento. Usa /compact periódicamente o configura el loop para limpiar el contexto entre iteraciones.

🌐 Agentes remotos

Los agentes remotos se ejecutan en la infraestructura de Claude sin necesidad de tener una terminal local abierta. Se activan por eventos (webhook, cron) y funcionan de forma completamente autónoma: solo recibes el resultado cuando terminan.

O RemoteTrigger es la herramienta que lanza un agente remoto. El PushNotification envía el resultado mediante webhook cuando el agente termina.

💻 Agente local

→ Requiere la terminal abierta
→ Se pausa cuando cierras la laptop
→ Acceso completo al filesystem local
→ Ideal para el desarrollo activo
→ Costo: solo los tokens usados

☁️ Agente remoto

→ Se ejecuta sin la terminal abierta
→ Continúa incluso con la laptop apagada
→ Acceso mediante API y repositorio remoto
→ Ideal para la automatización de producción
→ Costo: tokens + compute remoto

📋 Ejemplo: revisión diaria automatizada

El caso de uso más popular: un agente de revisión de código que se ejecuta todos los días a las 9h, analiza los commits del día anterior y genera un informe de calidad.

Cron se ejecuta a las 9h

Programación creada con /schedule: "todos los días hábiles a las 9h, ejecuta el workflow de revisión"

El agente recopila commits

git log --since=yesterday --oneline + diff de cada commit desde la última tag

Análisis de calidad

Verifica: lógica de negocio, casos límite, seguridad, rendimiento, pruebas faltantes

Informe guardado + notificación

Guarda en .reviews/YYYY-MM-DD.md + envía vía webhook a Slack/Discord

// Prompt para crear el schedule mediante /schedule

/schedule todo dia útil às 9h: 
  1. Execute: git log --since=yesterday --name-only --oneline
  2. Para cada arquivo modificado, execute /code-review
  3. Consolide os achados em .reviews/$(date +%Y-%m-%d).md
     Formato: ## Data · N commits · Qualidade: Alta/Média/Baixa
     Seções: Pontos Positivos, Riscos, Ações Recomendadas
  4. Se houver riscos ALTOS, poste no webhook $SLACK_WEBHOOK_URL

// O agente usa prompt caching para o contexto base
// (CLAUDE.md + CHECKLIST.md) — 90% mais barato por rodada

📥 Capturar el resultado de agentes asíncronos

Los agentes asíncronos (cron, remoto) no devuelven resultados de inmediato. Tienes que definir donde se entregará el output antes de lanzar el agente.

📁 Archivo

El agente guarda el informe en una ruta configurable. Simple, sin dependencias externas.

.reviews/2026-06-01.md

🔔 Webhook

PushNotification envía el resultado a Slack, Discord, n8n o cualquier endpoint HTTP.

POST $WEBHOOK_URL

👁️ Monitor

Stream de eventos en tiempo real. Úsalo cuando quieras seguir la ejecución.

/monitor task-id

💡 Automatización sin observabilidad = automatización a ciegas

Configura siempre al menos un mecanismo de output antes antes de activar un agente recurrente. Un agente que falla silenciosamente durante semanas es peor que no tener automatización: crea una falsa sensación de seguridad.

⚠️ Costo e idempotencia en producción

Los agentes recurrentes acumulan costos con el tiempo. Una revisión diaria que cuesta $0.10/día = $30/mes = $365/año. Parece barato, pero si un error hace que el agente se ejecute dos veces, el costo se duplica. La idempotencia lo resuelve.

Idempotencia: ejecutar el agente N veces produce el mismo resultado que ejecutarlo 1 vez. Es crucial cuando los fallos provocan reejecuciones automáticas.

✓ Prácticas de producción

✓ Verificar antes de actuar: comprobar si la tarea ya se hizo hoy
✓ Archivo de bloqueo: evitar ejecuciones simultáneas del mismo agente
✓ Alertas de budget: notificar cuando el costo supere el umbral
✓ Activar el almacenamiento en caché de prompts para el contexto fijo (CLAUDE.md)

✗ Trampas de producción

✗ Agente que crea PR idénticos si se ejecuta 2× el mismo día
✗ Sin alertas de costos: sorpresas en la factura del mes
✗ Agente con acceso de escritura a la base de datos de producción
✗ Sin output configurado, no sabes si funcionó

// Patrón idempotente: comprobar antes de actuar

#!/bin/bash # .claude/hooks/idempotency-check.sh
DATE=$(date +%Y-%m-%d)
LOCK_FILE=".reviews/.lock-$DATE"

# Se o arquivo de lock existir, o review já rodou hoje
if [ -f "$LOCK_FILE" ]; then
  echo "Review de $DATE já executado. Pulando." >&2
  exit 0
fi

# Cria o lock antes de começar
touch "$LOCK_FILE"

# ... resto da execução ...

# Se falhar, remove o lock para permitir retry
trap "rm -f '$LOCK_FILE'" ERR

🎯 Resumen del Módulo 4.4

✓

Cron + /schedule — programación de tareas en horarios fijos mediante sintaxis cron o lenguaje natural

✓

/loop — sondeo a intervalos durante la sesión activa, cancelable con Ctrl+C

✓

Agentes remotos — se ejecutan sin terminal local, activados por RemoteTrigger

✓

Review diario — patrón completo: cron → recopila commits → análisis → informe → webhook

✓

Idempotencia — el archivo de bloqueo + la verificación antes de actuar evitan ejecuciones duplicadas

🏆 ¡Ruta 4 completa!

Dominaste los 4 pilares de la automatización en Claude Code: subagents para paralelizar, hooks para políticas automáticas, slash commands para estandarizar y cron para que nunca duerma.

Siguiente paso: aplicar todo esto en proyectos reales en la Ruta 5 — Proyectos.

🏗️ Próxima ruta:

Ruta 5 — Proyectos: aplica subagents, hooks y workflows en proyectos reales de principio a fin

← Módulo 4.3 ↩ Ruta 4 🏗️ Ruta 5: Proyectos →