[q] fix(agent-persona-explorer): direct recommendations to .github/aw/*.md, not AGENTS.md

[github-actions]

Issue

The agent-persona-explorer workflow was generating recommendations that referenced AGENTS.md (e.g., "Document the pre-processing bash step pattern — Add to AGENTS.md or a skill") in its published discussion output.

AGENTS.md is the Go developer documentation for the gh-aw codebase — it is unrelated to agentic workflow instructions. The correct target for agentic workflow documentation improvements is the .github/aw/*.md files (e.g., github-agentic-workflows.md, create-agentic-workflow.md).

Changes

.github/workflows/agent-persona-explorer.md

• Added explicit guidance in Phase 4 (Improvement Opportunities) that recommendations must target .github/aw/*.md files
• Added a note in the Phase 5 Recommendations template template reinforcing that AGENTS.md must not be referenced

Validation

• ✅ agent-persona-explorer compiled successfully (no errors, no warnings)
• ✅ Lock file regenerated

Evidence

Triggered by @pelikhan comment on discussion #22354 (Agent Persona Exploration - 2026-03-23):

"/q the agent persona is meant to update the files in .github/aw/*.md. it is NOT meant to use or consider the AGENTS.md in this project."

---

Warning

🛡️ Protected Files — Push Permission Denied

This was originally intended as a pull request, but the patch modifies protected files: .github/workflows/agent-persona-explorer.md.

The push was rejected because GitHub Actions does not have workflows permission to push these changes, and is never allowed to make such changes, or other authorization being used does not have this permission. A human must create the pull request manually.

📋 Create the pull request manually

# Download the patch from the workflow run
gh run download 23418098889 -n agent -D /tmp/agent-23418098889

# Create a new branch
git checkout -b q/agent-persona-no-agents-md-6374f9c4debb3888 main

# Apply the patch (--3way handles cross-repo patches)
git am --3way /tmp/agent-23418098889/aw-q-agent-persona-no-agents-md.patch

# Push the branch and create the pull request
git push origin q/agent-persona-no-agents-md-6374f9c4debb3888
gh pr create --title '[q] fix(agent-persona-explorer): direct recommendations to .github/aw/*.md, not AGENTS.md' --base main --head q/agent-persona-no-agents-md-6374f9c4debb3888 --repo github/gh-aw

🎩 Equipped by Q · ◷

• expires on Mar 25, 2026, 2:02 AM UTC