schedule (cron) en GitHub Actions: UTC, no cada minuto

on.schedule no es el botón Run. Es un cron UTC. 0 9 * * * son las 09:00 UTC, no las 9 de Guatemala (−6).

GitHub documenta que los schedules pueden retrasarse y que un repo inactivo deja de dispararlos. No es un SLA.

No sustituye workflow_dispatch (a demanda). El curso instalar un agente no cubre cron. gh pr no programa jobs.

Receta

on:
  schedule:
    - cron: "0 */6 * * *"
  workflow_dispatch: {}

Pon también workflow_dispatch para probar sin esperar 6 h.

Mínimo razonable: cada hora o más. */5 * * * * en un job de 8 min se pisa. Combina con concurrency si hace falta.

Qué no hacer

• * * * * *. GitHub lo limita; igual es abuso.
• Cron “a las 21 GT” escrito como 0 21 * * * (eso es 21 UTC).
• Un schedule que deploys a prod sin Environment.

Si el workflow está en una rama que no es default, el schedule no corre (solo default branch).

Receta AGENTS.md

schedule cron is UTC. Never * * * * *.
Always add workflow_dispatch next to schedule for manual test.
Default-branch only. Do not schedule production deploys without Environment.

FAQ

¿60 días? GitHub desactiva schedules en repos sin actividad. Un push reactiva.

¿Varios crons? Lista bajo schedule:. No copies el workflow.

¿TZ en el job? TZ=America/Guatemala date en el step, el trigger sigue UTC.

Verificado 2026-09-03 contra GitHub Docs events schedule (cron UTC, default branch, delays).