🛠️ Update various documentation, scripts, and configuration templates to enhance clarity, functionality, and maintainability across the project

resources/prompts/prepare-audit-promotions.prompt.md

@@ -0,0 +1,16 @@
+---
+name: "prepare-audit-promotions"
+description: "Generate draft resources or staging notes from approved audit manifest rows."
+agent: "agent"
+tools: [read, search, execute]
+argument-hint: "audit=<optional audit directory>"
+---
+
+Generate promotion drafts from the audit approval surface by using the shared repository script.
+
+Requirements:
+
+- Prefer `resources/scripts/prepare-audit-promotions.sh` over manual translation.
+- Treat `promote-*`, `template-only`, and `docs-only` rows as approved when their `decision` column is non-empty.
+- Treat `discard`, `needs-sanitization`, and empty decisions as non-approved.
+- Review `promotion-summary.md` after the script runs and summarize the generated draft resources and staging notes.