release: v6.2.0.0

.beads/issues.jsonl

@@ -11,6 +11,7 @@
 {"id":"bmp-2ng","title":"Track Claude Code plugin update bug fix (anthropics/claude-code#28540)","description":"claude plugin update doesn't git pull the marketplace cache before comparing versions, so it reports stale versions as latest. Upstream: https://github.com/anthropics/claude-code/issues/28540 (also #14061, #25244, #25598 as duplicates). Workaround in README Installation section. When fixed upstream, remove the Troubleshooting section from README. Add a weekly CI check (Thursdays) using gh API to see if #28540 is closed: gh issue view 28540 --repo anthropics/claude-code --json state -q .state","status":"open","priority":4,"issue_type":"task","owner":"dev@pablolion.com","created_at":"2026-02-26T04:42:51.330251+01:00","created_by":"Pablo LION","updated_at":"2026-02-26T08:35:42.015987+01:00"}
 {"id":"bmp-2ry","title":"Implement BMAD project settings file (.claude/bmad.local.md)","description":"Create .claude/bmad.local.md with YAML frontmatter for per-project BMAD configuration. Settings from upstream core/module.yaml and bmm/module.yaml:\n\n- user_name: what agents call the user\n- communication_language: chat language\n- document_output_language: doc output language\n- output_folder: base output directory (default: _bmad-output)\n- project_name: project name for artifacts\n- user_skill_level: beginner/intermediate/expert\n- planning_artifacts: where PRDs, briefs, architecture docs go\n- implementation_artifacts: where sprint docs go\n- project_knowledge: where long-term docs go (default: docs/)\n\nFile format: .claude/bmad.local.md with YAML frontmatter (auto-gitignored by Claude Code). Agents read this at activation to know where to write artifacts and how to communicate.\n\nThis is essential for agent-as-service architecture — the settings file is the shared coordination mechanism between independent BMAD agents.","status":"closed","priority":2,"issue_type":"task","owner":"36828324+PabloLION@users.noreply.github.com","created_at":"2026-01-30T19:44:37.660504+01:00","created_by":"Pablo LION","updated_at":"2026-02-09T21:27:58.918297+01:00","closed_at":"2026-02-09T21:27:58.918297+01:00","close_reason":"Closed"}
 {"id":"bmp-2s0","title":"Sync workflow fails: cannot push badge updates to protected main branch","description":"The sync-upstream.yml workflow runs on main and attempts to git push badge JSON updates directly to main. This fails because main is a protected branch (requires PRs).\n\nError: 'GH006: Protected branch update failed for refs/heads/main — Changes must be made through a pull request.'\n\nThe latest failure shows upstream core is at v6.0.0-Beta.8, but the badge commit was rejected. This also explains why the 'Synced with BMAD-METHOD' workflow badge shows a red failure state on the README.\n\nTwo sub-problems:\n1. Workflow cannot push to main — needs to either create a PR, or run on dev instead\n2. Badge URLs in README point to main branch, so they show stale versions until a release merge\n\nOptions to fix:\nA. Change workflow to run on dev, change badge URLs to read from dev\nB. Change workflow to create a PR instead of direct push\nC. Add a GitHub repo rule exception for github-actions[bot] on main","status":"closed","priority":1,"issue_type":"bug","owner":"dev@pablolion.com","created_at":"2026-02-09T23:26:39.068269+01:00","created_by":"Pablo LION","updated_at":"2026-02-26T01:14:49.857132+01:00","closed_at":"2026-02-26T01:14:49.857132+01:00","close_reason":"Fixed: removed badge JSON push steps from sync-upstream.yml, issue creation no longer blocked by protected branch"}
