BMAD v6 Agent Handover Broken in GitHub Copilot UI Due to Agent Directory Placement

[gurjotsingh1991]

Describe the bug
When installing BMAD v6 for use with GitHub Copilot (UI-based chat, not CLI), agent definitions are generated under:

.github/agents/

Instead of

.github/chatmodes/

This breaks agent handover / switching behavior in the GitHub Copilot UI, which worked correctly in BMAD v4.

Environment:

• BMAD Version: v6
• AI Tool: GitHub Copilot (Chat UI in VS Code / IDE)
• Interaction Mode: UI-based chat (not CLI, not message-based)

Expected Behavior (BMAD V4 - working)

• Agent definitions placed under:

.github/chatmodes/

• Users can switch agents cleanly via UI prompts such as:

*analyst
*dev
*qa

• Agent context handover works seamlessly without manual intervention

Actual Behavior (BMAD V6)

• Agent definitions are generated under:

.github/agents/

• GitHub Copilot UI does recognize agents from this directory (check)
• But Agent switching via UI (e.g. *analyst or wildcard agent selection) fails or behaves inconsistently
• Users must manually restate agent context, defeating BMAD’s structured multi-agent workflow

Root Cause

• GitHub Copilot’s UI agent-switching mechanism appears to only recognize agent definitions under .github/chatmodes/, not .github/agents/.
• BMAD v6’s directory structure, while valid for CLI or other AI tools, introduces a compatibility gap with Copilot UI.

Screenshots or links
Attached

[Sjoerd-Bo3]

Sorry but, the .agents folder is the correct place for copilot's agents:

Chatmodes is vscodes / GH Copilots old naming for 'agents' https://www.reddit.com/r/GithubCopilot/comments/1onrioo/difference_between_the_chatmodes_and_agents/
Also see: https://dev.to/anchildress1/github-copilot-chat-modes-from-chaos-to-command-54k0

What you can do now is make prompts /init-workflow to initiate and agent and command together like I have done here: #1205

[bmadcode]

Closing as this relates to BMad Method v4 which is deprecated. Please open a new issue if this still applies to v6.

[bmadcode]

Reopening - this was incorrectly marked as v4-related. The title explicitly states BMAD v6, so this is still valid.

[bmadcode]

Consolidated into #1482 which covers all GitHub Copilot integration issues. Your report about agent handover being broken due to directory placement has been preserved.