Skip to content

docs(changelog): add v0.7.0 entry, bump plugin version, fix dead skill path - #31

Open
bmadcode wants to merge 1 commit into
mainfrom
changelog-release
Open

docs(changelog): add v0.7.0 entry, bump plugin version, fix dead skill path#31
bmadcode wants to merge 1 commit into
mainfrom
changelog-release

Conversation

@bmadcode

@bmadcode bmadcode commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Release notes for v0.7.0, covering #28, #29, and #30 — plus a real defect found while validating.

⚠️ The published plugin pointed at a skill that doesn't exist

.claude-plugin/marketplace.json listed:

./src/workflows/2-design/gds-create-ux-design

That directory was removed in v0.6.0, which replaced it with gds-ux — and gds-ux was never added to the plugin. So anyone installing the game-dev-studio plugin got a dead path and no UX skill at all, while the v0.6.0 changelog announced the new skill.

Swapped. I then checked the whole array both directions: all 33 listed paths resolve, and no real skill is unlisted.

Changelog

The v0.7.0 entry covers:

Version bump

Marketplace plugin 0.6.00.7.0. package.json is left alone; the release workflow owns it.

Nothing in publish.yaml touches marketplace.json, so it drifts unless bumped by hand — which is also how the dead gds-create-ux-design path survived a full release. bmad-method-test-architecture-enterprise solves this with a Sync marketplace version step plus a test-release-metadata.js guard; worth copying here, ideally extended to assert every skill path resolves.

Verification

markdownlint and prettier pass.

Summary by CodeRabbit

  • New Features

    • Added support for running Python commands through uv run.
    • Added platform-native browser opening support.
    • Added a Python version badge and Roblox README guidance.
    • Updated the UX workflow path.
  • Documentation

    • Added release notes for version 0.7.0.
    • Reformatted historical changelog bullets for consistency.

…l path

Covers #28, #29, and #30. Marketplace plugin version goes 0.6.0 -> 0.7.0.

Also fixes a real defect found while validating: marketplace.json listed
./src/workflows/2-design/gds-create-ux-design, which v0.6.0 replaced with
gds-ux, and gds-ux was never added in its place. Anyone installing the
plugin got a dead path and no UX skill. All 33 listed paths now resolve.
@coderabbitai

coderabbitai Bot commented Aug 10, 2026

Copy link
Copy Markdown

Review Change Stack

Walkthrough

The plugin metadata now targets version 0.7.0 and the gds-ux skill path. The changelog adds v0.7.0 release notes and converts historical bullets to hyphen format.

Changes

Plugin release update

Layer / File(s) Summary
Plugin metadata updates
.claude-plugin/marketplace.json
The plugin version changed from 0.6.0 to 0.7.0. The UX workflow skill path changed from gds-create-ux-design to gds-ux.
Version 0.7.0 release notes
CHANGELOG.md
The changelog documents the v0.7.0 changes, including uv run adoption, browser opener changes, requirement corrections, path fixes, legacy file removal, and Roblox documentation.
Historical changelog formatting
CHANGELOG.md
Existing release notes from v0.6.0 through v0.1.1 use hyphen bullets while preserving their content and nesting.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Suggested reviewers: sjennings

Poem

A rabbit hops through version snow,
The plugin path now points just so.
Hyphen notes line up in cheer,
New release details bloom this year.
“uv run!” the bunny sings,
While tidy changelog magic springs.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately identifies the changelog entry, plugin version bump, and dead skill path fix.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch changelog-release

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.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 3

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.claude-plugin/marketplace.json:
- Line 15: Synchronize the package version with the marketplace metadata: update
the release/versioning flow around package.json.version and the marketplace
version entry so npm version uses the marketplace’s current version as its base
before applying the requested bump, ensuring both remain aligned for publishing.

In `@CHANGELOG.md`:
- Line 10: Update the changelog entry to state that
`.claude-plugin/marketplace.json` omitted the existing `gds-ux` skill entry,
rather than claiming the skill was never added or did not exist; preserve the
explanation that the outdated `gds-create-ux-design` path caused the published
plugin to reference a dead path.
- Line 132: Update the historical changelog note to capitalize “Markdown” in
both occurrences: “Markdown links” and “Markdown-style links,” without changing
the surrounding wording.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: a2aa4388-385e-40cb-a6a8-c788ede8dd36

📥 Commits

Reviewing files that changed from the base of the PR and between ac99cb8 and a622efe.

📒 Files selected for processing (2)
  • .claude-plugin/marketplace.json
  • CHANGELOG.md

"source": "./",
"description": "A comprehensive game development module with agents and workflows for preproduction, design, architecture, production, and testing across Unity, Unreal, and Godot. Part of the BMad Method ecosystem.",
"version": "0.6.0",
"version": "0.7.0",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🗄️ Data Integrity & Integration | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

printf '%s\n' "Declared versions:"
rg -n '"version":' package.json .claude-plugin/marketplace.json

printf '%s\n' "Release automation references:"
fd -H -t f -0 -e yml -e yaml -e json -e js -e ts -e sh |
  xargs -0 -r rg -n -C 4 'package\.json|marketplace\.json|npm (version|publish)|0\.7\.0'

Repository: bmad-code-org/bmad-module-game-dev-studio

Length of output: 3179


🏁 Script executed:

#!/bin/bash
set -euo pipefail

printf '%s\n' "workflow outline:"
ast-grep outline .github/workflows/release.yaml --view expanded || true

printf '%s\n' "release workflow body:"
cat -n .github/workflows/release.yaml | sed -n '1,180p'

printf '%s\n' "workflow dispatch config:"
cat -n .github/workflows/release.yaml | sed -n '1,80p'

printf '%s\n' "other marketplace/version references:"
rg -n 'marketplace\.json|version.*0\.7\.0|npm version|npm publish|sourceless|publish' .github .claude-plugin package.json 2>/dev/null || true

Repository: bmad-code-org/bmad-module-game-dev-studio

Length of output: 7829


Synchronize the version in package.json with the marketplace metadata.

.claude-plugin/marketplace.json declares 0.7.0, while package.json still has 0.6.0. npm version ${{ inputs.bump }} bumps package.json by patch/minor/major instead of setting the marketplace version, so publish will use 0.8.0 for the next patch release. Set or automate package.json.version to match the marketplace entry before release.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.claude-plugin/marketplace.json at line 15, Synchronize the package version
with the marketplace metadata: update the release/versioning flow around
package.json.version and the marketplace version entry so npm version uses the
marketplace’s current version as its base before applying the requested bump,
ensuring both remain aligned for publishing.

