Un archivo de Dag es un módulo de Python en la carpeta dags/. El procesador de Dags de Airflow ejecuta el archivo y guarda cada Dag que crea. Hay dos formas de escribirlo, y las dos aparecen en proyectos reales.
with DAG(dag_id=..., schedule=..., start_date=...): abre un bloque, y cada operador creado dentro pertenece a ese Dag. El decorador @dag convierte en cambio una función en una fábrica de Dags: el Dag solo existe cuando llamas a la función al final del archivo. Olvidar esa llamada es la razón más habitual de que un Dag nuevo no aparezca.
Airflow 3 importa los dos desde el Task SDK: from airflow.sdk import DAG, dag, task. La programación va en schedule (el antiguo argumento schedule_interval ya no existe en Airflow 3). Usa una start_date fija en el pasado, creada con pendulum.datetime(2026, 11, 1, tz="UTC"), nunca datetime.now(). El dag_id puede llevar letras, números, guiones, puntos y guiones bajos.
El Dag útil más pequeño: dos tareas de marcador en orden. La sangría decide a qué Dag pertenecen.