From 0d858cbc5be89d85786a80c38766073e2ae3d76e Mon Sep 17 00:00:00 2001 From: Brian Madison Date: Mon, 23 Feb 2026 15:31:03 -0600 Subject: [PATCH] standardize all workflow descriptions to use proper quotes to not break command or skilll front matter --- src/bmm/workflows/1-analysis/create-product-brief/workflow.md | 2 +- .../workflows/1-analysis/research/workflow-domain-research.md | 2 +- .../workflows/1-analysis/research/workflow-market-research.md | 2 +- .../1-analysis/research/workflow-technical-research.md | 2 +- .../2-plan-workflows/create-prd/workflow-create-prd.md | 2 +- .../workflows/2-plan-workflows/create-prd/workflow-edit-prd.md | 2 +- .../2-plan-workflows/create-prd/workflow-validate-prd.md | 2 +- src/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md | 2 +- .../3-solutioning/check-implementation-readiness/workflow.md | 2 +- src/bmm/workflows/3-solutioning/create-architecture/workflow.md | 2 +- .../3-solutioning/create-epics-and-stories/workflow.md | 2 +- src/bmm/workflows/4-implementation/code-review/workflow.yaml | 2 +- src/bmm/workflows/4-implementation/correct-course/workflow.yaml | 2 +- src/bmm/workflows/4-implementation/create-story/workflow.yaml | 2 +- src/bmm/workflows/4-implementation/dev-story/workflow.yaml | 2 +- src/bmm/workflows/4-implementation/retrospective/workflow.yaml | 2 +- .../workflows/4-implementation/sprint-planning/workflow.yaml | 2 +- src/bmm/workflows/4-implementation/sprint-status/workflow.yaml | 2 +- src/bmm/workflows/bmad-quick-flow/quick-dev/workflow.md | 2 +- src/bmm/workflows/bmad-quick-flow/quick-spec/workflow.md | 2 +- src/bmm/workflows/document-project/workflow.yaml | 2 +- src/bmm/workflows/generate-project-context/workflow.md | 2 +- src/bmm/workflows/qa-generate-e2e-tests/workflow.yaml | 2 +- src/core/tasks/editorial-review-prose.xml | 2 +- src/core/tasks/editorial-review-structure.xml | 2 +- src/core/tasks/help.md | 2 +- src/core/tasks/index-docs.xml | 2 +- src/core/tasks/review-adversarial-general.xml | 2 +- src/core/tasks/shard-doc.xml | 2 +- src/core/workflows/advanced-elicitation/workflow.xml | 2 +- src/core/workflows/brainstorming/workflow.md | 2 +- src/core/workflows/party-mode/workflow.md | 2 +- 32 files changed, 32 insertions(+), 32 deletions(-) diff --git a/src/bmm/workflows/1-analysis/create-product-brief/workflow.md b/src/bmm/workflows/1-analysis/create-product-brief/workflow.md index 1892603e7..c50d325ef 100644 --- a/src/bmm/workflows/1-analysis/create-product-brief/workflow.md +++ b/src/bmm/workflows/1-analysis/create-product-brief/workflow.md @@ -1,6 +1,6 @@ --- name: 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' +description: 'Create product brief through collaborative discovery. Use when the user says "lets create a product brief" or "help me create a project brief"' --- # Product Brief Workflow diff --git a/src/bmm/workflows/1-analysis/research/workflow-domain-research.md b/src/bmm/workflows/1-analysis/research/workflow-domain-research.md index 7dc86184b..ec193660d 100644 --- a/src/bmm/workflows/1-analysis/research/workflow-domain-research.md +++ b/src/bmm/workflows/1-analysis/research/workflow-domain-research.md @@ -1,6 +1,6 @@ --- name: domain-research -description: Conduct domain and industry research. Use when the user says 'lets create a research report on [domain or industry] +description: 'Conduct domain and industry research. Use when the user says "lets create a research report on [domain or industry]"' --- # Domain Research Workflow diff --git a/src/bmm/workflows/1-analysis/research/workflow-market-research.md b/src/bmm/workflows/1-analysis/research/workflow-market-research.md index 9c424c16b..8a77a67cd 100644 --- a/src/bmm/workflows/1-analysis/research/workflow-market-research.md +++ b/src/bmm/workflows/1-analysis/research/workflow-market-research.md @@ -1,6 +1,6 @@ --- name: market-research -description: Conduct market research on competition and customers. Use when the user says 'create a market research report about [business idea]'. +description: 'Conduct market research on competition and customers. Use when the user says "create a market research report about [business idea]".' --- # Market Research Workflow diff --git a/src/bmm/workflows/1-analysis/research/workflow-technical-research.md b/src/bmm/workflows/1-analysis/research/workflow-technical-research.md index 8ba2273d3..ecc9a2f27 100644 --- a/src/bmm/workflows/1-analysis/research/workflow-technical-research.md +++ b/src/bmm/workflows/1-analysis/research/workflow-technical-research.md @@ -1,6 +1,6 @@ --- name: technical-research -description: Conduct technical research on technologies and architecture. Use when the user says 'create a technical research report on [topic]'. +description: 'Conduct technical research on technologies and architecture. Use when the user says "create a technical research report on [topic]".' --- # Technical Research Workflow diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/workflow-create-prd.md b/src/bmm/workflows/2-plan-workflows/create-prd/workflow-create-prd.md index e84a0058e..c7c565a72 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/workflow-create-prd.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/workflow-create-prd.md @@ -1,6 +1,6 @@ --- name: 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' +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"' main_config: '{project-root}/_bmad/bmm/config.yaml' nextStep: './steps-c/step-01-init.md' --- diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/workflow-edit-prd.md b/src/bmm/workflows/2-plan-workflows/create-prd/workflow-edit-prd.md index 58a67a9bc..e416e11f5 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/workflow-edit-prd.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/workflow-edit-prd.md @@ -1,6 +1,6 @@ --- name: edit-prd -description: Edit an existing PRD. Use when the user says 'edit this PRD'. +description: 'Edit an existing PRD. Use when the user says "edit this PRD".' main_config: '{project-root}/_bmad/bmm/config.yaml' editWorkflow: './steps-e/step-e-01-discovery.md' --- diff --git a/src/bmm/workflows/2-plan-workflows/create-prd/workflow-validate-prd.md b/src/bmm/workflows/2-plan-workflows/create-prd/workflow-validate-prd.md index 4d59b42ee..7f0703440 100644 --- a/src/bmm/workflows/2-plan-workflows/create-prd/workflow-validate-prd.md +++ b/src/bmm/workflows/2-plan-workflows/create-prd/workflow-validate-prd.md @@ -1,6 +1,6 @@ --- name: validate-prd -description: Validate a PRD against standards. Use when the user says 'validate this PRD' or 'run PRD validation' +description: 'Validate a PRD against standards. Use when the user says "validate this PRD" or "run PRD validation"' main_config: '{project-root}/_bmad/bmm/config.yaml' validateWorkflow: './steps-v/step-v-01-discovery.md' --- diff --git a/src/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md b/src/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md index 19dfbb5ca..4dfdba9f1 100644 --- a/src/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md +++ b/src/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md @@ -1,6 +1,6 @@ --- name: 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' +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"' --- # Create UX Design Workflow diff --git a/src/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md b/src/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md index 38e2d10be..f1ab122ec 100644 --- a/src/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md +++ b/src/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md @@ -1,6 +1,6 @@ --- name: check-implementation-readiness -description: Validate PRD, UX, Architecture and Epics specs are complete. Use when the user says 'check implementation readiness'. +description: 'Validate PRD, UX, Architecture and Epics specs are complete. Use when the user says "check implementation readiness".' --- # Implementation Readiness diff --git a/src/bmm/workflows/3-solutioning/create-architecture/workflow.md b/src/bmm/workflows/3-solutioning/create-architecture/workflow.md index bee5fe33d..1fac8d1ac 100644 --- a/src/bmm/workflows/3-solutioning/create-architecture/workflow.md +++ b/src/bmm/workflows/3-solutioning/create-architecture/workflow.md @@ -1,6 +1,6 @@ --- name: 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' +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"' --- # Architecture Workflow diff --git a/src/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md b/src/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md index 23c791d94..41a6ee106 100644 --- a/src/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md +++ b/src/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md @@ -1,6 +1,6 @@ --- name: create-epics-and-stories -description: Break requirements into epics and user stories. Use when the user says 'create the epics and stories list' +description: 'Break requirements into epics and user stories. Use when the user says "create the epics and stories list"' --- # Create Epics and Stories diff --git a/src/bmm/workflows/4-implementation/code-review/workflow.yaml b/src/bmm/workflows/4-implementation/code-review/workflow.yaml index cea8f83c1..7965af5ae 100644 --- a/src/bmm/workflows/4-implementation/code-review/workflow.yaml +++ b/src/bmm/workflows/4-implementation/code-review/workflow.yaml @@ -1,6 +1,6 @@ # Review Story Workflow name: code-review -description: "Perform adversarial code review finding specific issues. Use when the user says 'run code review' or 'review this code'" +description: 'Perform adversarial code review finding specific issues. Use when the user says "run code review" or "review this code"' # Critical variables from config config_source: "{project-root}/_bmad/bmm/config.yaml" diff --git a/src/bmm/workflows/4-implementation/correct-course/workflow.yaml b/src/bmm/workflows/4-implementation/correct-course/workflow.yaml index a1d374a47..f2211f7b3 100644 --- a/src/bmm/workflows/4-implementation/correct-course/workflow.yaml +++ b/src/bmm/workflows/4-implementation/correct-course/workflow.yaml @@ -1,6 +1,6 @@ # Correct Course - Sprint Change Management Workflow name: "correct-course" -description: "Manage significant changes during sprint execution. Use when the user says 'correct course' or 'propose sprint change'" +description: 'Manage significant changes during sprint execution. Use when the user says "correct course" or "propose sprint change"' config_source: "{project-root}/_bmad/bmm/config.yaml" user_name: "{config_source}:user_name" diff --git a/src/bmm/workflows/4-implementation/create-story/workflow.yaml b/src/bmm/workflows/4-implementation/create-story/workflow.yaml index 118458110..972972aff 100644 --- a/src/bmm/workflows/4-implementation/create-story/workflow.yaml +++ b/src/bmm/workflows/4-implementation/create-story/workflow.yaml @@ -1,5 +1,5 @@ name: create-story -description: "Creates a dedicated story file with all the context the agent will need to implement it later. Use when the user says 'create the next story' or 'create story [story identifier]'" +description: '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]"' # Critical variables from config config_source: "{project-root}/_bmad/bmm/config.yaml" diff --git a/src/bmm/workflows/4-implementation/dev-story/workflow.yaml b/src/bmm/workflows/4-implementation/dev-story/workflow.yaml index 06442699a..b5ee9308a 100644 --- a/src/bmm/workflows/4-implementation/dev-story/workflow.yaml +++ b/src/bmm/workflows/4-implementation/dev-story/workflow.yaml @@ -1,5 +1,5 @@ name: dev-story -description: "Execute story implementation following a context filled story spec file. Use when the user says 'dev this story [story file]' or 'implement the next story in the sprint plan'" +description: '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"' # Critical variables from config config_source: "{project-root}/_bmad/bmm/config.yaml" diff --git a/src/bmm/workflows/4-implementation/retrospective/workflow.yaml b/src/bmm/workflows/4-implementation/retrospective/workflow.yaml index a92761af2..49ac2cc35 100644 --- a/src/bmm/workflows/4-implementation/retrospective/workflow.yaml +++ b/src/bmm/workflows/4-implementation/retrospective/workflow.yaml @@ -1,6 +1,6 @@ # Retrospective - Epic Completion Review Workflow name: "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]'" +description: 'Post-epic review to extract lessons and assess success. Use when the user says "run a retrospective" or "lets retro the epic [epic]"' config_source: "{project-root}/_bmad/bmm/config.yaml" user_name: "{config_source}:user_name" diff --git a/src/bmm/workflows/4-implementation/sprint-planning/workflow.yaml b/src/bmm/workflows/4-implementation/sprint-planning/workflow.yaml index f91cc1e88..0f1b73789 100644 --- a/src/bmm/workflows/4-implementation/sprint-planning/workflow.yaml +++ b/src/bmm/workflows/4-implementation/sprint-planning/workflow.yaml @@ -1,5 +1,5 @@ name: sprint-planning -description: "Generate sprint status tracking from epics. Use when the user says 'run sprint planning' or 'generate sprint plan'" +description: 'Generate sprint status tracking from epics. Use when the user says "run sprint planning" or "generate sprint plan"' author: "BMad" # Critical variables from config diff --git a/src/bmm/workflows/4-implementation/sprint-status/workflow.yaml b/src/bmm/workflows/4-implementation/sprint-status/workflow.yaml index e6b89df16..290b1ce32 100644 --- a/src/bmm/workflows/4-implementation/sprint-status/workflow.yaml +++ b/src/bmm/workflows/4-implementation/sprint-status/workflow.yaml @@ -1,6 +1,6 @@ # Sprint Status - Implementation Tracker name: sprint-status -description: "Summarize sprint status and surface risks. Use when the user says 'check sprint status' or 'show sprint status'" +description: 'Summarize sprint status and surface risks. Use when the user says "check sprint status" or "show sprint status"' author: "BMad" # Critical variables from config diff --git a/src/bmm/workflows/bmad-quick-flow/quick-dev/workflow.md b/src/bmm/workflows/bmad-quick-flow/quick-dev/workflow.md index f68d343b7..29349a5d8 100644 --- a/src/bmm/workflows/bmad-quick-flow/quick-dev/workflow.md +++ b/src/bmm/workflows/bmad-quick-flow/quick-dev/workflow.md @@ -1,6 +1,6 @@ --- name: 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]'" +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]"' --- # Quick Dev Workflow diff --git a/src/bmm/workflows/bmad-quick-flow/quick-spec/workflow.md b/src/bmm/workflows/bmad-quick-flow/quick-spec/workflow.md index 2cbd17f89..462f41741 100644 --- a/src/bmm/workflows/bmad-quick-flow/quick-spec/workflow.md +++ b/src/bmm/workflows/bmad-quick-flow/quick-spec/workflow.md @@ -1,6 +1,6 @@ --- name: 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' +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"' main_config: '{project-root}/_bmad/bmm/config.yaml' # Checkpoint handler paths diff --git a/src/bmm/workflows/document-project/workflow.yaml b/src/bmm/workflows/document-project/workflow.yaml index 8ca0599bf..a47acf090 100644 --- a/src/bmm/workflows/document-project/workflow.yaml +++ b/src/bmm/workflows/document-project/workflow.yaml @@ -1,7 +1,7 @@ # Document Project Workflow Configuration name: "document-project" version: "1.2.0" -description: "Document brownfield projects for AI context. Use when the user says 'document this project' or 'generate project docs'" +description: 'Document brownfield projects for AI context. Use when the user says "document this project" or "generate project docs"' author: "BMad" # Critical variables diff --git a/src/bmm/workflows/generate-project-context/workflow.md b/src/bmm/workflows/generate-project-context/workflow.md index 017e06121..f1537c06e 100644 --- a/src/bmm/workflows/generate-project-context/workflow.md +++ b/src/bmm/workflows/generate-project-context/workflow.md @@ -1,6 +1,6 @@ --- name: generate-project-context -description: Create project-context.md with AI rules. Use when the user says 'generate project context' or 'create project context' +description: 'Create project-context.md with AI rules. Use when the user says "generate project context" or "create project context"' --- # Generate Project Context Workflow diff --git a/src/bmm/workflows/qa-generate-e2e-tests/workflow.yaml b/src/bmm/workflows/qa-generate-e2e-tests/workflow.yaml index 3d28df890..89c83e014 100644 --- a/src/bmm/workflows/qa-generate-e2e-tests/workflow.yaml +++ b/src/bmm/workflows/qa-generate-e2e-tests/workflow.yaml @@ -1,5 +1,5 @@ name: 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]'" +description: 'Generate end to end automated tests for existing features. Use when the user says "create qa automated tests for [feature]"' # Critical variables from config config_source: "{project-root}/_bmad/bmm/config.yaml" diff --git a/src/core/tasks/editorial-review-prose.xml b/src/core/tasks/editorial-review-prose.xml index 1f26c34d8..9b61bf734 100644 --- a/src/core/tasks/editorial-review-prose.xml +++ b/src/core/tasks/editorial-review-prose.xml @@ -1,6 +1,6 @@ + description="Clinical copy-editor that reviews text for communication issues. Use when user says review for prose or improve the prose"> Review text for communication issues that impede comprehension and output suggested fixes in a three-column table diff --git a/src/core/tasks/editorial-review-structure.xml b/src/core/tasks/editorial-review-structure.xml index 4d52d3c08..6a8cb7819 100644 --- a/src/core/tasks/editorial-review-structure.xml +++ b/src/core/tasks/editorial-review-structure.xml @@ -3,7 +3,7 @@ but no context except the content to review --> + description="Structural editor that proposes cuts, reorganization, and simplification while preserving comprehension. Use when user requests structural review or editorial review of structure"> Review document structure and propose substantive changes to improve clarity and flow-run this BEFORE copy editing diff --git a/src/core/tasks/help.md b/src/core/tasks/help.md index 0d72da6c6..9ec95b2ff 100644 --- a/src/core/tasks/help.md +++ b/src/core/tasks/help.md @@ -1,6 +1,6 @@ --- name: help -description: "Analyzes what is done and the users query and offers advice on what to do next. Use if user says 'bmad-help what should I do next' or 'bmad-help what do I do now'" +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" --- # Task: BMAD Help diff --git a/src/core/tasks/index-docs.xml b/src/core/tasks/index-docs.xml index d4d7c0811..871501e1c 100644 --- a/src/core/tasks/index-docs.xml +++ b/src/core/tasks/index-docs.xml @@ -1,5 +1,5 @@ + 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"> MANDATORY: Execute ALL steps in the flow section IN EXACT ORDER DO NOT skip steps or change the sequence diff --git a/src/core/tasks/review-adversarial-general.xml b/src/core/tasks/review-adversarial-general.xml index 52e5b17fe..58551aa60 100644 --- a/src/core/tasks/review-adversarial-general.xml +++ b/src/core/tasks/review-adversarial-general.xml @@ -2,7 +2,7 @@ but no context except the content to review --> + description="Perform a Cynical Review and produce a findings report. Use when the user requests a critical review of something"> Cynically review content and produce findings diff --git a/src/core/tasks/shard-doc.xml b/src/core/tasks/shard-doc.xml index c8705555b..28ca55594 100644 --- a/src/core/tasks/shard-doc.xml +++ b/src/core/tasks/shard-doc.xml @@ -1,5 +1,5 @@ + description="Splits large markdown documents into smaller, organized files based on level 2 (default) sections. Use if the user says perform shard document"> Split large markdown documents into smaller, organized files based on level 2 sections using @kayvan/markdown-tree-parser tool diff --git a/src/core/workflows/advanced-elicitation/workflow.xml b/src/core/workflows/advanced-elicitation/workflow.xml index 31c52ce73..56e9f18ca 100644 --- a/src/core/workflows/advanced-elicitation/workflow.xml +++ b/src/core/workflows/advanced-elicitation/workflow.xml @@ -1,5 +1,5 @@ diff --git a/src/core/workflows/brainstorming/workflow.md b/src/core/workflows/brainstorming/workflow.md index 565e1e9e5..b150b8ec9 100644 --- a/src/core/workflows/brainstorming/workflow.md +++ b/src/core/workflows/brainstorming/workflow.md @@ -1,6 +1,6 @@ --- name: 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'." +description: 'Facilitate interactive brainstorming sessions using diverse creative techniques and ideation methods. Use when the user says "help me brainstorm" or "help me ideate".' context_file: '' # Optional context file path for project-specific guidance --- diff --git a/src/core/workflows/party-mode/workflow.md b/src/core/workflows/party-mode/workflow.md index b4498341e..7517cda89 100644 --- a/src/core/workflows/party-mode/workflow.md +++ b/src/core/workflows/party-mode/workflow.md @@ -1,6 +1,6 @@ --- name: party-mode -description: "Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations. Use when user requests 'party mode' only." +description: 'Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations. Use when user requests "party mode" only.' --- # Party Mode Workflow