[product-manager-impersonator] Workflow scaffold generator for maintainers

[github-actions]

Feature Idea

Summary: Add a lightweight new-workflow scaffold command that generates the canonical source, example trigger, and README files for a new gh-agent-workflows workflow slug.

Why a Customer Would Want This

Maintainers extending this project currently create new workflows through several manual, convention-heavy steps across multiple directories. A scaffold command would reduce authoring mistakes, make contributions faster, and keep workflow packaging consistent as the catalog grows.

Rough Implementation Sketch

• Add scripts/new-gh-agent-workflow.sh <slug> [--detector|--fixer|--event] to generate:
  • .github/workflows/gh-aw-<slug>.md
  • gh-agent-workflows/<slug>/example.yml
  • gh-agent-workflows/<slug>/README.md
• Include baseline workflow_call wiring and common inputs (additional-instructions, setup-commands) in the generated .md file, matching existing conventions.
• Add a Make target like make new-workflow SLUG=<slug> as a wrapper and checklist output (make compile, docs update).
• Document the scaffold flow in gh-agent-workflows/DEVELOPING.md under “Adding a new workflow”.

Why It Won't Be That Hard

This is additive and localized to scripting/docs. The repository already has strict, repeatable file conventions and helper scripts for syncing workflow artifacts; the scaffold can reuse those conventions without touching runtime behavior.

Evidence

• gh-agent-workflows/DEVELOPING.md#L156-L163 defines a fully manual multi-file workflow creation process.
• gh-agent-workflows/DEVELOPING.md#L145-L150 requires manual source/compiled artifact coordination.
• scripts/dogfood.sh#L53-L75 assumes standardized gh-agent-workflows/<slug>/example.yml structure when generating trigger-*.yml files.
• Makefile#L50-L67 and Makefile#L167-L183 provide setup/sync/compile targets but no workflow scaffolding command.

Duplicate Check Notes

• Closest related open idea appears to be [product-manager-impersonator] Add workflow artifact parity lint #730 ([product-manager-impersonator] Add workflow artifact parity lint), which validates existing artifacts.
• This proposal is different: it prevents authoring drift up front by generating the canonical files at creation time.

Note

🔒 Integrity filter blocked 22 items

The following items were blocked because they don't meet the GitHub integrity level.

• #1175 list_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #359 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #1175 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #1128 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #505 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #476 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #428 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #1067 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #875 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #704 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #694 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #684 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #354 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #336 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #321 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #140 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• ... and 6 more items

To allow these resources, lower min-integrity in your GitHub frontmatter:

tools:
  github:
    min-integrity: approved  # merged | approved | unapproved | none

---

What is this? | From workflow: Trigger Product Manager Impersonator

Give us feedback! React with 🚀 if perfect, 👍 if helpful, 👎 if not.