Skip to content
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 9 additions & 1 deletion workflows/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,10 +20,18 @@

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.

Check warning on line 23 in workflows/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

workflows/index.mdx#L23

Don't put a space before or after a dash.
- **Push events** — Run when changes push to a specific repository or branch, including pull request merges and direct pushes.

Check warning on line 24 in workflows/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

workflows/index.mdx#L24

Don't put a space before or after a dash.

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.

### How triggers and prompts work together

Triggers control _how often_ a workflow runs. The prompt controls _what the agent does_ once it is running.

- Triggers fire on every qualifying event. Push triggers run on every push to the configured branch, regardless of which files changed. Schedule triggers run on every scheduled occurrence. There is no built-in path filter or pre-flight check that decides whether to skip a run.
- The prompt is where conditional logic belongs. Write instructions that tell the agent to evaluate whether a change is warranted and to take no action if it is not. For example: "Review changes in the linked repository since the last run. If no user-facing behavior changed, do not open a pull request."

Check warning on line 33 in workflows/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

workflows/index.mdx#L33

In general, use active voice instead of passive voice ('is warranted').
- To reduce run frequency, switch to a schedule trigger (daily or weekly) instead of relying on every push. Failed runs do not count against [usage limits](#usage-limits).

## Usage limits

Expand Down
Loading