Solve Complex Problems
Use the problem-solving workflow to systematically diagnose problems, identify root causes, and develop effective solutions using proven analytical frameworks.
When to Use This
Section titled âWhen to Use Thisâ- Facing a complex, persistent challenge
- Need to understand root causes before fixing symptoms
- Multiple solution options exist and you need to choose
- Problems recur despite previous attempts to fix them
- Issues span multiple systems or components
When to Skip This
Section titled âWhen to Skip Thisâ- Well-understood problems with obvious solutions
- Simple, isolated bugs or issues
- Time-critical situations requiring immediate action
1. Load Dr. Quinn
Section titled â1. Load Dr. QuinnâStart a fresh chat and load the Problem Solver:
/cis-problem-solving2. Describe Your Problem
Section titled â2. Describe Your ProblemâDr. Quinn will ask about your challenge. Be specific about symptoms:
Good problem descriptions:
- âUsers abandon checkout after entering payment info 40% of the timeâ
- âThe database query takes 30 seconds when user count exceeds 1000â
- âCustomer support tickets increased 300% after the last releaseâ
Less effective:
- âFix performanceâ (too vague)
- âThe app is slowâ (no specifics)
3. Diagnose the Problem
Section titled â3. Diagnose the ProblemâDr. Quinn treats problems like puzzles and guides you through:
| Diagnostic Step | Goal |
|---|---|
| Symptom analysis | Separate what you see from whatâs causing it |
| Boundary definition | Understand where the problem lives and doesnât |
| History review | What changed, when, and what was attempted |
4. Apply Analytical Frameworks
Section titled â4. Apply Analytical FrameworksâDr. Quinn selects from his solving-methods library:
| Framework | Best For |
|---|---|
| Five Whys | Quick root cause drilling |
| TRIZ | Technical contradictions and inventive solutions |
| Theory of Constraints | System bottlenecks and flow |
| Systems Thinking | Interconnected, recurring issues |
| Root Cause Analysis | Comprehensive causal mapping |
5. Generate and Evaluate Solutions
Section titled â5. Generate and Evaluate SolutionsâOnce root causes are identified:
- Diverge â Generate multiple solution approaches
- Evaluate â Assess pros, cons, and trade-offs
- Select â Choose based on effectiveness and feasibility
- Plan â Create implementation steps with risk mitigation
What You Get
Section titled âWhat You GetâOutput saved to _bmad-output/problem-solution-{date}.md:
| Section | Contents |
|---|---|
| Problem Statement | Clearly defined challenge with symptoms |
| Diagnosis | Root cause analysis using selected frameworks |
| Solution Options | Multiple approaches with pros/cons |
| Recommended Solution | Best option with rationale |
| Implementation Plan | Actionable steps and timeline |
| Risk Mitigation | What could go wrong and how to prevent it |
| Success Metrics | How to measure effectiveness |
Example
Section titled âExampleâYou: /cis-problem-solvingDr. Quinn: What puzzle are we solving today?You: User engagement dropped 50% after our last release.Dr. Quinn: Fascinating symptom. Let's drill down. [Applies Five Whys] Why did engagement drop?You: Users aren't opening the app.Dr. Quinn: Why aren't they opening it?You: Push notifications stopped working.Dr. Quinn: Why did notifications stop?You: The API changed and we didn't update.Dr. Quinn: Aha! Root cause: Missing API integration. But why wasn't this caught in testing? [Drills deeper into process issues] [Identifies multiple root causes] [Generates solution options] [Creates implementation plan with safeguards]Next Steps
Section titled âNext StepsâAfter problem-solving:
- Use brainstorming (
/cis-brainstorm) to generate creative solutions - Apply innovation strategy (
/cis-innovation-strategy) if the problem requires strategic pivots - Use design thinking (
/cis-design-thinking) if users are experiencing the problem
Providing Context
Section titled âProviding ContextâFor best results, provide problem context via the --data flag:
workflow cis-problem-solving --data /path/to/problem-brief.mdDr. Quinn will use this context to accelerate the diagnostic phase.