Skip to content

feat(cis): convert problem solving to a native skill#7

Merged
bmadcode merged 1 commit intobmad-code-org:mainfrom
dickymoore:feature/native-skills-problem-solving-slice
Mar 14, 2026
Merged

feat(cis): convert problem solving to a native skill#7
bmadcode merged 1 commit intobmad-code-org:mainfrom
dickymoore:feature/native-skills-problem-solving-slice

Conversation

@dickymoore
Copy link
Copy Markdown
Contributor

@dickymoore dickymoore commented Mar 12, 2026

Summary

  • convert src/workflows/problem-solving/ to native skill shape at src/workflows/bmad-cis-problem-solving/
  • update agent and module-help wiring to the canonical CIS skill id
  • preserve the existing workflow sequence, companion files, and checkpoint behavior

Proof

  • npm test
  • node test/test-installation-components.js
  • fresh custom-content install proof against the CIS src/ tree
  • same-context old-vs-new walkthrough found no material conversion drift

Deferred / Notes

  • preserved the pre-existing ambiguity between the no-time-estimates rule and the explicit timeline output
  • did not broaden scope into unrelated CIS workflows

Summary by CodeRabbit

  • Refactor

    • Reorganized problem-solving workflow with improved structure, adding explicit configuration initialization, file path management, and enhanced checkpoint behaviors for better workflow control and output handling.
  • Documentation

    • Updated workflow documentation to reflect new directory structure and added manifest files documenting workflow configuration.

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Mar 12, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: b3df7668-78d5-4f4a-8eff-652e4ce09551

📥 Commits

Reviewing files that changed from the base of the PR and between 28fc367 and 7cd9e46.

⛔ Files ignored due to path filters (2)
  • src/module-help.csv is excluded by !**/*.csv
  • src/workflows/bmad-cis-problem-solving/solving-methods.csv is excluded by !**/*.csv
📒 Files selected for processing (8)
  • src/agents/creative-problem-solver.agent.yaml
  • src/workflows/README.md
  • src/workflows/bmad-cis-problem-solving/SKILL.md
  • src/workflows/bmad-cis-problem-solving/bmad-skill-manifest.yaml
  • src/workflows/bmad-cis-problem-solving/template.md
  • src/workflows/bmad-cis-problem-solving/workflow.md
  • src/workflows/problem-solving/README.md
  • src/workflows/problem-solving/workflow.yaml

Walkthrough

This PR migrates the problem-solving workflow from a legacy format located in src/workflows/problem-solving/ to a new native skill format in src/workflows/bmad-cis-problem-solving/ and updates the agent configuration to reference the new SKILL.md entry point instead of the old workflow.yaml.

Changes

Cohort / File(s) Summary
Agent Configuration Update
src/agents/creative-problem-solver.agent.yaml
Changed agent menu entry property from workflow to exec and updated path from problem-solving/workflow.yaml to bmad-cis-problem-solving/SKILL.md.
New Native Skill Implementation
src/workflows/bmad-cis-problem-solving/SKILL.md, src/workflows/bmad-cis-problem-solving/bmad-skill-manifest.yaml, src/workflows/bmad-cis-problem-solving/workflow.md
Introduced new skill structure with entry-point SKILL.md, manifest declaring skill type, and restructured workflow.md with explicit initialization, configuration, inputs, behavioral constraints, and facili­tation sections; replaced {solving_methods} placeholders with {solving_methods_file} and added checkpoint behaviors after template outputs.
Legacy Workflow Removal
src/workflows/problem-solving/README.md, src/workflows/problem-solving/workflow.yaml
Deleted obsolete workflow documentation and configuration files.
Documentation Update
src/workflows/README.md
Updated link reference from ./problem-solving to ./bmad-cis-problem-solving and added code block documenting new skill directory structure.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

  • PR #8: Performs the same native-skill conversion pattern, migrating workflow from src/workflows/<name>/workflow.yaml to src/workflows/bmad-cis-<name>/SKILL.md and updating agent menu entry to use exec.
  • PR #6: Implements identical code-level conversion from legacy workflow shape to native-skill shape, renaming agent.menu[0].workflow to exec and switching references to SKILL.md.
  • PR #7: Makes the same problem-solving workflow conversion to native "bmad-cis-problem-solving" skill structure and updates agent menu entry from workflow to exec pointing at SKILL.md.

Poem

🐰 A workflow takes its native flight,
From legacy paths to SKILL.md's light,
The agent's exec now reads the way,
bmad-cis-problem-solving saves the day! ✨
Old configs sleep, new skills arise,
Hop toward tomorrow's skies! 🌟

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: converting the problem-solving workflow from legacy format to a native skill format, which is reflected throughout the changeset.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
📝 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.

@dickymoore
Copy link
Copy Markdown
Contributor Author

@coderabbitai review

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Mar 12, 2026

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (2)
src/workflows/bmad-cis-problem-solving/workflow.md (2)

158-168: ⚠️ Potential issue | 🟠 Major

Keep Step 5 aligned with the loaded methods CSV.

Line 158 asks the facilitator to review synthesis, creative categories, but src/workflows/bmad-cis-problem-solving/solving-methods.csv:1-22 only provides diagnosis, analysis, synthesis, and evaluation. This block also lists Assumption Busting and Reverse Brainstorming, which are not present in that file. The converted skill will end up inventing unsupported methods instead of using the companion data it preloads in initialization.

🧩 Proposed fix
- Review solution generation methods from `{solving_methods_file}` (categories: synthesis, creative) and select 2-4 methods that fit the problem context. Consider:
+ Review solution generation methods from `{solving_methods_file}` (category: synthesis) and select 2-4 methods that fit the problem context. Consider:

...
- - **Creative approaches:** Lateral Thinking, Assumption Busting, Reverse Brainstorming
+ - **Creative approaches:** Lateral Thinking Techniques, Synectics Method, Biomimicry Problem Solving
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/workflows/bmad-cis-problem-solving/workflow.md` around lines 158 - 168,
Step 5 currently references a non-existent "creative" category and methods not
present in the loaded CSV; update the Step 5 prose in workflow.md to only use
categories actually in
src/workflows/bmad-cis-problem-solving/solving-methods.csv (diagnosis, analysis,
synthesis, evaluation), remove mentions of "Assumption Busting" and "Reverse
Brainstorming", and instruct the facilitator to select 2–4 methods from those
CSV-backed categories (or dynamically read the {solving_methods_file} at
runtime) while giving brief guidance on when each CSV-listed method is
appropriate.

229-233: ⚠️ Potential issue | 🟠 Major

Step 7 references implementation methods that do not exist in the companion data.

Line 229 tells the facilitator to use PDCA Cycle and an implementation category from {solving_methods_file}, but src/workflows/bmad-cis-problem-solving/solving-methods.csv:1-22 does not contain either. That leaves the implementation step without the file-backed method source the initialization section promises to load.

🛠️ Proposed fix
- Reference **PDCA Cycle** and other implementation methods from `{solving_methods_file}` (category: implementation) to guide iterative thinking:
+ Use an iterative plan/do/check/adjust loop to guide implementation thinking:

If you want this step to stay file-backed, the other valid fix is to add an implementation category and the corresponding methods to src/workflows/bmad-cis-problem-solving/solving-methods.csv.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/workflows/bmad-cis-problem-solving/workflow.md` around lines 229 - 233,
The workflow references the "PDCA Cycle" and an "implementation" category from
{solving_methods_file} but those entries are missing from the companion methods
data; either add an "implementation" category plus a PDCA Cycle row (and any
other implementation methods) to the solving-methods data source so
{solving_methods_file} contains the referenced items, or update the workflow
step to reference an existing category/method name that is present in the
methods data; look for the workflow step that mentions "PDCA Cycle" and the
placeholder {solving_methods_file} and either add matching rows to the methods
CSV (category: implementation, name: PDCA Cycle, description) or replace the
reference with a valid method/category that already exists.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@src/workflows/bmad-cis-problem-solving/workflow.md`:
- Around line 25-32: The generated filename default_output_file currently
interpolates the raw system `date` (a full datetime) which can contain
characters invalid on some filesystems; change the workflow to use a
filesystem-safe timestamp instead (for example format `date` as YYYYMMDD_HHMMSS
or strip/replace characters like ":" "+" and timezone separators) before
injecting it into `default_output_file` so filenames are portable and valid
across OSes; update any references to `date` or `default_output_file` in the
workflow/template generation code to use the sanitized timestamp function or
transformed value.

---

Outside diff comments:
In `@src/workflows/bmad-cis-problem-solving/workflow.md`:
- Around line 158-168: Step 5 currently references a non-existent "creative"
category and methods not present in the loaded CSV; update the Step 5 prose in
workflow.md to only use categories actually in
src/workflows/bmad-cis-problem-solving/solving-methods.csv (diagnosis, analysis,
synthesis, evaluation), remove mentions of "Assumption Busting" and "Reverse
Brainstorming", and instruct the facilitator to select 2–4 methods from those
CSV-backed categories (or dynamically read the {solving_methods_file} at
runtime) while giving brief guidance on when each CSV-listed method is
appropriate.
- Around line 229-233: The workflow references the "PDCA Cycle" and an
"implementation" category from {solving_methods_file} but those entries are
missing from the companion methods data; either add an "implementation" category
plus a PDCA Cycle row (and any other implementation methods) to the
solving-methods data source so {solving_methods_file} contains the referenced
items, or update the workflow step to reference an existing category/method name
that is present in the methods data; look for the workflow step that mentions
"PDCA Cycle" and the placeholder {solving_methods_file} and either add matching
rows to the methods CSV (category: implementation, name: PDCA Cycle,
description) or replace the reference with a valid method/category that already
exists.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: d607babf-1749-4f47-ae29-fe273ff7dff5

📥 Commits

Reviewing files that changed from the base of the PR and between 131768f and 28fc367.

⛔ Files ignored due to path filters (2)
  • src/module-help.csv is excluded by !**/*.csv
  • src/workflows/bmad-cis-problem-solving/solving-methods.csv is excluded by !**/*.csv
📒 Files selected for processing (9)
  • AGENTS.md
  • src/agents/creative-problem-solver.agent.yaml
  • src/workflows/README.md
  • src/workflows/bmad-cis-problem-solving/SKILL.md
  • src/workflows/bmad-cis-problem-solving/bmad-skill-manifest.yaml
  • src/workflows/bmad-cis-problem-solving/template.md
  • src/workflows/bmad-cis-problem-solving/workflow.md
  • src/workflows/problem-solving/README.md
  • src/workflows/problem-solving/workflow.yaml
💤 Files with no reviewable changes (2)
  • src/workflows/problem-solving/README.md
  • src/workflows/problem-solving/workflow.yaml

Comment on lines +25 to +32
- `date` as the system-generated current datetime

### Paths

- `skill_path` = `{project-root}/_bmad/cis/workflows/bmad-cis-problem-solving`
- `template_file` = `./template.md`
- `solving_methods_file` = `./solving-methods.csv`
- `default_output_file` = `{output_folder}/problem-solution-{date}.md`
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major

Use a filesystem-safe timestamp for default_output_file.

Line 25 defines date as a full datetime, and Line 32 injects it into the output filename. If that value contains : or timezone separators, saving the checkpoint artifact will fail on Windows and produce awkward filenames elsewhere.

🛠️ Proposed fix
- - `date` as the system-generated current datetime
+ - `date` as the system-generated current datetime
+ - `file_timestamp` as the same value formatted for filenames (`YYYYMMDD-HHmmss`)

...
- - `default_output_file` = `{output_folder}/problem-solution-{date}.md`
+ - `default_output_file` = `{output_folder}/problem-solution-{file_timestamp}.md`
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- `date` as the system-generated current datetime
### Paths
- `skill_path` = `{project-root}/_bmad/cis/workflows/bmad-cis-problem-solving`
- `template_file` = `./template.md`
- `solving_methods_file` = `./solving-methods.csv`
- `default_output_file` = `{output_folder}/problem-solution-{date}.md`
- `date` as the system-generated current datetime
- `file_timestamp` as the same value formatted for filenames (`YYYYMMDD-HHmmss`)
### Paths
- `skill_path` = `{project-root}/_bmad/cis/workflows/bmad-cis-problem-solving`
- `template_file` = `./template.md`
- `solving_methods_file` = `./solving-methods.csv`
- `default_output_file` = `{output_folder}/problem-solution-{file_timestamp}.md`
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/workflows/bmad-cis-problem-solving/workflow.md` around lines 25 - 32, The
generated filename default_output_file currently interpolates the raw system
`date` (a full datetime) which can contain characters invalid on some
filesystems; change the workflow to use a filesystem-safe timestamp instead (for
example format `date` as YYYYMMDD_HHMMSS or strip/replace characters like ":"
"+" and timezone separators) before injecting it into `default_output_file` so
filenames are portable and valid across OSes; update any references to `date` or
`default_output_file` in the workflow/template generation code to use the
sanitized timestamp function or transformed value.

@bmadcode bmadcode force-pushed the feature/native-skills-problem-solving-slice branch from 28fc367 to 7cd9e46 Compare March 14, 2026 02:43
@bmadcode bmadcode merged commit 68f62e2 into bmad-code-org:main Mar 14, 2026
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.

2 participants