From 6ce3801dffda6e4c22e737286c8bf2a68e7207aa Mon Sep 17 00:00:00 2001 From: Alex Verkhovsky Date: Thu, 12 Mar 2026 15:22:51 -0600 Subject: [PATCH 1/2] chore(bmm): convert document-project workflow to native skill package --- src/bmm/agents/analyst.agent.yaml | 2 +- src/bmm/agents/tech-writer/tech-writer.agent.yaml | 2 +- src/bmm/module-help.csv | 2 +- src/bmm/workflows/bmad-document-project/SKILL.md | 6 ++++++ .../bmad-document-project/bmad-skill-manifest.yaml | 1 + .../checklist.md | 0 .../documentation-requirements.csv | 0 .../instructions.md | 0 .../templates/deep-dive-template.md | 0 .../templates/index-template.md | 0 .../templates/project-overview-template.md | 0 .../templates/project-scan-report-schema.json | 0 .../templates/source-tree-template.md | 0 .../{document-project => bmad-document-project}/workflow.md | 4 ++-- .../workflows/deep-dive-instructions.md | 0 .../workflows/deep-dive-workflow.md | 6 +++--- .../workflows/full-scan-instructions.md | 0 .../workflows/full-scan-workflow.md | 6 +++--- src/bmm/workflows/document-project/bmad-skill-manifest.yaml | 3 --- 19 files changed, 18 insertions(+), 14 deletions(-) create mode 100644 src/bmm/workflows/bmad-document-project/SKILL.md create mode 100644 src/bmm/workflows/bmad-document-project/bmad-skill-manifest.yaml rename src/bmm/workflows/{document-project => bmad-document-project}/checklist.md (100%) rename src/bmm/workflows/{document-project => bmad-document-project}/documentation-requirements.csv (100%) rename src/bmm/workflows/{document-project => bmad-document-project}/instructions.md (100%) rename src/bmm/workflows/{document-project => bmad-document-project}/templates/deep-dive-template.md (100%) rename src/bmm/workflows/{document-project => bmad-document-project}/templates/index-template.md (100%) rename src/bmm/workflows/{document-project => bmad-document-project}/templates/project-overview-template.md (100%) rename src/bmm/workflows/{document-project => bmad-document-project}/templates/project-scan-report-schema.json (100%) rename src/bmm/workflows/{document-project => bmad-document-project}/templates/source-tree-template.md (100%) rename src/bmm/workflows/{document-project => bmad-document-project}/workflow.md (90%) rename src/bmm/workflows/{document-project => bmad-document-project}/workflows/deep-dive-instructions.md (100%) rename src/bmm/workflows/{document-project => bmad-document-project}/workflows/deep-dive-workflow.md (80%) rename src/bmm/workflows/{document-project => bmad-document-project}/workflows/full-scan-instructions.md (100%) rename src/bmm/workflows/{document-project => bmad-document-project}/workflows/full-scan-workflow.md (80%) delete mode 100644 src/bmm/workflows/document-project/bmad-skill-manifest.yaml diff --git a/src/bmm/agents/analyst.agent.yaml b/src/bmm/agents/analyst.agent.yaml index f17597c2a..19fcd1a78 100644 --- a/src/bmm/agents/analyst.agent.yaml +++ b/src/bmm/agents/analyst.agent.yaml @@ -39,5 +39,5 @@ agent: description: "[CB] Create Brief: A guided experience to nail down your product idea into an executive brief" - trigger: DP or fuzzy match on document-project - exec: "{project-root}/_bmad/bmm/workflows/document-project/workflow.md" + exec: "skill:bmad-document-project" description: "[DP] Document Project: Analyze an existing project to produce useful documentation for both human and LLM" diff --git a/src/bmm/agents/tech-writer/tech-writer.agent.yaml b/src/bmm/agents/tech-writer/tech-writer.agent.yaml index 25f0aca06..c7bf7acab 100644 --- a/src/bmm/agents/tech-writer/tech-writer.agent.yaml +++ b/src/bmm/agents/tech-writer/tech-writer.agent.yaml @@ -22,7 +22,7 @@ agent: menu: - trigger: DP or fuzzy match on document-project - exec: "{project-root}/_bmad/bmm/workflows/document-project/workflow.md" + exec: "skill:bmad-document-project" description: "[DP] Document Project: Generate comprehensive project documentation (brownfield analysis, architecture scanning)" - trigger: WD or fuzzy match on write-document diff --git a/src/bmm/module-help.csv b/src/bmm/module-help.csv index 116f84fa6..fa177e792 100644 --- a/src/bmm/module-help.csv +++ b/src/bmm/module-help.csv @@ -1,5 +1,5 @@ module,phase,name,code,sequence,workflow-file,command,required,agent,options,description,output-location,outputs, -bmm,anytime,Document Project,DP,,_bmad/bmm/workflows/document-project/workflow.md,bmad-bmm-document-project,false,analyst,Create Mode,"Analyze an existing project to produce useful documentation",project-knowledge,*, +bmm,anytime,Document Project,DP,,skill:bmad-document-project,bmad-bmm-document-project,false,analyst,Create Mode,"Analyze an existing project to produce useful documentation",project-knowledge,*, bmm,anytime,Generate Project Context,GPC,,_bmad/bmm/workflows/generate-project-context/workflow.md,bmad-bmm-generate-project-context,false,analyst,Create Mode,"Scan existing codebase to generate a lean LLM-optimized project-context.md containing critical implementation rules patterns and conventions for AI agents. Essential for brownfield projects and quick-flow.",output_folder,"project context", bmm,anytime,Quick Spec,QS,,_bmad/bmm/workflows/bmad-quick-flow/quick-spec/workflow.md,bmad-bmm-quick-spec,false,quick-flow-solo-dev,Create Mode,"Do not suggest for potentially very complex things unless requested or if the user complains that they do not want to follow the extensive planning of the bmad method. Quick one-off tasks small changes simple apps brownfield additions to well established patterns utilities without extensive planning",planning_artifacts,"tech spec", bmm,anytime,Quick Dev,QD,,skill:bmad-quick-dev,bmad-bmm-quick-dev,false,quick-flow-solo-dev,Create Mode,"Quick one-off tasks small changes simple apps utilities without extensive planning - Do not suggest for potentially very complex things unless requested or if the user complains that they do not want to follow the extensive planning of the bmad method, unless the user is already working through the implementation phase and just requests a 1 off things not already in the plan",,, diff --git a/src/bmm/workflows/bmad-document-project/SKILL.md b/src/bmm/workflows/bmad-document-project/SKILL.md new file mode 100644 index 000000000..32e30ebc1 --- /dev/null +++ b/src/bmm/workflows/bmad-document-project/SKILL.md @@ -0,0 +1,6 @@ +--- +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). diff --git a/src/bmm/workflows/bmad-document-project/bmad-skill-manifest.yaml b/src/bmm/workflows/bmad-document-project/bmad-skill-manifest.yaml new file mode 100644 index 000000000..d0f08abdb --- /dev/null +++ b/src/bmm/workflows/bmad-document-project/bmad-skill-manifest.yaml @@ -0,0 +1 @@ +type: skill diff --git a/src/bmm/workflows/document-project/checklist.md b/src/bmm/workflows/bmad-document-project/checklist.md similarity index 100% rename from src/bmm/workflows/document-project/checklist.md rename to src/bmm/workflows/bmad-document-project/checklist.md diff --git a/src/bmm/workflows/document-project/documentation-requirements.csv b/src/bmm/workflows/bmad-document-project/documentation-requirements.csv similarity index 100% rename from src/bmm/workflows/document-project/documentation-requirements.csv rename to src/bmm/workflows/bmad-document-project/documentation-requirements.csv diff --git a/src/bmm/workflows/document-project/instructions.md b/src/bmm/workflows/bmad-document-project/instructions.md similarity index 100% rename from src/bmm/workflows/document-project/instructions.md rename to src/bmm/workflows/bmad-document-project/instructions.md diff --git a/src/bmm/workflows/document-project/templates/deep-dive-template.md b/src/bmm/workflows/bmad-document-project/templates/deep-dive-template.md similarity index 100% rename from src/bmm/workflows/document-project/templates/deep-dive-template.md rename to src/bmm/workflows/bmad-document-project/templates/deep-dive-template.md diff --git a/src/bmm/workflows/document-project/templates/index-template.md b/src/bmm/workflows/bmad-document-project/templates/index-template.md similarity index 100% rename from src/bmm/workflows/document-project/templates/index-template.md rename to src/bmm/workflows/bmad-document-project/templates/index-template.md diff --git a/src/bmm/workflows/document-project/templates/project-overview-template.md b/src/bmm/workflows/bmad-document-project/templates/project-overview-template.md similarity index 100% rename from src/bmm/workflows/document-project/templates/project-overview-template.md rename to src/bmm/workflows/bmad-document-project/templates/project-overview-template.md diff --git a/src/bmm/workflows/document-project/templates/project-scan-report-schema.json b/src/bmm/workflows/bmad-document-project/templates/project-scan-report-schema.json similarity index 100% rename from src/bmm/workflows/document-project/templates/project-scan-report-schema.json rename to src/bmm/workflows/bmad-document-project/templates/project-scan-report-schema.json diff --git a/src/bmm/workflows/document-project/templates/source-tree-template.md b/src/bmm/workflows/bmad-document-project/templates/source-tree-template.md similarity index 100% rename from src/bmm/workflows/document-project/templates/source-tree-template.md rename to src/bmm/workflows/bmad-document-project/templates/source-tree-template.md diff --git a/src/bmm/workflows/document-project/workflow.md b/src/bmm/workflows/bmad-document-project/workflow.md similarity index 90% rename from src/bmm/workflows/document-project/workflow.md rename to src/bmm/workflows/bmad-document-project/workflow.md index cd7d9d33d..88d4084aa 100644 --- a/src/bmm/workflows/document-project/workflow.md +++ b/src/bmm/workflows/bmad-document-project/workflow.md @@ -1,5 +1,5 @@ --- -name: document-project +name: bmad-document-project description: 'Document brownfield projects for AI context. Use when the user says "document this project" or "generate project docs"' --- @@ -27,7 +27,7 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve: ### Paths -- `installed_path` = `{project-root}/_bmad/bmm/workflows/document-project` +- `installed_path` = `.` - `instructions` = `{installed_path}/instructions.md` - `validation` = `{installed_path}/checklist.md` - `documentation_requirements_csv` = `{installed_path}/documentation-requirements.csv` diff --git a/src/bmm/workflows/document-project/workflows/deep-dive-instructions.md b/src/bmm/workflows/bmad-document-project/workflows/deep-dive-instructions.md similarity index 100% rename from src/bmm/workflows/document-project/workflows/deep-dive-instructions.md rename to src/bmm/workflows/bmad-document-project/workflows/deep-dive-instructions.md diff --git a/src/bmm/workflows/document-project/workflows/deep-dive-workflow.md b/src/bmm/workflows/bmad-document-project/workflows/deep-dive-workflow.md similarity index 80% rename from src/bmm/workflows/document-project/workflows/deep-dive-workflow.md rename to src/bmm/workflows/bmad-document-project/workflows/deep-dive-workflow.md index 1bc7b40f4..f6bc79069 100644 --- a/src/bmm/workflows/document-project/workflows/deep-dive-workflow.md +++ b/src/bmm/workflows/bmad-document-project/workflows/deep-dive-workflow.md @@ -28,10 +28,10 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve: ### Paths -- `installed_path` = `{project-root}/_bmad/bmm/workflows/document-project/workflows` +- `installed_path` = `.` - `instructions` = `{installed_path}/deep-dive-instructions.md` -- `validation` = `{project-root}/_bmad/bmm/workflows/document-project/checklist.md` -- `deep_dive_template` = `{project-root}/_bmad/bmm/workflows/document-project/templates/deep-dive-template.md` +- `validation` = `../checklist.md` +- `deep_dive_template` = `../templates/deep-dive-template.md` ### Runtime Inputs diff --git a/src/bmm/workflows/document-project/workflows/full-scan-instructions.md b/src/bmm/workflows/bmad-document-project/workflows/full-scan-instructions.md similarity index 100% rename from src/bmm/workflows/document-project/workflows/full-scan-instructions.md rename to src/bmm/workflows/bmad-document-project/workflows/full-scan-instructions.md diff --git a/src/bmm/workflows/document-project/workflows/full-scan-workflow.md b/src/bmm/workflows/bmad-document-project/workflows/full-scan-workflow.md similarity index 80% rename from src/bmm/workflows/document-project/workflows/full-scan-workflow.md rename to src/bmm/workflows/bmad-document-project/workflows/full-scan-workflow.md index 421439476..0fa653820 100644 --- a/src/bmm/workflows/document-project/workflows/full-scan-workflow.md +++ b/src/bmm/workflows/bmad-document-project/workflows/full-scan-workflow.md @@ -27,10 +27,10 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve: ### Paths -- `installed_path` = `{project-root}/_bmad/bmm/workflows/document-project/workflows` +- `installed_path` = `.` - `instructions` = `{installed_path}/full-scan-instructions.md` -- `validation` = `{project-root}/_bmad/bmm/workflows/document-project/checklist.md` -- `documentation_requirements_csv` = `{project-root}/_bmad/bmm/workflows/document-project/documentation-requirements.csv` +- `validation` = `../checklist.md` +- `documentation_requirements_csv` = `../documentation-requirements.csv` ### Runtime Inputs diff --git a/src/bmm/workflows/document-project/bmad-skill-manifest.yaml b/src/bmm/workflows/document-project/bmad-skill-manifest.yaml deleted file mode 100644 index 4e8cb2767..000000000 --- a/src/bmm/workflows/document-project/bmad-skill-manifest.yaml +++ /dev/null @@ -1,3 +0,0 @@ -canonicalId: bmad-document-project -type: workflow -description: "Document brownfield projects for AI context" From cc2a4142d4a6ba05f8b1981e2f0c60500836b913 Mon Sep 17 00:00:00 2001 From: Alex Verkhovsky Date: Sat, 14 Mar 2026 12:25:06 -0600 Subject: [PATCH 2/2] chore(bmm): remove workflow metadata from document-project skill Remove name/description frontmatter from workflow.md and sub-workflow files (deep-dive-workflow.md, full-scan-workflow.md). Metadata belongs exclusively in SKILL.md for native skill packages. --- src/bmm/workflows/bmad-document-project/workflow.md | 5 ----- .../bmad-document-project/workflows/deep-dive-workflow.md | 5 ----- .../bmad-document-project/workflows/full-scan-workflow.md | 5 ----- 3 files changed, 15 deletions(-) diff --git a/src/bmm/workflows/bmad-document-project/workflow.md b/src/bmm/workflows/bmad-document-project/workflow.md index 88d4084aa..63a84c43e 100644 --- a/src/bmm/workflows/bmad-document-project/workflow.md +++ b/src/bmm/workflows/bmad-document-project/workflow.md @@ -1,8 +1,3 @@ ---- -name: bmad-document-project -description: 'Document brownfield projects for AI context. Use when the user says "document this project" or "generate project docs"' ---- - # Document Project Workflow **Goal:** Document brownfield projects for AI context. diff --git a/src/bmm/workflows/bmad-document-project/workflows/deep-dive-workflow.md b/src/bmm/workflows/bmad-document-project/workflows/deep-dive-workflow.md index f6bc79069..9a6a1349d 100644 --- a/src/bmm/workflows/bmad-document-project/workflows/deep-dive-workflow.md +++ b/src/bmm/workflows/bmad-document-project/workflows/deep-dive-workflow.md @@ -1,8 +1,3 @@ ---- -name: document-project-deep-dive -description: 'Exhaustive deep-dive documentation of specific project areas' ---- - # Deep-Dive Documentation Sub-Workflow **Goal:** Exhaustive deep-dive documentation of specific project areas. diff --git a/src/bmm/workflows/bmad-document-project/workflows/full-scan-workflow.md b/src/bmm/workflows/bmad-document-project/workflows/full-scan-workflow.md index 0fa653820..ba4fba57c 100644 --- a/src/bmm/workflows/bmad-document-project/workflows/full-scan-workflow.md +++ b/src/bmm/workflows/bmad-document-project/workflows/full-scan-workflow.md @@ -1,8 +1,3 @@ ---- -name: document-project-full-scan -description: 'Complete project documentation workflow (initial scan or full rescan)' ---- - # Full Project Scan Sub-Workflow **Goal:** Complete project documentation (initial scan or full rescan).