Skip to content

fix(installer): remove bmad-help from Copilot Custom Agents picker#2359

Merged
bmadcode merged 2 commits intobmad-code-org:mainfrom
jheyworth:fix/remove-bmad-help-from-copilot-agents
Apr 30, 2026
Merged

fix(installer): remove bmad-help from Copilot Custom Agents picker#2359
bmadcode merged 2 commits intobmad-code-org:mainfrom
jheyworth:fix/remove-bmad-help-from-copilot-agents

Conversation

@jheyworth
Copy link
Copy Markdown
Contributor

@jheyworth jheyworth commented Apr 30, 2026

Problem statement

PR #2324 added bmad-help to the GitHub Copilot Custom Agents picker. On reflection this was a mistake — bmad-help is not a true agent (it's the meta-help skill that every persona agent already advertises on activation), so its picker entry is redundant and confusing.

Proposed solution

This PR removes bmad-help from the GitHub Copilot Custom Agents picker.

Files changed

  • tools/installer/ide/_config-driven.js — installer code that controls which skills appear in the picker
  • test/test-installation-components.js — flips the bmad-help assertion from inclusion to exclusion

Tests

npm run lint, npm run format:check, npm run test:install all pass locally.

Refs #2324

Per @bmadcode's feedback after bmad-code-org#2324 merged: every persona agent's
activation message already advertises bmad-help, so its picker entry is
redundant AND confusing (looks like a peer agent when it's actually the
meta-help). Removes the ALWAYS_AGENT_IDS allowlist exception that put it
there.

The toml-driven filter (the mechanism BMadCode endorsed in his PR review)
remains the sole signal: a skill is a persona iff its source
customize.toml has an [agent] section. bmad-help has no customize.toml,
so under the cleaned-up filter it's correctly excluded.

Tests: replaces the inclusion assertion in Suite 17 with an exclusion
assertion. Suite still covers persona / non-conventional persona /
workflow / meta-skill-with-`-agent-`-in-name cases.

Refs bmad-code-org#2324

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@augmentcode
Copy link
Copy Markdown

augmentcode Bot commented Apr 30, 2026

🤖 Augment PR Summary

Summary: This PR removes the special-case allowlist that forced bmad-help to appear in GitHub Copilot’s Custom Agents picker.

Changes:

  • Deleted ALWAYS_AGENT_IDS and the corresponding inclusion check in isAgentSkill, making [agent] in customize.toml the only signal for picker inclusion.
  • Updated Suite 17’s fixture and assertions to expect bmad-help to be excluded when it has no customize.toml.
  • Adjusted inline documentation/comments in both the installer logic and the test to reflect the toml-driven filtering.

Technical Notes: Copilot picker entries are now strictly derived from the presence of an [agent] section in each skill’s source customize.toml.

🤖 Was this summary useful? React with 👍 or 👎

Copy link
Copy Markdown

@augmentcode augmentcode Bot left a comment

Choose a reason for hiding this comment

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

Review completed. 1 suggestion posted.

Fix All in Augment

Comment augment review to trigger a new review at any time.

Comment thread test/test-installation-components.js Outdated
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 30, 2026

📝 Walkthrough

Walkthrough

This PR removes special-case handling for the bmad-help skill from agent skill detection logic and updates corresponding test expectations to rely on toml-driven filtering instead of a hardcoded exception list.

Changes

Cohort / File(s) Summary
Agent Detection Logic
tools/installer/ide/_config-driven.js
Removed ALWAYS_AGENT_IDS set and early-return check from isAgentSkill() so that agent skill detection is now based solely on whether the skill's customize.toml contains an [agent] section.
Test Updates
test/test-installation-components.js
Updated fixture metadata and assertions to expect bmad-help to be excluded from .github/agents/ via toml-driven filtering rather than included via the removed ALWAYS_AGENT_IDS exception list; updated inline comments to reflect the new behavior.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

  • PR #1932 — Modifies installer agent-detection logic and test expectations in the same files (_config-driven.js and test-installation-components.js).

Suggested reviewers

  • bmadcode
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and specifically describes the primary change: removing bmad-help from the Copilot Custom Agents picker, which aligns with the main objective of the PR.
Docstring Coverage ✅ Passed Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description check ✅ Passed The pull request description clearly relates to the changeset, explaining the removal of bmad-help from the Copilot picker and referencing the specific files modified.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

The fixture creates no customize.toml at all for bmad-help, so the
exclusion path being exercised is the missing-file branch — not the
file-without-[agent]-section branch. Reword the comment accordingly.

Per @augmentcode review on bmad-code-org#2359.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@bmadcode bmadcode merged commit 9debc16 into bmad-code-org:main Apr 30, 2026
5 checks passed
@jheyworth jheyworth deleted the fix/remove-bmad-help-from-copilot-agents branch April 30, 2026 14:17
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.

2 participants