+{"id":"bmp-2so","title":"Sync core special workflows from new src/core/skills/ path","description":"syncCoreExtras in sync-upstream-content.ts hardcodes src/core/workflows/ for advanced-elicitation, party-mode, and brainstorming. Core v6.2.0 moved these to src/core/skills/ with bmad- prefix (bmad-advanced-elicitation, bmad-brainstorming, bmad-party-mode). The sync copies nothing for these skills. Also: new core skills added in v6.2.0 (bmad-distillator, bmad-editorial-review-prose, bmad-editorial-review-structure, bmad-help, bmad-index-docs, bmad-review-adversarial-general, bmad-review-edge-case-hunter, bmad-shard-doc) are not synced at all.","status":"closed","priority":2,"issue_type":"bug","owner":"dev@pablolion.com","created_at":"2026-03-17T18:35:44.038921+01:00","created_by":"Pablo LION","updated_at":"2026-03-17T21:33:16.904218+01:00","closed_at":"2026-03-17T21:33:16.904218+01:00","close_reason":"Fixed in 3e74d52+468f4f3: syncCoreExtras scans src/core/skills/ dynamically, generate:skills skips when upstream provides SKILL.md."}
 {"id":"bmp-30e","title":"Test plugin version format compatibility with Claude Code marketplace","description":"Our version format (6.0.0-Beta.8.1) uses semver pre-release identifiers. Claude Code docs confirm pre-release support but don't specify the exact comparison algorithm. Need to verify: (1) marketplace detects version bumps correctly, (2) update ordering works as expected, (3) capitalized 'Beta' vs lowercase 'beta' doesn't cause issues. Test by installing plugin, bumping version, and checking marketplace behavior.","status":"closed","priority":3,"issue_type":"task","owner":"dev@pablolion.com","created_at":"2026-02-24T12:45:41.972965+01:00","created_by":"Pablo LION","updated_at":"2026-03-07T19:50:33.448583+01:00","closed_at":"2026-03-07T19:50:33.448583+01:00","close_reason":"No longer relevant. Beta format removed. 4-part version (6.0.4.2) works — successfully released v6.0.4.2 via PR #36."}
 {"id":"bmp-333","title":"Add BMB (BMad Builder) module","description":"Repeat TEA integration pattern: add BMB to UPSTREAM_SOURCES, sync content, create SKILL.md files, update plugin.json and agent delegation. Upstream repo: bmad-code-org/bmad-builder","status":"closed","priority":3,"issue_type":"task","owner":"36828324+PabloLION@users.noreply.github.com","created_at":"2026-01-30T04:29:36.556003+01:00","created_by":"Pablo LION","updated_at":"2026-02-06T19:35:51.789382+01:00","closed_at":"2026-02-06T19:35:51.789382+01:00","close_reason":"Completed in PR #10 (feat/module-bmb)","dependencies":[{"issue_id":"bmp-333","depends_on_id":"bmp-h6k","type":"blocks","created_at":"2026-01-30T04:37:06.408888+01:00","created_by":"Pablo LION"}]}
 {"id":"bmp-365","title":"Upstream: agent YAML principles field inconsistency (string vs array)","description":"The agent.customize.template.yaml defines principles as an array (principles: []). The new qa.agent.yaml correctly uses a YAML array. But all older agents (analyst, architect, dev, pm, sm, quick-flow-solo-dev, ux-designer, bmad-master, tech-writer) use principles: | (block scalar string). This inconsistency broke our generate-agents.ts script when qa was added in v6.0.0-Beta.7. Options: (a) PR upstream to normalize all agents to arrays (correct per template), (b) PR upstream to change qa to string (match majority). Recommend (a). Ref: commit 7ecae1d0 introduced qa.agent.yaml.","notes":"Upstream PR: https://github.com/bmad-code-org/BMAD-METHOD/pull/1593","status":"closed","priority":1,"issue_type":"bug","owner":"dev@pablolion.com","created_at":"2026-02-08T15:34:03.714979+01:00","created_by":"Pablo LION","updated_at":"2026-02-08T23:09:44.897541+01:00","closed_at":"2026-02-08T23:09:44.897541+01:00","close_reason":"Replaced by 4 individual watching issues (bmp-8r5, bmp-ps1, bmp-7vo, bmp-63w). Fixes merged locally on branch local/beta7-with-fixes."}
@@ -60,6 +61,7 @@
 {"id":"bmp-p6w","title":"Add upstream dependency badges to README","description":"Show upstream dependency versions in README with one badge per row for clarity. Each row shows module name, tracked version, and upstream repo link. Makes it immediately visible which upstream versions the plugin bundles.","notes":"Needs badge JSON generation for TEA module and sync workflow update. Not a quick fix.","status":"closed","priority":2,"issue_type":"task","owner":"36828324+PabloLION@users.noreply.github.com","created_at":"2026-01-30T04:29:35.541299+01:00","created_by":"Pablo LION","updated_at":"2026-02-04T17:13:40.627997+01:00","closed_at":"2026-02-04T17:13:40.627997+01:00","close_reason":"Added TEA module badge to README","dependencies":[{"issue_id":"bmp-p6w","depends_on_id":"bmp-nmw","type":"blocks","created_at":"2026-01-30T04:37:05.971439+01:00","created_by":"Pablo LION"}]}
 {"id":"bmp-p8e","title":"Fix YAML indentation in SKILL.md frontmatter (create-product-brief, framework)","description":"Two SKILL.md files have mismatched indentation in the YAML description field (3 spaces on continuation line vs 2 spaces on first line), causing 'unexpected indentation' YAML parse errors. Affected files: plugins/bmad/skills/create-product-brief/SKILL.md:4, plugins/bmad/skills/framework/SKILL.md:4. Fix: align continuation lines to 2-space indent. Also check if generate:skills script introduces this — may need a fix in the generator.","status":"closed","priority":2,"issue_type":"bug","owner":"dev@pablolion.com","created_at":"2026-02-26T08:35:37.203535+01:00","created_by":"Pablo LION","updated_at":"2026-02-26T08:35:37.203535+01:00","closed_at":"2026-03-05T20:29:01.790706+01:00"}
 {"id":"bmp-ps1","title":"Watch: upstream PR #1599 — fix typos in tech-writer/ux-designer","status":"closed","priority":4,"issue_type":"task","owner":"dev@pablolion.com","created_at":"2026-02-08T22:55:09.672723+01:00","created_by":"Pablo LION","updated_at":"2026-02-21T05:22:03.647244+01:00","closed_at":"2026-02-21T05:22:03.647244+01:00","close_reason":"PRs #1599 and #1600 merged upstream","labels":["watching"]}
