Description
The Copilot Agent Analysis (discussion #29090) reported that open PR #29060 identified a documentation gap: workflow_run is mentioned 4 times in create-agentic-workflow.md but has no complete working example, leaving users unable to set up chained workflows from documentation alone.
Additionally, the Lockfile Statistics report (discussion #29010) confirms workflow_run is used by only 1 of 204 workflows (0.5%), suggesting it's underutilized partly because the setup is undocumented.
Expected Fix
Add a complete workflow_run trigger example to docs/create-agentic-workflow.md:
- Example frontmatter showing
workflow_run as a trigger with workflows and types filters
- A brief explanation of when to use it (chaining workflows, post-merge validation, etc.)
- Note about access permissions (the triggered workflow runs in the context of the base branch)
PR #29060 may already contain a draft — review and merge or expand as needed.
Expected Impact
Unlocks the workflow_run trigger pattern for users; reduces setup friction for chained agentic workflows.
Suggested Agent
Copilot documentation agent — pure documentation task.
Estimated Effort
Fast (< 30 min)
Data Source
DeepReport Intelligence Briefing — 2026-04-29 · Copilot Agent Analysis #29090 · Lockfile Stats #29010 · Run §25117657405
Generated by DeepReport - Intelligence Gathering Agent · ● 654.3K · ◷
Description
The Copilot Agent Analysis (discussion #29090) reported that open PR #29060 identified a documentation gap:
workflow_runis mentioned 4 times increate-agentic-workflow.mdbut has no complete working example, leaving users unable to set up chained workflows from documentation alone.Additionally, the Lockfile Statistics report (discussion #29010) confirms
workflow_runis used by only 1 of 204 workflows (0.5%), suggesting it's underutilized partly because the setup is undocumented.Expected Fix
Add a complete
workflow_runtrigger example todocs/create-agentic-workflow.md:workflow_runas a trigger withworkflowsandtypesfiltersPR #29060 may already contain a draft — review and merge or expand as needed.
Expected Impact
Unlocks the
workflow_runtrigger pattern for users; reduces setup friction for chained agentic workflows.Suggested Agent
Copilot documentation agent — pure documentation task.
Estimated Effort
Fast (< 30 min)
Data Source
DeepReport Intelligence Briefing — 2026-04-29 · Copilot Agent Analysis #29090 · Lockfile Stats #29010 · Run §25117657405