Skip to content

chore(install): stop copying skill prompts to _bmad by default#2182

Open
alexeyv wants to merge 3 commits intomainfrom
chore/stop-copying-prompts-to-bmad
Open

chore(install): stop copying skill prompts to _bmad by default#2182
alexeyv wants to merge 3 commits intomainfrom
chore/stop-copying-prompts-to-bmad

Conversation

@alexeyv
Copy link
Copy Markdown
Collaborator

@alexeyv alexeyv commented Apr 1, 2026

Summary

  • Flips install_to_bmad default from true to false so skill directories are cleaned from _bmad/ after IDE install — skills are self-contained in their IDE directories and no longer need duplicate copies
  • Fixes 5 broken cross-skill file references in bmad-edit-prd (bmm-skills/bmm/)
  • Adds explicit install_to_bmad: true opt-in manifests for bmad-create-prd and bmad-validate-prd (cross-referenced by bmad-edit-prd)
  • Corrects file-ref validator module-to-source path mapping (_bmad/bmm/src/bmm-skills/)

Test plan

  • npm run quality passes (204 tests, 0 broken refs, lint clean)
  • test/test-install-to-bmad.js contract tests updated and passing (10/10)
  • Run installer on a test project and verify _bmad/ no longer contains skill directories (except opted-in ones)
  • Verify bmad-edit-prd skill can resolve prd-purpose.md at runtime

🤖 Generated with Claude Code

@augmentcode
Copy link
Copy Markdown

augmentcode bot commented Apr 1, 2026

🤖 Augment PR Summary

Summary: This PR changes IDE installation so skills are no longer kept in _bmad/ by default, treating IDE skill folders as the source of truth.

Changes:

  • Flips install_to_bmad default behavior to false and updates the installer manifest logic accordingly
  • Updates contract tests covering getInstallToBmad() defaults and multi-entry behavior
  • Fixes cross-skill file references in bmad-edit-prd to use _bmad/bmm/… paths
  • Adds per-skill opt-in manifests intended to keep bmad-create-prd and bmad-validate-prd in _bmad/
  • Adjusts file-ref validation mapping for installed module names (core/bmm) back to their source directories

🤖 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.

@@ -0,0 +1,3 @@
# Cross-referenced by bmad-edit-prd for prd-purpose.md and data files.
# Must remain in _bmad/ until those references are refactored.
install_to_bmad: true
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

This manifest only sets install_to_bmad, but loadSkillManifest() treats a top-level manifest as single-entry only when canonicalId or type is present; as-is it will be parsed as multi-entry and getInstallToBmad() will return false for all files. That would allow this skill (and bmad-validate-prd) to be cleaned from _bmad/, breaking the cross-skill _bmad/bmm/... refs in bmad-edit-prd.

Severity: high

Other Locations
  • src/bmm-skills/2-plan-workflows/bmad-validate-prd/bmad-skill-manifest.yaml:3

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.

@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Apr 1, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 0765af7e-98b0-4a96-bae9-6c3cf2099e75

📥 Commits

Reviewing files that changed from the base of the PR and between 2ea917e and ff5ab0d.

📒 Files selected for processing (10)
  • src/bmm-skills/2-plan-workflows/bmad-create-prd/bmad-skill-manifest.yaml
  • src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md
  • src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md
  • src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md
  • src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md
  • src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md
  • src/bmm-skills/2-plan-workflows/bmad-validate-prd/bmad-skill-manifest.yaml
  • test/test-install-to-bmad.js
  • tools/installer/ide/shared/skill-manifest.js
  • tools/validate-file-refs.js

📝 Walkthrough

Walkthrough

This PR reorganizes the skill directory structure from bmm-skills to bmm format, adds install_to_bmad: true configuration to skill manifests, and inverts the default behavior of getInstallToBmad() to return false instead of true when install_to_bmad is unspecified or missing.

Changes

Cohort / File(s) Summary
Skill Manifest Configuration
src/bmm-skills/2-plan-workflows/bmad-create-prd/bmad-skill-manifest.yaml, src/bmm-skills/2-plan-workflows/bmad-validate-prd/bmad-skill-manifest.yaml
Added install_to_bmad: true entries with cross-reference comments indicating these manifests must remain under _bmad/ directory and are referenced by related workflow steps.
Step File Path Updates
src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md, src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md, src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md, src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md, src/bmm-skills/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md
Updated frontmatter path references from {project-root}/_bmad/bmm-skills/... to {project-root}/_bmad/bmm/... format for prdPurpose and validationWorkflow variables.
Core Installer Logic
tools/installer/ide/shared/skill-manifest.js
Changed getInstallToBmad() default behavior from true to false; now returns true only when install_to_bmad === true explicitly, instead of treating missing values as enabled.
Path Mapping & Validation
tools/validate-file-refs.js
Updated mapInstalledToSource() to map installed _bmad/core/ and _bmad/bmm/ paths to src/core-skills/... and src/bmm-skills/... respectively instead of src/core/... and src/bmm/....
Test Updates
test/test-install-to-bmad.js
Inverted test expectations: default case, single-entry manifest without install_to_bmad, and unknown filename queries now expect false instead of true; explicit assertions for true and false values retained.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested reviewers

  • bmadcode
🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 66.67% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The pull request title clearly and concisely summarizes the main change: flipping the install_to_bmad default from true to false to stop copying skill prompts to _bmad by default.
Description check ✅ Passed The pull request description is well-related to the changeset, providing a clear summary of the changes, the rationale, and the test plan for verifying the modifications.

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

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch chore/stop-copying-prompts-to-bmad

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.

@alexeyv alexeyv force-pushed the chore/stop-copying-prompts-to-bmad branch from f03f862 to 47a622a Compare April 1, 2026 21:18
alexeyv added a commit to alexeyv/bmad-method-wds-expansion that referenced this pull request Apr 2, 2026
…dencies

- Duplicate referenced innards into wds-0-project-setup/resources/
  (templates from wds-1, wds-2, wds-4, wds-7 and freya agent guides)
- Duplicate project-brief template into saga agent-guide resources
- Update folder-guide template refs to use local ./resources/ paths
- Change cross-skill invocations to skill:<name> syntax
- Replace dead _bmad/wds/docs/method/ refs with skill invocation hints
- Preserve config.yaml refs (module-level, handled by installer)

Supports bmad-code-org/BMAD-METHOD#2182 which stops copying
skill content into _bmad/ at install time.
bmadcode pushed a commit to bmad-code-org/bmad-method-wds-expansion that referenced this pull request Apr 2, 2026
* fix: make all skills self-contained by removing _bmad/wds/ path dependencies

- Duplicate referenced innards into wds-0-project-setup/resources/
  (templates from wds-1, wds-2, wds-4, wds-7 and freya agent guides)
- Duplicate project-brief template into saga agent-guide resources
- Update folder-guide template refs to use local ./resources/ paths
- Change cross-skill invocations to skill:<name> syntax
- Replace dead _bmad/wds/docs/method/ refs with skill invocation hints
- Preserve config.yaml refs (module-level, handled by installer)

Supports bmad-code-org/BMAD-METHOD#2182 which stops copying
skill content into _bmad/ at install time.

* fix: update broken relative paths in duplicated resource files

Fix ../../workflows/ references in copied agent guides that were
valid at their original location but broke after duplication into
wds-0-project-setup/resources/. Replaced with skill:<name> syntax.
alexeyv and others added 3 commits April 2, 2026 07:36
Flip install_to_bmad default from true to false so skill directories
are cleaned from _bmad/ after IDE install. Skills are self-contained
in their IDE directories (.claude/skills/, etc.) and no longer need
duplicate copies in _bmad/.

Two skills (bmad-create-prd, bmad-validate-prd) opt back in via
explicit manifests because bmad-edit-prd cross-references their data
files. Also fixes broken bmm-skills/ path references and corrects
the file-ref validator module-to-source mapping.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…_bmad

Give bmad-edit-prd its own copy of prd-purpose.md and replace the
cross-skill validation workflow reference with a skill invocation, so
all three PRD skills are fully self-contained. With no remaining
consumers, remove the install_to_bmad flag from manifests, CSV output,
the post-install cleanup loop, and the dedicated test file.
Skills are self-contained in IDE directories, so _bmad/ only needs
module-level files (config.yaml, _config/). After all IDE setups
complete, remove skill directories from _bmad/ via skill-manifest.csv.
Also cleans up skill dirs left by older installer versions.
@alexeyv alexeyv force-pushed the chore/stop-copying-prompts-to-bmad branch from 7687d1b to d0bd379 Compare April 2, 2026 14:36
MartenAngner added a commit to whiteport-collective/whiteport-design-studio that referenced this pull request Apr 3, 2026
…ad PR bmad-code-org#23

Remove all _bmad/wds/workflows/ and _bmad/wds/docs/method/ path references
from activation files, folder-guide templates, and skill references. Replace
with skill:<name> syntax following the self-contained pattern from bmad-method-
wds-expansion PR bmad-code-org#23 (BMAD-METHOD bmad-code-org#2182).

config.yaml refs preserved — handled by installer as before.

Files updated: saga.activation.md, freya.activation.md, all folder-guide
templates, alignment-signoff steps, saga/freya reference docs.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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.

1 participant