Refine workflow-creation guidance for workflow_run scoping, scheduled report windows, and visual-regression minimal config

[Copilot]

Persona exploration found strong overall trigger/tool/security alignment, with remaining gaps in scoping specificity—especially workflow_run targeting, reporting date windows, and concrete visual-regression configuration examples.

• workflow_run scoping tightened

  • Added explicit guidance to scope by named upstream workflows, types: [completed], and conclusion-gated execution via if on github.event.workflow_run.conclusion.
  • Updated the scoping checklist to require explicit workflow-name + conclusion gating for incident-triage scenarios.

• Scheduled reporting window made explicit

  • Expanded the stakeholder digest example to require a concrete reporting window (for example, “last 7 full days ending at run start (UTC)”) instead of vague “date window” wording.

• Visual regression example made concrete

  • Clarified the compact scenario to use the minimal toolset (playwright + cache-memory only), minimal network allowlist, add-comment for output, and explicit noop behavior when UI paths are unchanged.

on:
  workflow_run:
    workflows: [CI]
    types: [completed]

if: ${{ contains(fromJson('["failure","timed_out","cancelled","action_required"]'), github.event.workflow_run.conclusion) }}

[Copilot]

Pull request overview

Refines the gh-aw workflow-creation guidance to reduce ambiguity around workflow_run targeting, scheduled reporting windows, and minimal/explicit visual-regression configuration, improving correctness and consistency for commonly generated workflows.

Changes:

• Tightens workflow_run guidance to require explicit upstream workflow scoping, types: [completed], and conclusion gating via if:.
• Makes scheduled report examples specify a concrete reporting window (e.g., last 7 full days ending at run start, UTC).
• Clarifies a minimal visual-regression setup (playwright + cache-memory only), minimal network allowlisting, and explicit noop behavior.

Show a summary per file

File	Description
.github/aw/create-agentic-workflow.md	Updates trigger/scoping checklists and compact examples to be more explicit about workflow_run constraints, reporting windows, and minimal visual-regression configuration.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

• Files reviewed: 1/1 changed files
• Comments generated: 0