Skip to content

Commit 68f62e2

Browse files
authored
Merge pull request #7 from dickymoore/feature/native-skills-problem-solving-slice
feat(cis): convert problem solving to a native skill
2 parents b1ab320 + 7cd9e46 commit 68f62e2

10 files changed

Lines changed: 81 additions & 108 deletions

File tree

src/agents/creative-problem-solver.agent.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,5 +17,5 @@ agent:
1717

1818
menu:
1919
- trigger: PS or fuzzy match on problem-solving
20-
workflow: "{project-root}/_bmad/cis/workflows/problem-solving/workflow.yaml"
20+
exec: "{project-root}/_bmad/cis/workflows/bmad-cis-problem-solving/SKILL.md"
2121
description: "[PS] Apply systematic problem-solving methodologies"

src/module-help.csv

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
module,phase,name,code,sequence,workflow-file,command,required,agent,options,description,output-location,outputs,
22
cis,anytime,Innovation Strategy,IS,,skill:bmad-cis-innovation-strategy,bmad-cis-innovation-strategy,false,innovation-strategist,Create Mode,"Identify disruption opportunities and architect business model innovation. Use when exploring new business models or seeking competitive advantage.",output_folder,"innovation strategy",
3-
cis,anytime,Problem Solving,PS,,_bmad/cis/workflows/problem-solving/workflow.yaml,bmad-cis-problem-solving,false,creative-problem-solver,Create Mode,"Apply systematic problem-solving methodologies to crack complex challenges. Use when stuck on difficult problems or needing structured approaches.",output_folder,"problem solution",
3+
cis,anytime,Problem Solving,PS,,skill:bmad-cis-problem-solving,bmad-cis-problem-solving,false,creative-problem-solver,Create Mode,"Apply systematic problem-solving methodologies to crack complex challenges. Use when stuck on difficult problems or needing structured approaches.",output_folder,"problem solution",
44
cis,anytime,Design Thinking,DT,,skill:bmad-cis-design-thinking,bmad-cis-design-thinking,false,design-thinking-coach,Create Mode,"Guide human-centered design processes using empathy-driven methodologies. Use for user-centered design challenges or improving user experience.",output_folder,"design thinking",
55
cis,anytime,Brainstorming,BS,,_bmad/core/workflows/brainstorming/workflow.md,bmad-cis-brainstorming,false,brainstorming-coach,Create Mode,"Facilitate brainstorming sessions using one or more techniques. Use early in ideation phase or when stuck generating ideas.",output_folder,"brainstorming session results",
66
cis,anytime,Storytelling,ST,,_bmad/cis/workflows/storytelling/workflow.yaml,bmad-cis-storytelling,false,storyteller,Create Mode,"Craft compelling narratives using proven story frameworks and techniques. Use when needing persuasive communication or story-driven content.",output_folder,"narrative/story",

src/workflows/README.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ Five interactive workflows facilitating creative and strategic processes through
4141

4242
**Output:** Strategic innovation roadmap
4343

44-
### [Problem Solving](./problem-solving)
44+
### [Problem Solving](./bmad-cis-problem-solving)
4545

4646
**Purpose:** Systematic challenge resolution
4747

@@ -136,6 +136,15 @@ bmad-cis-innovation-strategy/
136136
└── template.md
137137
```
138138

139+
```text
140+
bmad-cis-problem-solving/
141+
├── SKILL.md
142+
├── workflow.md
143+
├── bmad-skill-manifest.yaml
144+
├── solving-methods.csv
145+
└── template.md
146+
```
147+
139148
## Best Practices
140149

141150
1. **Prepare context** - Provide background documents for better results
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
name: bmad-cis-problem-solving
3+
description: 'Apply systematic problem-solving methodologies to complex challenges. Use when the user says "guide me through structured problem solving" or "I want to crack this challenge with guided problem solving techniques"'
4+
---
5+
6+
Follow the instructions in [workflow.md](workflow.md).
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
type: skill

src/workflows/problem-solving/solving-methods.csv renamed to src/workflows/bmad-cis-problem-solving/solving-methods.csv

File renamed without changes.
File renamed without changes.

src/workflows/problem-solving/instructions.md renamed to src/workflows/bmad-cis-problem-solving/workflow.md

Lines changed: 62 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,59 @@
1-
# Problem Solving Workflow Instructions
2-
3-
<critical>The workflow execution engine is governed by: {project-root}/_bmad/core/tasks/workflow.xml</critical>
4-
<critical>You MUST have already loaded and processed: {project-root}/_bmad/cis/workflows/problem-solving/workflow.yaml</critical>
5-
<critical>Load and understand solving methods from: {solving_methods}</critical>
6-
<critical>⚠️ ABSOLUTELY NO TIME ESTIMATES - NEVER mention hours, days, weeks, months, or ANY time-based predictions. AI has fundamentally changed development speed - what once took teams weeks/months can now be done by one person in hours. DO NOT give ANY time estimates whatsoever.</critical>
7-
<critical>⚠️ CHECKPOINT PROTOCOL: After EVERY <template-output> tag, you MUST follow workflow.xml substep 2c: SAVE content to file immediately → SHOW checkpoint separator (━━━━━━━━━━━━━━━━━━━━━━━) → DISPLAY generated content → PRESENT options [a]Advanced Elicitation/[c]Continue/[p]Party-Mode/[y]YOLO → WAIT for user response. Never batch saves or skip checkpoints.</critical>
8-
9-
<facilitation-principles>
10-
YOU ARE A SYSTEMATIC PROBLEM-SOLVING FACILITATOR:
11-
- Guide through diagnosis before jumping to solutions
12-
- Ask questions that reveal patterns and root causes
13-
- Help them think systematically, not do thinking for them
14-
- Balance rigor with momentum - don't get stuck in analysis
15-
- Celebrate insights when they emerge
16-
- Monitor energy - problem-solving is mentally intensive
17-
</facilitation-principles>
1+
---
2+
name: bmad-cis-problem-solving
3+
description: 'Apply systematic problem-solving methodologies to complex challenges. Use when the user says "guide me through structured problem solving" or "I want to crack this challenge with guided problem solving techniques"'
4+
standalone: true
5+
main_config: '{project-root}/_bmad/cis/config.yaml'
6+
---
7+
8+
# Problem Solving Workflow
9+
10+
**Goal:** Diagnose complex problems systematically, identify root causes, generate solutions, and produce an actionable implementation and validation plan.
11+
12+
**Your Role:** You are a systematic problem-solving facilitator. Guide diagnosis before solutions, reveal patterns and root causes, balance rigor with momentum, and never give time estimates.
13+
14+
---
15+
16+
## INITIALIZATION
17+
18+
### Configuration Loading
19+
20+
Load config from `{main_config}` and resolve:
21+
22+
- `output_folder`
23+
- `user_name`
24+
- `communication_language`
25+
- `date` as the system-generated current datetime
26+
27+
### Paths
28+
29+
- `skill_path` = `{project-root}/_bmad/cis/workflows/bmad-cis-problem-solving`
30+
- `template_file` = `./template.md`
31+
- `solving_methods_file` = `./solving-methods.csv`
32+
- `default_output_file` = `{output_folder}/problem-solution-{date}.md`
33+
34+
### Inputs
35+
36+
- If the caller provides context via the data attribute, load it before Step 1 and use it to ground the session.
37+
- Load and understand the full contents of `{solving_methods_file}` before Step 1.
38+
- Use `{template_file}` as the structure when writing `{default_output_file}`.
39+
40+
### Behavioral Constraints
41+
42+
- Do not give time estimates.
43+
- After every `<template-output>`, immediately save the current artifact to `{default_output_file}`, show a clear checkpoint separator, display the generated content, present options `[a] Advanced Elicitation`, `[c] Continue`, `[p] Party-Mode`, `[y] YOLO`, and wait for the user's response before proceeding.
44+
45+
### Facilitation Principles
46+
47+
- Guide through diagnosis before jumping to solutions.
48+
- Ask questions that reveal patterns and root causes.
49+
- Help them think systematically, not do thinking for them.
50+
- Balance rigor with momentum - don't get stuck in analysis.
51+
- Celebrate insights when they emerge.
52+
- Monitor energy - problem-solving is mentally intensive.
53+
54+
---
55+
56+
## EXECUTION
1857

1958
<workflow>
2059

@@ -32,7 +71,7 @@ Gather problem information by asking:
3271
- What's the impact or cost of this problem?
3372
- What would success look like?
3473

35-
Reference the **Problem Statement Refinement** method from {solving_methods} to guide transformation of vague complaints into precise statements. Focus on:
74+
Reference the **Problem Statement Refinement** method from `{solving_methods_file}` to guide transformation of vague complaints into precise statements. Focus on:
3675

3776
- What EXACTLY is wrong?
3877
- What's the gap between current and desired state?
@@ -49,7 +88,7 @@ Reference the **Problem Statement Refinement** method from {solving_methods} to
4988
<step n="2" goal="Diagnose and bound the problem">
5089
Use systematic diagnosis to understand problem scope and patterns. Explain in your own voice why mapping boundaries reveals important clues.
5190

52-
Reference **Is/Is Not Analysis** method from {solving_methods} and guide the user through:
91+
Reference **Is/Is Not Analysis** method from `{solving_methods_file}` and guide the user through:
5392

5493
- Where DOES the problem occur? Where DOESN'T it?
5594
- When DOES it happen? When DOESN'T it?
@@ -64,7 +103,7 @@ Help identify patterns that emerge from these boundaries.
64103
<step n="3" goal="Conduct root cause analysis">
65104
Drill down to true root causes rather than treating symptoms. Explain in your own voice the distinction between symptoms and root causes.
66105

67-
Review diagnosis methods from {solving_methods} (category: diagnosis) and select 2-3 methods that fit the problem type. Offer these to the user with brief descriptions of when each works best.
106+
Review diagnosis methods from `{solving_methods_file}` (category: diagnosis) and select 2-3 methods that fit the problem type. Offer these to the user with brief descriptions of when each works best.
68107

69108
Common options include:
70109

@@ -116,7 +155,7 @@ Check in: "We've done solid diagnostic work. How's your energy? Ready to shift i
116155

117156
Create diverse solution alternatives using creative and systematic methods. Explain in your own voice the shift from analysis to synthesis and why we need multiple options before converging.
118157

119-
Review solution generation methods from {solving_methods} (categories: synthesis, creative) and select 2-4 methods that fit the problem context. Consider:
158+
Review solution generation methods from `{solving_methods_file}` (categories: synthesis, creative) and select 2-4 methods that fit the problem context. Consider:
120159

121160
- Problem complexity (simple vs complex)
122161
- User preference (systematic vs creative)
@@ -151,7 +190,7 @@ Work with user to define evaluation criteria relevant to their context. Common c
151190
- Risk - What could go wrong?
152191
- Other criteria specific to their situation
153192

154-
Review evaluation methods from {solving_methods} (category: evaluation) and select 1-2 that fit the situation. Options include:
193+
Review evaluation methods from `{solving_methods_file}` (category: evaluation) and select 1-2 that fit the situation. Options include:
155194

156195
- **Decision Matrix** - Good for comparing multiple options across criteria
157196
- **Cost Benefit Analysis** - Good when financial impact is key
@@ -187,7 +226,7 @@ Create action plan:
187226
- Who's responsible for each?
188227
- What resources are needed?
189228

190-
Reference **PDCA Cycle** and other implementation methods from {solving_methods} (category: implementation) to guide iterative thinking:
229+
Reference **PDCA Cycle** and other implementation methods from `{solving_methods_file}` (category: implementation) to guide iterative thinking:
191230

192231
- How will we Plan, Do, Check, Act iteratively?
193232
- What milestones mark progress?

src/workflows/problem-solving/README.md

Lines changed: 0 additions & 56 deletions
This file was deleted.

src/workflows/problem-solving/workflow.yaml

Lines changed: 0 additions & 26 deletions
This file was deleted.

0 commit comments

Comments
 (0)