[product-manager-impersonator] Add --audit preflight mode to quick setup #523

Feature Idea

Summary: Add a read-only --audit mode to scripts/quick-setup.sh that reports repository readiness (installed triggers, maintenance workflow, and required secret presence) before making any changes.

Why a Customer Would Want This

Teams evaluating adoption want a safe preflight view before the script creates branches, writes files, and opens a PR. A readiness report reduces setup risk, shortens onboarding, and makes it easier for platform owners to standardize rollout checks across repositories.

Rough Implementation Sketch

• Add --audit to scripts/quick-setup.sh CLI parsing and help output.
• Reuse existing workflow selection logic to compare expected trigger files against current .github/workflows/trigger-*.yml and agentics-maintenance.yml.
• Check whether COPILOT_GITHUB_TOKEN exists for the target repo and include result in the report.
• Print a concise summary (missing/present items and next actions) and exit without mutating git state.

Why It Won't Be That Hard

This is an additive script enhancement in one file with minimal blast radius: argument parsing and workflow inventory logic already exist, and the feature is read-only (no compile/runtime workflow changes needed).

Evidence

• scripts/quick-setup.sh:23-30 exposes setup flags today, but there is no audit/preflight option.
• scripts/quick-setup.sh:175-215 shows the script flow is currently oriented around fetch/checkout and writing workflow files (or echoing dry-run commands), not repository readiness reporting.
• README.md:30-39 documents that quick setup installs workflows, sets the secret, and opens a PR; it does not provide a “check first” mode.
• docs/workflows/gh-agent-workflows.md:130-155 documents two critical prerequisites (COPILOT_GITHUB_TOKEN and agentics-maintenance.yml) that are ideal audit checks before installation.

What is this? | From workflow: Product Manager Impersonator

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