fix: decouple skills from _bmad/ paths and wire project-context into story workflows

Migrate all hardcoded _bmad/ path references to forward-compatible patterns
(skill: invocations, relative paths, {installed_path}/{module_config}/{skill_root}
variables) anticipating BMAD-METHOD PR #2182 which stops copying skill dirs to
_bmad/. Fix project-context.md not being loaded or applied during story creation
and dev-story execution.

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

Author: sjennings

.claude-plugin/marketplace.json

@@ -12,7 +12,7 @@
       "name": "bmad-game-dev-studio",
       "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.2.3",
+      "version": "0.2.4",
       "author": {
         "name": "Brian (BMad) Madison"
       },

CHANGELOG.md

@@ -1,5 +1,24 @@
 # CHANGELOG
 
+## v0.2.4 - Apr 1, 2026
+
+### Decouple Skills from \_bmad/ Install Directory
+
+All skill file references migrated away from hardcoded `_bmad/` paths to forward-compatible patterns, anticipating the BMAD-METHOD installer change that stops copying skill directories into `_bmad/` (BMAD-METHOD PR #2182).
+
+* Core skill references (party-mode, advanced-elicitation, brainstorming, adversarial-review) converted to `skill:bmad-*` invocations across 68+ files
+* GDS self-references converted: step `workflow_path` → `{installed_path}`, cross-workflow handoffs → `skill:gds-*`, config → `{module_config}`, installed paths → `{skill_root}`
+* Next-step navigation converted to relative paths (`./step-NN-*.md`)
+* Data file references (CSVs, templates) converted to relative paths (`../data/`, `../templates/`)
+* Fixed 31 files using incorrect `bmad-party-mode` path (installer strips `bmad-` prefix, correct installed name is `party-mode`)
+
+### Fix project-context.md Not Applied During Story Creation and Development
+
+* Added `project-context.md` to `gds-create-story` Input Files table so `discover-inputs.md` actually loads it
+* Added project-context analysis step that extracts third-party frameworks, MCP configs, and conventions into story Dev Notes
+* Added "Project Context Rules" section to story template
+* Updated `gds-dev-story` to extract and actively apply project-context rules during implementation (Steps 2 and 5)
+
 ## v0.2.3 - Apr 1, 2026
 
 ### Opencode Compatibility Fix

package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-game-dev-studio",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "private": true,
   "description": "A BMad MEthod Core Module that offers a substantial stand alone module for Game Development across multiple supported platforms",
   "keywords": [

src/agents/gds-agent-game-architect/SKILL.md

@@ -46,7 +46,7 @@ When you are in this persona and the user calls a skill, this persona must carry
 
 ## On Activation
 
-1. Load config from `{project-root}/_bmad/gds/config.yaml` and resolve:
+1. Load config from `{module_config}` and resolve:
    - Use `{user_name}` for greeting
    - Use `{communication_language}` for all communications
    - Use `{document_output_language}` for output documents

src/agents/gds-agent-game-designer/SKILL.md

@@ -44,7 +44,7 @@ When you are in this persona and the user calls a skill, this persona must carry
 
 ## On Activation
 
-1. Load config from `{project-root}/_bmad/gds/config.yaml` and resolve:
+1. Load config from `{module_config}` and resolve:
    - Use `{user_name}` for greeting
    - Use `{communication_language}` for all communications
    - Use `{document_output_language}` for output documents

src/agents/gds-agent-game-dev/SKILL.md

@@ -46,7 +46,7 @@ When you are in this persona and the user calls a skill, this persona must carry
 
 ## On Activation
 
-1. Load config from `{project-root}/_bmad/gds/config.yaml` and resolve:
+1. Load config from `{module_config}` and resolve:
    - Use `{user_name}` for greeting
    - Use `{communication_language}` for all communications
    - Use `{document_output_language}` for output documents

src/agents/gds-agent-game-qa/SKILL.md

@@ -27,10 +27,10 @@ Speaks like GLaDOS, the AI from Valve's "Portal" series. Runs tests because we c
 
 ## Critical Actions
 
-- Consult `{project-root}/_bmad/gds/gametest/qa-index.csv` to select knowledge fragments under `knowledge/` and load only the files needed for the current task.
+- Consult `{module_root}/gametest/qa-index.csv` to select knowledge fragments under `knowledge/` and load only the files needed for the current task.
 - For E2E testing requests, always load `knowledge/e2e-testing.md` first.
 - When scaffolding tests, distinguish between unit, integration, and E2E test needs.
-- Load the referenced fragment(s) from `{project-root}/_bmad/gds/gametest/knowledge/` before giving recommendations.
+- Load the referenced fragment(s) from `{module_root}/gametest/knowledge/` before giving recommendations.
 - Cross-check recommendations with the current official Unity Test Framework, Unreal Automation, or Godot GUT documentation.
 - Find if this exists, if it does, always treat it as the bible I plan and execute against: `**/project-context.md`
 
@@ -53,7 +53,7 @@ When you are in this persona and the user calls a skill, this persona must carry
 
 ## On Activation
 
-1. Load config from `{project-root}/_bmad/gds/config.yaml` and resolve:
+1. Load config from `{module_config}` and resolve:
    - Use `{user_name}` for greeting
    - Use `{communication_language}` for all communications
    - Use `{document_output_language}` for output documents

src/agents/gds-agent-game-scrum-master/SKILL.md

@@ -47,7 +47,7 @@ When you are in this persona and the user calls a skill, this persona must carry
 
 ## On Activation
 
-1. Load config from `{project-root}/_bmad/gds/config.yaml` and resolve:
+1. Load config from `{module_config}` and resolve:
    - Use `{user_name}` for greeting
    - Use `{communication_language}` for all communications
    - Use `{document_output_language}` for output documents

src/agents/gds-agent-game-solo-dev/SKILL.md

@@ -46,7 +46,7 @@ When you are in this persona and the user calls a skill, this persona must carry
 
 ## On Activation
 
-1. Load config from `{project-root}/_bmad/gds/config.yaml` and resolve:
+1. Load config from `{module_config}` and resolve:
    - Use `{user_name}` for greeting
    - Use `{communication_language}` for all communications
    - Use `{document_output_language}` for output documents

src/agents/gds-agent-tech-writer/SKILL.md

@@ -41,7 +41,7 @@ When you are in this persona and the user calls a skill, this persona must carry
 
 ## On Activation
 
-1. Load config from `{project-root}/_bmad/gds/config.yaml` and resolve:
+1. Load config from `{module_config}` and resolve:
    - Use `{user_name}` for greeting
    - Use `{communication_language}` for all communications
    - Use `{document_output_language}` for output documents