Skip to content

Commit f8ec8c0

Browse files
docs: fix template-markers.md — triggers.pipeline → on.pipeline, agentic_depends_on accuracy (#561)
- {{ pipeline_resources }}: fix stale references to 'triggers.pipeline' field name; the unified trigger syntax uses 'on.pipeline' under the 'on:' key. - {{ agentic_depends_on }}: expand the description to accurately reflect that this marker also fires for PR/pipeline runtime filters (not just setup steps), and that it emits both 'dependsOn: Setup' and a 'condition:' expression when gate steps are present. Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 7ddaefc commit f8ec8c0

1 file changed

Lines changed: 10 additions & 4 deletions

File tree

docs/template-markers.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -198,9 +198,15 @@ If `post-steps` is empty, this is replaced with an empty string.
198198

199199
## {{ agentic_depends_on }}
200200

201-
Generates a `dependsOn: Setup` clause for `Agent` if a setup job is configured. The setup job is identified by the job name `Setup`, ensuring the agentic task waits for the setup job to complete.
201+
Generates job dependency and condition configuration for the `Agent` job. This marker is populated whenever any of the following are true:
202202

203-
If no setup job is configured, this is replaced with an empty string.
203+
- A **setup job** is configured (`setup:` steps are present)
204+
- **PR runtime filters** are configured (`on.pr.filters`)
205+
- **Pipeline runtime filters** are configured (`on.pipeline.filters`)
206+
207+
When a setup job or gate step is needed, this emits `dependsOn: Setup`. When PR or pipeline filter conditions are also present, it additionally emits a `condition:` expression that gates the Agent job on the gate evaluator's output from the Setup job (e.g. `dependencies.Setup.outputs['prGate.SHOULD_RUN'] == 'true'`).
208+
209+
If none of these are configured, this is replaced with an empty string.
204210

205211
## {{ job_timeout }}
206212

@@ -288,9 +294,9 @@ Generates CI trigger configuration. When a schedule or pipeline trigger is confi
288294

289295
## {{ pipeline_resources }}
290296

291-
Generates pipeline resource YAML when `triggers.pipeline` is configured in the front matter. Creates a pipeline resource with appropriate trigger configuration based on the specified branches. If no branches are specified, the pipeline triggers on any branch.
297+
Generates pipeline resource YAML when `on.pipeline` is configured in the front matter. Creates a pipeline resource with appropriate trigger configuration based on the specified branches. If no branches are specified, the pipeline triggers on any branch.
292298

293-
Example output when `triggers.pipeline` is configured:
299+
Example output when `on.pipeline` is configured:
294300
```yaml
295301
resources:
296302
pipelines:

0 commit comments

Comments
 (0)