plugins/workflow/skills/problem-framing/SKILL.md
Use when beginning analytical or strategic tasks, facing undefined problems, or facing analysis paralysis—requires explicit problem definition before proceeding.
npx skillsauth add joellewis/skill-library problem-framingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Problem-framing is the "discovery gate" that ensures you are solving the right problem before investing resources in solutions. It uses human-centered design principles and strategic cascades to move from symptoms to root causes.
NO ANALYSIS WITHOUT APPROVED PROBLEM FRAMING FIRST
Premature analysis leads to solving the wrong problem, wasting resources on elegant solutions to low-value or non-existent issues.
digraph problem_framing_flow {
"Start" [shape=doublecircle];
"Step 1: Observe & Gather Context" [shape=box];
"Step 2: Root Cause Analysis (5 Whys)" [shape=box];
"Step 3: Reframing & Questioning" [shape=box];
"Gate: User Approval of Problem Statement" [shape=diamond];
"Step 4: Define Winning Aspiration" [shape=box];
"Done: Discovery Gate Passed" [shape=doublecircle];
"Start" -> "Step 1: Observe & Gather Context";
"Step 1: Observe & Gather Context" -> "Step 2: Root Cause Analysis (5 Whys)";
"Step 2: Root Cause Analysis (5 Whys)" -> "Step 3: Reframing & Questioning";
"Step 3: Reframing & Questioning" -> "Gate: User Approval of Problem Statement";
"Gate: User Approval of Problem Statement" -> "Step 4: Define Winning Aspiration" [label="approved"];
"Gate: User Approval of Problem Statement" -> "Step 1: Observe & Gather Context" [label="rejected"];
"Step 4: Define Winning Aspiration" -> "Done: Discovery Gate Passed";
}
REQUIRED SUB-SKILL: using-skills — To ensure proper skill invocation discipline.
RECOMMENDED SUB-SKILL: stakeholder-discovery — To map who needs to approve the problem framing.
| Thought | Reality | |---------|---------| | "The problem is obvious, let's just start." | Obvious problems are usually just symptoms of a deeper root cause. | | "We don't have time for a framing workshop." | Solving the wrong problem takes infinitely longer than framing it correctly. | | "The client already told us what the problem is." | Clients often describe the solution they think they need, not the actual problem. | | "I'll frame it as I go while I'm doing the analysis." | Analysis without framing is aimless and prone to confirmation bias. |
These thoughts mean STOP — you are about to shortcut:
databases
Use when a deliverable needs structured stakeholder sign-off before finalization—runs the pre-read, feedback-type alignment, and conflict-resolution protocol.
development
Use when you need to map who has power, who will be affected, and what motivates each party — produces a stakeholder map as an analytical artifact. This skill identifies and categorizes stakeholders; it does not persuade or influence them (use influence-architect for that).
testing
Use when translating a product vision into engineering requirements—enforces the Working Backwards PR/FAQ method, requiring a customer-facing press release before any technical spec.
development
Builds investor pitches and funding proposals that prove a 'secret' through data and narrative — answering 'Why Now?' and 'Why Us?' using Thiel's definite optimism framework. Use when creating pitch decks, internal presentations, or funding requests.