@clfhhc/bmad-methods-skills 0.2.1 → 0.2.2

package/config.json

@@ -3,16 +3,9 @@
   "bmadBranch": "main",
   "outputDir": "./skills",
   "tempDir": "./.temp/bmad-method",
-  "modules": [
-    "bmm",
-    "core"
-  ],
-  "agentPaths": [
-    "src/*/agents"
-  ],
-  "workflowPaths": [
-    "src/*/workflows"
-  ],
+  "modules": ["bmm", "core"],
+  "agentPaths": ["src/*/agents"],
+  "workflowPaths": ["src/*/workflows"],
   "enhancements": {
     "optional": {
       "addExamples": true,
@@ -53,61 +46,226 @@
       "isDirectory": true
     }
   ],
+  "skillMap": {
+    "sourcePrefix": "\\{project-root\\}/_bmad/",
+    "dirLookahead": "(?=['\\s`]|$)",
+    "replacementPrefix": "{skill-root}"
+  },
   "pathPatterns": [
     {
-      "pattern": "\\{project-root\\}/_bmad/(core|bmm|bmb|cis)/workflows/([^/\\\\s'\"]+)/workflow\\.(yaml|md|xml)",
-      "replacement": "{skill-root}/$1/$2/SKILL.md",
-      "description": "Standard workflow files"
+      "pattern": "\\{project-root\\}/_bmad/bmm/workflows/workflow-status/init/workflow\\.(yaml|md)",
+      "replacement": "{skill-root}/bmm/init/SKILL.md",
+      "description": "Init nested workflow (must run before workflow-status dir)"
     },
     {
-      "pattern": "\\{project-root\\}/_bmad/(core|bmm|bmb|cis)/config\\.yaml",
-      "replacement": "{skill-root}/$1/config.yaml",
-      "description": "Module config files"
+      "pattern": "\\{project-root\\}/_bmad/bmm/workflows/document-project/workflows",
+      "replacement": "{skill-root}/bmm/document-project",
+      "description": "document-project workflows dir"
     },
     {
-      "pattern": "\\{project-root\\}/_bmad/(core|bmm|bmb|cis)/workflows/([^/\\\\s'\"]+)/([^/\\\\s'\"]+\\.(md|csv|yaml|xml))",
-      "replacement": "{skill-root}/$1/$2/$3",
-      "description": "Files within workflow directories"
+      "pattern": "\\{project-root\\}/_bmad/core/workflows/([^/\\s'\"]+)/workflow\\.(yaml|md|xml)",
+      "replacement": "{skill-root}/core/$1/SKILL.md",
+      "description": "Core workflow files"
     },
     {
-      "pattern": "\\{project-root\\}/_bmad/_memory/([^/\\\\s'\"]+)",
-      "replacement": "{runtime-memory}/$1",
-      "description": "Runtime memory references"
+      "pattern": "\\{project-root\\}/_bmad/bmm/workflows/(?:\\d-[^/]+/)?([^/\\s'\"]+)/workflow\\.(yaml|md|xml)",
+      "replacement": "{skill-root}/bmm/$1/SKILL.md",
+      "description": "BMM workflow files (incl. category folders)"
     },
     {
-      "pattern": "\\{project-root\\}/_bmad/bmb-creations",
-      "replacement": "{output-folder}/bmb-creations",
-      "description": "BMB creations output folder"
+      "pattern": "\\{project-root\\}/_bmad/bmm/(?:workflows/)?testarch/([^/\\s'\"]+)/workflow\\.(yaml|md|xml)",
+      "replacement": "{skill-root}/bmm/testarch-$1/SKILL.md",
+      "description": "Testarch workflow files"
     },
     {
-      "pattern": "\\{project-root\\}/_data/([^/\\\\s'\"]+)",
-      "replacement": "{project-data}/$1",
-      "description": "Project data files"
+      "pattern": "\\{project-root\\}/_bmad/bmm/workflows/excalidraw-diagrams/([^/\\s'\"]+)/workflow\\.(yaml|md|xml)",
+      "replacement": "{skill-root}/bmm/$1/SKILL.md",
+      "description": "Excalidraw-diagrams workflow files"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/bmm/workflows/bmad-quick-flow/([^/\\s'\"]+)/workflow\\.(yaml|md)",
+      "replacement": "{skill-root}/bmm/$1/SKILL.md",
+      "description": "bmad-quick-flow workflow files"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/core/tasks/workflow\\.xml",
+      "replacement": "{skill-root}/core/tasks/SKILL.md",
+      "description": "Core tasks workflow.xml"
     },
     {
-      "pattern": "\\{project-root\\}/_bmad/core/resources/excalidraw/([^/\\\\s'\"]+)",
+      "pattern": "\\{project-root\\}/_bmad/core/resources/excalidraw/([^/\\s'\"]+)",
       "replacement": "{skill-root}/core/resources/excalidraw/$1",
       "description": "Excalidraw helper resources"
     },
     {
-      "pattern": "\\{project-root\\}/_bmad/bmm/workflows/excalidraw-diagrams/_shared/([^/\\\\s'\"]+)",
+      "pattern": "\\{project-root\\}/_bmad/bmm/workflows/excalidraw-diagrams/_shared/([^/\\s'\"]+)",
       "replacement": "{skill-root}/bmm/excalidraw-diagrams/_shared/$1",
-      "description": "Excalidraw-diagrams _shared files (excalidraw-templates.yaml, excalidraw-library.json)"
+      "description": "Excalidraw-diagrams _shared files"
     },
     {
       "pattern": "\\{project-root\\}/_bmad/bmm/workflows/excalidraw-diagrams/_shared(?!/)",
       "replacement": "{skill-root}/bmm/excalidraw-diagrams/_shared",
-      "description": "Excalidraw-diagrams _shared directory (when not followed by /)"
+      "description": "Excalidraw-diagrams _shared directory"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/(core|bmm|bmb)/workflows/(?:\\d-[^/]+/)?([^/\\s'\"]+)/([^/\\s'\"]+\\.(md|csv|yaml|xml))",
+      "replacement": "{skill-root}/$1/$2/$3",
+      "description": "Files within workflow dirs"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/(core|bmm|bmb)/workflows/(?:\\d-[^/]+/)?([^/\\s'\"]+)/steps/([^/\\s'\"]+)",
+      "replacement": "{skill-root}/$1/$2/steps/$3",
+      "description": "Step files within workflows"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/bmb/workflows/([^/\\s'\"]+)/(steps-[^/]+)/([^/\\s'\"]+)",
+      "replacement": "{skill-root}/bmb/$1/$2/$3",
+      "description": "BMB workflow step files"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/bmm/workflows/\\d-[^/]+/([^/\\s'\"]+)(?=['\\s`])",
+      "replacement": "{skill-root}/bmm/$1",
+      "description": "BMM workflows dir with category"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/bmm/workflows/([a-z][-a-z0-9]+)(?=['\\s`])",
+      "replacement": "{skill-root}/bmm/$1",
+      "description": "BMM workflows dir (no category)"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/bmm/workflows/bmad-quick-flow/([^/\\s'\"]+)(?=['\\s`])",
+      "replacement": "{skill-root}/bmm/$1",
+      "description": "bmad-quick-flow directory refs"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/bmm/workflows/testarch/([^/\\s'\"]+)(?=['\\s`])",
+      "replacement": "{skill-root}/bmm/testarch-$1",
+      "description": "Testarch directory refs"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/bmm/workflows/workflow-status(?=['\\s`/])",
+      "replacement": "{skill-root}/bmm/workflow-status",
+      "description": "workflow-status directory"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/(bmm|bmb|core)/config\\.yaml",
+      "replacement": "{skill-root}/$1/config.yaml",
+      "description": "Module config files"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/_config/agent-manifest\\.csv",
+      "replacement": "{skill-root}/agent-manifest.csv",
+      "description": "Agent manifest"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/bmm/testarch/tea-index\\.csv",
+      "replacement": "{skill-root}/bmm/tea/tea-index.csv",
+      "description": "TEA tea-index.csv"
     },
     {
       "pattern": "\\{project-root\\}/_bmad/bmm/testarch/knowledge/",
       "replacement": "{skill-root}/bmm/tea/knowledge/",
       "description": "TEA Knowledge Base (migrated)"
     },
+    {
+      "pattern": "\\{project-root\\}/_bmad/bmm/data/documentation-standards\\.md",
+      "replacement": "{skill-root}/bmm/tech-writer/data/documentation-standards.md",
+      "description": "documentation-standards (migrated to tech-writer)"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/_memory/([^/\\s'\"]+)",
+      "replacement": "{runtime-memory}/$1",
+      "description": "Runtime memory"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/bmb-creations",
+      "replacement": "{output-folder}/bmb-creations",
+      "description": "bmb-creations output folder"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/core/tasks/([^/\\s'\"]+\\.xml)",
+      "replacement": "{skill-root}/core/tasks/$1",
+      "description": "Core tasks XML files"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/(bmm|bmb|core)/tasks/([^/\\s'\"]+)",
+      "replacement": "{skill-root}/$1/tasks/$2",
+      "description": "Module tasks"
+    },
+    {
+      "pattern": "\\{project-root\\}/_data/([^/\\s'\"]+)",
+      "replacement": "{project-data}/$1",
+      "description": "Project data files"
+    },
+    {
+      "pattern": "\\{project-root\\}/src/modules/(bmm|bmb|core)/workflows/(?:\\d-[^/]+/)?([^/\\s'\"]+)",
+      "replacement": "{skill-root}/$1/$2",
+      "description": "src/modules workflow refs"
+    },
+    {
+      "pattern": "\\{project-root\\}/src/modules/bmb/workflows/([^/\\s'\"]+)/(steps-[^/]+)/([^/\\s'\"]+)",
+      "replacement": "{skill-root}/bmb/$1/$2/$3",
+      "description": "src/modules BMB step refs"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/cis/workflows/([^/\\s'\"]+)/workflow\\.(yaml|md|xml)",
+      "replacement": "{skill-root}/cis/$1/SKILL.md",
+      "description": "CIS workflow files"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/(bmm|bmb|core|cis)/workflows/([a-z][-a-z0-9]+)(?=['\\s`]|$)",
+      "replacement": "{skill-root}/$1/$2",
+      "description": "Generic workflow fallback (only when no extra path segment)"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/\\{module-code\\}/workflows/",
+      "replacement": "{skill-root}/{module-code}/",
+      "description": "Template {module-code}"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/\\{module-id\\}/workflows/",
+      "replacement": "{skill-root}/{module-id}/",
+      "description": "Template {module-id}"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/\\{module\\}/",
+      "replacement": "{skill-root}/{module}/",
+      "description": "Template {module}"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/\\{module_code\\}/workflows/",
+      "replacement": "{skill-root}/{module_code}/",
+      "description": "Template {module_code}"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/\\[module\\]/",
+      "replacement": "{skill-root}/[module]/",
+      "description": "Template [module]"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/\\[module-path\\]/workflows/",
+      "replacement": "{skill-root}/[module-path]/",
+      "description": "Template [module-path]"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/\\[MODULE FOLDER\\]/",
+      "replacement": "{skill-root}/[MODULE FOLDER]/",
+      "description": "Template [MODULE FOLDER]"
+    },
+    {
+      "pattern": "\\{project-root\\}/\\.\\.\\./([^/\\s'\"]+)/workflow\\.(yaml|md|xml)",
+      "replacement": "{skill-root}/.../$1/SKILL.md",
+      "description": "Ellipsis workflow in docs"
+    },
     {
       "pattern": "\\{project-root\\}/_bmad/\\.\\.\\./",
       "replacement": "{skill-root}/.../",
-      "description": "Ellipsis in documentation examples"
+      "description": "Ellipsis in documentation"
+    },
+    {
+      "pattern": "\\{project-root\\}/_bmad/core/workflows/\\{workflow-name\\}/",
+      "replacement": "{skill-root}/core/{workflow-name}/",
+      "description": "Template {workflow-name}"
     }
   ]
-}
+}

package/convert.js

@@ -53,7 +53,7 @@ output_folder: "_bmad-output"
 /**
  * Get module-specific config content
  * Checks BMAD repo for config-template.yaml first, falls back to defaults
- * @param {string} moduleName - Module name (core, bmm, bmb)
+ * @param {string} moduleName - Module name (core, bmm)
  * @param {string|null} bmadRoot - Optional path to BMAD repo for template lookup
  * @returns {Promise<string>} YAML config content
  */
@@ -438,6 +438,7 @@ async function main() {
           await writeSkill(outputDir, agent.module, agent.name, skillContent, {
             skillMap,
             pathPatterns: config.pathPatterns,
+            skillMapOptions: config.skillMap || {},
           });
           stats.agents.converted++;
           console.log(`  ✓ ${agent.module}/${agent.name}`);
@@ -482,6 +483,7 @@ async function main() {
               workflowDir: workflow.workflowDir,
               skillMap,
               pathPatterns: config.pathPatterns,
+              skillMapOptions: config.skillMap || {},
             }
           );
           stats.workflows.converted++;

package/docs/technical-reference.md

@@ -97,20 +97,15 @@ Migrated resources are processed recursively. Any text-based files within these
 
 ## Path Rewriting
 
-To make skills portable, path rewriting uses a dynamic map of all discovered skills combined with configurable regex patterns:
-
-- **Configurable Patterns**: Custom rewriting rules can be added to `config.json` under `pathPatterns`. These are applied first.
-- **Pattern Optimization**: Regex patterns are pre-compiled once at startup for maximum performance during large conversion runs.
-- **Exact Skill Resolution**: Uses a `skillMap` to resolve paths like `testarch/ci/workflow.yaml` to their correct installed name e.g. `testarch-ci`.
-- **Global Normalization**: Path normalization ensures that both module paths (`src/*/`) and core paths (`src/core/*`) are correctly mapping to their destination equivalents.
-- **Skill Root Variable**: Replaces fragile relative paths (`../../`) with `{skill-root}`.
-- **Variable Consolidation**: `{skill-config}` has been merged into `{skill-root}`.
-- **Standardized Paths**:
-  - Cross-Skill: `{skill-root}/{module}/{skill}/SKILL.md`
-  - Resources: `{skill-root}/{module}/{skill}/data/...`
-  - Excalidraw core: `{skill-root}/core/resources/excalidraw/...`
-  - Excalidraw shared: `{skill-root}/bmm/excalidraw-diagrams/_shared/...` (templates, library)
-- **Migrated Resources**: Paths to migrated files are updated to their new locations.
+To make skills portable, path rewriting uses **config-driven regex patterns** plus a dynamic map of discovered skills:
+
+- **Source of truth**: All path-rewrite rules are defined in `config.json` under `pathPatterns`. Each entry has `pattern` (regex string), `replacement`, and optional `description`. Order in the array matters—specific rules (e.g. init, document-project) must come before generic ones.
+- **skillMap options**: The dynamic skillMap block (exact file and directory rewrites from discovered agents/workflows) uses `config.skillMap`: `sourcePrefix` (regex fragment for `{project-root}/_bmad/`), `dirLookahead` (lookahead so directory matches don’t over-match, e.g. space/quote/backtick or end), and `replacementPrefix` (e.g. `{skill-root}`). Omit `skillMap` to use built-in defaults.
+- **Pattern optimization**: Regexes are pre-compiled at startup for performance.
+- **Exact skill resolution**: A `skillMap` of discovered agents/workflows is applied after `pathPatterns` to resolve exact source paths to destination skills.
+- **Skill root variable**: Output uses `{skill-root}` instead of fragile relative paths.
+- **Standardized paths** (from `pathPatterns`): Cross-skill `{skill-root}/{module}/{skill}/SKILL.md`; resources under `data/`; Excalidraw under `core/resources/excalidraw/` and `bmm/excalidraw-diagrams/_shared/`.
+- **Migrated resources**: Paths inside files migrated via `auxiliaryResources` are rewritten using the same `pathPatterns`.
 
 This ensures skills work correctly regardless of where the root `skills` directory is installed and that cross-skill references are robust.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clfhhc/bmad-methods-skills",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Convert BMAD-METHOD agents and workflows to Claude Skills format",
   "type": "module",
   "repository": {

package/skills/enhance-bmad-skills/data/path-patterns.md

@@ -90,6 +90,5 @@ Reference for detecting and transforming path patterns in BMAD-converted skills.
 | BMAD Module | Skills Location | Notes |
 |-------------|-----------------|-------|
 | `bmm` | `skills/bmm/` | Main method modules |
-| `bmb` | `skills/bmb/` | Builder modules |
 | `core` | `skills/core/` | Core workflows |
 | `cis` | N/A | Not converted - reference as external |

package/src/utils/path-rewriter.js

@@ -7,18 +7,22 @@
  * Rewrite BMAD paths in content to relative skill paths
  * @param {string} content - File content to process
  * @param {Map|null} skillMap - Map of source paths to destination skill info
- * @param {Array|null} pathPatterns - Array of {pattern, regex, replacement} from config
+ * @param {Array|null} pathPatterns - Array of {pattern, replacement, description?} from config.json pathPatterns (source of truth for all regex rewrites)
+ * @param {Object} [skillMapOptions] - From config.json skillMap: { sourcePrefix, dirLookahead, replacementPrefix } for the dynamic skillMap block
  * @returns {string} Content with rewritten paths
  */
 export function rewriteBmadPaths(
   content,
   skillMap = null,
-  pathPatterns = null
+  pathPatterns = null,
+  skillMapOptions = {}
 ) {
   let result = content;
 
-  // Use user-defined {skill-root} variable for portability instead of fragile relative paths
-  const relativePrefix = '{skill-root}';
+  const opts = skillMapOptions || {};
+  const sourcePrefix = opts.sourcePrefix ?? '\\{project-root\\}/_bmad/';
+  const dirLookahead = opts.dirLookahead ?? "(?=['\\s`]|$)";
+  const replacementPrefix = opts.replacementPrefix ?? '{skill-root}';
 
   // === CONFIG-DRIVEN PATTERNS (Applied First) ===
   if (pathPatterns && pathPatterns.length > 0) {
@@ -48,10 +52,10 @@ export function rewriteBmadPaths(
       // Pattern: {project-root}/_bmad/{srcPath}
       // srcPath is now normalized by convert.js
       const escapedPath = srcPath.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-      const regex = new RegExp(`\\{project-root\\}/_bmad/${escapedPath}`, 'g');
+      const regex = new RegExp(`${sourcePrefix}${escapedPath}`, 'g');
       result = result.replace(
         regex,
-        `${relativePrefix}/${module}/${name}/SKILL.md`
+        `${replacementPrefix}/${module}/${name}/SKILL.md`
       );
     }
 
@@ -64,271 +68,14 @@ export function rewriteBmadPaths(
     for (const srcDir of sortedDirs) {
       const { module, name } = dirMap.get(srcDir);
       const escapedDir = srcDir.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-      // Look for directory path not followed by / (to avoid replacing parents of nested files that weren't caught?)
-      // Actually, if we replaced files first, the only things left starting with this dir are directory references or other files.
       const regex = new RegExp(
-        `\\{project-root\\}/_bmad/${escapedDir}(?=['\\s\`]|$)`,
+        `${sourcePrefix}${escapedDir}${dirLookahead}`,
         'g'
       );
-      result = result.replace(regex, `${relativePrefix}/${module}/${name}`);
+      result = result.replace(regex, `${replacementPrefix}/${module}/${name}`);
     }
   }
 
-  // === SPECIFIC EXCEPTIONS (Must run before generic patterns) ===
-
-  // Rewrite init nested workflow references
-  // Must run BEFORE workflow-status directory rewrite
-  result = result.replace(
-    /\{project-root\}\/_bmad\/bmm\/workflows\/workflow-status\/init\/workflow\.(yaml|md)/g,
-    `${relativePrefix}/bmm/init/SKILL.md`
-  );
-
-  // Rewrite document-project workflow references
-  result = result.replace(
-    /\{project-root\}\/_bmad\/bmm\/workflows\/document-project\/workflows/g,
-    `${relativePrefix}/bmm/document-project`
-  );
-
-  // Rewrite core workflow references
-  // {project-root}/_bmad/core/workflows/{name}/workflow.* -> ../../core/{name}/SKILL.md
-  result = result.replace(
-    /\{project-root\}\/_bmad\/core\/workflows\/([^/\s'"]+)\/workflow\.(yaml|md|xml)/g,
-    `${relativePrefix}/core/$1/SKILL.md`
-  );
-
-  // Rewrite bmm workflow references (handles nested category folders)
-  // {project-root}/_bmad/bmm/workflows/{category}/{name}/workflow.* -> ../../bmm/{name}/SKILL.md
-  // {project-root}/_bmad/bmm/workflows/{name}/workflow.* -> ../../bmm/{name}/SKILL.md
-  result = result.replace(
-    /\{project-root\}\/_bmad\/bmm\/workflows\/(?:\d-[^/]+\/)?([^/\s'"]+)\/workflow\.(yaml|md|xml)/g,
-    `${relativePrefix}/bmm/$1/SKILL.md`
-  );
-
-  // Rewrite bmb workflow references
-  // {project-root}/_bmad/bmb/workflows/{name}/workflow.* -> ../../bmb/{name}/SKILL.md
-  result = result.replace(
-    /\{project-root\}\/_bmad\/bmb\/workflows\/([^/\s'"]+)\/workflow\.(yaml|md|xml)/g,
-    `${relativePrefix}/bmb/$1/SKILL.md`
-  );
-
-  // Rewrite testarch workflow references (bmm/testarch/{name}/workflow.* or bmm/workflows/testarch/...)
-  result = result.replace(
-    /\{project-root\}\/_bmad\/bmm\/(?:workflows\/)?testarch\/([^/\s'"]+)\/workflow\.(yaml|md|xml)/g,
-    `${relativePrefix}/bmm/testarch-$1/SKILL.md`
-  );
-
-  // Rewrite excalidraw-diagrams workflow references
-  result = result.replace(
-    /\{project-root\}\/_bmad\/bmm\/workflows\/excalidraw-diagrams\/([^/\s'"]+)\/workflow\.(yaml|md|xml)/g,
-    `${relativePrefix}/bmm/$1/SKILL.md`
-  );
-
-  // Rewrite bmad-quick-flow workflow references
-  result = result.replace(
-    /\{project-root\}\/_bmad\/bmm\/workflows\/bmad-quick-flow\/([^/\s'"]+)\/workflow\.(yaml|md)/g,
-    `${relativePrefix}/bmm/$1/SKILL.md`
-  );
-
-  // Rewrite core tasks reference (special case)
-  // {project-root}/_bmad/core/tasks/workflow.xml -> ../../core/tasks/SKILL.md
-  result = result.replace(
-    /\{project-root\}\/_bmad\/core\/tasks\/workflow\.xml/g,
-    `${relativePrefix}/core/tasks/SKILL.md`
-  );
-
-  // Rewrite references to specific files within workflows
-  // {project-root}/_bmad/*/workflows/*/{file} -> ../../{module}/{name}/{file}
-  result = result.replace(
-    /\{project-root\}\/_bmad\/(core|bmm|bmb)\/workflows\/(?:\d-[^/]+\/)?([^/\s'"]+)\/([^/\s'"]+\.(md|csv|yaml|xml))/g,
-    `${relativePrefix}/$1/$2/$3`
-  );
-
-  // Rewrite step file references within workflows
-  // {project-root}/_bmad/*/workflows/*/steps/{file} -> ../../{module}/{name}/steps/{file}
-  result = result.replace(
-    /\{project-root\}\/_bmad\/(core|bmm|bmb)\/workflows\/(?:\d-[^/]+\/)?([^/\s'"]+)\/steps\/([^/\s'"]+)/g,
-    `${relativePrefix}/$1/$2/steps/$3`
-  );
-
-  // Rewrite bmb workflow step file references
-  // {project-root}/_bmad/bmb/workflows/{name}/steps-*/step-*.md -> ../../bmb/{name}/steps-*/{file}
-  result = result.replace(
-    /\{project-root\}\/_bmad\/bmb\/workflows\/([^/\s'"]+)\/(steps-[^/]+)\/([^/\s'"]+)/g,
-    `${relativePrefix}/bmb/$1/$2/$3`
-  );
-
-  // Rewrite directory references (without workflow.* at end)
-  // {project-root}/_bmad/bmm/workflows/{category}/{name} -> ../../bmm/{name}
-  result = result.replace(
-    /\{project-root\}\/_bmad\/bmm\/workflows\/\d-[^/]+\/([^/\s'"]+)(?=['\s`])/g,
-    `${relativePrefix}/bmm/$1`
-  );
-
-  // {project-root}/_bmad/bmm/workflows/{name} (without trailing /) -> ../../bmm/{name}
-  result = result.replace(
-    /\{project-root\}\/_bmad\/bmm\/workflows\/([a-z][-a-z0-9]+)(?=['\s`])/g,
-    `${relativePrefix}/bmm/$1`
-  );
-
-  // Rewrite bmad-quick-flow directory references
-  result = result.replace(
-    /\{project-root\}\/_bmad\/bmm\/workflows\/bmad-quick-flow\/([^/\s'"]+)(?=['\s`])/g,
-    `${relativePrefix}/bmm/$1`
-  );
-
-  // Rewrite testarch directory references
-  result = result.replace(
-    /\{project-root\}\/_bmad\/bmm\/workflows\/testarch\/([^/\s'"]+)(?=['\s`])/g,
-    `${relativePrefix}/bmm/testarch-$1`
-  );
-
-  // Rewrite workflow-status directory references
-  result = result.replace(
-    /\{project-root\}\/_bmad\/bmm\/workflows\/workflow-status(?=['\s`/])/g,
-    `${relativePrefix}/bmm/workflow-status`
-  );
-
-  // Rewrite config.yaml references (module-level config)
-  // {project-root}/_bmad/{module}/config.yaml -> {skill-root}/{module}/config.yaml
-  result = result.replace(
-    /\{project-root\}\/_bmad\/(bmm|bmb|core)\/config\.yaml/g,
-    '{skill-root}/$1/config.yaml'
-  );
-
-  // Rewrite agent manifest references
-  result = result.replace(
-    /\{project-root\}\/_bmad\/_config\/agent-manifest\.csv/g,
-    '{skill-root}/agent-manifest.csv'
-  );
-
-  // Rewrite testarch tea-index.csv references
-  result = result.replace(
-    /\{project-root\}\/_bmad\/bmm\/testarch\/tea-index\.csv/g,
-    `${relativePrefix}/bmm/tea/tea-index.csv`
-  );
-
-  // Rewrite documentation-standards.md references (migrated to tech-writer/data)
-  // {project-root}/_bmad/bmm/data/documentation-standards.md -> ../../bmm/tech-writer/data/documentation-standards.md
-  // But wait, if we are IN tech-writer, it should be ./data/documentation-standards.md
-  // The relativePrefix logic handles ../.. but we might prefer a direct replacement here
-  // since it's a specific file.
-  // Let's rely on the generic ../..bmm/tech-writer/data approach which works from anywhere.
-  result = result.replace(
-    /\{project-root\}\/_bmad\/bmm\/data\/documentation-standards\.md/g,
-    `${relativePrefix}/bmm/tech-writer/data/documentation-standards.md`
-  );
-
-  // Rewrite _memory sidecar references (these are runtime, mark as placeholder)
-  result = result.replace(
-    /\{project-root\}\/_bmad\/_memory\/([^/\s'"]+)/g,
-    '{runtime-memory}/$1'
-  );
-
-  // Rewrite bmb-creations references (these are output folders)
-  result = result.replace(
-    /\{project-root\}\/_bmad\/bmb-creations/g,
-    '{output-folder}/bmb-creations'
-  );
-
-  // Rewrite core tasks file references (specific XML files)
-  result = result.replace(
-    /\{project-root\}\/_bmad\/core\/tasks\/([^/\s'"]+\\.xml)/g,
-    `${relativePrefix}/core/tasks/$1`
-  );
-
-  // Rewrite tasks references (bmm/tasks/*, bmb/tasks/*)
-  result = result.replace(
-    /\{project-root\}\/_bmad\/(bmm|bmb|core)\/tasks\/([^/\s'"]+)/g,
-    `${relativePrefix}/$1/tasks/$2`
-  );
-
-  // Rewrite _data references (project data files)
-  result = result.replace(
-    /\{project-root\}\/_data\/([^/\s'"]+)/g,
-    '{project-data}/$1'
-  );
-
-  // Rewrite src/modules references (raw source paths)
-  result = result.replace(
-    /\{project-root\}\/src\/modules\/(bmm|bmb|core)\/workflows\/(?:\d-[^/]+\/)?([^/\s'"]+)/g,
-    `${relativePrefix}/$1/$2`
-  );
-
-  // Rewrite src/modules agent step references
-  result = result.replace(
-    /\{project-root\}\/src\/modules\/bmb\/workflows\/([^/\s'"]+)\/(steps-[^/]+)\/([^/\s'"]+)/g,
-    `${relativePrefix}/bmb/$1/$2/$3`
-  );
-
-  // Rewrite cis workflow references (if any)
-  result = result.replace(
-    /\{project-root\}\/_bmad\/cis\/workflows\/([^/\s'"]+)\/workflow\.(yaml|md|xml)/g,
-    `${relativePrefix}/cis/$1/SKILL.md`
-  );
-
-  // Generic fallback: Any remaining {project-root}/_bmad/{module}/workflows/{name}
-  result = result.replace(
-    /\{project-root\}\/_bmad\/(bmm|bmb|core|cis)\/workflows\/([a-z][-a-z0-9]+)/g,
-    `${relativePrefix}/$1/$2`
-  );
-
-  // === Template Placeholder Patterns ===
-  // These handle paths with template variables like {module}, {module-code}, [module], etc.
-
-  // Handle {project-root}/_bmad/{module-code}/workflows/...
-  result = result.replace(
-    /\{project-root\}\/_bmad\/\{module-code\}\/workflows\//g,
-    `${relativePrefix}/{module-code}/`
-  );
-
-  // Handle {project-root}/_bmad/{module-id}/workflows/...
-  result = result.replace(
-    /\{project-root\}\/_bmad\/\{module-id\}\/workflows\//g,
-    `${relativePrefix}/{module-id}/`
-  );
-
-  // Handle {project-root}/_bmad/{module}/... (generic module placeholder)
-  result = result.replace(
-    /\{project-root\}\/_bmad\/\{module\}\//g,
-    `${relativePrefix}/{module}/`
-  );
-
-  // Handle {project-root}/_bmad/{module_code}/workflows/...
-  result = result.replace(
-    /\{project-root\}\/_bmad\/\{module_code\}\/workflows\//g,
-    `${relativePrefix}/{module_code}/`
-  );
-
-  // Handle {project-root}/_bmad/[module]/... (bracket notation)
-  result = result.replace(
-    /\{project-root\}\/_bmad\/\[module\]\//g,
-    `${relativePrefix}/[module]/`
-  );
-
-  // Handle {project-root}/_bmad/[module-path]/workflows/...
-  result = result.replace(
-    /\{project-root\}\/_bmad\/\[module-path\]\/workflows\//g,
-    `${relativePrefix}/[module-path]/`
-  );
-
-  // Handle {project-root}/_bmad/[MODULE FOLDER]/...
-  result = result.replace(
-    /\{project-root\}\/_bmad\/\[MODULE FOLDER\]\//g,
-    `${relativePrefix}/[MODULE FOLDER]/`
-  );
-
-  // Handle {project-root}/.../ ellipsis patterns (documentation examples)
-  result = result.replace(
-    /\{project-root\}\/\.\.\.\/([^/\s'"]+)\/workflow\.(yaml|md|xml)/g,
-    `${relativePrefix}/.../$1/SKILL.md`
-  );
-
-  // Handle {project-root}/_bmad/core/workflows/{workflow-name}/...
-  result = result.replace(
-    /\{project-root\}\/_bmad\/core\/workflows\/\{workflow-name\}\//g,
-    `${relativePrefix}/core/{workflow-name}/`
-  );
-
   return result;
 }
 

package/src/utils/skill-writer.js

@@ -50,7 +50,8 @@ export async function writeSkill(
     const rewrittenContent = rewriteBmadPaths(
       skillContent,
       options.skillMap,
-      options.pathPatterns
+      options.pathPatterns,
+      options.skillMapOptions
     );
 
     // Write SKILL.md
@@ -64,7 +65,8 @@ export async function writeSkill(
           skillDir,
           module,
           options.skillMap,
-          options.pathPatterns
+          options.pathPatterns,
+          options.skillMapOptions
         );
       } catch (copyError) {
         console.warn(
@@ -95,7 +97,8 @@ async function copyDirectoryWithPathRewrite(
   destDir,
   module,
   skillMap,
-  pathPatterns
+  pathPatterns,
+  skillMapOptions
 ) {
   const entries = await fs.readdir(srcDir, { withFileTypes: true });
 
@@ -130,7 +133,8 @@ async function copyDirectoryWithPathRewrite(
         destPath,
         module,
         skillMap,
-        pathPatterns
+        pathPatterns,
+        skillMapOptions
       );
     } else if (shouldRewritePaths(entry.name)) {
       // Read, rewrite paths, and write text files
@@ -138,7 +142,8 @@ async function copyDirectoryWithPathRewrite(
       const rewrittenContent = rewriteBmadPaths(
         content,
         skillMap,
-        pathPatterns
+        pathPatterns,
+        skillMapOptions
       );
       await fs.writeFile(destPath, rewrittenContent, 'utf-8');
     } else {