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

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.

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.