diff --git a/workflows/index.mdx b/workflows/index.mdx index 5ead465d7..076d218b9 100644 --- a/workflows/index.mdx +++ b/workflows/index.mdx @@ -24,9 +24,13 @@ Use workflows that run on push events to automate reactive maintenance tasks, li Workflows support two trigger types. - **Schedule (cron)** — Run on a recurring daily, weekly, or monthly schedule. Workflows queue within 10 minutes of the scheduled time. -- **Push events** — Run when changes push to a specific repository or branch, including pull request merges and direct pushes. +- **Push events** — Run when changes land on the watched branch of a trigger repository, either through a pull request merge or a direct push to the default branch. The agent receives the merged or pushed commit as context for the run. -You cannot combine trigger types in a single workflow. Each workflow has exactly one trigger. +You cannot combine trigger types in a single workflow. Each workflow has exactly one trigger. + + + When a push event triggers a workflow, the agent runs once per change. If the same commit lands on the default branch through both a pull request merge and a direct push, the workflow only runs once. + ## Usage limits