Skip to content

Convert create-story workflow to native skill package#1939

Merged
alexeyv merged 3 commits intomainfrom
convert-create-story-skill
Mar 13, 2026
Merged

Convert create-story workflow to native skill package#1939
alexeyv merged 3 commits intomainfrom
convert-create-story-skill

Conversation

@alexeyv
Copy link
Copy Markdown
Collaborator

@alexeyv alexeyv commented Mar 12, 2026

Summary

This PR converts the create-story implementation workflow into a native skill package without changing workflow behavior.

The conversion:

  • renames the workflow directory from create-story to bmad-create-story
  • adds SKILL.md with frontmatter matching the skill directory name
  • replaces the old workflow manifest with a skill manifest
  • updates module-help.csv so Create Story and Validate Story resolve via skill:bmad-create-story
  • updates the scrum master agent menu entry to invoke skill:bmad-create-story instead of a workflow file path
  • updates remaining test and installer example references to the new path

Files of Interest

  • src/bmm/workflows/4-implementation/bmad-create-story/
  • src/bmm/module-help.csv
  • src/bmm/agents/sm.agent.yaml
  • test/test-workflow-path-regex.js
  • tools/cli/installers/lib/modules/manager.js

Behavior Impact

Behavior is intended to remain unchanged.

This is a mechanical workflow-to-skill conversion plus follow-up reference cleanup so that:

  • skill discovery recognizes bmad-create-story as a native skill
  • help and agent metadata point at the skill identifier instead of legacy workflow file paths where appropriate
  • tests and installer examples reflect the converted path layout

Validation

Executed on the PR branch worktree convert-create-story-skill after the follow-up fixes:

  • npm ci
  • npm run format:check
  • npm run lint
  • npm run lint:md
  • npm run docs:build
  • npm run validate:schemas
  • npm run test:schemas
  • npm run test:install
  • npm run validate:refs
  • node test/test-workflow-path-regex.js

@augmentcode
Copy link
Copy Markdown

augmentcode bot commented Mar 12, 2026

🤖 Augment PR Summary

Summary: Converts the existing create-story workflow into a native skill package (bmad-create-story) while keeping the workflow logic unchanged.

Changes: Adds SKILL.md + a type: skill manifest, relocates the workflow files into the new directory, and updates the Scrum Master agent menu entry to point at the renamed workflow path.

🤖 Was this summary useful? React with 👍 or 👎

Copy link
Copy Markdown

@augmentcode augmentcode bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review completed. No suggestions at this time.

Comment augment review to trigger a new review at any time.

@alexeyv alexeyv force-pushed the convert-create-story-skill branch from 7a918ff to c2f92fa Compare March 13, 2026 04:57
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 13, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 20b44464-c6d9-4872-94a2-043c228b2aa9

📥 Commits

Reviewing files that changed from the base of the PR and between 8ba428e and c2f92fa.

⛔ Files ignored due to path filters (1)
  • src/bmm/module-help.csv is excluded by !**/*.csv
📒 Files selected for processing (10)
  • src/bmm/agents/sm.agent.yaml
  • src/bmm/workflows/4-implementation/bmad-create-story/SKILL.md
  • src/bmm/workflows/4-implementation/bmad-create-story/bmad-skill-manifest.yaml
  • src/bmm/workflows/4-implementation/bmad-create-story/checklist.md
  • src/bmm/workflows/4-implementation/bmad-create-story/discover-inputs.md
  • src/bmm/workflows/4-implementation/bmad-create-story/template.md
  • src/bmm/workflows/4-implementation/bmad-create-story/workflow.md
  • src/bmm/workflows/4-implementation/create-story/bmad-skill-manifest.yaml
  • test/test-workflow-path-regex.js
  • tools/cli/installers/lib/modules/manager.js

📝 Walkthrough

Walkthrough

The "create-story" workflow is being converted into a native "skill" artifact named "bmad-create-story". This involves creating skill documentation and manifest files, renaming the workflow directory with relative path resolution, updating the Scrum Master agent to invoke the skill by identifier instead of filesystem path, and updating corresponding test and utility references.

Changes

Cohort / File(s) Summary
Skill Definition
src/bmm/workflows/4-implementation/bmad-create-story/SKILL.md, src/bmm/workflows/4-implementation/bmad-create-story/bmad-skill-manifest.yaml
New files establishing the skill artifact structure with documentation and type declaration for bmad-create-story skill.
Workflow Refactoring
src/bmm/workflows/4-implementation/bmad-create-story/workflow.md, src/bmm/workflows/4-implementation/create-story/bmad-skill-manifest.yaml
Renamed workflow from "create-story" to "bmad-create-story" with paths converted to relative format; removed metadata fields from old manifest.
Agent Configuration
src/bmm/agents/sm.agent.yaml
Updated CS trigger exec value from filesystem workflow path to skill invocation identifier "skill:bmad-create-story".
Tests & Utilities
test/test-workflow-path-regex.js, tools/cli/installers/lib/modules/manager.js
Updated test assertions and example comments to reflect new "bmad-create-story" workflow path.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

Suggested reviewers

  • pbean
  • cecil-the-coder
  • bmadcode
✨ Finishing Touches
  • 📝 Generate docstrings (stacked PR)
  • 📝 Generate docstrings (commit on current branch)
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch convert-create-story-skill
📝 Coding Plan
  • Generate coding plan for human review comments

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@alexeyv alexeyv merged commit d39fcd5 into main Mar 13, 2026
5 checks passed
alexeyv added a commit to alexeyv/BMAD-METHOD that referenced this pull request Mar 13, 2026
…1939)

* convert create-story workflow to native skill package

* fix(create-story): update converted workflow path refs

* fix(sm-agent): use skill reference for create-story
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant