bmad-method 6.10.1-next.26 → 6.10.1-next.28

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-method",
-  "version": "6.10.1-next.26",
+  "version": "6.10.1-next.28",
   "description": "Breakthrough Method of Agile AI-driven Development",
   "keywords": [
     "agile",

package/src/bmm-skills/4-implementation/bmad-code-review/customize.toml

@@ -50,39 +50,48 @@ on_complete = ""
 id = "blind-hunter"
 name = "Blind Hunter"
 instruction = """
-Read `{skill-root}/review-prompts/adversarial.md` fully and replace its
-`{review_content}` placeholder with the following diff:
+Launch a context-free subagent with this prompt:
+
+Read `{skill-root}/review-prompts/adversarial.md` completely and follow it as your review instructions.
+
+Review content:
 
 {diff_output}
 
-Launch a subagent with no prior conversation context using the entire rendered
-prompt directly.
+Do not invoke any skill. If the instruction file is unreadable, report that exact failure and stop. Return only the review result.
+
 """
 
 [[workflow.review_layers]]
 id = "edge-case-hunter"
 name = "Edge Case Hunter"
 instruction = """
-Read `{skill-root}/review-prompts/edge-case-hunter.md` fully and replace its
-`{review_content}` placeholder with the following diff:
+Launch a context-free subagent with this prompt:
+
+Read `{skill-root}/review-prompts/edge-case-hunter.md` completely and follow it as your review instructions.
+
+Review content:
 
 {diff_output}
 
-Launch a subagent with no prior conversation context using the entire rendered
-prompt directly.
+Do not invoke any skill. If the instruction file is unreadable, report that exact failure and stop. Return only the review result.
+
 """
 
 [[workflow.review_layers]]
 id = "verification-gap"
 name = "Verification Gap Reviewer"
 instruction = """
-Read `{skill-root}/review-prompts/verification-gap.md` fully and replace its
-`{review_content}` placeholder with the following diff:
+Launch a context-free subagent with this prompt:
+
+Read `{skill-root}/review-prompts/verification-gap.md` completely and follow it as your review instructions.
+
+Review content:
 
 {diff_output}
 
-Launch a subagent with no prior conversation context using the entire rendered
-prompt directly.
+Do not invoke any skill. If the instruction file is unreadable, report that exact failure and stop. Return only the review result.
+
 """
 
 [[workflow.review_layers]]
@@ -90,10 +99,11 @@ id = "acceptance-auditor"
 name = "Acceptance Auditor"
 when = 'Only when {review_mode} = "full".'
 instruction = """
-Launch a subagent with no prior conversation context, with this prompt:
+Launch a subagent with this prompt:
 
-> You are an Acceptance Auditor. Review the provided diff against `{spec_file}` and any loaded context docs. Check for: violations of acceptance criteria, deviations from spec intent, missing implementation of specified behavior, contradictions between spec constraints and actual code. Output findings as a Markdown list. Each finding: one-line title, which AC/constraint it violates, and evidence from the diff.
->
-> Diff:
-> {diff_output}
+You are an Acceptance Auditor. Review the provided diff against `{spec_file}` and any loaded context docs. Check for: violations of acceptance criteria, deviations from spec intent, missing implementation of specified behavior, contradictions between spec constraints and actual code. Output findings as a Markdown list. Each finding: one-line title, which AC/constraint it violates, and evidence from the diff.
+
+Diff:
+
+{diff_output}
 """

package/src/bmm-skills/4-implementation/bmad-code-review/review-prompts/adversarial.md

@@ -13,7 +13,7 @@
 
 ### Step 1: Receive Content
 
-- Load the content to review from provided input or context
+- Load the content to review from the parent message that launched you (not from this instruction file)
 - If content to review is empty, ask for clarification and abort
 - Identify content type (diff, branch, uncommitted changes, document, etc.)
 
@@ -30,8 +30,7 @@ Output findings as a Markdown list: descriptions only, no severity, priority, or
 
 - HALT if zero findings — this is suspicious, re-analyze or ask for guidance
 - HALT if content is empty or unreadable
-## PROVIDED INPUTS
 
-**content:**
+## CONTENT SOURCE
 
-{review_content}
+Load the review target from the parent message, or from a trailing `## REVIEW TARGET` section if present (offline fallback). This file has no `{review_content}` slot. If neither supplies content, treat content as empty and follow the empty-content halt rules above.

package/src/bmm-skills/4-implementation/bmad-code-review/review-prompts/edge-case-hunter.md

@@ -19,7 +19,7 @@ A brief secondary deletion check runs as Step 4 when the diff removes code.
 
 ### Step 1: Receive Content
 
-- Load the content to review strictly from provided input
+- Load the content to review strictly from the parent message that launched you (not from this instruction file)
 - If content is empty, or cannot be decoded as text, return `[{"location":"N/A","trigger_condition":"Input empty or undecodable","guard_snippet":"Provide valid content to review","potential_consequence":"Review skipped — no analysis performed"}]` and stop
 - Identify content type (diff, full file, or function) to determine scope rules
 
@@ -83,8 +83,6 @@ For a deletion finding the standard fields read as: `location` = the removed ite
 Add nothing if nothing qualifies.
 </reference>
 
-## PROVIDED INPUTS
+## CONTENT SOURCE
 
-**content:**
-
-{review_content}
+Load the review target from the parent message, or from a trailing `## REVIEW TARGET` section if present (offline fallback). This file has no `{review_content}` slot. If neither supplies content, treat content as empty and follow the empty-content halt rules above.

package/src/bmm-skills/4-implementation/bmad-code-review/review-prompts/verification-gap.md

@@ -99,8 +99,7 @@ If you noticed genuine non-gap problems while tracing verification, append:
 When you find no verification gaps and no other findings, output exactly this single line, not an empty response:
 
 `No verification gaps found.`
-## PROVIDED INPUTS
 
-**content:**
+## CONTENT SOURCE
 
-{review_content}
+Load the change set from the parent message, or from a trailing `## REVIEW TARGET` section if present (offline fallback). This file has no `{review_content}` slot. If neither supplies a change set, stop with exactly: `No verification gaps found.`

package/src/bmm-skills/4-implementation/bmad-code-review/steps/step-02-review.md

@@ -21,7 +21,7 @@ failed_layers: '' # set at runtime: comma-separated list of layers that failed o
 
    If no layer is active, HALT with status `blocked` and blocking condition `no active review layers`.
 
-3. Execute all active layers in parallel wherever their execution methods allow: substitute the runtime placeholders (`{diff_output}`, `{spec_file}`) into each layer's `instruction`, then follow it verbatim. If a layer's instruction requires subagents and subagents are not available, generate prompt files in `{implementation_artifacts}` for each such layer and HALT. Ask the user to run each in a separate session (ideally a different LLM) and paste back the findings. When findings are pasted, treat them as those layers' findings and resume from this point.
+3. Execute all active layers in parallel wherever their execution methods allow: expand `{skill-root}` in each layer's `instruction` to this skill's absolute installed directory, then substitute the runtime placeholders (`{diff_output}`, `{spec_file}`). For an instruction that launches a reviewer subagent, launch that child with the prompt text after placeholder substitution; do not load the reviewer instruction file yourself. For any other customized instruction, execute it as written. Do not leave `{skill-root}` unresolved in a child prompt. If a layer's instruction requires subagents and subagents are not available, for each such layer read its reviewer instruction file, write a self-contained prompt under `{implementation_artifacts}` (full instruction body + `## REVIEW TARGET` with the review content — not a path-only pointer), then HALT. Ask the user to run each in a separate session (ideally a different LLM) and paste back the findings. When findings are pasted, treat them as those layers' findings and resume from this point. This is the only allowed parent-side read of a reviewer instruction file.
 
 4. **Layer failure handling**: If any layer fails, times out, or returns empty results, append the layer's `name` to `{failed_layers}` (comma-separated) and proceed with findings from the remaining layers.
 

package/src/bmm-skills/4-implementation/bmad-dev-auto/customize.toml

@@ -55,54 +55,63 @@ Launch a subagent with no prior conversation context, with this prompt:
 id = "blind-hunter"
 name = "Blind Hunter"
 instruction = """
-Read `{skill-root}/review-prompts/adversarial.md` fully and replace its
-`{review_content}` placeholder with the following diff:
+Launch a context-free subagent with this prompt:
+
+Read `{skill-root}/review-prompts/adversarial.md` completely and follow it as your review instructions.
+
+Review content:
 
 {diff_output}
 
-Launch a subagent with no prior conversation context using the entire rendered
-prompt directly.
+Do not invoke any skill. If the instruction file is unreadable, report that exact failure and stop. Return only the review result.
+
 """
 
 [[workflow.review_layers]]
 id = "edge-case-hunter"
 name = "Edge Case Hunter"
 instruction = """
-Read `{skill-root}/review-prompts/edge-case-hunter.md` fully and replace its
-`{review_content}` placeholder with the following diff:
+Launch a context-free subagent with this prompt:
+
+Read `{skill-root}/review-prompts/edge-case-hunter.md` completely and follow it as your review instructions.
+
+Review content:
 
 {diff_output}
 
-Launch a subagent with no prior conversation context using the entire rendered
-prompt directly.
+Do not invoke any skill. If the instruction file is unreadable, report that exact failure and stop. Return only the review result.
+
 """
 
 [[workflow.review_layers]]
 id = "verification-gap"
 name = "Verification Gap Reviewer"
 instruction = """
-Read `{skill-root}/review-prompts/verification-gap.md` fully and replace its
-`{review_content}` placeholder with the following diff:
+Launch a context-free subagent with this prompt:
+
+Read `{skill-root}/review-prompts/verification-gap.md` completely and follow it as your review instructions.
+
+Review content:
 
 {diff_output}
 
-Launch a subagent with no prior conversation context using the entire rendered
-prompt directly.
+Do not invoke any skill. If the instruction file is unreadable, report that exact failure and stop. Return only the review result.
+
 """
 
 [[workflow.review_layers]]
 id = "intent-alignment"
 name = "Intent Alignment Auditor"
 instruction = """
-Launch a subagent with no prior conversation context, with this prompt:
+Launch a subagent with this prompt:
 
-> You are an intent-alignment auditor. You have no other context about how this change was produced. Here is the verbatim intent this work started from:
->
-> {verbatim_intent}
->
-> Here is the diff:
->
-> {diff_output}
->
-> Your task is strictly descriptive — do not prescribe additional work. Report: (1) the defensible readings of the intent, enumerated; (2) which reading this diff implements; (3) where the readings and the diff diverge — specifically, which surface the intent's expectations live at versus which surface the diff's changes and its tests exercise.
+You are an intent-alignment auditor. You have no other context about how this change was produced. Here is the verbatim intent this work started from:
+
+{verbatim_intent}
+
+Here is the diff:
+
+{diff_output}
+
+Your task is strictly descriptive — do not prescribe additional work. Report: (1) the defensible readings of the intent, enumerated; (2) which reading this diff implements; (3) where the readings and the diff diverge — specifically, which surface the intent's expectations live at versus which surface the diff's changes and its tests exercise.
 """

package/src/bmm-skills/4-implementation/bmad-dev-auto/review-prompts/adversarial.md

@@ -13,7 +13,7 @@
 
 ### Step 1: Receive Content
 
-- Load the content to review from provided input or context
+- Load the content to review from the parent message that launched you (not from this instruction file)
 - If content to review is empty, ask for clarification and abort
 - Identify content type (diff, branch, uncommitted changes, document, etc.)
 
@@ -30,8 +30,7 @@ Output findings as a Markdown list: descriptions only, no severity, priority, or
 
 - HALT if zero findings — this is suspicious, re-analyze or ask for guidance
 - HALT if content is empty or unreadable
-## PROVIDED INPUTS
 
-**content:**
+## CONTENT SOURCE
 
-{review_content}
+Load the review target from the parent message, or from a trailing `## REVIEW TARGET` section if present (offline fallback). This file has no `{review_content}` slot. If neither supplies content, treat content as empty and follow the empty-content halt rules above.

package/src/bmm-skills/4-implementation/bmad-dev-auto/review-prompts/edge-case-hunter.md

@@ -19,7 +19,7 @@ A brief secondary deletion check runs as Step 4 when the diff removes code.
 
 ### Step 1: Receive Content
 
-- Load the content to review strictly from provided input
+- Load the content to review strictly from the parent message that launched you (not from this instruction file)
 - If content is empty, or cannot be decoded as text, return `[{"location":"N/A","trigger_condition":"Input empty or undecodable","guard_snippet":"Provide valid content to review","potential_consequence":"Review skipped — no analysis performed"}]` and stop
 - Identify content type (diff, full file, or function) to determine scope rules
 
@@ -83,8 +83,6 @@ For a deletion finding the standard fields read as: `location` = the removed ite
 Add nothing if nothing qualifies.
 </reference>
 
-## PROVIDED INPUTS
+## CONTENT SOURCE
 
-**content:**
-
-{review_content}
+Load the review target from the parent message, or from a trailing `## REVIEW TARGET` section if present (offline fallback). This file has no `{review_content}` slot. If neither supplies content, treat content as empty and follow the empty-content halt rules above.

package/src/bmm-skills/4-implementation/bmad-dev-auto/review-prompts/verification-gap.md

@@ -99,8 +99,7 @@ If you noticed genuine non-gap problems while tracing verification, append:
 When you find no verification gaps and no other findings, output exactly this single line, not an empty response:
 
 `No verification gaps found.`
-## PROVIDED INPUTS
 
-**content:**
+## CONTENT SOURCE
 
-{review_content}
+Load the change set from the parent message, or from a trailing `## REVIEW TARGET` section if present (offline fallback). This file has no `{review_content}` slot. If neither supplies a change set, stop with exactly: `No verification gaps found.`

package/src/bmm-skills/4-implementation/bmad-dev-auto/step-04-review.md

@@ -18,9 +18,9 @@ Do NOT `git add` anything — this is read-only inspection.
 
 ### Review
 
-Runtime placeholders: `{diff_output}` is the diff constructed above. `{verbatim_intent}` is the invocation intent exactly as this run received it at step-01; if the run started from an existing spec file rather than a fresh intent, it is the spec's `<intent-contract>` block instead.
+Runtime placeholders: `{diff_output}` is the diff constructed above. `{verbatim_intent}` is the invocation intent exactly as this run received it at step-01; if the run started from an existing spec file rather than a fresh intent, it is the spec's `<intent-contract>` block instead. Before launching a layer, expand its skill-root placeholder to this skill's absolute installed directory; never leave that placeholder unresolved in a child prompt.
 
-Execute these review layers in parallel wherever their execution methods allow: substitute the runtime placeholders (e.g. `{diff_output}`) into each layer's instruction, then follow it verbatim. Parallel means several blocking calls awaited together in this turn — never backgrounded or detached, never ending the turn to await results (see workflow.md → Subagents). Spawn every reviewer subagent before reading or reacting to any of their output; begin collection and triage only once all are launched.
+Execute these review layers in parallel wherever their execution methods allow: substitute the runtime placeholders (e.g. `{diff_output}`) into each layer's instruction. When an instruction launches a reviewer subagent, launch that child with the prompt text after placeholder substitution; do not load the reviewer instruction file yourself. For any other customized instruction, execute it as written. Parallel means several blocking calls awaited together in this turn — never backgrounded or detached, never ending the turn to await results (see workflow.md → Subagents). Spawn every reviewer subagent before reading or reacting to any of their output; begin collection and triage only once all are launched.
 
 {workflow.review_layers}
 

package/src/bmm-skills/4-implementation/bmad-quick-dev/customize.toml

@@ -55,39 +55,48 @@ Launch a subagent with no prior conversation context, with this prompt:
 id = "blind-hunter"
 name = "Blind Hunter"
 instruction = """
-Read `{skill-root}/review-prompts/adversarial.md` fully and replace its
-`{review_content}` placeholder with the following diff:
+Launch a context-free subagent with this prompt:
+
+Read `{skill-root}/review-prompts/adversarial.md` completely and follow it as your review instructions.
+
+Review content:
 
 {diff_output}
 
-Launch a subagent with no prior conversation context using the entire rendered
-prompt directly.
+Do not invoke any skill. If the instruction file is unreadable, report that exact failure and stop. Return only the review result.
+
 """
 
 [[workflow.review_layers]]
 id = "edge-case-hunter"
 name = "Edge Case Hunter"
 instruction = """
-Read `{skill-root}/review-prompts/edge-case-hunter.md` fully and replace its
-`{review_content}` placeholder with the following diff:
+Launch a context-free subagent with this prompt:
+
+Read `{skill-root}/review-prompts/edge-case-hunter.md` completely and follow it as your review instructions.
+
+Review content:
 
 {diff_output}
 
-Launch a subagent with no prior conversation context using the entire rendered
-prompt directly.
+Do not invoke any skill. If the instruction file is unreadable, report that exact failure and stop. Return only the review result.
+
 """
 
 [[workflow.review_layers]]
 id = "verification-gap"
 name = "Verification Gap Reviewer"
 instruction = """
-Read `{skill-root}/review-prompts/verification-gap.md` fully and replace its
-`{review_content}` placeholder with the following diff:
+Launch a context-free subagent with this prompt:
+
+Read `{skill-root}/review-prompts/verification-gap.md` completely and follow it as your review instructions.
+
+Review content:
 
 {diff_output}
 
-Launch a subagent with no prior conversation context using the entire rendered
-prompt directly.
+Do not invoke any skill. If the instruction file is unreadable, report that exact failure and stop. Return only the review result.
+
 """
 
 # Review layers for the one-shot route.
@@ -96,11 +105,12 @@ prompt directly.
 id = "blind-hunter"
 name = "Blind Hunter"
 instruction = """
-Read `{skill-root}/review-prompts/adversarial.md` fully and replace its
-`{review_content}` placeholder with this review target:
+Launch a context-free subagent with this prompt:
+
+Read `{skill-root}/review-prompts/adversarial.md` completely and follow it as your review instructions.
+
+Review content: the changed files in the current worktree. Inspect them directly before reviewing.
 
-The changed files in the current worktree. Inspect them directly before reviewing.
+Do not invoke any skill. If the instruction file is unreadable, report that exact failure and stop. Return only the review result.
 
-Launch a subagent with no prior conversation context using the entire rendered
-prompt directly.
 """

package/src/bmm-skills/4-implementation/bmad-quick-dev/render.py

@@ -21,8 +21,10 @@ Customization: three-layer merge of {skill}/customize.toml +
 _bmad/custom/bmad-quick-dev.toml + .user.toml (same structural rules as
 resolve_customization.py). The resolved [workflow] values fill {workflow.*}
 placeholders, so this skill needs no runtime resolve_customization.py call.
-Other single-curly placeholders ({project-root}, {spec_file}, {skill-root},
-...) pass through untouched for the LLM to resolve during workflow execution.
+Other single-curly placeholders ({project-root}, {spec_file}, ...) pass
+through untouched for the LLM to resolve during workflow execution. The sole
+exception is {skill-root} in resolved review-layer instructions, which must be
+an absolute prompt-file path before those instructions reach the parent LLM.
 
 Every invocation rebuilds from scratch — no hash, no cache.
 Python 3.11+ stdlib only. UTF-8 I/O.
@@ -242,6 +244,34 @@ def _scalar_str(value):
 _REVIEW_LAYER_KEYS = ("review_layers", "oneshot_review_layers")
 
 
+def expand_review_layer_skill_roots(workflow, skill_root):
+    """Expand only {skill-root} inside resolved review-layer instructions.
+
+    Review layers originate in customization after regular template rendering,
+    so their prompt paths need this explicit pass. Runtime placeholders remain
+    untouched for the parent to supply to each child at dispatch time.
+    """
+    expanded_workflow = dict(workflow)
+    for key in _REVIEW_LAYER_KEYS:
+        layers = workflow.get(key)
+        if not isinstance(layers, list):
+            continue
+        expanded_layers = []
+        for layer in layers:
+            if not isinstance(layer, dict):
+                expanded_layers.append(layer)
+                continue
+            expanded_layer = dict(layer)
+            instruction = expanded_layer.get("instruction")
+            if isinstance(instruction, str):
+                expanded_layer["instruction"] = instruction.replace(
+                    "{skill-root}", skill_root
+                )
+            expanded_layers.append(expanded_layer)
+        expanded_workflow[key] = expanded_layers
+    return expanded_workflow
+
+
 def _render_review_layers(layers):
     """Materialize review layers into direct invocation blocks. A layer with an
     empty or missing instruction is disabled (that is how an override turns off
@@ -359,7 +389,9 @@ def main():
         )
         sys.exit(1)
 
-    workflow = resolve_workflow(root, script_dir.replace(os.sep, "/"), skill_name)
+    skill_dir = script_dir.replace(os.sep, "/")
+    workflow = resolve_workflow(root, skill_dir, skill_name)
+    workflow = expand_review_layer_skill_roots(workflow, skill_dir)
 
     out_dir = posixpath.join(root, "_bmad", "render", skill_name)
     os.makedirs(out_dir, exist_ok=True)

package/src/bmm-skills/4-implementation/bmad-quick-dev/review-prompts/adversarial.md

@@ -13,7 +13,7 @@
 
 ### Step 1: Receive Content
 
-- Load the content to review from provided input or context
+- Load the content to review from the parent message that launched you (not from this instruction file)
 - If content to review is empty, ask for clarification and abort
 - Identify content type (diff, branch, uncommitted changes, document, etc.)
 
@@ -30,8 +30,7 @@ Output findings as a Markdown list: descriptions only, no severity, priority, or
 
 - HALT if zero findings — this is suspicious, re-analyze or ask for guidance
 - HALT if content is empty or unreadable
-## PROVIDED INPUTS
 
-**content:**
+## CONTENT SOURCE
 
-{review_content}
+Load the review target from the parent message, or from a trailing `## REVIEW TARGET` section if present (offline fallback). This file has no `{review_content}` slot. If neither supplies content, treat content as empty and follow the empty-content halt rules above.

package/src/bmm-skills/4-implementation/bmad-quick-dev/review-prompts/edge-case-hunter.md

@@ -19,7 +19,7 @@ A brief secondary deletion check runs as Step 4 when the diff removes code.
 
 ### Step 1: Receive Content
 
-- Load the content to review strictly from provided input
+- Load the content to review strictly from the parent message that launched you (not from this instruction file)
 - If content is empty, or cannot be decoded as text, return `[{"location":"N/A","trigger_condition":"Input empty or undecodable","guard_snippet":"Provide valid content to review","potential_consequence":"Review skipped — no analysis performed"}]` and stop
 - Identify content type (diff, full file, or function) to determine scope rules
 
@@ -83,8 +83,6 @@ For a deletion finding the standard fields read as: `location` = the removed ite
 Add nothing if nothing qualifies.
 </reference>
 
-## PROVIDED INPUTS
+## CONTENT SOURCE
 
-**content:**
-
-{review_content}
+Load the review target from the parent message, or from a trailing `## REVIEW TARGET` section if present (offline fallback). This file has no `{review_content}` slot. If neither supplies content, treat content as empty and follow the empty-content halt rules above.

package/src/bmm-skills/4-implementation/bmad-quick-dev/review-prompts/verification-gap.md

@@ -99,8 +99,7 @@ If you noticed genuine non-gap problems while tracing verification, append:
 When you find no verification gaps and no other findings, output exactly this single line, not an empty response:
 
 `No verification gaps found.`
-## PROVIDED INPUTS
 
-**content:**
+## CONTENT SOURCE
 
-{review_content}
+Load the change set from the parent message, or from a trailing `## REVIEW TARGET` section if present (offline fallback). This file has no `{review_content}` slot. If neither supplies a change set, stop with exactly: `No verification gaps found.`

package/src/bmm-skills/4-implementation/bmad-quick-dev/step-04-review.md

@@ -18,11 +18,11 @@ Do NOT `git add` anything — this is read-only inspection.
 
 ### Review
 
-Execute these review layers in parallel wherever their execution methods allow: substitute the runtime placeholders (e.g. `{diff_output}`) into each layer's instruction, then follow it verbatim. Parallel means several blocking calls awaited together in this turn — never backgrounded or detached, never ending the turn to await results. When running layers as subagents, spawn every reviewer before reading or reacting to any of their output; begin collection and triage only once all are launched.
+Execute these review layers in parallel wherever their execution methods allow: substitute the runtime placeholders (e.g. `{diff_output}`) into each layer's instruction. When an instruction launches a reviewer subagent, launch that child with the prompt text after placeholder substitution; do not load the reviewer instruction file yourself. For any other customized instruction, execute it as written. Parallel means several blocking calls awaited together in this turn — never backgrounded or detached, never ending the turn to await results. When running layers as subagents, spawn every reviewer before reading or reacting to any of their output; begin collection and triage only once all are launched.
 
 {workflow.review_layers}
 
-If a layer's instruction requires subagents and none are available, generate one review prompt file per such layer in `{{.implementation_artifacts}}` and HALT. Ask the human to run each in a separate session (ideally a different LLM) and paste back the findings.
+If a layer's instruction requires subagents and none are available, for each such layer read its reviewer instruction file, write a self-contained prompt under `{{.implementation_artifacts}}` (full instruction body + `## REVIEW TARGET` with the review content — not a path-only pointer), then HALT. Ask the human to run each in a separate session (ideally a different LLM) and paste back the findings. This is the only allowed parent-side read of a reviewer instruction file.
 
 ### Classify
 

package/src/bmm-skills/4-implementation/bmad-quick-dev/step-oneshot.md

@@ -17,11 +17,11 @@ Implement the clarified intent directly.
 
 ### Review
 
-Execute these review layers in parallel wherever their execution methods allow, following each layer's instruction verbatim after substituting any runtime placeholders:
+Execute these review layers in parallel wherever their execution methods allow. After substituting runtime placeholders, when an instruction launches a reviewer subagent, launch that child with the prompt text; do not load the reviewer instruction file yourself. For any other customized instruction, execute it as written:
 
 {workflow.oneshot_review_layers}
 
-If a layer's instruction requires subagents and none are available, generate one review prompt file per such layer in `{{.implementation_artifacts}}` and HALT. Ask the human to run each in a separate session and paste back the findings.
+If a layer's instruction requires subagents and none are available, for each such layer read its reviewer instruction file, write a self-contained prompt under `{{.implementation_artifacts}}` (full instruction body + `## REVIEW TARGET` with the review content — not a path-only pointer), then HALT. Ask the human to run each in a separate session and paste back the findings. This is the only allowed parent-side read of a reviewer instruction file.
 
 ### Classify
 

package/src/bmm-skills/v6-shims/README.md

@@ -1,12 +1,13 @@
 # v6 Deprecation Shims
 
-Skills in this folder are forwarders kept for backward compatibility with v6 skill IDs.
-Each one holds no logic of its own — it forwards to the skill that replaced it, passing a
-stated intent and pre-resolved customization fields so the target skips its own intent
-inference.
+Skills in this folder are deprecated skills kept for backward compatibility with v6 skill IDs.
+Some retain their full workflow, while others forward to the skill that replaced them, passing a
+stated intent and pre-resolved customization fields so the target skips its own intent inference.
 
 | Shim                       | Forwards to                          |
 | -------------------------- | ------------------------------------ |
+| `bmad-create-story`        | Retained in full                     |
+| `bmad-dev-story`           | Retained in full                     |
 | `bmad-create-prd`          | `bmad-prd` (create intent)           |
 | `bmad-edit-prd`            | `bmad-prd` (update intent)           |
 | `bmad-validate-prd`        | `bmad-prd` (validate intent)         |

package/src/bmm-skills/{4-implementation → v6-shims}/bmad-create-story/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: bmad-create-story
-description: 'Creates a dedicated story file with all the context the agent will need to implement it later. Use when the user says "create the next story" or "create story [story identifier]"'
+description: "Deprecated: `bmad-quick-dev` is now the official implementation method. Only use this when explicitly invoked by name."
 ---
 
 # Create Story Workflow
@@ -62,6 +62,8 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
 
 Greet `{user_name}`, speaking in `{communication_language}`.
 
+<output>Deprecated: `bmad-quick-dev` is now the official implementation method. Only use this when explicitly invoked by name.</output>
+
 ### Step 6: Execute Append Steps
 
 Execute each entry in `{workflow.activation_steps_append}` in order.

package/src/bmm-skills/{4-implementation → v6-shims}/bmad-dev-story/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: bmad-dev-story
-description: 'Execute story implementation following a context filled story spec file. Use when the user says "dev this story [story file]" or "implement the next story in the sprint plan"'
+description: "Deprecated: `bmad-quick-dev` is now the official implementation method. Only use this when explicitly invoked by name."
 ---
 
 # Dev Story Workflow
@@ -60,6 +60,8 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
 
 Greet `{user_name}`, speaking in `{communication_language}`.
 
+<output>Deprecated: `bmad-quick-dev` is now the official implementation method. Only use this when explicitly invoked by name.</output>
+
 ### Step 6: Execute Append Steps
 
 Execute each entry in `{workflow.activation_steps_append}` in order.

package/tools/validate-published-implementation-model.mjs

@@ -0,0 +1,65 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+const CANONICAL_LLMS_ENTRY = '**[Quick Dev]';
+const CANONICAL_LLMS_DESCRIPTION = 'Canonical implementation workflow for direct intent and fully planned work';
+
+const FORBIDDEN_TERMS = [
+  /\bbmad-(?:create|dev)-story\b/gi,
+  /\b(?:create-story|dev-story)\b/gi,
+  /\b(?:Create Story|Dev Story)\b/g,
+  /\b(?:createStory|devStory|create_story|dev_story)\b/g,
+  /\bquick[ -]?flow\b/gi,
+  /flux rapide|parcours parallèle/gi,
+  /paralelní cesta/gi,
+  /luồng nhanh|nhánh nhanh/gi,
+  /快速流程|并行快线/g,
+];
+
+export function validatePublishedImplementationModel(siteDir) {
+  const findings = findObsoleteImplementationTerms(siteDir);
+  if (findings.length > 0) {
+    const details = findings.map(({ file, line, match }) => `${file}:${line}: ${match}`).join('\n  ');
+    throw new Error(`Obsolete implementation terminology found in deployable documentation:\n  ${details}`);
+  }
+
+  const llmsPath = path.join(siteDir, 'llms.txt');
+  const llmsContent = fs.readFileSync(llmsPath, 'utf-8');
+  if (!llmsContent.includes(CANONICAL_LLMS_ENTRY) || !llmsContent.includes(CANONICAL_LLMS_DESCRIPTION)) {
+    throw new Error('llms.txt must describe Quick Dev as canonical for both direct intent and fully planned work');
+  }
+}
+
+export function findObsoleteImplementationTerms(siteDir) {
+  const findings = [];
+
+  for (const filePath of getPublishedTextFiles(siteDir)) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    for (const pattern of FORBIDDEN_TERMS) {
+      for (const match of content.matchAll(pattern)) {
+        findings.push({
+          file: path.relative(siteDir, filePath),
+          line: content.slice(0, match.index).split('\n').length,
+          match: match[0],
+        });
+      }
+    }
+  }
+
+  return findings;
+}
+
+function getPublishedTextFiles(dir) {
+  const files = [];
+
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...getPublishedTextFiles(fullPath));
+    } else if (/\.(?:html|txt|xml|json|svg)$/i.test(entry.name)) {
+      files.push(fullPath);
+    }
+  }
+
+  return files;
+}