From 098c96740c191a3e01433409cf962ac66ae2b60c Mon Sep 17 00:00:00 2001 From: Alex Verkhovsky Date: Sun, 15 Mar 2026 10:38:43 -0600 Subject: [PATCH 01/11] =?UTF-8?q?fix(skills):=20validation=20pass=202=20?= =?UTF-8?q?=E2=80=94=20fix=20path,=20variable,=20and=20sequence=20issues?= =?UTF-8?q?=20across=2032=20files?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Run skill-validator against all 36 skills on HEAD (42b1d0f6). Fixes: - PATH-01: relative path corrections in product-brief-preview, brainstorming, distillator, generate-project-context, edit-prd, quick-dev-new-preview - PATH-04: remove 5 intra-skill path variables from edit-prd - REF-01: single-curly template vars → double-curly in create-architecture, create-epics-and-stories, create-story - REF-02: fix dangling file refs in advanced-elicitation, validate-prd, edit-prd - REF-03: update rule to prefer natural language `Invoke the skill` form; fix stale persona ref in qa-generate-e2e-tests - SEQ-01: "skip to" → "proceed to" in quick-dev-new-preview - SEQ-02: remove time estimates from document-project, quick-spec - SKILL-06: add "Use when" trigger to review-edge-case-hunter - STEP numbering: renumber step n="0.5" to integer sequence in retrospective Also updates REF-03 rule in tools/skill-validator.md to clarify that natural language invocation is canonical — no skill: prefix required. Co-Authored-By: Claude Opus 4.6 (1M context) --- .../bmad-product-brief-preview/SKILL.md | 4 +-- .../prompts/contextual-discovery.md | 14 +++++----- .../prompts/draft-and-review.md | 10 +++---- .../prompts/finalize.md | 2 +- .../prompts/guided-elicitation.md | 4 +-- .../steps-e/step-e-01-discovery.md | 5 ++-- .../steps-e/step-e-01b-legacy-conversion.md | 3 +-- .../bmad-edit-prd/steps-e/step-e-02-review.md | 5 ++-- .../bmad-edit-prd/steps-e/step-e-03-edit.md | 14 +++------- .../steps-e/step-e-04-complete.md | 2 +- .../bmad-edit-prd/workflow.md | 3 +-- .../steps-v/step-v-13-report-complete.md | 4 +-- .../steps/step-01-init.md | 12 ++++----- .../steps/step-01b-continue.md | 8 +++--- .../steps/step-02-context.md | 8 +++--- .../steps/step-03-create-stories.md | 16 ++++++------ .../bmad-create-story/workflow.md | 2 +- .../bmad-retrospective/workflow.md | 26 +++++++++---------- .../workflows/full-scan-instructions.md | 6 ++--- .../steps/step-01-discover.md | 2 +- .../bmad-qa-generate-e2e-tests/workflow.md | 2 +- .../steps/step-01-clarify-and-route.md | 4 +-- .../steps/step-04-review.md | 4 +-- .../steps/step-01-understand.md | 2 +- .../skills/bmad-advanced-elicitation/SKILL.md | 2 +- .../bmad-advanced-elicitation/workflow.md | 4 +-- .../steps/step-02a-user-selected.md | 2 +- .../steps/step-02b-ai-recommended.md | 2 +- .../steps/step-02c-random-selection.md | 2 +- .../steps/step-02d-progressive-flow.md | 2 +- .../agents/distillate-compressor.md | 8 +++--- .../bmad-review-edge-case-hunter/SKILL.md | 2 +- tools/skill-validator.md | 6 ++--- 33 files changed, 91 insertions(+), 101 deletions(-) diff --git a/src/bmm/workflows/1-analysis/bmad-product-brief-preview/SKILL.md b/src/bmm/workflows/1-analysis/bmad-product-brief-preview/SKILL.md index adeda50f7..3d0a87b3d 100644 --- a/src/bmm/workflows/1-analysis/bmad-product-brief-preview/SKILL.md +++ b/src/bmm/workflows/1-analysis/bmad-product-brief-preview/SKILL.md @@ -84,5 +84,5 @@ Check activation context immediately: ## External Skills -This workflow uses: -- `bmad-init` — Configuration loading (module: bmm) +This workflow may invoke: +- `bmad-init` — Invoke for configuration loading (module: bmm) diff --git a/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/contextual-discovery.md b/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/contextual-discovery.md index 6950a1da5..68e12bfe1 100644 --- a/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/contextual-discovery.md +++ b/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/contextual-discovery.md @@ -12,9 +12,9 @@ Now that you know what the brief is about, fan out subagents in parallel to gath **Launch in parallel:** -1. **Artifact Analyzer** (`agents/artifact-analyzer.md`) — Scans `{planning_artifacts}` and `{project_knowledge}` for relevant documents. Also scans any specific paths the user provided. Returns structured synthesis of what it found. +1. **Artifact Analyzer** (`../agents/artifact-analyzer.md`) — Scans `{planning_artifacts}` and `{project_knowledge}` for relevant documents. Also scans any specific paths the user provided. Returns structured synthesis of what it found. -2. **Web Researcher** (`agents/web-researcher.md`) — Searches for competitive landscape, market context, trends, and relevant industry data. Returns structured findings scoped to the product domain. +2. **Web Researcher** (`../agents/web-researcher.md`) — Searches for competitive landscape, market context, trends, and relevant industry data. Returns structured findings scoped to the product domain. ### Graceful Degradation @@ -38,20 +38,20 @@ Once subagent results return (or inline scanning completes): - Highlight anything surprising or worth discussing - Share the gaps you've identified - Ask: "Anything else you'd like to add, or shall we move on to filling in the details?" -- Route to `prompts/guided-elicitation.md` +- Route to `guided-elicitation.md` **Yolo mode:** - Absorb all findings silently -- Skip directly to `prompts/draft-and-review.md` — you have enough to draft +- Skip directly to `draft-and-review.md` — you have enough to draft - The user will refine later **Headless mode:** - Absorb all findings -- Skip directly to `prompts/draft-and-review.md` +- Skip directly to `draft-and-review.md` - No interaction ## Stage Complete This stage is complete when subagent results (or inline scanning fallback) have returned and findings are merged with user context. Route per mode: -- **Guided** → `prompts/guided-elicitation.md` -- **Yolo / Headless** → `prompts/draft-and-review.md` +- **Guided** → `guided-elicitation.md` +- **Yolo / Headless** → `draft-and-review.md` diff --git a/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/draft-and-review.md b/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/draft-and-review.md index b2d225a01..e6dd8cf1b 100644 --- a/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/draft-and-review.md +++ b/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/draft-and-review.md @@ -8,7 +8,7 @@ ## Step 1: Draft the Executive Brief -Use `resources/brief-template.md` as a guide — adapt structure to fit the product's story. +Use `../resources/brief-template.md` as a guide — adapt structure to fit the product's story. **Writing principles:** - **Executive audience** — persuasive, clear, concise. 1-2 pages. @@ -36,9 +36,9 @@ Before showing the draft to the user, run it through multiple review lenses in p **Launch in parallel:** -1. **Skeptic Reviewer** (`agents/skeptic-reviewer.md`) — "What's missing? What assumptions are untested? What could go wrong? Where is the brief vague or hand-wavy?" +1. **Skeptic Reviewer** (`../agents/skeptic-reviewer.md`) — "What's missing? What assumptions are untested? What could go wrong? Where is the brief vague or hand-wavy?" -2. **Opportunity Reviewer** (`agents/opportunity-reviewer.md`) — "What adjacent value propositions are being missed? What market angles or partnerships could strengthen this? What's underemphasized?" +2. **Opportunity Reviewer** (`../agents/opportunity-reviewer.md`) — "What adjacent value propositions are being missed? What market angles or partnerships could strengthen this? What's underemphasized?" 3. **Contextual Reviewer** — You (the main agent) pick the most useful third lens based on THIS specific product. Choose the lens that addresses the SINGLE BIGGEST RISK that the skeptic and opportunity reviewers won't naturally catch. Examples: - For healthtech: "Regulatory and compliance risk reviewer" @@ -65,7 +65,7 @@ After all reviews complete: ## Step 4: Present to User -**Headless mode:** Skip to `prompts/finalize.md` — no user interaction. Save the improved draft directly. +**Headless mode:** Skip to `finalize.md` — no user interaction. Save the improved draft directly. **Yolo and Guided modes:** @@ -83,4 +83,4 @@ Present reviewer findings with brief rationale, then offer: "Want me to dig into ## Stage Complete -This stage is complete when: (a) the draft has been reviewed by all three lenses and improvements integrated, AND either (autonomous) save and route directly, or (guided/yolo) the user is satisfied. Route to `prompts/finalize.md`. +This stage is complete when: (a) the draft has been reviewed by all three lenses and improvements integrated, AND either (autonomous) save and route directly, or (guided/yolo) the user is satisfied. Route to `finalize.md`. diff --git a/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/finalize.md b/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/finalize.md index aedcdd4b1..b51c8afd3 100644 --- a/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/finalize.md +++ b/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/finalize.md @@ -72,4 +72,4 @@ purpose: "Token-efficient context for downstream PRD creation" ## Stage Complete -This is the terminal stage. After delivering the completion message and file paths, the workflow is done. If the user requests further revisions, loop back to `prompts/draft-and-review.md`. Otherwise, exit. +This is the terminal stage. After delivering the completion message and file paths, the workflow is done. If the user requests further revisions, loop back to `draft-and-review.md`. Otherwise, exit. diff --git a/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/guided-elicitation.md b/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/guided-elicitation.md index ec2e7705d..a5d0e3a1b 100644 --- a/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/guided-elicitation.md +++ b/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/guided-elicitation.md @@ -5,7 +5,7 @@ **Goal:** Fill the gaps in what you know. By now you have the user's brain dump, artifact analysis, and web research. This stage is about smart, targeted questioning — not rote section-by-section interrogation. -**Skip this stage entirely in Yolo and Autonomous modes** — go directly to `prompts/draft-and-review.md`. +**Skip this stage entirely in Yolo and Autonomous modes** — go directly to `draft-and-review.md`. ## Approach @@ -67,4 +67,4 @@ If the user is providing complete, confident answers and you have solid coverage ## Stage Complete -This stage is complete when sufficient substance exists to draft a compelling brief and the user confirms readiness. Route to `prompts/draft-and-review.md`. +This stage is complete when sufficient substance exists to draft a compelling brief and the user confirms readiness. Route to `draft-and-review.md`. diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md index fa61b982d..7c2a899bc 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md @@ -3,7 +3,6 @@ name: 'step-e-01-discovery' description: 'Discovery & Understanding - Understand what user wants to edit and detect PRD format' # File references (ONLY variables used in this step) -altStepFile: './step-e-01b-legacy-conversion.md' prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md' --- @@ -188,7 +187,7 @@ Display: "**Edit Requirements Understood** **Proceeding to deep review and analysis...**" -Read fully and follow: next step (step-e-02-review.md) +Read fully and follow: [step-e-02-review.md](step-e-02-review.md) **IF PRD is Legacy (Non-Standard) AND no validation report:** @@ -215,7 +214,7 @@ Present MENU OPTIONS below for user selection #### Menu Handling Logic: -- IF C (Convert): Read fully and follow: {altStepFile} (step-e-01b-legacy-conversion.md) +- IF C (Convert): Read fully and follow: [step-e-01b-legacy-conversion.md](step-e-01b-legacy-conversion.md) - IF E (Edit As-Is): Display "Proceeding with edits..." then load next step - IF X (Exit): Display summary and exit - IF Any other: help user, then redisplay menu diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md index d13531d26..7bbdbfa0f 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md @@ -3,7 +3,6 @@ name: 'step-e-01b-legacy-conversion' description: 'Legacy PRD Conversion Assessment - Analyze legacy PRD and propose conversion strategy' # File references (ONLY variables used in this step) -nextStepFile: './step-e-02-review.md' prdFile: '{prd_file_path}' prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md' --- @@ -182,7 +181,7 @@ Edit goals: {summary} **Proceeding to deep review...**" -Read fully and follow: {nextStepFile} (step-e-02-review.md) +Read fully and follow: [step-e-02-review.md](step-e-02-review.md) --- diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md index 042df8c77..1c7c472a4 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md @@ -3,7 +3,6 @@ name: 'step-e-02-review' description: 'Deep Review & Analysis - Thoroughly review existing PRD and prepare detailed change plan' # File references (ONLY variables used in this step) -nextStepFile: './step-e-03-edit.md' prdFile: '{prd_file_path}' validationReport: '{validation_report_path}' # If provided prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md' @@ -204,7 +203,7 @@ Display: "**Change Plan Approved** **Proceeding to edit step...**" -Read fully and follow: {nextStepFile} (step-e-03-edit.md) +Read fully and follow: [step-e-03-edit.md](step-e-03-edit.md) ### 7. Present MENU OPTIONS (If User Wants Discussion) @@ -221,7 +220,7 @@ Read fully and follow: {nextStepFile} (step-e-03-edit.md) - IF A: Invoke the `bmad-advanced-elicitation` skill, then return to discussion - IF P: Invoke the `bmad-party-mode` skill, then return to discussion -- IF C: Document approval, then load {nextStepFile} +- IF C: Document approval, then load [step-e-03-edit.md](step-e-03-edit.md) - IF Any other: discuss, then redisplay menu --- diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md index 133a6f5c2..5f8b73029 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md @@ -3,7 +3,6 @@ name: 'step-e-03-edit' description: 'Edit & Update - Apply changes to PRD following approved change plan' # File references (ONLY variables used in this step) -nextStepFile: './step-e-04-complete.md' prdFile: '{prd_file_path}' prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md' --- @@ -211,10 +210,8 @@ Display: ### 8. Present MENU OPTIONS -**[V] Run Validation** - Execute full validation workflow (steps-v/step-v-01-discovery.md) -**[S] Summary Only** - End with summary of changes (no validation) +**[C] Continue** - Proceed to completion and next steps **[A] Adjust** - Make additional edits -**[X] Exit** - Exit edit workflow #### EXECUTION RULES: @@ -223,10 +220,8 @@ Display: #### Menu Handling Logic: -- IF V (Validate): Display "Starting validation workflow..." then read fully and follow: steps-v/step-v-01-discovery.md -- IF S (Summary): Present edit summary and exit +- IF C (Continue): Read fully and follow: [step-e-04-complete.md](step-e-04-complete.md) - IF A (Adjust): Accept additional requirements, loop back to editing -- IF X (Exit): Display summary and exit --- @@ -239,8 +234,7 @@ Display: - Restructuring completed (if needed) - Frontmatter updated accurately - Final verification confirms changes -- User can proceed to validation or exit with summary -- Option to run validation seamlessly integrates edit and validate modes +- User can proceed to completion step or adjust edits ### ❌ SYSTEM FAILURE: @@ -251,4 +245,4 @@ Display: - No final verification - Not saving updated PRD -**Master Rule:** Execute the plan exactly as approved. PRD is now ready for validation or downstream use. Validation integration ensures quality. +**Master Rule:** Execute the plan exactly as approved. PRD is now ready for validation or downstream use. diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md index ad394488e..cc427f6b5 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md @@ -127,7 +127,7 @@ Display: - Display: "**Additional Edits**" - Ask: "What additional edits would you like to make?" - Accept input, then display: "**Returning to edit step...**" - - Read fully and follow: step-e-03-edit.md again + - Read fully and follow: [step-e-03-edit.md](step-e-03-edit.md) again - **IF S (Summary):** - Display detailed summary including: diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/workflow.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/workflow.md index a765a5459..d68b90bc5 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/workflow.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/workflow.md @@ -1,6 +1,5 @@ --- main_config: '{project-root}/_bmad/bmm/config.yaml' -editWorkflow: './steps-e/step-e-01-discovery.md' --- # PRD Edit Workflow @@ -61,4 +60,4 @@ Load and read full config from {main_config} and resolve: Prompt for PRD path: "Which PRD would you like to edit? Please provide the path to the PRD.md file." -Then read fully and follow: `{editWorkflow}` (steps-e/step-e-01-discovery.md) +Then read fully and follow: [steps-e/step-e-01-discovery.md](steps-e/step-e-01-discovery.md) diff --git a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-13-report-complete.md b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-13-report-complete.md index decc5579a..9ac4cc4d9 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-13-report-complete.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-13-report-complete.md @@ -180,9 +180,9 @@ Display: - After review, return to menu - **IF E (Use Edit Workflow):** - - Explain: "The Edit workflow (steps-e/) can use this validation report to systematically address issues. Edit mode will guide you through discovering what to edit, reviewing the PRD, and applying targeted improvements." + - Explain: "The Edit workflow can use this validation report to systematically address issues. Edit mode will guide you through discovering what to edit, reviewing the PRD, and applying targeted improvements." - Offer: "Would you like to launch Edit mode now? It will help you fix validation findings systematically." - - If yes: Read fully and follow: steps-e/step-e-01-discovery.md + - If yes: Invoke the `bmad-edit-prd` skill, passing the validation report path as context - If no: Return to menu - **IF F (Fix Simpler Items):** diff --git a/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-01-init.md b/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-01-init.md index c2933dfb8..00ea5c205 100644 --- a/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-01-init.md +++ b/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-01-init.md @@ -112,13 +112,13 @@ Report what was found: **Documents Found:** -- PRD: {number of PRD files loaded or "None found - REQUIRED"} -- UX Design: {number of UX files loaded or "None found"} -- Research: {number of research files loaded or "None found"} -- Project docs: {number of project files loaded or "None found"} -- Project context: {project_context_rules count of rules for AI agents found} +- PRD: {{number_of_prd_files_loaded_or_none}} +- UX Design: {{number_of_ux_files_loaded_or_none}} +- Research: {{number_of_research_files_loaded_or_none}} +- Project docs: {{number_of_project_files_loaded_or_none}} +- Project context: {{project_context_rules_count}} -**Files loaded:** {list of specific file names or "No additional documents found"} +**Files loaded:** {{list_of_loaded_file_names}} Ready to begin architectural decision making. Do you have any other documents you'd like me to include? diff --git a/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-01b-continue.md b/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-01b-continue.md index 977896afc..d7e1d14fe 100644 --- a/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-01b-continue.md +++ b/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-01b-continue.md @@ -64,13 +64,13 @@ Show the user their current progress: - Input documents loaded: {{number of inputDocuments}} files **Document Sections Found:** -{list all H2/H3 sections found in the document} +{{list_of_h2_h3_sections_found_in_document}} -{if_incomplete_sections} +{{if_incomplete_sections}} **Incomplete Areas:** -- {areas that appear incomplete or have placeholders} - {/if_incomplete_sections} +- {{areas_that_appear_incomplete_or_have_placeholders}} + {{/if_incomplete_sections}} **What would you like to do?** [R] Resume from where we left off diff --git a/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-02-context.md b/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-02-context.md index 96cb5c4e1..5ccffdc87 100644 --- a/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-02-context.md +++ b/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-02-context.md @@ -96,15 +96,15 @@ Present your analysis back to user for validation: "I'm reviewing your project documentation for {{project_name}}. -{if_epics_loaded}I see {{epic_count}} epics with {{story_count}} total stories.{/if_epics_loaded} -{if_no_epics}I found {{fr_count}} functional requirements organized into {{fr_category_list}}.{/if_no_epics} -{if_ux_loaded}I also found your UX specification which defines the user experience requirements.{/if_ux_loaded} +{{if_epics_loaded}}I see {{epic_count}} epics with {{story_count}} total stories.{{/if_epics_loaded}} +{{if_no_epics}}I found {{fr_count}} functional requirements organized into {{fr_category_list}}.{{/if_no_epics}} +{{if_ux_loaded}}I also found your UX specification which defines the user experience requirements.{{/if_ux_loaded}} **Key architectural aspects I notice:** - [Summarize core functionality from FRs] - [Note critical NFRs that will shape architecture] -- {if_ux_loaded}[Note UX complexity and technical requirements]{/if_ux_loaded} +- {{if_ux_loaded}}[Note UX complexity and technical requirements]{{/if_ux_loaded}} - [Identify unique technical challenges or constraints] - [Highlight any regulatory or compliance requirements] diff --git a/src/bmm/workflows/3-solutioning/bmad-create-epics-and-stories/steps/step-03-create-stories.md b/src/bmm/workflows/3-solutioning/bmad-create-epics-and-stories/steps/step-03-create-stories.md index 14caafeb3..5c17a5dc5 100644 --- a/src/bmm/workflows/3-solutioning/bmad-create-epics-and-stories/steps/step-03-create-stories.md +++ b/src/bmm/workflows/3-solutioning/bmad-create-epics-and-stories/steps/step-03-create-stories.md @@ -79,18 +79,18 @@ Stories must be independently completable in sequence: **STORY FORMAT (from template):** ``` -### Story {N}.{M}: {story_title} +### Story {{N}}.{{M}}: {{story_title}} -As a {user_type}, -I want {capability}, -So that {value_benefit}. +As a {{user_type}}, +I want {{capability}}, +So that {{value_benefit}}. **Acceptance Criteria:** -**Given** {precondition} -**When** {action} -**Then** {expected_outcome} -**And** {additional_criteria} +**Given** {{precondition}} +**When** {{action}} +**Then** {{expected_outcome}} +**And** {{additional_criteria}} ``` **✅ GOOD STORY EXAMPLES:** diff --git a/src/bmm/workflows/4-implementation/bmad-create-story/workflow.md b/src/bmm/workflows/4-implementation/bmad-create-story/workflow.md index 7e5b47bc9..0acd8666b 100644 --- a/src/bmm/workflows/4-implementation/bmad-create-story/workflow.md +++ b/src/bmm/workflows/4-implementation/bmad-create-story/workflow.md @@ -344,7 +344,7 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve: - Validate the newly created story file {story_file} against `./checklist.md` and apply any required fixes before finalizing + Validate the newly created story file {default_output_file} against `./checklist.md` and apply any required fixes before finalizing Save story document unconditionally diff --git a/src/bmm/workflows/4-implementation/bmad-retrospective/workflow.md b/src/bmm/workflows/4-implementation/bmad-retrospective/workflow.md index 3f56f728c..958fe13ef 100644 --- a/src/bmm/workflows/4-implementation/bmad-retrospective/workflow.md +++ b/src/bmm/workflows/4-implementation/bmad-retrospective/workflow.md @@ -192,12 +192,12 @@ Bob (Scrum Master): "Perfect. Epic {{epic_number}} is complete and ready for ret - + Load input files according to the Input Files table in INITIALIZATION. For SELECTIVE_LOAD inputs, load only the epic matching {{epic_number}}. For FULL_LOAD inputs, load the complete document. For INDEX_GUIDED inputs, check the index first and load relevant sections. After discovery, these content variables are available: {epics_content} (selective load for this epic), {architecture_content}, {prd_content}, {document_project_content} After discovery, these content variables are available: {epics_content} (selective load for this epic), {architecture_content}, {prd_content}, {document_project_content} - + Bob (Scrum Master): "Before we start the team discussion, let me review all the story records to surface key themes. This'll help us have a richer conversation." @@ -291,7 +291,7 @@ Bob (Scrum Master): "We'll get to all of it. But first, let me load the previous - + Calculate previous epic number: {{prev_epic_num}} = {{epic_number}} - 1 @@ -387,7 +387,7 @@ Charlie (Senior Dev): "First epic, first retro. Let's make it count." - + Calculate next epic number: {{next_epic_num}} = {{epic_number}} + 1 @@ -476,7 +476,7 @@ Bob (Scrum Master): "No problem. We'll still do a thorough retro on Epic {{epic_ - + Load agent configurations from {agent_manifest} Identify which agents participated in Epic {{epic_number}} based on story records @@ -566,7 +566,7 @@ Bob (Scrum Master): "Exactly. {user_name}, any questions before we dive in?" - + Bob (Scrum Master): "Let's start with the good stuff. What went well in Epic {{epic_number}}?" @@ -711,13 +711,13 @@ Bob (Scrum Master): "Does that capture it? Anyone have something important we mi - + Bob (Scrum Master): "Normally we'd discuss preparing for the next epic, but since Epic {{next_epic_num}} isn't defined yet, let's skip to action items." - Skip to Step 8 + Skip to Step 9 @@ -835,7 +835,7 @@ Bob (Scrum Master): "{user_name}, does this preparation plan work for you?" - + Bob (Scrum Master): "Let's capture concrete action items from everything we've discussed." @@ -1076,7 +1076,7 @@ Bob (Scrum Master): "Everyone clear on what they own?" - + Bob (Scrum Master): "Before we close, I want to do a final readiness check." @@ -1259,7 +1259,7 @@ Charlie (Senior Dev): "Better to catch this now than three stories into the next - + Bob (Scrum Master): "We've covered a lot of ground today. Let me bring this retrospective to a close." @@ -1335,7 +1335,7 @@ Bob (Scrum Master): "See you all when prep work is done. Meeting adjourned!" - + Ensure retrospectives folder exists: {implementation_artifacts} Create folder if it doesn't exist @@ -1392,7 +1392,7 @@ Retrospective document was saved successfully, but {sprint_status_file} may need - + **✅ Retrospective Complete, {user_name}!** diff --git a/src/bmm/workflows/bmad-document-project/workflows/full-scan-instructions.md b/src/bmm/workflows/bmad-document-project/workflows/full-scan-instructions.md index dd90c4eea..bbf49af6a 100644 --- a/src/bmm/workflows/bmad-document-project/workflows/full-scan-instructions.md +++ b/src/bmm/workflows/bmad-document-project/workflows/full-scan-instructions.md @@ -89,21 +89,21 @@ Your choice [1/2/3]: Choose your scan depth level: -**1. Quick Scan** (2-5 minutes) [DEFAULT] +**1. Quick Scan** [DEFAULT] - Pattern-based analysis without reading source files - Scans: Config files, package manifests, directory structure - Best for: Quick project overview, initial understanding - File reading: Minimal (configs, README, package.json, etc.) -**2. Deep Scan** (10-30 minutes) +**2. Deep Scan** - Reads files in critical directories based on project type - Scans: All critical paths from documentation requirements - Best for: Comprehensive documentation for brownfield PRD - File reading: Selective (key files in critical directories) -**3. Exhaustive Scan** (30-120 minutes) +**3. Exhaustive Scan** - Reads ALL source files in project - Scans: Every source file (excludes node_modules, dist, build) diff --git a/src/bmm/workflows/bmad-generate-project-context/steps/step-01-discover.md b/src/bmm/workflows/bmad-generate-project-context/steps/step-01-discover.md index b34e0e1e0..03ef49a47 100644 --- a/src/bmm/workflows/bmad-generate-project-context/steps/step-01-discover.md +++ b/src/bmm/workflows/bmad-generate-project-context/steps/step-01-discover.md @@ -123,7 +123,7 @@ Based on discovery, create or update the context document: #### A. Fresh Document Setup (if no existing context) -Copy template from `./project-context-template.md` to `{output_folder}/project-context.md` +Copy template from `../project-context-template.md` to `{output_folder}/project-context.md` Initialize frontmatter fields. #### B. Existing Document Update diff --git a/src/bmm/workflows/bmad-qa-generate-e2e-tests/workflow.md b/src/bmm/workflows/bmad-qa-generate-e2e-tests/workflow.md index 934355d99..c7159019c 100644 --- a/src/bmm/workflows/bmad-qa-generate-e2e-tests/workflow.md +++ b/src/bmm/workflows/bmad-qa-generate-e2e-tests/workflow.md @@ -2,7 +2,7 @@ **Goal:** Generate automated API and E2E tests for implemented code. -**Your Role:** You are a QA automation engineer. You generate tests ONLY — no code review or story validation (use Code Review `CR` for that). +**Your Role:** You are a QA automation engineer. You generate tests ONLY — no code review or story validation (use the `bmad-code-review` skill for that). --- diff --git a/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-01-clarify-and-route.md b/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-01-clarify-and-route.md index 5671b6c66..4d4dc7046 100644 --- a/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-01-clarify-and-route.md +++ b/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-01-clarify-and-route.md @@ -18,8 +18,8 @@ spec_file: '' # set at runtime before leaving this step - `{wipFile}` exists? → Offer resume or archive. - Active specs (`ready-for-dev`, `in-progress`, `in-review`) in `{implementation_artifacts}`? → List them and HALT. Ask user which to resume (or `[N]` for new). - - If `ready-for-dev` or `in-progress` selected: Set `spec_file`, set `execution_mode = "plan-code-review"`, skip to step 3. - - If `in-review` selected: Set `spec_file`, set `execution_mode = "plan-code-review"`, skip to step 4. + - If `ready-for-dev` or `in-progress` selected: Set `spec_file`, set `execution_mode = "plan-code-review"`, proceed to step 3. + - If `in-review` selected: Set `spec_file`, set `execution_mode = "plan-code-review"`, proceed to step 4. - Unformatted spec or intent file lacking `status` frontmatter in `{implementation_artifacts}`? → Suggest to the user to treat its contents as the starting intent for this workflow. DO NOT attempt to infer a state and resume it. ## INSTRUCTIONS diff --git a/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-04-review.md b/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-04-review.md index 154e97d0a..2405c94a0 100644 --- a/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-04-review.md +++ b/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-04-review.md @@ -26,8 +26,8 @@ Do NOT `git add` anything — this is read-only inspection. **Plan-code-review:** Launch three subagents without conversation context. If no sub-agents are available, generate three review prompt files in `{implementation_artifacts}` — one per reviewer role below — and HALT. Ask the human to run each in a separate session (ideally a different LLM) and paste back the findings. -- **Blind hunter** — receives `{diff_output}` only. No spec, no context docs, no project access. Invoke via the `bmad-review-adversarial-general` skill. -- **Edge case hunter** — receives `{diff_output}` and read access to the project. Invoke via the `bmad-review-edge-case-hunter` skill. +- **Blind hunter** — receives `{diff_output}` only. No spec, no context docs, no project access. Invoke the `bmad-review-adversarial-general` skill. +- **Edge case hunter** — receives `{diff_output}` and read access to the project. Invoke the `bmad-review-edge-case-hunter` skill. - **Acceptance auditor** — receives `{diff_output}`, `{spec_file}`, and read access to the project. Must also read the docs listed in `{spec_file}` frontmatter `context`. Checks for violations of acceptance criteria, rules, and principles from the spec and context docs. ### Classify diff --git a/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/steps/step-01-understand.md b/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/steps/step-01-understand.md index 1206271ea..b8d61c2ca 100644 --- a/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/steps/step-01-understand.md +++ b/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/steps/step-01-understand.md @@ -86,7 +86,7 @@ d) **Build mental model:** - What's the likely scope based on what you found? - What questions do you NOW have, informed by the code? -**This scan should take < 30 seconds. Just enough to ask smart questions.** +**Just enough to ask smart questions.** ### 3. Ask Informed Questions diff --git a/src/core/skills/bmad-advanced-elicitation/SKILL.md b/src/core/skills/bmad-advanced-elicitation/SKILL.md index 2c222cd7f..bcb381f95 100644 --- a/src/core/skills/bmad-advanced-elicitation/SKILL.md +++ b/src/core/skills/bmad-advanced-elicitation/SKILL.md @@ -1,6 +1,6 @@ --- name: bmad-advanced-elicitation -description: 'Push the LLM to reconsider refine and improve its recent output.' +description: 'Push the LLM to reconsider, refine, and improve its recent output.' --- Follow the instructions in [workflow.md](workflow.md). diff --git a/src/core/skills/bmad-advanced-elicitation/workflow.md b/src/core/skills/bmad-advanced-elicitation/workflow.md index 692a37fa6..ecb7f8391 100644 --- a/src/core/skills/bmad-advanced-elicitation/workflow.md +++ b/src/core/skills/bmad-advanced-elicitation/workflow.md @@ -96,9 +96,9 @@ x. Proceed / No Further Actions **Case x (Proceed):** - Complete elicitation and proceed -- Return the fully enhanced content back to create-doc.md +- Return the fully enhanced content back to the invoking skill - The enhanced content becomes the final version for that section -- Signal completion back to create-doc.md to continue with next section +- Signal completion back to the invoking skill to continue with next section **Case a (List All):** diff --git a/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md b/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md index 2b523db84..7803dcf60 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md @@ -40,7 +40,7 @@ Load techniques from CSV on-demand: **Load CSV and parse:** -- Read `brain-methods.csv` +- Read `../brain-methods.csv` - Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration - Organize by categories for browsing diff --git a/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md b/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md index f928ff043..ae7ccd41b 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md @@ -47,7 +47,7 @@ Load techniques from CSV for analysis: **Load CSV and parse:** -- Read `brain-methods.csv` +- Read `../brain-methods.csv` - Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration ### 2. Context Analysis for Technique Matching diff --git a/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md b/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md index def91d0a4..fd4085f7e 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md @@ -47,7 +47,7 @@ Create anticipation for serendipitous technique discovery: **Load CSV and parse:** -- Read `brain-methods.csv` +- Read `../brain-methods.csv` - Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration - Prepare for intelligent random selection diff --git a/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md b/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md index 96aa2d90a..a2dfb8aa4 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md @@ -66,7 +66,7 @@ Explain the value of systematic creative progression: **Load CSV and parse:** -- Read `brain-methods.csv` +- Read `../brain-methods.csv` - Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration - Map techniques to each phase of the creative journey diff --git a/src/core/skills/bmad-distillator/agents/distillate-compressor.md b/src/core/skills/bmad-distillator/agents/distillate-compressor.md index f51df0014..d581b79f9 100644 --- a/src/core/skills/bmad-distillator/agents/distillate-compressor.md +++ b/src/core/skills/bmad-distillator/agents/distillate-compressor.md @@ -4,7 +4,7 @@ Act as an information extraction and compression specialist. Your sole purpose i You receive: source document file paths, an optional downstream_consumer context, and a splitting decision. -You must load and apply `resources/compression-rules.md` before producing output. Reference `resources/distillate-format-reference.md` for the expected output format. +You must load and apply `../resources/compression-rules.md` before producing output. Reference `../resources/distillate-format-reference.md` for the expected output format. ## Compression Process @@ -31,7 +31,7 @@ Treat this as entity extraction — pull out every distinct piece of information ### Step 3: Deduplicate -Apply the deduplication rules from `resources/compression-rules.md`. +Apply the deduplication rules from `../resources/compression-rules.md`. ### Step 4: Filter (only if downstream_consumer is specified) @@ -58,7 +58,7 @@ Common groupings (use what fits, omit what doesn't, add what's needed): ### Step 6: Compress Language -For each item, apply the compression rules from `resources/compression-rules.md`: +For each item, apply the compression rules from `../resources/compression-rules.md`: - Strip prose transitions and connective tissue - Remove hedging and rhetoric - Remove explanations of common knowledge @@ -80,7 +80,7 @@ Do NOT include frontmatter — the calling skill handles that. ## Semantic Splitting -If the splitting decision indicates splitting is needed, load `resources/splitting-strategy.md` and follow it. +If the splitting decision indicates splitting is needed, load `../resources/splitting-strategy.md` and follow it. When splitting: diff --git a/src/core/skills/bmad-review-edge-case-hunter/SKILL.md b/src/core/skills/bmad-review-edge-case-hunter/SKILL.md index 872fff46f..4417495ba 100644 --- a/src/core/skills/bmad-review-edge-case-hunter/SKILL.md +++ b/src/core/skills/bmad-review-edge-case-hunter/SKILL.md @@ -1,6 +1,6 @@ --- name: bmad-review-edge-case-hunter -description: 'Walk every branching path and boundary condition in content, report only unhandled edge cases. Orthogonal to adversarial review - method-driven not attitude-driven.' +description: 'Walk every branching path and boundary condition in content, report only unhandled edge cases. Orthogonal to adversarial review - method-driven not attitude-driven. Use when you need exhaustive edge-case analysis of code, specs, or diffs.' --- Follow the instructions in [workflow.md](workflow.md). diff --git a/tools/skill-validator.md b/tools/skill-validator.md index 4ab5f1cb8..b3aac2302 100644 --- a/tools/skill-validator.md +++ b/tools/skill-validator.md @@ -274,9 +274,9 @@ If no findings are generated, the skill passes validation. - **Severity:** HIGH - **Applies to:** all files -- **Rule:** When a skill references another skill via `skill:skill-name`, the surrounding instruction must use the word "invoke" (e.g., `Invoke skill:bmad-party-mode`). Phrases like "Read fully and follow", "Execute", "Run", "Load", "Open", or "Follow" are invalid — they imply file-level operations on a document, not skill invocation. A skill is a unit that is invoked, not a file that is read. -- **Detection:** Find all `skill:` references in body text and frontmatter. Check the surrounding instruction text (same sentence or directive) for file-oriented verbs: "read", "follow", "load", "execute", "run", "open". Flag any that do not use "invoke" (or a close synonym like "activate" or "launch"). -- **Fix:** Replace the instruction with `Invoke skill:skill-name` or `Invoke the \`skill-name\` skill`. Remove any "read fully and follow" or similar file-oriented phrasing. +- **Rule:** When a skill references another skill by name, the surrounding instruction must use the word "invoke". The canonical form is `Invoke the \`skill-name\` skill`. Phrases like "Read fully and follow", "Execute", "Run", "Load", "Open", or "Follow" are invalid — they imply file-level operations on a document, not skill invocation. A skill is a unit that is invoked, not a file that is read. +- **Detection:** Find all references to other skills by name (typically backtick-quoted skill names like \`bmad-foo\`). Check the surrounding instruction text (same sentence or directive) for file-oriented verbs: "read", "follow", "load", "execute", "run", "open". Flag any that do not use "invoke" (or a close synonym like "activate" or "launch"). +- **Fix:** Replace the instruction with `Invoke the \`skill-name\` skill`. Remove any "read fully and follow" or similar file-oriented phrasing. Do NOT add a `skill:` prefix to the name — use natural language. --- From a2f4bfea8f6fe2833147c25dd6f6fc85c3daad4f Mon Sep 17 00:00:00 2001 From: Alex Verkhovsky Date: Sun, 15 Mar 2026 10:53:47 -0600 Subject: [PATCH 02/11] fix(skills): address re-validation findings in edit-prd, validate-prd, brainstorming MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - STEP-06: Remove name/description from step frontmatter in edit-prd (5 files) and validate-prd (14 files) — these belong only in SKILL.md - REF-02: Fix brainstorming step-02a/b/c/d CSV parse instructions to match actual brain-methods.csv columns (3 cols, not 7) - SEQ-02: Remove time estimates from brainstorming step-02a/b/c/d and step-03, replace time-based thresholds with idea-count criteria Co-Authored-By: Claude Opus 4.6 (1M context) --- .../steps-e/step-e-01-discovery.md | 3 --- .../steps-e/step-e-01b-legacy-conversion.md | 3 --- .../bmad-edit-prd/steps-e/step-e-02-review.md | 3 --- .../bmad-edit-prd/steps-e/step-e-03-edit.md | 3 --- .../steps-e/step-e-04-complete.md | 3 --- .../steps-v/step-v-01-discovery.md | 3 --- .../steps-v/step-v-02-format-detection.md | 3 --- .../steps-v/step-v-02b-parity-check.md | 3 --- .../steps-v/step-v-03-density-validation.md | 3 --- .../step-v-04-brief-coverage-validation.md | 3 --- .../step-v-05-measurability-validation.md | 3 --- .../step-v-06-traceability-validation.md | 3 --- ...p-v-07-implementation-leakage-validation.md | 3 --- .../step-v-08-domain-compliance-validation.md | 3 --- .../step-v-09-project-type-validation.md | 3 --- .../steps-v/step-v-10-smart-validation.md | 3 --- .../step-v-11-holistic-quality-validation.md | 3 --- .../step-v-12-completeness-validation.md | 3 --- .../steps-v/step-v-13-report-complete.md | 3 --- .../steps/step-02a-user-selected.md | 10 +++++----- .../steps/step-02b-ai-recommended.md | 18 ++++-------------- .../steps/step-02c-random-selection.md | 12 ++++-------- .../steps/step-02d-progressive-flow.md | 11 +++++------ .../steps/step-03-technique-execution.md | 4 ++-- 24 files changed, 20 insertions(+), 92 deletions(-) diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md index 7c2a899bc..fd9071e5f 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md @@ -1,7 +1,4 @@ --- -name: 'step-e-01-discovery' -description: 'Discovery & Understanding - Understand what user wants to edit and detect PRD format' - # File references (ONLY variables used in this step) prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md' --- diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md index 7bbdbfa0f..b9a9eb5a7 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md @@ -1,7 +1,4 @@ --- -name: 'step-e-01b-legacy-conversion' -description: 'Legacy PRD Conversion Assessment - Analyze legacy PRD and propose conversion strategy' - # File references (ONLY variables used in this step) prdFile: '{prd_file_path}' prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md' diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md index 1c7c472a4..efac80337 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md @@ -1,7 +1,4 @@ --- -name: 'step-e-02-review' -description: 'Deep Review & Analysis - Thoroughly review existing PRD and prepare detailed change plan' - # File references (ONLY variables used in this step) prdFile: '{prd_file_path}' validationReport: '{validation_report_path}' # If provided diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md index 5f8b73029..be33fa2a9 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md @@ -1,7 +1,4 @@ --- -name: 'step-e-03-edit' -description: 'Edit & Update - Apply changes to PRD following approved change plan' - # File references (ONLY variables used in this step) prdFile: '{prd_file_path}' prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md' diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md index cc427f6b5..943bdbf90 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md @@ -1,7 +1,4 @@ --- -name: 'step-e-04-complete' -description: 'Complete & Validate - Present options for next steps including full validation' - # File references (ONLY variables used in this step) prdFile: '{prd_file_path}' validationWorkflow: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-01-discovery.md' diff --git a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-01-discovery.md b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-01-discovery.md index 561ae8901..feb002641 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-01-discovery.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-01-discovery.md @@ -1,7 +1,4 @@ --- -name: 'step-v-01-discovery' -description: 'Document Discovery & Confirmation - Handle fresh context validation, confirm PRD path, discover input documents' - # File references (ONLY variables used in this step) nextStepFile: './step-v-02-format-detection.md' prdPurpose: '../data/prd-purpose.md' diff --git a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-02-format-detection.md b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-02-format-detection.md index a354b5aff..1211ca6b3 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-02-format-detection.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-02-format-detection.md @@ -1,7 +1,4 @@ --- -name: 'step-v-02-format-detection' -description: 'Format Detection & Structure Analysis - Classify PRD format and route appropriately' - # File references (ONLY variables used in this step) nextStepFile: './step-v-03-density-validation.md' altStepFile: './step-v-02b-parity-check.md' diff --git a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-02b-parity-check.md b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-02b-parity-check.md index 604265a9a..33b6a1931 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-02b-parity-check.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-02b-parity-check.md @@ -1,7 +1,4 @@ --- -name: 'step-v-02b-parity-check' -description: 'Document Parity Check - Analyze non-standard PRD and identify gaps to achieve BMAD PRD parity' - # File references (ONLY variables used in this step) nextStepFile: './step-v-03-density-validation.md' prdFile: '{prd_file_path}' diff --git a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-03-density-validation.md b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-03-density-validation.md index d00478c10..35b7e453f 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-03-density-validation.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-03-density-validation.md @@ -1,7 +1,4 @@ --- -name: 'step-v-03-density-validation' -description: 'Information Density Check - Scan for anti-patterns that violate information density principles' - # File references (ONLY variables used in this step) nextStepFile: './step-v-04-brief-coverage-validation.md' prdFile: '{prd_file_path}' diff --git a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-04-brief-coverage-validation.md b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-04-brief-coverage-validation.md index 60ad8684f..e1e70af99 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-04-brief-coverage-validation.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-04-brief-coverage-validation.md @@ -1,7 +1,4 @@ --- -name: 'step-v-04-brief-coverage-validation' -description: 'Product Brief Coverage Check - Validate PRD covers all content from Product Brief (if used as input)' - # File references (ONLY variables used in this step) nextStepFile: './step-v-05-measurability-validation.md' prdFile: '{prd_file_path}' diff --git a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-05-measurability-validation.md b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-05-measurability-validation.md index a97187184..196f5c732 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-05-measurability-validation.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-05-measurability-validation.md @@ -1,7 +1,4 @@ --- -name: 'step-v-05-measurability-validation' -description: 'Measurability Validation - Validate that all requirements (FRs and NFRs) are measurable and testable' - # File references (ONLY variables used in this step) nextStepFile: './step-v-06-traceability-validation.md' prdFile: '{prd_file_path}' diff --git a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-06-traceability-validation.md b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-06-traceability-validation.md index 84bf9cce9..67fb2847b 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-06-traceability-validation.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-06-traceability-validation.md @@ -1,7 +1,4 @@ --- -name: 'step-v-06-traceability-validation' -description: 'Traceability Validation - Validate the traceability chain from vision → success → journeys → FRs is intact' - # File references (ONLY variables used in this step) nextStepFile: './step-v-07-implementation-leakage-validation.md' prdFile: '{prd_file_path}' diff --git a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-07-implementation-leakage-validation.md b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-07-implementation-leakage-validation.md index 923f99691..a4f740c01 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-07-implementation-leakage-validation.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-07-implementation-leakage-validation.md @@ -1,7 +1,4 @@ --- -name: 'step-v-07-implementation-leakage-validation' -description: 'Implementation Leakage Check - Ensure FRs and NFRs don\'t include implementation details' - # File references (ONLY variables used in this step) nextStepFile: './step-v-08-domain-compliance-validation.md' prdFile: '{prd_file_path}' diff --git a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-08-domain-compliance-validation.md b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-08-domain-compliance-validation.md index 562697eda..c9f48e960 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-08-domain-compliance-validation.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-08-domain-compliance-validation.md @@ -1,7 +1,4 @@ --- -name: 'step-v-08-domain-compliance-validation' -description: 'Domain Compliance Validation - Validate domain-specific requirements are present for high-complexity domains' - # File references (ONLY variables used in this step) nextStepFile: './step-v-09-project-type-validation.md' prdFile: '{prd_file_path}' diff --git a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-09-project-type-validation.md b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-09-project-type-validation.md index aea41d924..f9343b9d6 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-09-project-type-validation.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-09-project-type-validation.md @@ -1,7 +1,4 @@ --- -name: 'step-v-09-project-type-validation' -description: 'Project-Type Compliance Validation - Validate project-type specific requirements are properly documented' - # File references (ONLY variables used in this step) nextStepFile: './step-v-10-smart-validation.md' prdFile: '{prd_file_path}' diff --git a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-10-smart-validation.md b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-10-smart-validation.md index 0c44b00da..52f5cbb1d 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-10-smart-validation.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-10-smart-validation.md @@ -1,7 +1,4 @@ --- -name: 'step-v-10-smart-validation' -description: 'SMART Requirements Validation - Validate Functional Requirements meet SMART quality criteria' - # File references (ONLY variables used in this step) nextStepFile: './step-v-11-holistic-quality-validation.md' prdFile: '{prd_file_path}' diff --git a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-11-holistic-quality-validation.md b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-11-holistic-quality-validation.md index f34dee65a..a559e40ce 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-11-holistic-quality-validation.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-11-holistic-quality-validation.md @@ -1,7 +1,4 @@ --- -name: 'step-v-11-holistic-quality-validation' -description: 'Holistic Quality Assessment - Assess PRD as cohesive, compelling document - is it a good PRD?' - # File references (ONLY variables used in this step) nextStepFile: './step-v-12-completeness-validation.md' prdFile: '{prd_file_path}' diff --git a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-12-completeness-validation.md b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-12-completeness-validation.md index 00c477981..90065e1df 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-12-completeness-validation.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-12-completeness-validation.md @@ -1,7 +1,4 @@ --- -name: 'step-v-12-completeness-validation' -description: 'Completeness Check - Final comprehensive completeness check before report generation' - # File references (ONLY variables used in this step) nextStepFile: './step-v-13-report-complete.md' prdFile: '{prd_file_path}' diff --git a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-13-report-complete.md b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-13-report-complete.md index 9ac4cc4d9..946b5704d 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-13-report-complete.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-13-report-complete.md @@ -1,7 +1,4 @@ --- -name: 'step-v-13-report-complete' -description: 'Validation Report Complete - Finalize report, summarize findings, present to user, offer next steps' - # File references (ONLY variables used in this step) validationReportPath: '{validation_report_path}' prdFile: '{prd_file_path}' diff --git a/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md b/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md index 7803dcf60..f10588f8a 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md @@ -41,7 +41,7 @@ Load techniques from CSV on-demand: **Load CSV and parse:** - Read `../brain-methods.csv` -- Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration +- Parse: category, technique_name, description - Organize by categories for browsing ### 2. Present Technique Categories @@ -100,19 +100,19 @@ After user selects category: **Present 3-5 techniques from selected category:** For each technique: -- **Technique Name** (Duration: [time], Energy: [level]) +- **Technique Name** - Description: [Brief clear description] - Best for: [What this technique excels at] - Example prompt: [Sample facilitation prompt] **Example presentation format:** -"**1. SCAMPER Method** (Duration: 20-30 min, Energy: Moderate) +"**1. SCAMPER Method** - Systematic creativity through seven lenses (Substitute/Combine/Adapt/Modify/Put/Eliminate/Reverse) - Best for: Product improvement, innovation challenges, systematic idea generation - Example prompt: "What could you substitute in your current approach to create something new?" -**2. Six Thinking Hats** (Duration: 15-25 min, Energy: Moderate) +**2. Six Thinking Hats** - Explore problems through six distinct perspectives for comprehensive analysis - Best for: Complex decisions, team alignment, thorough exploration @@ -148,7 +148,7 @@ When user selects techniques: - [Technique 3]: [If selected, how it builds on others] **Session Plan:** -This combination will take approximately [total_time] and focus on [expected outcomes]. +This combination will focus on [expected outcomes]. **Confirm these choices?** [C] Continue - Begin technique execution diff --git a/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md b/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md index ae7ccd41b..d9ccf6b72 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md @@ -48,7 +48,7 @@ Load techniques from CSV for analysis: **Load CSV and parse:** - Read `../brain-methods.csv` -- Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration +- Parse: category, technique_name, description ### 2. Context Analysis for Technique Matching @@ -76,12 +76,6 @@ Analyze user's session context across multiple dimensions: - User language playful → creative, theatrical, wild techniques - User language reflective → introspective_delight, deep techniques -**4. Time Available:** - -- <30 min → 1-2 focused techniques -- 30-60 min → 2-3 complementary techniques -- > 60 min → Multi-phase technique flow - ### 3. Generate Technique Recommendations Based on context analysis, create tailored recommendations: @@ -91,24 +85,20 @@ Based on context analysis, create tailored recommendations: Based on your session context, I recommend this customized technique sequence: **Phase 1: Foundation Setting** -**[Technique Name]** from [Category] (Duration: [time], Energy: [level]) - +**[Technique Name]** from [Category] - **Why this fits:** [Specific connection to user's goals/context] - **Expected outcome:** [What this will accomplish for their session] **Phase 2: Idea Generation** -**[Technique Name]** from [Category] (Duration: [time], Energy: [level]) - +**[Technique Name]** from [Category] - **Why this builds on Phase 1:** [Complementary effect explanation] - **Expected outcome:** [How this develops the foundation] **Phase 3: Refinement & Action** (If time allows) -**[Technique Name]** from [Category] (Duration: [time], Energy: [level]) - +**[Technique Name]** from [Category] - **Why this concludes effectively:** [Final phase rationale] - **Expected outcome:** [How this leads to actionable results] -**Total Estimated Time:** [Sum of durations] **Session Focus:** [Primary benefit and outcome description]" ### 4. Present Recommendation Details diff --git a/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md b/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md index fd4085f7e..e1c1db754 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md @@ -48,7 +48,7 @@ Create anticipation for serendipitous technique discovery: **Load CSV and parse:** - Read `../brain-methods.csv` -- Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration +- Parse: category, technique_name, description - Prepare for intelligent random selection ### 2. Intelligent Random Selection @@ -74,27 +74,23 @@ Reveal the randomly selected techniques with enthusiasm: "**🎲 Your Randomly Selected Creative Techniques! 🎲** **Phase 1: Exploration** -**[Random Technique 1]** from [Category] (Duration: [time], Energy: [level]) - +**[Random Technique 1]** from [Category] - **Description:** [Technique description] - **Why this is exciting:** [What makes this technique surprising or powerful] - **Random discovery bonus:** [Unexpected insight about this technique] **Phase 2: Connection** -**[Random Technique 2]** from [Category] (Duration: [time], Energy: [level]) - +**[Random Technique 2]** from [Category] - **Description:** [Technique description] - **Why this complements the first:** [How these techniques might work together] - **Random discovery bonus:** [Unexpected insight about this combination] **Phase 3: Synthesis** -**[Random Technique 3]** from [Category] (Duration: [time], Energy: [level]) - +**[Random Technique 3]** from [Category] - **Description:** [Technique description] - **Why this completes the journey:** [How this ties the sequence together] - **Random discovery bonus:** [Unexpected insight about the overall flow] -**Total Random Session Time:** [Combined duration] **Serendipity Factor:** [Enthusiastic description of creative potential]" ### 4. Highlight the Creative Potential diff --git a/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md b/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md index a2dfb8aa4..2d35275a2 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md @@ -67,7 +67,7 @@ Explain the value of systematic creative progression: **Load CSV and parse:** - Read `../brain-methods.csv` -- Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration +- Parse: category, technique_name, description - Map techniques to each phase of the creative journey ### 2. Design Phase-Specific Technique Selection @@ -128,10 +128,9 @@ Show the full progressive flow with timing and transitions: "**Your Complete Creative Journey Map:** -**⏰ Total Journey Time:** [Combined duration] **🎯 Session Focus:** Systematic development from ideas to action -**Phase 1: Expansive Exploration** ([duration]) +**Phase 1: Expansive Exploration** - **Technique:** [Selected technique] - **Goal:** Generate [number]+ diverse ideas without limits @@ -139,7 +138,7 @@ Show the full progressive flow with timing and transitions: **→ Phase Transition:** We'll review and cluster ideas before moving deeper -**Phase 2: Pattern Recognition** ([duration]) +**Phase 2: Pattern Recognition** - **Technique:** [Selected technique] - **Goal:** Identify themes and prioritize most promising directions @@ -147,7 +146,7 @@ Show the full progressive flow with timing and transitions: **→ Phase Transition:** Select top concepts for detailed development -**Phase 3: Idea Development** ([duration]) +**Phase 3: Idea Development** - **Technique:** [Selected technique] - **Goal:** Refine priority ideas with depth and practicality @@ -155,7 +154,7 @@ Show the full progressive flow with timing and transitions: **→ Phase Transition:** Choose final concepts for implementation planning -**Phase 4: Action Planning** ([duration]) +**Phase 4: Action Planning** - **Technique:** [Selected technique] - **Goal:** Create concrete implementation plans and next steps diff --git a/src/core/skills/bmad-brainstorming/steps/step-03-technique-execution.md b/src/core/skills/bmad-brainstorming/steps/step-03-technique-execution.md index 28c11c916..6c30a9e3d 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-03-technique-execution.md +++ b/src/core/skills/bmad-brainstorming/steps/step-03-technique-execution.md @@ -12,7 +12,7 @@ - 🧠 **THOUGHT BEFORE INK (CoT):** Before generating each idea, you must internally reason: "What domain haven't we explored yet? What would make this idea surprising or 'uncomfortable' for the user?" - 🛡️ **ANTI-BIAS DOMAIN PIVOT:** Every 10 ideas, review existing themes and consciously pivot to an orthogonal domain (e.g., UX -> Business -> Physics -> Social Impact). - 🌡️ **SIMULATED TEMPERATURE:** Act as if your creativity is set to 0.85 - take wilder leaps and suggest "provocative" concepts. -- ⏱️ Spend minimum 30-45 minutes in active ideation before offering to conclude +- ⏱️ Generate at least 100 ideas in active ideation before offering to conclude - 🎯 EXECUTE ONE TECHNIQUE ELEMENT AT A TIME with interactive exploration - 📋 RESPOND DYNAMICALLY to user insights and build upon their ideas - 🔍 ADAPT FACILITATION based on user engagement and emerging directions @@ -176,7 +176,7 @@ Remember: The goal is quantity first - we can organize later. What feels right?" **IMPORTANT:** Default to continuing exploration. Only suggest organization if: - User has explicitly asked to wrap up, OR -- You've been exploring for 45+ minutes AND generated 100+ ideas, OR +- You've generated 100+ ideas, OR - User's energy is clearly depleted (short responses, "I don't know", etc.) ### 4a. Handle Immediate Technique Transition From 75292af47c7c44afbaf857e5aa633b632010fa45 Mon Sep 17 00:00:00 2001 From: Alex Verkhovsky Date: Sun, 15 Mar 2026 10:58:16 -0600 Subject: [PATCH 03/11] fix(skills): add missing HALT instructions before user menus STEP-04 compliance: add explicit HALT directives after menu presentations in brainstorming (4 locations) and generate-project-context (2 locations) to prevent LLM from auto-selecting options without waiting for user input. Co-Authored-By: Claude Opus 4.6 (1M context) --- .../bmad-generate-project-context/steps/step-01-discover.md | 2 ++ .../bmad-generate-project-context/steps/step-02-generate.md | 2 ++ .../skills/bmad-brainstorming/steps/step-01-session-setup.md | 4 ++++ .../bmad-brainstorming/steps/step-03-technique-execution.md | 2 ++ .../bmad-brainstorming/steps/step-04-idea-organization.md | 2 ++ 5 files changed, 12 insertions(+) diff --git a/src/bmm/workflows/bmad-generate-project-context/steps/step-01-discover.md b/src/bmm/workflows/bmad-generate-project-context/steps/step-01-discover.md index 03ef49a47..7c69b7e0c 100644 --- a/src/bmm/workflows/bmad-generate-project-context/steps/step-01-discover.md +++ b/src/bmm/workflows/bmad-generate-project-context/steps/step-01-discover.md @@ -160,6 +160,8 @@ Ready to create/update your project context. This will help AI agents implement [C] Continue to context generation" +**HALT — wait for user selection before proceeding.** + ## SUCCESS METRICS: ✅ Existing project context properly detected and handled diff --git a/src/bmm/workflows/bmad-generate-project-context/steps/step-02-generate.md b/src/bmm/workflows/bmad-generate-project-context/steps/step-02-generate.md index a4ff4e256..2bc33c8d9 100644 --- a/src/bmm/workflows/bmad-generate-project-context/steps/step-02-generate.md +++ b/src/bmm/workflows/bmad-generate-project-context/steps/step-02-generate.md @@ -264,6 +264,8 @@ After each category, show the generated rules and present choices: [P] Party Mode - Review from different implementation perspectives [C] Continue - Save these rules and move to next category" +**HALT — wait for user selection before proceeding.** + ### 10. Handle Menu Selection #### If 'A' (Advanced Elicitation): diff --git a/src/core/skills/bmad-brainstorming/steps/step-01-session-setup.md b/src/core/skills/bmad-brainstorming/steps/step-01-session-setup.md index edbf453c1..cdc6069c3 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-01-session-setup.md +++ b/src/core/skills/bmad-brainstorming/steps/step-01-session-setup.md @@ -48,6 +48,8 @@ If existing session files are found: **[2]** Start a new session **[3]** See all existing sessions" +**HALT — wait for user selection before proceeding.** + - If user selects **[1]** (continue): Set `{brainstorming_session_output_file}` to that file path and load `./step-01b-continue.md` - If user selects **[2]** (new): Generate new filename with current date/time and proceed to step 3 - If user selects **[3]** (see all): List all session filenames and ask which to continue or if new @@ -155,6 +157,8 @@ When user selects approach, append the session overview content directly to `{br Which approach appeals to you most? (Enter 1-4)" +**HALT — wait for user selection before proceeding.** + ### 4. Handle User Selection and Initial Document Append #### When user selects approach number: diff --git a/src/core/skills/bmad-brainstorming/steps/step-03-technique-execution.md b/src/core/skills/bmad-brainstorming/steps/step-03-technique-execution.md index 6c30a9e3d..a030b5522 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-03-technique-execution.md +++ b/src/core/skills/bmad-brainstorming/steps/step-03-technique-execution.md @@ -290,6 +290,8 @@ After final technique element: [B] **Take a quick break** - Pause and return with fresh energy [C] **Move to organization** - Only when you feel we've thoroughly explored +**HALT — wait for user selection before proceeding.** + **Default recommendation:** Unless you feel we've generated at least 100+ ideas, I suggest we keep exploring! The best insights often come after the obvious ideas are exhausted. ### 8. Handle Menu Selection diff --git a/src/core/skills/bmad-brainstorming/steps/step-04-idea-organization.md b/src/core/skills/bmad-brainstorming/steps/step-04-idea-organization.md index 74e7faeb8..cf40dc3cf 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-04-idea-organization.md +++ b/src/core/skills/bmad-brainstorming/steps/step-04-idea-organization.md @@ -249,6 +249,8 @@ Provide final session wrap-up and forward guidance: **Ready to complete your session documentation?** [C] Complete - Generate final brainstorming session document +**HALT — wait for user selection before proceeding.** + ### 8. Handle Completion Selection #### If [C] Complete: From 6ee4062e567da404d346a1b231eb500e8886522e Mon Sep 17 00:00:00 2001 From: Alex Verkhovsky Date: Sun, 15 Mar 2026 11:12:35 -0600 Subject: [PATCH 04/11] fix(skills): add remaining HALT instructions in brainstorming menus STEP-04 compliance: add HALT directives to 5 additional menu locations in brainstorming steps (01b, 02a, 02b, 02c, 02d). Also fixes bracket typo [3 -> [3] in step-01b-continue.md. Co-Authored-By: Claude Opus 4.6 (1M context) EOF ) --- src/core/skills/bmad-brainstorming/steps/step-01b-continue.md | 4 +++- .../skills/bmad-brainstorming/steps/step-02a-user-selected.md | 4 ++++ .../bmad-brainstorming/steps/step-02b-ai-recommended.md | 2 ++ .../bmad-brainstorming/steps/step-02c-random-selection.md | 2 ++ .../bmad-brainstorming/steps/step-02d-progressive-flow.md | 2 ++ 5 files changed, 13 insertions(+), 1 deletion(-) diff --git a/src/core/skills/bmad-brainstorming/steps/step-01b-continue.md b/src/core/skills/bmad-brainstorming/steps/step-01b-continue.md index 9b7e5968c..27e41500a 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-01b-continue.md +++ b/src/core/skills/bmad-brainstorming/steps/step-01b-continue.md @@ -63,7 +63,9 @@ Based on session analysis, provide appropriate options: **Options:** [1] Review Results - Go through your documented ideas and insights [2] Start New Session - Begin brainstorming on a new topic -[3) Extend Session - Add more techniques or explore new angles" +[3] Extend Session - Add more techniques or explore new angles" + +**HALT — wait for user selection before proceeding.** **If Session In Progress:** "Let's continue where we left off! diff --git a/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md b/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md index f10588f8a..20c8e9226 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md @@ -87,6 +87,8 @@ Show available categories with brief descriptions: **Which category interests you most? Enter 1-7, or tell me what type of thinking you're drawn to.**" +**HALT — wait for user selection before proceeding.** + ### 3. Handle Category Selection After user selects category: @@ -154,6 +156,8 @@ This combination will focus on [expected outcomes]. [C] Continue - Begin technique execution [Back] - Modify technique selection" +**HALT — wait for user selection before proceeding.** + ### 6. Update Frontmatter and Continue If user confirms: diff --git a/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md b/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md index d9ccf6b72..c5a7e226e 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md @@ -142,6 +142,8 @@ Provide deeper insight into each recommended technique: [Details] - Tell me more about any specific technique [Back] - Return to approach selection +**HALT — wait for user selection before proceeding.** + ### 6. Handle User Response #### If [C] Continue: diff --git a/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md b/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md index e1c1db754..b229f8df4 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md @@ -120,6 +120,8 @@ You're about to experience brainstorming in a completely new way. These unexpect [Details] - Tell me more about any specific technique [Back] - Return to approach selection +**HALT — wait for user selection before proceeding.** + ### 5. Handle User Response #### If [C] Continue: diff --git a/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md b/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md index 2d35275a2..3134513d0 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md @@ -175,6 +175,8 @@ Show the full progressive flow with timing and transitions: [Details] - Tell me more about any specific phase or technique [Back] - Return to approach selection +**HALT — wait for user selection before proceeding.** + ### 4. Handle Customization Requests If user wants customization: From de565221d816d10d4a9962c60edade0961a103cc Mon Sep 17 00:00:00 2001 From: Alex Verkhovsky Date: Sun, 15 Mar 2026 11:22:38 -0600 Subject: [PATCH 05/11] fix(skills): strip redundant markdown links in edit-prd step references MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Bare filenames are cleaner than [file.md](file.md) for LLM-consumed skill files — the markdown link wrapper adds nothing when display text and URL are identical. Co-Authored-By: Claude Opus 4.6 (1M context) --- .../bmad-edit-prd/steps-e/step-e-01-discovery.md | 4 ++-- .../bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md | 2 +- .../bmad-edit-prd/steps-e/step-e-02-review.md | 4 ++-- .../2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md | 2 +- .../bmad-edit-prd/steps-e/step-e-04-complete.md | 2 +- src/bmm/workflows/2-plan-workflows/bmad-edit-prd/workflow.md | 2 +- 6 files changed, 8 insertions(+), 8 deletions(-) diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md index fd9071e5f..14bd7919f 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md @@ -184,7 +184,7 @@ Display: "**Edit Requirements Understood** **Proceeding to deep review and analysis...**" -Read fully and follow: [step-e-02-review.md](step-e-02-review.md) +Read fully and follow: step-e-02-review.md **IF PRD is Legacy (Non-Standard) AND no validation report:** @@ -211,7 +211,7 @@ Present MENU OPTIONS below for user selection #### Menu Handling Logic: -- IF C (Convert): Read fully and follow: [step-e-01b-legacy-conversion.md](step-e-01b-legacy-conversion.md) +- IF C (Convert): Read fully and follow: step-e-01b-legacy-conversion.md - IF E (Edit As-Is): Display "Proceeding with edits..." then load next step - IF X (Exit): Display summary and exit - IF Any other: help user, then redisplay menu diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md index b9a9eb5a7..7ca17a340 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md @@ -178,7 +178,7 @@ Edit goals: {summary} **Proceeding to deep review...**" -Read fully and follow: [step-e-02-review.md](step-e-02-review.md) +Read fully and follow: step-e-02-review.md --- diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md index efac80337..ca1ed6d4f 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md @@ -200,7 +200,7 @@ Display: "**Change Plan Approved** **Proceeding to edit step...**" -Read fully and follow: [step-e-03-edit.md](step-e-03-edit.md) +Read fully and follow: step-e-03-edit.md ### 7. Present MENU OPTIONS (If User Wants Discussion) @@ -217,7 +217,7 @@ Read fully and follow: [step-e-03-edit.md](step-e-03-edit.md) - IF A: Invoke the `bmad-advanced-elicitation` skill, then return to discussion - IF P: Invoke the `bmad-party-mode` skill, then return to discussion -- IF C: Document approval, then load [step-e-03-edit.md](step-e-03-edit.md) +- IF C: Document approval, then load step-e-03-edit.md - IF Any other: discuss, then redisplay menu --- diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md index be33fa2a9..1c93afa50 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md @@ -217,7 +217,7 @@ Display: #### Menu Handling Logic: -- IF C (Continue): Read fully and follow: [step-e-04-complete.md](step-e-04-complete.md) +- IF C (Continue): Read fully and follow: step-e-04-complete.md - IF A (Adjust): Accept additional requirements, loop back to editing --- diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md index 943bdbf90..31e620ae0 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md @@ -124,7 +124,7 @@ Display: - Display: "**Additional Edits**" - Ask: "What additional edits would you like to make?" - Accept input, then display: "**Returning to edit step...**" - - Read fully and follow: [step-e-03-edit.md](step-e-03-edit.md) again + - Read fully and follow: step-e-03-edit.md again - **IF S (Summary):** - Display detailed summary including: diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/workflow.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/workflow.md index d68b90bc5..b0f6864fc 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/workflow.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/workflow.md @@ -60,4 +60,4 @@ Load and read full config from {main_config} and resolve: Prompt for PRD path: "Which PRD would you like to edit? Please provide the path to the PRD.md file." -Then read fully and follow: [steps-e/step-e-01-discovery.md](steps-e/step-e-01-discovery.md) +Then read fully and follow: steps-e/step-e-01-discovery.md From cb16a4fac220b7b55c2e597c60b89ed9e24ce62c Mon Sep 17 00:00:00 2001 From: Alex Verkhovsky Date: Sun, 15 Mar 2026 11:24:13 -0600 Subject: [PATCH 06/11] fix(skills): strip redundant [workflow.md](workflow.md) links repo-wide Replace `[workflow.md](workflow.md)` with bare `workflow.md` in all 34 SKILL.md files. Redundant markdown link syntax adds noise for LLM consumers. Also update the validator example to match. Co-Authored-By: Claude Opus 4.6 (1M context) --- src/bmm/workflows/1-analysis/bmad-create-product-brief/SKILL.md | 2 +- .../workflows/1-analysis/research/bmad-domain-research/SKILL.md | 2 +- .../workflows/1-analysis/research/bmad-market-research/SKILL.md | 2 +- .../1-analysis/research/bmad-technical-research/SKILL.md | 2 +- .../workflows/2-plan-workflows/bmad-create-ux-design/SKILL.md | 2 +- src/bmm/workflows/2-plan-workflows/bmad-edit-prd/SKILL.md | 2 +- src/bmm/workflows/2-plan-workflows/bmad-validate-prd/SKILL.md | 2 +- .../3-solutioning/bmad-check-implementation-readiness/SKILL.md | 2 +- .../workflows/3-solutioning/bmad-create-architecture/SKILL.md | 2 +- .../3-solutioning/bmad-create-epics-and-stories/SKILL.md | 2 +- src/bmm/workflows/4-implementation/bmad-code-review/SKILL.md | 2 +- src/bmm/workflows/4-implementation/bmad-correct-course/SKILL.md | 2 +- src/bmm/workflows/4-implementation/bmad-create-story/SKILL.md | 2 +- src/bmm/workflows/4-implementation/bmad-dev-story/SKILL.md | 2 +- src/bmm/workflows/4-implementation/bmad-retrospective/SKILL.md | 2 +- .../workflows/4-implementation/bmad-sprint-planning/SKILL.md | 2 +- src/bmm/workflows/4-implementation/bmad-sprint-status/SKILL.md | 2 +- src/bmm/workflows/bmad-document-project/SKILL.md | 2 +- src/bmm/workflows/bmad-generate-project-context/SKILL.md | 2 +- src/bmm/workflows/bmad-qa-generate-e2e-tests/SKILL.md | 2 +- .../bmad-quick-flow/bmad-quick-dev-new-preview/SKILL.md | 2 +- src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/SKILL.md | 2 +- src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/SKILL.md | 2 +- src/core/skills/bmad-advanced-elicitation/SKILL.md | 2 +- src/core/skills/bmad-brainstorming/SKILL.md | 2 +- src/core/skills/bmad-editorial-review-prose/SKILL.md | 2 +- src/core/skills/bmad-editorial-review-structure/SKILL.md | 2 +- src/core/skills/bmad-help/SKILL.md | 2 +- src/core/skills/bmad-index-docs/SKILL.md | 2 +- src/core/skills/bmad-party-mode/SKILL.md | 2 +- src/core/skills/bmad-review-adversarial-general/SKILL.md | 2 +- src/core/skills/bmad-review-edge-case-hunter/SKILL.md | 2 +- src/core/skills/bmad-shard-doc/SKILL.md | 2 +- src/core/tasks/bmad-create-prd/SKILL.md | 2 +- tools/skill-validator.md | 2 +- 35 files changed, 35 insertions(+), 35 deletions(-) diff --git a/src/bmm/workflows/1-analysis/bmad-create-product-brief/SKILL.md b/src/bmm/workflows/1-analysis/bmad-create-product-brief/SKILL.md index 4ef96c650..a66ee7a49 100644 --- a/src/bmm/workflows/1-analysis/bmad-create-product-brief/SKILL.md +++ b/src/bmm/workflows/1-analysis/bmad-create-product-brief/SKILL.md @@ -3,4 +3,4 @@ name: bmad-create-product-brief description: 'Create product brief through collaborative discovery. Use when the user says "lets create a product brief" or "help me create a project brief"' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/1-analysis/research/bmad-domain-research/SKILL.md b/src/bmm/workflows/1-analysis/research/bmad-domain-research/SKILL.md index f978519dc..fcddc7751 100644 --- a/src/bmm/workflows/1-analysis/research/bmad-domain-research/SKILL.md +++ b/src/bmm/workflows/1-analysis/research/bmad-domain-research/SKILL.md @@ -3,4 +3,4 @@ name: bmad-domain-research description: 'Conduct domain and industry research. Use when the user says "lets create a research report on [domain or industry]"' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/1-analysis/research/bmad-market-research/SKILL.md b/src/bmm/workflows/1-analysis/research/bmad-market-research/SKILL.md index 1e8c1190f..44f1a6abe 100644 --- a/src/bmm/workflows/1-analysis/research/bmad-market-research/SKILL.md +++ b/src/bmm/workflows/1-analysis/research/bmad-market-research/SKILL.md @@ -3,4 +3,4 @@ name: bmad-market-research description: 'Conduct market research on competition and customers. Use when the user says "create a market research report about [business idea]".' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/1-analysis/research/bmad-technical-research/SKILL.md b/src/bmm/workflows/1-analysis/research/bmad-technical-research/SKILL.md index fe3df662e..d6930a40d 100644 --- a/src/bmm/workflows/1-analysis/research/bmad-technical-research/SKILL.md +++ b/src/bmm/workflows/1-analysis/research/bmad-technical-research/SKILL.md @@ -3,4 +3,4 @@ name: bmad-technical-research description: 'Conduct technical research on technologies and architecture. Use when the user says "create a technical research report on [topic]".' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/SKILL.md b/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/SKILL.md index d3d2c9af2..96079575b 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/SKILL.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/SKILL.md @@ -3,4 +3,4 @@ name: bmad-create-ux-design description: 'Plan UX patterns and design specifications. Use when the user says "lets create UX design" or "create UX specifications" or "help me plan the UX"' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/SKILL.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/SKILL.md index 43f6e3181..b16498d39 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/SKILL.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/SKILL.md @@ -3,4 +3,4 @@ name: bmad-edit-prd description: 'Edit an existing PRD. Use when the user says "edit this PRD".' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/SKILL.md b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/SKILL.md index 7c9eb0bd5..77b523b81 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/SKILL.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/SKILL.md @@ -3,4 +3,4 @@ name: bmad-validate-prd description: 'Validate a PRD against standards. Use when the user says "validate this PRD" or "run PRD validation"' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/3-solutioning/bmad-check-implementation-readiness/SKILL.md b/src/bmm/workflows/3-solutioning/bmad-check-implementation-readiness/SKILL.md index f76bba0a2..d5ba0903f 100644 --- a/src/bmm/workflows/3-solutioning/bmad-check-implementation-readiness/SKILL.md +++ b/src/bmm/workflows/3-solutioning/bmad-check-implementation-readiness/SKILL.md @@ -3,4 +3,4 @@ name: bmad-check-implementation-readiness description: 'Validate PRD, UX, Architecture and Epics specs are complete. Use when the user says "check implementation readiness".' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/3-solutioning/bmad-create-architecture/SKILL.md b/src/bmm/workflows/3-solutioning/bmad-create-architecture/SKILL.md index 24c2fbdab..27d4c7e66 100644 --- a/src/bmm/workflows/3-solutioning/bmad-create-architecture/SKILL.md +++ b/src/bmm/workflows/3-solutioning/bmad-create-architecture/SKILL.md @@ -3,4 +3,4 @@ name: bmad-create-architecture description: 'Create architecture solution design decisions for AI agent consistency. Use when the user says "lets create architecture" or "create technical architecture" or "create a solution design"' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/3-solutioning/bmad-create-epics-and-stories/SKILL.md b/src/bmm/workflows/3-solutioning/bmad-create-epics-and-stories/SKILL.md index d1ce639b9..d092487dc 100644 --- a/src/bmm/workflows/3-solutioning/bmad-create-epics-and-stories/SKILL.md +++ b/src/bmm/workflows/3-solutioning/bmad-create-epics-and-stories/SKILL.md @@ -3,4 +3,4 @@ name: bmad-create-epics-and-stories description: 'Break requirements into epics and user stories. Use when the user says "create the epics and stories list"' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/4-implementation/bmad-code-review/SKILL.md b/src/bmm/workflows/4-implementation/bmad-code-review/SKILL.md index 35edf0505..a5b4225a0 100644 --- a/src/bmm/workflows/4-implementation/bmad-code-review/SKILL.md +++ b/src/bmm/workflows/4-implementation/bmad-code-review/SKILL.md @@ -3,4 +3,4 @@ name: bmad-code-review description: 'Perform adversarial code review finding specific issues. Use when the user says "run code review" or "review this code"' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/4-implementation/bmad-correct-course/SKILL.md b/src/bmm/workflows/4-implementation/bmad-correct-course/SKILL.md index fe2501552..021c715f8 100644 --- a/src/bmm/workflows/4-implementation/bmad-correct-course/SKILL.md +++ b/src/bmm/workflows/4-implementation/bmad-correct-course/SKILL.md @@ -3,4 +3,4 @@ name: bmad-correct-course description: 'Manage significant changes during sprint execution. Use when the user says "correct course" or "propose sprint change"' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/4-implementation/bmad-create-story/SKILL.md b/src/bmm/workflows/4-implementation/bmad-create-story/SKILL.md index 5acb64e97..66119b062 100644 --- a/src/bmm/workflows/4-implementation/bmad-create-story/SKILL.md +++ b/src/bmm/workflows/4-implementation/bmad-create-story/SKILL.md @@ -3,4 +3,4 @@ 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]"' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/4-implementation/bmad-dev-story/SKILL.md b/src/bmm/workflows/4-implementation/bmad-dev-story/SKILL.md index c7217863d..0eb505cc7 100644 --- a/src/bmm/workflows/4-implementation/bmad-dev-story/SKILL.md +++ b/src/bmm/workflows/4-implementation/bmad-dev-story/SKILL.md @@ -3,4 +3,4 @@ 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"' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/4-implementation/bmad-retrospective/SKILL.md b/src/bmm/workflows/4-implementation/bmad-retrospective/SKILL.md index bf07612b9..bdc2b6d2a 100644 --- a/src/bmm/workflows/4-implementation/bmad-retrospective/SKILL.md +++ b/src/bmm/workflows/4-implementation/bmad-retrospective/SKILL.md @@ -3,4 +3,4 @@ name: bmad-retrospective description: 'Post-epic review to extract lessons and assess success. Use when the user says "run a retrospective" or "lets retro the epic [epic]"' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/4-implementation/bmad-sprint-planning/SKILL.md b/src/bmm/workflows/4-implementation/bmad-sprint-planning/SKILL.md index 88c35310e..85783cf00 100644 --- a/src/bmm/workflows/4-implementation/bmad-sprint-planning/SKILL.md +++ b/src/bmm/workflows/4-implementation/bmad-sprint-planning/SKILL.md @@ -3,4 +3,4 @@ name: bmad-sprint-planning description: 'Generate sprint status tracking from epics. Use when the user says "run sprint planning" or "generate sprint plan"' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/4-implementation/bmad-sprint-status/SKILL.md b/src/bmm/workflows/4-implementation/bmad-sprint-status/SKILL.md index c3642e86d..3a15968e8 100644 --- a/src/bmm/workflows/4-implementation/bmad-sprint-status/SKILL.md +++ b/src/bmm/workflows/4-implementation/bmad-sprint-status/SKILL.md @@ -3,4 +3,4 @@ name: bmad-sprint-status description: 'Summarize sprint status and surface risks. Use when the user says "check sprint status" or "show sprint status"' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/bmad-document-project/SKILL.md b/src/bmm/workflows/bmad-document-project/SKILL.md index 32e30ebc1..09422e159 100644 --- a/src/bmm/workflows/bmad-document-project/SKILL.md +++ b/src/bmm/workflows/bmad-document-project/SKILL.md @@ -3,4 +3,4 @@ name: bmad-document-project description: 'Document brownfield projects for AI context. Use when the user says "document this project" or "generate project docs"' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/bmad-generate-project-context/SKILL.md b/src/bmm/workflows/bmad-generate-project-context/SKILL.md index 369264285..e54067b14 100644 --- a/src/bmm/workflows/bmad-generate-project-context/SKILL.md +++ b/src/bmm/workflows/bmad-generate-project-context/SKILL.md @@ -3,4 +3,4 @@ name: bmad-generate-project-context description: 'Create project-context.md with AI rules. Use when the user says "generate project context" or "create project context"' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/bmad-qa-generate-e2e-tests/SKILL.md b/src/bmm/workflows/bmad-qa-generate-e2e-tests/SKILL.md index b34d2fc9c..5235f7b6c 100644 --- a/src/bmm/workflows/bmad-qa-generate-e2e-tests/SKILL.md +++ b/src/bmm/workflows/bmad-qa-generate-e2e-tests/SKILL.md @@ -3,4 +3,4 @@ name: bmad-qa-generate-e2e-tests description: 'Generate end to end automated tests for existing features. Use when the user says "create qa automated tests for [feature]"' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/SKILL.md b/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/SKILL.md index cb03301ac..bd4323225 100644 --- a/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/SKILL.md +++ b/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/SKILL.md @@ -3,4 +3,4 @@ name: bmad-quick-dev-new-preview description: 'Implements any user intent, requirement, story, bug fix or change request by producing clean working code artifacts that follow the project''s existing architecture, patterns and conventions. Use when the user wants to build, fix, tweak, refactor, add or modify any code, component or feature.' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/SKILL.md b/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/SKILL.md index cc2b628b1..602015cf0 100644 --- a/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/SKILL.md +++ b/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/SKILL.md @@ -3,4 +3,4 @@ name: bmad-quick-dev description: 'Implement a Quick Tech Spec for small changes or features. Use when the user provides a quick tech spec and says "implement this quick spec" or "proceed with implementation of [quick tech spec]"' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/SKILL.md b/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/SKILL.md index 18cab1a26..b5419dfe2 100644 --- a/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/SKILL.md +++ b/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/SKILL.md @@ -3,4 +3,4 @@ name: bmad-quick-spec description: 'Very quick process to create implementation-ready quick specs for small changes or features. Use when the user says "create a quick spec" or "generate a quick tech spec"' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/core/skills/bmad-advanced-elicitation/SKILL.md b/src/core/skills/bmad-advanced-elicitation/SKILL.md index bcb381f95..999bcbae6 100644 --- a/src/core/skills/bmad-advanced-elicitation/SKILL.md +++ b/src/core/skills/bmad-advanced-elicitation/SKILL.md @@ -3,4 +3,4 @@ name: bmad-advanced-elicitation description: 'Push the LLM to reconsider, refine, and improve its recent output.' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/core/skills/bmad-brainstorming/SKILL.md b/src/core/skills/bmad-brainstorming/SKILL.md index 0d0d55663..865b476cc 100644 --- a/src/core/skills/bmad-brainstorming/SKILL.md +++ b/src/core/skills/bmad-brainstorming/SKILL.md @@ -3,4 +3,4 @@ name: bmad-brainstorming description: 'Facilitate interactive brainstorming sessions using diverse creative techniques and ideation methods. Use when the user says help me brainstorm or help me ideate.' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/core/skills/bmad-editorial-review-prose/SKILL.md b/src/core/skills/bmad-editorial-review-prose/SKILL.md index ccd895e23..3702b0378 100644 --- a/src/core/skills/bmad-editorial-review-prose/SKILL.md +++ b/src/core/skills/bmad-editorial-review-prose/SKILL.md @@ -3,4 +3,4 @@ name: bmad-editorial-review-prose description: 'Clinical copy-editor that reviews text for communication issues. Use when user says review for prose or improve the prose' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/core/skills/bmad-editorial-review-structure/SKILL.md b/src/core/skills/bmad-editorial-review-structure/SKILL.md index 917e04c62..5be13686b 100644 --- a/src/core/skills/bmad-editorial-review-structure/SKILL.md +++ b/src/core/skills/bmad-editorial-review-structure/SKILL.md @@ -3,4 +3,4 @@ name: bmad-editorial-review-structure description: 'Structural editor that proposes cuts, reorganization, and simplification while preserving comprehension. Use when user requests structural review or editorial review of structure' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/core/skills/bmad-help/SKILL.md b/src/core/skills/bmad-help/SKILL.md index fbd6ff60e..466509a64 100644 --- a/src/core/skills/bmad-help/SKILL.md +++ b/src/core/skills/bmad-help/SKILL.md @@ -3,4 +3,4 @@ name: bmad-help description: 'Analyzes what is done and the users query and offers advice on what to do next. Use if user says what should I do next or what do I do now' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/core/skills/bmad-index-docs/SKILL.md b/src/core/skills/bmad-index-docs/SKILL.md index 30e451a62..35fffdd45 100644 --- a/src/core/skills/bmad-index-docs/SKILL.md +++ b/src/core/skills/bmad-index-docs/SKILL.md @@ -3,4 +3,4 @@ name: bmad-index-docs description: 'Generates or updates an index.md to reference all docs in the folder. Use if user requests to create or update an index of all files in a specific folder' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/core/skills/bmad-party-mode/SKILL.md b/src/core/skills/bmad-party-mode/SKILL.md index bc8a92f22..8fb3d9af8 100644 --- a/src/core/skills/bmad-party-mode/SKILL.md +++ b/src/core/skills/bmad-party-mode/SKILL.md @@ -3,4 +3,4 @@ name: bmad-party-mode description: 'Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations. Use when user requests party mode.' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/core/skills/bmad-review-adversarial-general/SKILL.md b/src/core/skills/bmad-review-adversarial-general/SKILL.md index 88f5b2fa1..4900bc9e1 100644 --- a/src/core/skills/bmad-review-adversarial-general/SKILL.md +++ b/src/core/skills/bmad-review-adversarial-general/SKILL.md @@ -3,4 +3,4 @@ name: bmad-review-adversarial-general description: 'Perform a Cynical Review and produce a findings report. Use when the user requests a critical review of something' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/core/skills/bmad-review-edge-case-hunter/SKILL.md b/src/core/skills/bmad-review-edge-case-hunter/SKILL.md index 4417495ba..e321fb9ee 100644 --- a/src/core/skills/bmad-review-edge-case-hunter/SKILL.md +++ b/src/core/skills/bmad-review-edge-case-hunter/SKILL.md @@ -3,4 +3,4 @@ name: bmad-review-edge-case-hunter description: 'Walk every branching path and boundary condition in content, report only unhandled edge cases. Orthogonal to adversarial review - method-driven not attitude-driven. Use when you need exhaustive edge-case analysis of code, specs, or diffs.' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/core/skills/bmad-shard-doc/SKILL.md b/src/core/skills/bmad-shard-doc/SKILL.md index 2bd4404d4..442af56e2 100644 --- a/src/core/skills/bmad-shard-doc/SKILL.md +++ b/src/core/skills/bmad-shard-doc/SKILL.md @@ -3,4 +3,4 @@ name: bmad-shard-doc description: 'Splits large markdown documents into smaller, organized files based on level 2 (default) sections. Use if the user says perform shard document' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/src/core/tasks/bmad-create-prd/SKILL.md b/src/core/tasks/bmad-create-prd/SKILL.md index dc0c844ce..54f764032 100644 --- a/src/core/tasks/bmad-create-prd/SKILL.md +++ b/src/core/tasks/bmad-create-prd/SKILL.md @@ -3,4 +3,4 @@ name: bmad-create-prd description: 'Create a PRD from scratch. Use when the user says "lets create a product requirements document" or "I want to create a new PRD"' --- -Follow the instructions in [workflow.md](workflow.md). +Follow the instructions in ./workflow.md. diff --git a/tools/skill-validator.md b/tools/skill-validator.md index b3aac2302..2ca33ea8e 100644 --- a/tools/skill-validator.md +++ b/tools/skill-validator.md @@ -118,7 +118,7 @@ If no findings are generated, the skill passes validation. - CORRECT: `./steps/step-01-init.md` (from workflow.md at skill root to a step) - CORRECT: `./template.md` (from workflow.md to a sibling) - CORRECT: `../template.md` (from steps/step-01.md to a skill-root file) - - CORRECT: `[workflow.md](workflow.md)` (markdown link to sibling — bare relative) + - CORRECT: `workflow.md` (bare relative filename for sibling) - CORRECT: `./step-02-plan.md` (from steps/step-01.md to a sibling step) - WRONG: `./steps/step-02-plan.md` (from a file already inside steps/ — resolves to steps/steps/) - WRONG: `{installed_path}/template.md` From 1558a68a0ae8e1a471a818e29cd4be54c29eeb78 Mon Sep 17 00:00:00 2001 From: Alex Verkhovsky Date: Sun, 15 Mar 2026 11:42:12 -0600 Subject: [PATCH 07/11] fix(skills): add missing ./ prefix to bare step file references Bare filenames like `step-e-02-review.md` in "Read fully and follow:" directives need `./` prefix for consistent relative path resolution. Fixes 9 references across edit-prd, create-prd, and brainstorming. Co-Authored-By: Claude Opus 4.6 (1M context) --- .../bmad-edit-prd/steps-e/step-e-01-discovery.md | 4 ++-- .../bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md | 2 +- .../bmad-edit-prd/steps-e/step-e-02-review.md | 2 +- .../2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md | 2 +- .../bmad-edit-prd/steps-e/step-e-04-complete.md | 2 +- src/bmm/workflows/2-plan-workflows/bmad-edit-prd/workflow.md | 2 +- .../create-prd/steps-v/step-v-13-report-complete.md | 2 +- src/core/skills/bmad-brainstorming/workflow.md | 2 +- 8 files changed, 9 insertions(+), 9 deletions(-) diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md index 14bd7919f..3bc85e49a 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md @@ -184,7 +184,7 @@ Display: "**Edit Requirements Understood** **Proceeding to deep review and analysis...**" -Read fully and follow: step-e-02-review.md +Read fully and follow: `./step-e-02-review.md` **IF PRD is Legacy (Non-Standard) AND no validation report:** @@ -211,7 +211,7 @@ Present MENU OPTIONS below for user selection #### Menu Handling Logic: -- IF C (Convert): Read fully and follow: step-e-01b-legacy-conversion.md +- IF C (Convert): Read fully and follow: `./step-e-01b-legacy-conversion.md` - IF E (Edit As-Is): Display "Proceeding with edits..." then load next step - IF X (Exit): Display summary and exit - IF Any other: help user, then redisplay menu diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md index 7ca17a340..c1f868995 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md @@ -178,7 +178,7 @@ Edit goals: {summary} **Proceeding to deep review...**" -Read fully and follow: step-e-02-review.md +Read fully and follow: `./step-e-02-review.md` --- diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md index ca1ed6d4f..86e537adb 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md @@ -200,7 +200,7 @@ Display: "**Change Plan Approved** **Proceeding to edit step...**" -Read fully and follow: step-e-03-edit.md +Read fully and follow: `./step-e-03-edit.md` ### 7. Present MENU OPTIONS (If User Wants Discussion) diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md index 1c93afa50..eb9be1fc3 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md @@ -217,7 +217,7 @@ Display: #### Menu Handling Logic: -- IF C (Continue): Read fully and follow: step-e-04-complete.md +- IF C (Continue): Read fully and follow: `./step-e-04-complete.md` - IF A (Adjust): Accept additional requirements, loop back to editing --- diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md index 31e620ae0..be8c826f0 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md @@ -124,7 +124,7 @@ Display: - Display: "**Additional Edits**" - Ask: "What additional edits would you like to make?" - Accept input, then display: "**Returning to edit step...**" - - Read fully and follow: step-e-03-edit.md again + - Read fully and follow: `./step-e-03-edit.md` again - **IF S (Summary):** - Display detailed summary including: diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/workflow.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/workflow.md index b0f6864fc..2439a6c96 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/workflow.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/workflow.md @@ -60,4 +60,4 @@ Load and read full config from {main_config} and resolve: Prompt for PRD path: "Which PRD would you like to edit? Please provide the path to the PRD.md file." -Then read fully and follow: steps-e/step-e-01-discovery.md +Then read fully and follow: `./steps-e/step-e-01-discovery.md` diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-13-report-complete.md b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-13-report-complete.md index decc5579a..b08a35db8 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-13-report-complete.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-13-report-complete.md @@ -182,7 +182,7 @@ Display: - **IF E (Use Edit Workflow):** - Explain: "The Edit workflow (steps-e/) can use this validation report to systematically address issues. Edit mode will guide you through discovering what to edit, reviewing the PRD, and applying targeted improvements." - Offer: "Would you like to launch Edit mode now? It will help you fix validation findings systematically." - - If yes: Read fully and follow: steps-e/step-e-01-discovery.md + - If yes: Read fully and follow: `./steps-e/step-e-01-discovery.md` - If no: Return to menu - **IF F (Fix Simpler Items):** diff --git a/src/core/skills/bmad-brainstorming/workflow.md b/src/core/skills/bmad-brainstorming/workflow.md index dfdbfe9ff..168dab93e 100644 --- a/src/core/skills/bmad-brainstorming/workflow.md +++ b/src/core/skills/bmad-brainstorming/workflow.md @@ -48,6 +48,6 @@ All steps MUST reference `{brainstorming_session_output_file}` instead of the fu ## EXECUTION -Read fully and follow: `steps/step-01-session-setup.md` to begin the workflow. +Read fully and follow: `./steps/step-01-session-setup.md` to begin the workflow. **Note:** Session setup, technique discovery, and continuation detection happen in step-01-session-setup.md. From 1397c8f44a804113e55c539e0a5aaebdb9d99e09 Mon Sep 17 00:00:00 2001 From: Alex Verkhovsky Date: Sun, 15 Mar 2026 11:47:34 -0600 Subject: [PATCH 08/11] fix(skills): revert scope-creep menu changes in edit-prd step-e-03 Restore original menu options [V], [S], [A], [X] that were incorrectly replaced with [C], [A] during validation pass. The menu reduction was not covered by any validation rule. Co-Authored-By: Claude Opus 4.6 (1M context) --- .../bmad-edit-prd/steps-e/step-e-03-edit.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md index eb9be1fc3..20931b22e 100644 --- a/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md +++ b/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md @@ -207,8 +207,10 @@ Display: ### 8. Present MENU OPTIONS -**[C] Continue** - Proceed to completion and next steps +**[V] Run Validation** - Execute full validation workflow (./steps-v/step-v-01-discovery.md) +**[S] Summary Only** - End with summary of changes (no validation) **[A] Adjust** - Make additional edits +**[X] Exit** - Exit edit workflow #### EXECUTION RULES: @@ -217,8 +219,10 @@ Display: #### Menu Handling Logic: -- IF C (Continue): Read fully and follow: `./step-e-04-complete.md` +- IF V (Validate): Display "Starting validation workflow..." then read fully and follow: `./steps-v/step-v-01-discovery.md` +- IF S (Summary): Present edit summary and exit - IF A (Adjust): Accept additional requirements, loop back to editing +- IF X (Exit): Display summary and exit --- @@ -231,7 +235,8 @@ Display: - Restructuring completed (if needed) - Frontmatter updated accurately - Final verification confirms changes -- User can proceed to completion step or adjust edits +- User can proceed to validation or exit with summary +- Option to run validation seamlessly integrates edit and validate modes ### ❌ SYSTEM FAILURE: @@ -242,4 +247,4 @@ Display: - No final verification - Not saving updated PRD -**Master Rule:** Execute the plan exactly as approved. PRD is now ready for validation or downstream use. +**Master Rule:** Execute the plan exactly as approved. PRD is now ready for validation or downstream use. Validation integration ensures quality. From ac994d683d3af43a660f3e6a81c9ad1faaa5cbde Mon Sep 17 00:00:00 2001 From: Alex Verkhovsky Date: Sun, 15 Mar 2026 14:06:06 -0600 Subject: [PATCH 09/11] fix(skills): revert unnecessary rewording and misapplied REF-01 fixes - Revert SKILL.md wording change in product-brief-preview (not a validation issue) - Revert single-curly to double-curly conversions in create-architecture and create-epics-and-stories where the originals were display placeholders for LLM output, not template variables Co-Authored-By: Claude Opus 4.6 (1M context) --- .../bmad-product-brief-preview/SKILL.md | 4 ++-- .../steps/step-01-init.md | 12 ++++++------ .../steps/step-01b-continue.md | 8 ++++---- .../steps/step-02-context.md | 8 ++++---- .../steps/step-03-create-stories.md | 16 ++++++++-------- 5 files changed, 24 insertions(+), 24 deletions(-) diff --git a/src/bmm/workflows/1-analysis/bmad-product-brief-preview/SKILL.md b/src/bmm/workflows/1-analysis/bmad-product-brief-preview/SKILL.md index 3d0a87b3d..adeda50f7 100644 --- a/src/bmm/workflows/1-analysis/bmad-product-brief-preview/SKILL.md +++ b/src/bmm/workflows/1-analysis/bmad-product-brief-preview/SKILL.md @@ -84,5 +84,5 @@ Check activation context immediately: ## External Skills -This workflow may invoke: -- `bmad-init` — Invoke for configuration loading (module: bmm) +This workflow uses: +- `bmad-init` — Configuration loading (module: bmm) diff --git a/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-01-init.md b/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-01-init.md index 00ea5c205..c2933dfb8 100644 --- a/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-01-init.md +++ b/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-01-init.md @@ -112,13 +112,13 @@ Report what was found: **Documents Found:** -- PRD: {{number_of_prd_files_loaded_or_none}} -- UX Design: {{number_of_ux_files_loaded_or_none}} -- Research: {{number_of_research_files_loaded_or_none}} -- Project docs: {{number_of_project_files_loaded_or_none}} -- Project context: {{project_context_rules_count}} +- PRD: {number of PRD files loaded or "None found - REQUIRED"} +- UX Design: {number of UX files loaded or "None found"} +- Research: {number of research files loaded or "None found"} +- Project docs: {number of project files loaded or "None found"} +- Project context: {project_context_rules count of rules for AI agents found} -**Files loaded:** {{list_of_loaded_file_names}} +**Files loaded:** {list of specific file names or "No additional documents found"} Ready to begin architectural decision making. Do you have any other documents you'd like me to include? diff --git a/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-01b-continue.md b/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-01b-continue.md index d7e1d14fe..977896afc 100644 --- a/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-01b-continue.md +++ b/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-01b-continue.md @@ -64,13 +64,13 @@ Show the user their current progress: - Input documents loaded: {{number of inputDocuments}} files **Document Sections Found:** -{{list_of_h2_h3_sections_found_in_document}} +{list all H2/H3 sections found in the document} -{{if_incomplete_sections}} +{if_incomplete_sections} **Incomplete Areas:** -- {{areas_that_appear_incomplete_or_have_placeholders}} - {{/if_incomplete_sections}} +- {areas that appear incomplete or have placeholders} + {/if_incomplete_sections} **What would you like to do?** [R] Resume from where we left off diff --git a/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-02-context.md b/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-02-context.md index 5ccffdc87..96cb5c4e1 100644 --- a/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-02-context.md +++ b/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-02-context.md @@ -96,15 +96,15 @@ Present your analysis back to user for validation: "I'm reviewing your project documentation for {{project_name}}. -{{if_epics_loaded}}I see {{epic_count}} epics with {{story_count}} total stories.{{/if_epics_loaded}} -{{if_no_epics}}I found {{fr_count}} functional requirements organized into {{fr_category_list}}.{{/if_no_epics}} -{{if_ux_loaded}}I also found your UX specification which defines the user experience requirements.{{/if_ux_loaded}} +{if_epics_loaded}I see {{epic_count}} epics with {{story_count}} total stories.{/if_epics_loaded} +{if_no_epics}I found {{fr_count}} functional requirements organized into {{fr_category_list}}.{/if_no_epics} +{if_ux_loaded}I also found your UX specification which defines the user experience requirements.{/if_ux_loaded} **Key architectural aspects I notice:** - [Summarize core functionality from FRs] - [Note critical NFRs that will shape architecture] -- {{if_ux_loaded}}[Note UX complexity and technical requirements]{{/if_ux_loaded}} +- {if_ux_loaded}[Note UX complexity and technical requirements]{/if_ux_loaded} - [Identify unique technical challenges or constraints] - [Highlight any regulatory or compliance requirements] diff --git a/src/bmm/workflows/3-solutioning/bmad-create-epics-and-stories/steps/step-03-create-stories.md b/src/bmm/workflows/3-solutioning/bmad-create-epics-and-stories/steps/step-03-create-stories.md index 5c17a5dc5..14caafeb3 100644 --- a/src/bmm/workflows/3-solutioning/bmad-create-epics-and-stories/steps/step-03-create-stories.md +++ b/src/bmm/workflows/3-solutioning/bmad-create-epics-and-stories/steps/step-03-create-stories.md @@ -79,18 +79,18 @@ Stories must be independently completable in sequence: **STORY FORMAT (from template):** ``` -### Story {{N}}.{{M}}: {{story_title}} +### Story {N}.{M}: {story_title} -As a {{user_type}}, -I want {{capability}}, -So that {{value_benefit}}. +As a {user_type}, +I want {capability}, +So that {value_benefit}. **Acceptance Criteria:** -**Given** {{precondition}} -**When** {{action}} -**Then** {{expected_outcome}} -**And** {{additional_criteria}} +**Given** {precondition} +**When** {action} +**Then** {expected_outcome} +**And** {additional_criteria} ``` **✅ GOOD STORY EXAMPLES:** From 4937ce1bc247a3a7a5f9dd10715c6cc9cc18fc7d Mon Sep 17 00:00:00 2001 From: Alex Verkhovsky Date: Sun, 15 Mar 2026 14:46:05 -0600 Subject: [PATCH 10/11] fix(skills): revert out-of-scope changes from validation pass - Revert step renumbering in retrospective (no validator rule) - Revert full-scan-instructions, quick-dev-preview, quick-spec changes - Restore duration/energy/time content in brainstorming steps 02a-d, 03 (SEQ-02 time estimate removal was misapplied to display templates) Co-Authored-By: Claude Opus 4.6 (1M context) --- .../bmad-retrospective/workflow.md | 26 +++++++++---------- .../workflows/full-scan-instructions.md | 6 ++--- .../steps/step-01-clarify-and-route.md | 4 +-- .../steps/step-04-review.md | 4 +-- .../steps/step-01-understand.md | 2 +- .../steps/step-02a-user-selected.md | 8 +++--- .../steps/step-02b-ai-recommended.md | 16 +++++++++--- .../steps/step-02c-random-selection.md | 10 ++++--- .../steps/step-02d-progressive-flow.md | 9 ++++--- .../steps/step-03-technique-execution.md | 4 +-- 10 files changed, 52 insertions(+), 37 deletions(-) diff --git a/src/bmm/workflows/4-implementation/bmad-retrospective/workflow.md b/src/bmm/workflows/4-implementation/bmad-retrospective/workflow.md index 958fe13ef..3f56f728c 100644 --- a/src/bmm/workflows/4-implementation/bmad-retrospective/workflow.md +++ b/src/bmm/workflows/4-implementation/bmad-retrospective/workflow.md @@ -192,12 +192,12 @@ Bob (Scrum Master): "Perfect. Epic {{epic_number}} is complete and ready for ret - + Load input files according to the Input Files table in INITIALIZATION. For SELECTIVE_LOAD inputs, load only the epic matching {{epic_number}}. For FULL_LOAD inputs, load the complete document. For INDEX_GUIDED inputs, check the index first and load relevant sections. After discovery, these content variables are available: {epics_content} (selective load for this epic), {architecture_content}, {prd_content}, {document_project_content} After discovery, these content variables are available: {epics_content} (selective load for this epic), {architecture_content}, {prd_content}, {document_project_content} - + Bob (Scrum Master): "Before we start the team discussion, let me review all the story records to surface key themes. This'll help us have a richer conversation." @@ -291,7 +291,7 @@ Bob (Scrum Master): "We'll get to all of it. But first, let me load the previous - + Calculate previous epic number: {{prev_epic_num}} = {{epic_number}} - 1 @@ -387,7 +387,7 @@ Charlie (Senior Dev): "First epic, first retro. Let's make it count." - + Calculate next epic number: {{next_epic_num}} = {{epic_number}} + 1 @@ -476,7 +476,7 @@ Bob (Scrum Master): "No problem. We'll still do a thorough retro on Epic {{epic_ - + Load agent configurations from {agent_manifest} Identify which agents participated in Epic {{epic_number}} based on story records @@ -566,7 +566,7 @@ Bob (Scrum Master): "Exactly. {user_name}, any questions before we dive in?" - + Bob (Scrum Master): "Let's start with the good stuff. What went well in Epic {{epic_number}}?" @@ -711,13 +711,13 @@ Bob (Scrum Master): "Does that capture it? Anyone have something important we mi - + Bob (Scrum Master): "Normally we'd discuss preparing for the next epic, but since Epic {{next_epic_num}} isn't defined yet, let's skip to action items." - Skip to Step 9 + Skip to Step 8 @@ -835,7 +835,7 @@ Bob (Scrum Master): "{user_name}, does this preparation plan work for you?" - + Bob (Scrum Master): "Let's capture concrete action items from everything we've discussed." @@ -1076,7 +1076,7 @@ Bob (Scrum Master): "Everyone clear on what they own?" - + Bob (Scrum Master): "Before we close, I want to do a final readiness check." @@ -1259,7 +1259,7 @@ Charlie (Senior Dev): "Better to catch this now than three stories into the next - + Bob (Scrum Master): "We've covered a lot of ground today. Let me bring this retrospective to a close." @@ -1335,7 +1335,7 @@ Bob (Scrum Master): "See you all when prep work is done. Meeting adjourned!" - + Ensure retrospectives folder exists: {implementation_artifacts} Create folder if it doesn't exist @@ -1392,7 +1392,7 @@ Retrospective document was saved successfully, but {sprint_status_file} may need - + **✅ Retrospective Complete, {user_name}!** diff --git a/src/bmm/workflows/bmad-document-project/workflows/full-scan-instructions.md b/src/bmm/workflows/bmad-document-project/workflows/full-scan-instructions.md index bbf49af6a..dd90c4eea 100644 --- a/src/bmm/workflows/bmad-document-project/workflows/full-scan-instructions.md +++ b/src/bmm/workflows/bmad-document-project/workflows/full-scan-instructions.md @@ -89,21 +89,21 @@ Your choice [1/2/3]: Choose your scan depth level: -**1. Quick Scan** [DEFAULT] +**1. Quick Scan** (2-5 minutes) [DEFAULT] - Pattern-based analysis without reading source files - Scans: Config files, package manifests, directory structure - Best for: Quick project overview, initial understanding - File reading: Minimal (configs, README, package.json, etc.) -**2. Deep Scan** +**2. Deep Scan** (10-30 minutes) - Reads files in critical directories based on project type - Scans: All critical paths from documentation requirements - Best for: Comprehensive documentation for brownfield PRD - File reading: Selective (key files in critical directories) -**3. Exhaustive Scan** +**3. Exhaustive Scan** (30-120 minutes) - Reads ALL source files in project - Scans: Every source file (excludes node_modules, dist, build) diff --git a/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-01-clarify-and-route.md b/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-01-clarify-and-route.md index 4d4dc7046..5671b6c66 100644 --- a/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-01-clarify-and-route.md +++ b/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-01-clarify-and-route.md @@ -18,8 +18,8 @@ spec_file: '' # set at runtime before leaving this step - `{wipFile}` exists? → Offer resume or archive. - Active specs (`ready-for-dev`, `in-progress`, `in-review`) in `{implementation_artifacts}`? → List them and HALT. Ask user which to resume (or `[N]` for new). - - If `ready-for-dev` or `in-progress` selected: Set `spec_file`, set `execution_mode = "plan-code-review"`, proceed to step 3. - - If `in-review` selected: Set `spec_file`, set `execution_mode = "plan-code-review"`, proceed to step 4. + - If `ready-for-dev` or `in-progress` selected: Set `spec_file`, set `execution_mode = "plan-code-review"`, skip to step 3. + - If `in-review` selected: Set `spec_file`, set `execution_mode = "plan-code-review"`, skip to step 4. - Unformatted spec or intent file lacking `status` frontmatter in `{implementation_artifacts}`? → Suggest to the user to treat its contents as the starting intent for this workflow. DO NOT attempt to infer a state and resume it. ## INSTRUCTIONS diff --git a/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-04-review.md b/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-04-review.md index 2405c94a0..154e97d0a 100644 --- a/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-04-review.md +++ b/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-04-review.md @@ -26,8 +26,8 @@ Do NOT `git add` anything — this is read-only inspection. **Plan-code-review:** Launch three subagents without conversation context. If no sub-agents are available, generate three review prompt files in `{implementation_artifacts}` — one per reviewer role below — and HALT. Ask the human to run each in a separate session (ideally a different LLM) and paste back the findings. -- **Blind hunter** — receives `{diff_output}` only. No spec, no context docs, no project access. Invoke the `bmad-review-adversarial-general` skill. -- **Edge case hunter** — receives `{diff_output}` and read access to the project. Invoke the `bmad-review-edge-case-hunter` skill. +- **Blind hunter** — receives `{diff_output}` only. No spec, no context docs, no project access. Invoke via the `bmad-review-adversarial-general` skill. +- **Edge case hunter** — receives `{diff_output}` and read access to the project. Invoke via the `bmad-review-edge-case-hunter` skill. - **Acceptance auditor** — receives `{diff_output}`, `{spec_file}`, and read access to the project. Must also read the docs listed in `{spec_file}` frontmatter `context`. Checks for violations of acceptance criteria, rules, and principles from the spec and context docs. ### Classify diff --git a/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/steps/step-01-understand.md b/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/steps/step-01-understand.md index b8d61c2ca..1206271ea 100644 --- a/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/steps/step-01-understand.md +++ b/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/steps/step-01-understand.md @@ -86,7 +86,7 @@ d) **Build mental model:** - What's the likely scope based on what you found? - What questions do you NOW have, informed by the code? -**Just enough to ask smart questions.** +**This scan should take < 30 seconds. Just enough to ask smart questions.** ### 3. Ask Informed Questions diff --git a/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md b/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md index 20c8e9226..acab39e07 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md @@ -102,19 +102,19 @@ After user selects category: **Present 3-5 techniques from selected category:** For each technique: -- **Technique Name** +- **Technique Name** (Duration: [time], Energy: [level]) - Description: [Brief clear description] - Best for: [What this technique excels at] - Example prompt: [Sample facilitation prompt] **Example presentation format:** -"**1. SCAMPER Method** +"**1. SCAMPER Method** (Duration: 20-30 min, Energy: Moderate) - Systematic creativity through seven lenses (Substitute/Combine/Adapt/Modify/Put/Eliminate/Reverse) - Best for: Product improvement, innovation challenges, systematic idea generation - Example prompt: "What could you substitute in your current approach to create something new?" -**2. Six Thinking Hats** +**2. Six Thinking Hats** (Duration: 15-25 min, Energy: Moderate) - Explore problems through six distinct perspectives for comprehensive analysis - Best for: Complex decisions, team alignment, thorough exploration @@ -150,7 +150,7 @@ When user selects techniques: - [Technique 3]: [If selected, how it builds on others] **Session Plan:** -This combination will focus on [expected outcomes]. +This combination will take approximately [total_time] and focus on [expected outcomes]. **Confirm these choices?** [C] Continue - Begin technique execution diff --git a/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md b/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md index c5a7e226e..4c4607321 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md @@ -76,6 +76,12 @@ Analyze user's session context across multiple dimensions: - User language playful → creative, theatrical, wild techniques - User language reflective → introspective_delight, deep techniques +**4. Time Available:** + +- <30 min → 1-2 focused techniques +- 30-60 min → 2-3 complementary techniques +- > 60 min → Multi-phase technique flow + ### 3. Generate Technique Recommendations Based on context analysis, create tailored recommendations: @@ -85,20 +91,24 @@ Based on context analysis, create tailored recommendations: Based on your session context, I recommend this customized technique sequence: **Phase 1: Foundation Setting** -**[Technique Name]** from [Category] +**[Technique Name]** from [Category] (Duration: [time], Energy: [level]) + - **Why this fits:** [Specific connection to user's goals/context] - **Expected outcome:** [What this will accomplish for their session] **Phase 2: Idea Generation** -**[Technique Name]** from [Category] +**[Technique Name]** from [Category] (Duration: [time], Energy: [level]) + - **Why this builds on Phase 1:** [Complementary effect explanation] - **Expected outcome:** [How this develops the foundation] **Phase 3: Refinement & Action** (If time allows) -**[Technique Name]** from [Category] +**[Technique Name]** from [Category] (Duration: [time], Energy: [level]) + - **Why this concludes effectively:** [Final phase rationale] - **Expected outcome:** [How this leads to actionable results] +**Total Estimated Time:** [Sum of durations] **Session Focus:** [Primary benefit and outcome description]" ### 4. Present Recommendation Details diff --git a/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md b/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md index b229f8df4..053be279c 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md @@ -74,23 +74,27 @@ Reveal the randomly selected techniques with enthusiasm: "**🎲 Your Randomly Selected Creative Techniques! 🎲** **Phase 1: Exploration** -**[Random Technique 1]** from [Category] +**[Random Technique 1]** from [Category] (Duration: [time], Energy: [level]) + - **Description:** [Technique description] - **Why this is exciting:** [What makes this technique surprising or powerful] - **Random discovery bonus:** [Unexpected insight about this technique] **Phase 2: Connection** -**[Random Technique 2]** from [Category] +**[Random Technique 2]** from [Category] (Duration: [time], Energy: [level]) + - **Description:** [Technique description] - **Why this complements the first:** [How these techniques might work together] - **Random discovery bonus:** [Unexpected insight about this combination] **Phase 3: Synthesis** -**[Random Technique 3]** from [Category] +**[Random Technique 3]** from [Category] (Duration: [time], Energy: [level]) + - **Description:** [Technique description] - **Why this completes the journey:** [How this ties the sequence together] - **Random discovery bonus:** [Unexpected insight about the overall flow] +**Total Random Session Time:** [Combined duration] **Serendipity Factor:** [Enthusiastic description of creative potential]" ### 4. Highlight the Creative Potential diff --git a/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md b/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md index 3134513d0..b13affca8 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md @@ -128,9 +128,10 @@ Show the full progressive flow with timing and transitions: "**Your Complete Creative Journey Map:** +**⏰ Total Journey Time:** [Combined duration] **🎯 Session Focus:** Systematic development from ideas to action -**Phase 1: Expansive Exploration** +**Phase 1: Expansive Exploration** ([duration]) - **Technique:** [Selected technique] - **Goal:** Generate [number]+ diverse ideas without limits @@ -138,7 +139,7 @@ Show the full progressive flow with timing and transitions: **→ Phase Transition:** We'll review and cluster ideas before moving deeper -**Phase 2: Pattern Recognition** +**Phase 2: Pattern Recognition** ([duration]) - **Technique:** [Selected technique] - **Goal:** Identify themes and prioritize most promising directions @@ -146,7 +147,7 @@ Show the full progressive flow with timing and transitions: **→ Phase Transition:** Select top concepts for detailed development -**Phase 3: Idea Development** +**Phase 3: Idea Development** ([duration]) - **Technique:** [Selected technique] - **Goal:** Refine priority ideas with depth and practicality @@ -154,7 +155,7 @@ Show the full progressive flow with timing and transitions: **→ Phase Transition:** Choose final concepts for implementation planning -**Phase 4: Action Planning** +**Phase 4: Action Planning** ([duration]) - **Technique:** [Selected technique] - **Goal:** Create concrete implementation plans and next steps diff --git a/src/core/skills/bmad-brainstorming/steps/step-03-technique-execution.md b/src/core/skills/bmad-brainstorming/steps/step-03-technique-execution.md index a030b5522..71e708fec 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-03-technique-execution.md +++ b/src/core/skills/bmad-brainstorming/steps/step-03-technique-execution.md @@ -12,7 +12,7 @@ - 🧠 **THOUGHT BEFORE INK (CoT):** Before generating each idea, you must internally reason: "What domain haven't we explored yet? What would make this idea surprising or 'uncomfortable' for the user?" - 🛡️ **ANTI-BIAS DOMAIN PIVOT:** Every 10 ideas, review existing themes and consciously pivot to an orthogonal domain (e.g., UX -> Business -> Physics -> Social Impact). - 🌡️ **SIMULATED TEMPERATURE:** Act as if your creativity is set to 0.85 - take wilder leaps and suggest "provocative" concepts. -- ⏱️ Generate at least 100 ideas in active ideation before offering to conclude +- ⏱️ Spend minimum 30-45 minutes in active ideation before offering to conclude - 🎯 EXECUTE ONE TECHNIQUE ELEMENT AT A TIME with interactive exploration - 📋 RESPOND DYNAMICALLY to user insights and build upon their ideas - 🔍 ADAPT FACILITATION based on user engagement and emerging directions @@ -176,7 +176,7 @@ Remember: The goal is quantity first - we can organize later. What feels right?" **IMPORTANT:** Default to continuing exploration. Only suggest organization if: - User has explicitly asked to wrap up, OR -- You've generated 100+ ideas, OR +- You've been exploring for 45+ minutes AND generated 100+ ideas, OR - User's energy is clearly depleted (short responses, "I don't know", etc.) ### 4a. Handle Immediate Technique Transition From 8efc8c309c8f0027565b386e4ccf4548c090f42e Mon Sep 17 00:00:00 2001 From: Alex Verkhovsky Date: Sun, 15 Mar 2026 14:49:36 -0600 Subject: [PATCH 11/11] fix(skills): restore full CSV column list in brainstorming steps The CSV parse instructions were incorrectly truncated to 3 columns. Restore all 7: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration. Co-Authored-By: Claude Opus 4.6 (1M context) --- .../skills/bmad-brainstorming/steps/step-02a-user-selected.md | 2 +- .../skills/bmad-brainstorming/steps/step-02b-ai-recommended.md | 2 +- .../bmad-brainstorming/steps/step-02c-random-selection.md | 2 +- .../bmad-brainstorming/steps/step-02d-progressive-flow.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md b/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md index acab39e07..5335ff08a 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md @@ -41,7 +41,7 @@ Load techniques from CSV on-demand: **Load CSV and parse:** - Read `../brain-methods.csv` -- Parse: category, technique_name, description +- Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration - Organize by categories for browsing ### 2. Present Technique Categories diff --git a/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md b/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md index 4c4607321..b7d979a6b 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md @@ -48,7 +48,7 @@ Load techniques from CSV for analysis: **Load CSV and parse:** - Read `../brain-methods.csv` -- Parse: category, technique_name, description +- Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration ### 2. Context Analysis for Technique Matching diff --git a/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md b/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md index 053be279c..af3072fc4 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md @@ -48,7 +48,7 @@ Create anticipation for serendipitous technique discovery: **Load CSV and parse:** - Read `../brain-methods.csv` -- Parse: category, technique_name, description +- Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration - Prepare for intelligent random selection ### 2. Intelligent Random Selection diff --git a/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md b/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md index b13affca8..2677814db 100644 --- a/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md +++ b/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md @@ -67,7 +67,7 @@ Explain the value of systematic creative progression: **Load CSV and parse:** - Read `../brain-methods.csv` -- Parse: category, technique_name, description +- Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration - Map techniques to each phase of the creative journey ### 2. Design Phase-Specific Technique Selection