Skip to content

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

Merged
pelikhan merged 2 commits intomainfrom
copilot/fix-agent-persona-recommendations
Mar 23, 2026
Merged

fix(agent-persona-explorer): direct recommendations to .github/aw/*.md, not AGENTS.md#22358
pelikhan merged 2 commits intomainfrom
copilot/fix-agent-persona-recommendations

Conversation

Copy link
Contributor

Copilot AI commented Mar 23, 2026

  • Update Phase 4 Improvement Opportunities section to explicitly state recommendations must target .github/aw/*.md files, not AGENTS.md
  • Update Phase 5 Recommendations template to reinforce that AGENTS.md must not be referenced
  • Recompile the workflow — 0 errors, 0 warnings

📍 Connect Copilot coding agent with Jira, Azure Boards or Linear to delegate work to Copilot in one click without leaving your project management tool.

…d, not AGENTS.md

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Agent-Logs-Url: https://github.com/github/gh-aw/sessions/5f49e149-c0e7-4831-b796-174a4acdca82
Copilot AI changed the title [WIP] Fix agent-persona-explorer recommendations target fix(agent-persona-explorer): direct recommendations to .github/aw/*.md, not AGENTS.md Mar 23, 2026
Copilot AI requested a review from pelikhan March 23, 2026 02:27
@pelikhan pelikhan marked this pull request as ready for review March 23, 2026 02:35
Copilot AI review requested due to automatic review settings March 23, 2026 02:35
@pelikhan pelikhan merged commit afe6177 into main Mar 23, 2026
@pelikhan pelikhan deleted the copilot/fix-agent-persona-recommendations branch March 23, 2026 02:36
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the Agent Persona Explorer workflow instructions to ensure any documentation-focused recommendations are directed to .github/aw/*.md files and explicitly not to AGENTS.md.

Changes:

  • Clarifies in Phase 4 “Improvement Opportunities” that documentation recommendations must target .github/aw/*.md, not AGENTS.md.
  • Reinforces the same constraint in the Phase 5 “Recommendations” template.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

### Improvement Opportunities (top 3 only)
- What additional guidance could help the agent?
- Should certain patterns be more strongly recommended?
- **Important**: Any documentation recommendations must target `.github/aw/*.md` files (e.g., `github-agentic-workflows.md`, `create-agentic-workflow.md`). Do **not** reference or suggest changes to `AGENTS.md` — that file is Go developer documentation for the `gh-aw` codebase and is unrelated to agentic workflow instructions.
Copy link

Copilot AI Mar 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The examples list only filenames (github-agentic-workflows.md, create-agentic-workflow.md) even though the guidance is to target .github/aw/*.md. To remove ambiguity (and prevent readers from searching in the repo root), consider making the examples full paths like .github/aw/github-agentic-workflows.md and .github/aw/create-agentic-workflow.md.

Suggested change
- **Important**: Any documentation recommendations must target `.github/aw/*.md` files (e.g., `github-agentic-workflows.md`, `create-agentic-workflow.md`). Do **not** reference or suggest changes to `AGENTS.md` — that file is Go developer documentation for the `gh-aw` codebase and is unrelated to agentic workflow instructions.
- **Important**: Any documentation recommendations must target `.github/aw/*.md` files (e.g., `.github/aw/github-agentic-workflows.md`, `.github/aw/create-agentic-workflow.md`). Do **not** reference or suggest changes to `AGENTS.md` — that file is Go developer documentation for the `gh-aw` codebase and is unrelated to agentic workflow instructions.

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

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

3 participants