Comment thread CHANGELOG.md
- **All Python invocations go through `uv run`** (#30). Sixty-one call sites shelled out to a bare `python3` to run `_bmad/scripts/resolve_customization.py`, plus one for `render-validation-html.py`. The resolver declares `requires-python = ">=3.11"` and hard-exits below it, because `tomllib` is a 3.11 stdlib addition. On macOS without Homebrew or Ubuntu 22.04, where `python3` is 3.10, activation fell through to the "if the script fails" path and hand-merged the TOML layers in-context — no error surfaced. `uv run` reads each script's own `requires-python` and provisions a matching interpreter.
- **Browser openers no longer spawn a Python interpreter** (#30). Four sites ran `python3 -c "import webbrowser, pathlib; webbrowser.open(...)"` purely to open an HTML file. They now use the platform opener — `open` on macOS, `xdg-open` on Linux, `start ""` on Windows — and hand you the file path if that fails instead of leaving you waiting on a window that never appears. These were the last place the module needed a system Python at all, and they failed silently on a machine that has none.
- **README Python badge corrected to `>=3.11`** (#30). It advertised `>=3.10`, a floor that cannot run the shared resolver.
- **The published plugin pointed at a skill that doesn't exist.** `.claude-plugin/marketplace.json` still listed `gds-create-ux-design`, which v0.6.0 replaced with `gds-ux` — and `gds-ux` itself was never added. Anyone installing the plugin got a dead path and no UX skill. Swapped; all 33 listed paths now resolve.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Describe the marketplace omission accurately.

src/workflows/2-design/gds-ux/SKILL.md Lines 1-6 and src/agents/gds-agent-game-designer/customize.toml Lines 51-59 show that gds-ux exists. The missing entry was in .claude-plugin/marketplace.json, not the skill itself.

Proposed wording
-which v0.6.0 replaced with `gds-ux` — and `gds-ux` itself was never added.
+which v0.6.0 replaced with `gds-ux` — but `gds-ux` was not added to the marketplace skill list.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- **The published plugin pointed at a skill that doesn't exist.** `.claude-plugin/marketplace.json` still listed `gds-create-ux-design`, which v0.6.0 replaced with `gds-ux`and `gds-ux` itself was never added. Anyone installing the plugin got a dead path and no UX skill. Swapped; all 33 listed paths now resolve.
- **The published plugin pointed at a skill that doesn't exist.** `.claude-plugin/marketplace.json` still listed `gds-create-ux-design`, which v0.6.0 replaced with `gds-ux`but `gds-ux` was not added to the marketplace skill list. Anyone installing the plugin got a dead path and no UX skill. Swapped; all 33 listed paths now resolve.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@CHANGELOG.md` at line 10, Update the changelog entry to state that
`.claude-plugin/marketplace.json` omitted the existing `gds-ux` skill entry,
rather than claiming the skill was never added or did not exist; preserve the
explanation that the outdated `gds-create-ux-design` path caused the published
plugin to reference a dead path.

Comment thread CHANGELOG.md
### Opencode Compatibility Fix

* Changed SKILL.md workflow references from markdown links (`[workflow.md](workflow.md)`) to bare paths (`./workflow.md`) across all 28 workflow skills, matching the BMAD-METHOD convention. Opencode does not follow markdown-style links when resolving skill workflow files.
- Changed SKILL.md workflow references from markdown links (`[workflow.md](workflow.md)`) to bare paths (`./workflow.md`) across all 28 workflow skills, matching the BMAD-METHOD convention. Opencode does not follow markdown-style links when resolving skill workflow files.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Capitalize Markdown in the historical note.

Use Markdown in both Markdown links and Markdown-style links at Line 132.

Proposed wording
-Changed SKILL.md workflow references from markdown links (`[workflow.md](workflow.md)`) to bare paths (`./workflow.md`) across all 28 workflow skills, matching the BMAD-METHOD convention. Opencode does not follow markdown-style links when resolving skill workflow files.
+Changed SKILL.md workflow references from Markdown links (`[workflow.md](workflow.md)`) to bare paths (`./workflow.md`) across all 28 workflow skills, matching the BMAD-METHOD convention. Opencode does not follow Markdown-style links when resolving skill workflow files.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- Changed SKILL.md workflow references from markdown links (`[workflow.md](workflow.md)`) to bare paths (`./workflow.md`) across all 28 workflow skills, matching the BMAD-METHOD convention. Opencode does not follow markdown-style links when resolving skill workflow files.
- Changed SKILL.md workflow references from Markdown links (`[workflow.md](workflow.md)`) to bare paths (`./workflow.md`) across all 28 workflow skills, matching the BMAD-METHOD convention. Opencode does not follow Markdown-style links when resolving skill workflow files.
🧰 Tools
🪛 LanguageTool

[uncategorized] ~132-~132: Did you mean the formatting language “Markdown” (= proper noun)?
Context: ...anged SKILL.md workflow references from markdown links ([workflow.md](workflow.md)) to...

(MARKDOWN_NNP)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@CHANGELOG.md` at line 132, Update the historical changelog note to capitalize
“Markdown” in both occurrences: “Markdown links” and “Markdown-style links,”
without changing the surrounding wording.

Source: Linters/SAST tools

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