Strengthen persona-driven workflow guidance for recurring reports and compliance audits by Copilot · Pull Request #43412 · github/gh-aw

Copilot · 2026-07-04T16:16:02Z

Persona exploration found strong trigger/tool/security choices, but recurring report lifecycle guidance and compliance cadence specifics were inconsistent. This PR tightens those gaps with compact, prescriptive additions in the authoring docs.

Recurring report lifecycle defaults (.github/aw/create-agentic-workflow.md)
- Added a compact checklist for report workflows:
  - close-older-issues default behavior
  - explicit report window requirement
  - required grouping dimensions
  - stable dedup key + duplicate search before issue creation
Concrete compliance-audit drift scenario (.github/aw/triggers.md)
- Added a material-drift example with:
  - preferred cadence (schedule: daily on weekdays + workflow_dispatch)
  - explicit drift definition (control-state changes affecting posture)
  - stable drift key pattern and issue lifecycle behavior
  - noop requirement when no drift exists in-window
Non-technical persona coverage (.github/aw/github-agentic-workflows.md)
- Added a Program Management / stakeholder digest example that standardizes:
  - trigger pairing for recurring + manual runs
  - default output route (create-issue)
  - required window/grouping/dedup fields
  - recurring issue lifecycle (close-older-issues) and empty-window noop

- [ ] enable `close-older-issues: true` for issue-based recurring reports
- [ ] define one explicit report window
- [ ] define grouping dimensions that match audience decisions
- [ ] derive one stable dedup key per scope and window

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

github-actions · 2026-07-04T18:46:55Z

🤖 PR Triage — Run §28715668077

Field	Value
Category	`docs`
Risk	🟢 Low
Score	32/100
Impact	16/50
Urgency	10/30
Quality	6/20
Action	`defer`

Strengthens persona-driven workflow guidance. +22/-0 markdown in .github/aw/. Low urgency docs update. Defer until sprint.

Generated by 🔧 PR Triage Agent · 113.5 AIC · ⌖ 13 AIC · ⊞ 5.5K · ◷

Copilot

Pull request overview

This PR updates the gh-aw authoring guidance to be more prescriptive for recurring reports/digests and compliance-audit “drift” workflows (windows, grouping, dedup keys, lifecycle defaults), and also re-syncs the embedded action pin JSON copies.

Changes:

Adds a compact recurring-report lifecycle checklist (window, grouping, dedup key, close-older-issues) to the workflow authoring doc.
Adds a concrete “material drift” compliance-audit scenario and a PM/stakeholder digest example, emphasizing windows/grouping/dedup + empty-window noop.
Re-syncs/reformats embedded action_pins.json data under pkg/ (format-only / source parity).

Show a summary per file

File	Description
`pkg/workflow/data/action_pins.json`	Re-synced embedded action/container pin data formatting to match the `.github/aw/actions-lock.json` source.
`pkg/actionpins/data/action_pins.json`	Same embedded pin data re-sync for the actionpins package copy.
`.github/aw/triggers.md`	Adds a compliance-audit “material drift” example and related lifecycle/dedup/noop guidance.
`.github/aw/github-agentic-workflows.md`	Adds a non-technical (PM) persona digest example with trigger/output/window/grouping/dedup defaults.
`.github/aw/create-agentic-workflow.md`	Adds a compact recurring-report lifecycle checklist for authoring workflows.

Review details

Tip

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

Files reviewed: 3/5 changed files
Comments generated: 3
Review effort level: Low

  - reuse a stable deduplication key for the same scope and window
  - call `noop` when there are no updates in that window
+- **Compliance audit (material drift example)**:
+  - trigger `schedule: daily on weekdays` as the preferred baseline cadence, and add `workflow_dispatch` for ad hoc reruns


+
+When the request is framed as a PM or stakeholder workflow (for example "weekly product health digest"):
+
+- prefer `schedule: weekly` (or `daily on weekdays` for operational digests) plus `workflow_dispatch` for preview/backfill runs


 {
-  "entries": {
-    "actions-ecosystem/action-add-labels@v1.1.3": {
-      "repo": "actions-ecosystem/action-add-labels",
-      "version": "v1.1.3",
-      "sha": "c96b68fec76a0987cd93957189e9abd0b9a72ff1",
-      "inputs": {
-        "github_token": {
-          "description": "A GitHub token.",
-          "default": "${{ github.token }}"
-        },
-        "labels": {
-          "description": "The labels' name to be added. Must be separated with line breaks if there're multiple labels.",
-          "required": true
-        },
-        "number": {
-          "description": "The number of the issue or pull request."
-        },
-        "repo": {
-          "description": "The owner and repository name. e.g.) Codertocat/Hello-World",
-          "default": "${{ github.repository }}"
+    "entries": {
+        "actions-ecosystem/action-add-labels@v1.1.3": {
+            "repo": "actions-ecosystem/action-add-labels",
+            "version": "v1.1.3",


github-actions · 2026-07-07T10:08:18Z

🎉 This pull request is included in a new release.

Release: v0.82.3

Initial plan

937bc54

Copilot AI assigned Copilot and pelikhan Jul 4, 2026

Copilot started work on behalf of pelikhan July 4, 2026 16:43 View session

Copilot AI linked an issue Jul 4, 2026 that may be closed by this pull request

Agent Persona Exploration - 2026-07-04 #43401

Closed

Copilot AI and others added 2 commits July 4, 2026 16:50

Plan updates for persona exploration guidance

fdad0b3

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Add persona-focused workflow authoring guidance

d9a339a

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Explore agent persona findings and recommendations~~ Strengthen persona-driven workflow guidance for recurring reports and compliance audits Jul 4, 2026

Copilot finished work on behalf of pelikhan July 4, 2026 16:53

Copilot AI requested a review from pelikhan July 4, 2026 16:53

github-actions Bot added pr-action:defer pr-agent:copilot-swe-agent pr-priority:low pr-risk:low pr-type:docs labels Jul 4, 2026

This was referenced Jul 4, 2026

[PR Triage Report] 🤖 PR Triage Report — 2026-07-04 (Run §28715668077) #43427

Closed

[PR Triage Report] PR Triage Report — 2026-07-05 (Run §28725134784) #43445

Closed

pelikhan marked this pull request as ready for review July 5, 2026 03:15

Copilot AI review requested due to automatic review settings July 5, 2026 03:15

pelikhan merged commit 764d869 into main Jul 5, 2026
1 check passed

pelikhan deleted the copilot/agent-persona-exploration-again branch July 5, 2026 03:15

Copilot started reviewing on behalf of pelikhan July 5, 2026 03:15 View session

Copilot AI reviewed Jul 5, 2026

View reviewed changes

github-actions Bot mentioned this pull request Jul 5, 2026

[PR Triage Report] PR Triage Report — Run #7 (2026-07-05) #43502

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Strengthen persona-driven workflow guidance for recurring reports and compliance audits#43412

Strengthen persona-driven workflow guidance for recurring reports and compliance audits#43412
pelikhan merged 3 commits into
mainfrom
copilot/agent-persona-exploration-again

Copilot AI commented Jul 4, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jul 4, 2026

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

github-actions Bot commented Jul 7, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants


		When the request is framed as a PM or stakeholder workflow (for example "weekly product health digest"):

		- prefer `schedule: weekly` (or `daily on weekdays` for operational digests) plus `workflow_dispatch` for preview/backfill runs

Uh oh!

Conversation

Copilot AI commented Jul 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Jul 4, 2026

🤖 PR Triage — Run §28715668077

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Review details

Uh oh!

github-actions Bot commented Jul 7, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented Jul 4, 2026 •

edited

Loading