+{"id":"bmp-q1y","title":"Fix path rewriter for core v6.2.0 restructuring","description":"Core v6.2.0 moved src/core/workflows/ to src/core/skills/ and renamed with bmad- prefix. The addCoreSpecialWorkflows function in scripts/lib/path-rewriter.ts looks at the old path (src/core/workflows/), finds nothing, and never adds the 'core' key to the workflow map. This causes all {project-root}/_bmad/core/... path rewrites to fail silently (warning: Unknown module alias: core). Also affects syncCoreExtras in sync-upstream-content.ts. Found during full regen test comparing dev vs clean regeneration.","status":"closed","priority":2,"issue_type":"bug","owner":"dev@pablolion.com","created_at":"2026-03-17T18:35:36.629367+01:00","created_by":"Pablo LION","updated_at":"2026-03-17T19:01:57.099069+01:00","closed_at":"2026-03-17T19:01:57.099069+01:00","close_reason":"Fixed in 9c20167: addCoreSpecialWorkflows updated for core v6.2.0 src/core/skills/ path, maps both prefixed and un-prefixed names, copies bmm entries into core map for cross-module refs."}
 {"id":"bmp-r6o","title":"Add CI for typecheck, lint, and validate","description":"PR #9 test plan was manual-only (typecheck, lint, validate). These should run in CI. Add GitHub Actions workflow to run: bun run typecheck, bun run lint, bun run validate on PRs.","status":"closed","priority":1,"issue_type":"task","owner":"36828324+PabloLION@users.noreply.github.com","created_at":"2026-02-06T01:43:44.147714+01:00","created_by":"Pablo LION","updated_at":"2026-02-06T22:16:48.282213+01:00","closed_at":"2026-02-06T22:16:48.282213+01:00","close_reason":"PR #12 merged: pre-commit hook + CI workflow"}
 {"id":"bmp-t10","title":"Fix bmad-master delegation table","description":"Delegation table in bmad-master.md has formatting inconsistencies. The table has both tea (Murat) and quinn listed separately which is correct, but: 1) Column alignment is inconsistent (some rows have extra spaces), 2) quick-flow-solo-dev should show as 'barry' to match the agent name field. Verify all agent names match their actual name field in frontmatter.","status":"closed","priority":2,"issue_type":"task","owner":"36828324+PabloLION@users.noreply.github.com","created_at":"2026-01-30T01:28:57.095789+01:00","created_by":"Pablo LION","updated_at":"2026-02-04T21:37:30.075807+01:00","closed_at":"2026-02-03T22:33:00.544294+01:00","close_reason":"Completed in PR #4 (multi-upstream sync)"}
 {"id":"bmp-t5o","title":"Replace README version line with multi-upstream dependency table","description":"Replace the single-line version display between upstream-version-start/end markers with a markdown table showing all 5 upstream sources.\n\nCurrent state (README.md line 14):\n  **Plugin version:** v6.0.0-Beta.7.0 | **Upstream version:** v6.0.0-Beta.7 | **Last synced:** 2026-02-08\n\nTarget format:\n  **Plugin version:** v6.0.0-Beta.7.0\n\n  | Module | Repo | Version | Last Synced |\n  |---|---|---|---|\n  | Core | bmadcode/BMAD-METHOD | v6.0.0-Beta.7 | 2026-02-08 |\n  | TEA | bmad-code-org/bmad-method-test-architecture-enterprise | v0.4.0 | 2026-02-04 |\n  | BMB | bmad-code-org/bmad-builder | v0.1.5 | 2026-02-06 |\n  | CIS | bmad-code-org/bmad-module-creative-intelligence-suite | v0.2.0 | 2026-02-06 |\n  | GDS | bmad-code-org/bmad-module-game-dev-studio | v0.3.0 | 2026-02-06 |\n\nFiles to modify:\n1. README.md — replace content between \u003c!-- upstream-version-start/end --\u003e markers\n2. scripts/update-readme-version.ts — rewrite to:\n   - Import getEnabledSources() from scripts/lib/upstream-sources.ts\n   - Read all .upstream-version-* files (5 total)\n   - Read .plugin-version\n   - Generate the table with columns: Module, Repo, Version, Last Synced\n   - Last Synced: for now use today's date (bmp-lf2 will fix this later)\n\nSource config: scripts/lib/upstream-sources.ts — has id, repo, versionFile for each source\nVersion files: .upstream-version-core, -tea, -bmb, -cis, -gds","status":"closed","priority":1,"issue_type":"task","owner":"dev@pablolion.com","created_at":"2026-02-08T15:01:57.471039+01:00","created_by":"Pablo LION","updated_at":"2026-02-09T21:27:58.941157+01:00","closed_at":"2026-02-09T21:27:58.941157+01:00","close_reason":"Closed"}

.claude-plugin/marketplace.json

@@ -11,7 +11,7 @@
       "name": "bmad",
       "source": "./plugins/bmad",
       "description": "BMAD Method - Breakthrough Method for Agile AI-Driven Development",
-      "version": "6.0.4.3"
+      "version": "6.2.0.0"
     }
   ]
 }

.github/badges/upstream-version-bmb.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
   "label": "BMB Module",
-  "message": "v0.1.6",
+  "message": "v1.0.2",
   "color": "green"
 }

.github/badges/upstream-version-gds.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
   "label": "GDS Module",
-  "message": "v0.1.10",
+  "message": "v0.2.2",
   "color": "green"
 }

.github/badges/upstream-version-tea.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
   "label": "TEA Module",
-  "message": "v1.5.2",
+  "message": "v1.7.0",
   "color": "green"
 }

.github/badges/upstream-version.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
   "label": "BMAD Method",
-  "message": "v6.0.4",
+  "message": "v6.2.0",
   "color": "blue"
 }

.plugin-version

@@ -1 +1 @@
-v6.0.4.3
+v6.2.0.0

.upstream-versions/bmb.json

@@ -1,4 +1,4 @@
 {
-  "version": "v0.1.6",
-  "syncedAt": "2026-02-11"
+  "version": "v1.0.2",
+  "syncedAt": "2026-03-17"
 }

.upstream-versions/cis.json

@@ -1,4 +1,4 @@
 {
   "version": "v0.1.8",
-  "syncedAt": "2026-02-24"
+  "syncedAt": "2026-03-17"
 }

