Skip to content

[deep-report] Add complete workflow_run trigger example to create-agentic-workflow.md #29146

@github-actions

Description

@github-actions

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:

  1. Example frontmatter showing workflow_run as a trigger with workflows and types filters
  2. A brief explanation of when to use it (chaining workflows, post-merge validation, etc.)
  3. 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 ·

  • expires on May 1, 2026, 3:37 PM UTC

Metadata

Metadata

Assignees

No one assigned

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions