Skip to content
🤖 AI-optimized docs: llms-full.txt

Solve Complex Problems

Use the problem-solving workflow to systematically diagnose problems, identify root causes, and develop effective solutions using proven analytical frameworks.

  • 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
  • Well-understood problems with obvious solutions
  • Simple, isolated bugs or issues
  • Time-critical situations requiring immediate action

Start a fresh chat and load the Problem Solver:

/cis-problem-solving

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)

Dr. Quinn treats problems like puzzles and guides you through:

Diagnostic StepGoal
Symptom analysisSeparate what you see from what’s causing it
Boundary definitionUnderstand where the problem lives and doesn’t
History reviewWhat changed, when, and what was attempted

Dr. Quinn selects from his solving-methods library:

FrameworkBest For
Five WhysQuick root cause drilling
TRIZTechnical contradictions and inventive solutions
Theory of ConstraintsSystem bottlenecks and flow
Systems ThinkingInterconnected, recurring issues
Root Cause AnalysisComprehensive causal mapping

Once root causes are identified:

  1. Diverge — Generate multiple solution approaches
  2. Evaluate — Assess pros, cons, and trade-offs
  3. Select — Choose based on effectiveness and feasibility
  4. Plan — Create implementation steps with risk mitigation

Output saved to _bmad-output/problem-solution-{date}.md:

SectionContents
Problem StatementClearly defined challenge with symptoms
DiagnosisRoot cause analysis using selected frameworks
Solution OptionsMultiple approaches with pros/cons
Recommended SolutionBest option with rationale
Implementation PlanActionable steps and timeline
Risk MitigationWhat could go wrong and how to prevent it
Success MetricsHow to measure effectiveness
You: /cis-problem-solving
Dr. 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]

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

For best results, provide problem context via the --data flag:

Terminal window
workflow cis-problem-solving --data /path/to/problem-brief.md

Dr. Quinn will use this context to accelerate the diagnostic phase.