.upstream-versions/core.json

@@ -1,4 +1,4 @@
 {
-  "version": "v6.0.4",
-  "syncedAt": "2026-03-05"
+  "version": "v6.2.0",
+  "syncedAt": "2026-03-17"
 }

.upstream-versions/gds.json

@@ -1,4 +1,4 @@
 {
-  "version": "v0.1.10",
-  "syncedAt": "2026-03-05"
+  "version": "v0.2.2",
+  "syncedAt": "2026-03-17"
 }

.upstream-versions/tea.json

@@ -1,4 +1,4 @@
 {
-  "version": "v1.5.2",
-  "syncedAt": "2026-03-05"
+  "version": "v1.7.0",
+  "syncedAt": "2026-03-17"
 }

README.md

@@ -13,21 +13,33 @@
 <!-- upstream-badges-end -->
 
 <!-- upstream-version-start -->
-**Plugin version:** v6.0.4.3
+**Plugin version:** v6.2.0.0
 
 | Module | Version | Released | Last Synced |
 |---|---|---|---|
-| [BMAD Method](https://github.com/bmadcode/BMAD-METHOD) | v6.0.4 | 2026-02-28 | 2026-03-05 |
-| [TEA](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise) | v1.5.2 | 2026-03-05 | 2026-03-05 |
-| [BMB](https://github.com/bmad-code-org/bmad-builder) | v0.1.6 | 2026-02-08 | 2026-02-11 |
-| [CIS](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite) | v0.1.8 | 2026-02-23 | 2026-02-24 |
-| [GDS](https://github.com/bmad-code-org/bmad-module-game-dev-studio) | v0.1.10 | 2026-02-28 | 2026-03-05 |
+| [BMAD Method](https://github.com/bmadcode/BMAD-METHOD) | v6.2.0 | 2026-03-15 | 2026-03-17 |
+| [TEA](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise) | v1.7.0 | 2026-03-13 | 2026-03-17 |
+| [BMB](https://github.com/bmad-code-org/bmad-builder) | v1.0.2 | 2026-03-15 | 2026-03-17 |
+| [CIS](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite) | v0.1.8 | 2026-02-23 | 2026-03-17 |
+| [GDS](https://github.com/bmad-code-org/bmad-module-game-dev-studio) | v0.2.2 | 2026-03-16 | 2026-03-17 |
 <!-- upstream-version-end -->
 
 A Claude Code plugin that transforms Claude into a complete agile development
 environment with specialized agents, structured workflows, and intelligent
 context management.
 
+## Deprecation Notice
+
+The upstream BMAD repositories are migrating from their custom `workflow.yaml`
+format to Claude Code's native `SKILL.md` format. Once all upstream modules
+complete this migration, this plugin's sync and generation pipeline will become
+redundant — the upstream repos will ship Claude Code-compatible skills directly.
+
+At that point this plugin will be deprecated in favor of installing upstream
+BMAD packages directly. Until then, this plugin remains the only way to get all
+5 BMAD modules aggregated into a single installable Claude Code plugin with
+path rewrites, version tracking, and plugin-only additions.
+
 ## Features
 
 - **9 Specialized Agents**: Business Analyst, Product Manager, UX Designer,

package.json

@@ -1,6 +1,6 @@
 {
   "name": "bmad-plugin",
-  "version": "6.0.4.3",
+  "version": "6.2.0.0",
   "type": "module",
   "scripts": {
     "prepare": "husky",
@@ -15,6 +15,7 @@
     "generate:skills": "bun scripts/generate-skills.ts",
     "generate:manifest": "bun scripts/generate-agent-manifest.ts",
     "sync-all": "bun scripts/sync-all.ts",
+    "clean:orphaned": "bun scripts/clean-orphaned-skills.ts",
     "bump-core": "bun scripts/bump-core.ts",
     "bump-module": "bun scripts/bump-module.ts",
     "update-readme": "bun scripts/update-readme-version.ts",

plugins/bmad/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "bmad",
-  "version": "6.0.4.3",
+  "version": "6.2.0.0",
   "description": "BMAD Method - Breakthrough Method for Agile AI-Driven Development",
   "author": {
     "name": "PabloLION",