problem-framing
Skill2 starsChanged 2 months agoMITView on GitHub
Reassess a problem when a solution accumulates branches, special cases, or layers, or discussion repeatedly fails to converge. Use when the user asks to challenge the problem statement, validate the underlying requirement, or reframe a stuck design. Ordinary implementation difficulty alone is insufficient.
9 other projects use a version of this.
Adopted by
Most recently taken up by
- Harrypatria/data-mining-mltheir own version, first seen Nov 1, 2026
- taichuy/1flowbasetheir own version, first seen Oct 23, 2026
- hollandkevint/thinkhaven-method-kittheir own version, first seen Oct 20, 2026
- mariomile/builder-ostheir own version, first seen Oct 9, 2026
- Mozurok/fhorja.devtheir own version, first seen Oct 8, 2026
- Dyfree/problem-navigatortheir own version, first seen Sep 8, 2026
Other versions9 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 9
- taichuy/1flowbase★ 292same name
- Mozurok/fhorja.dev★ 10same name
- CN-WenYu/skills★ 3same name
- gmanch94/claude-code-aidlc-template★ 2same name
- Harrypatria/data-mining-ml★ 2same name
- mariomile/builder-os★ 2same name
- tommy-ngn/skills★ 2same name
- Dyfree/problem-navigator★ 1same name
- hollandkevint/thinkhaven-method-kit★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository34 other files it gives its agents.
- agent-native-redesignSkill
- assess-source-project-fitSkill
- brainstormingSkill
- coaching-engineSkill
- codex-skill-creatorSkill
- cubox-researchSkill
- dev-browserSkill
- diffusion-mapSkill
- exa-web-searchSkill
- executing-plansSkill
- general-skill-creatorSkill
- harnessSkill
- i-diagramSkill
- memosSkill
- merge-and-rebaseSkill
- paseo-relaySkill
- plan-coachingSkill
- plan-meSkill
- plan-reviewSkill
- prove-itSkill
- pruneSkill
- raise-ambitionSkill
- readwise-researchSkill
- report-coachingSkill
- report-meSkill
- report-reviewSkill
- seeSkill
- shapeSkill
- subagent-driven-developmentSkill
- systematic-debuggingSkill
- test-driven-developmentSkill
- use-remote-skillSkill
- worktree-managerSkill
- writing-plansSkill
The file
We split this skill into the rules it gives an agent
2 rules. 0 are common, 2 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 7 edited versions we read keep these.
2
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
Treat rising complexity and repeated non-convergence as diagnostic signals that the problem may be framed incorrectly.
- Distinctive: line 30
Keep this proportional to the problem.
“Common” is measured: kept by at least 6 in 10 of the 7 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Problem framing
Treat rising complexity and repeated non-convergence as diagnostic signals that the problem may be framed incorrectly. They are evidence to investigate, not proof that the requirement is false.
Pause refinement of the disputed design long enough to examine the problem it serves. Use the conversation and available artifacts before asking the user to repeat information.
Diagnose and reframe
- Identify the signal concretely: which branches, exceptions, or layers keep appearing, or which point keeps being re-argued without new evidence?
- Restate the intended outcome independently of the proposed implementation. Identify who needs it and what observable result would count as success.
- Separate established requirements from assumptions and implementation choices. Check the evidence behind the requirement driving the complexity. Mark unsupported claims as unverified, not false. Preserve confirmed constraints, including compatibility, safety, and business obligations.
- Name the suspected false problem explicitly. State which assumption may be manufacturing the difficulty and why. Consider whether the actual cause is missing information, conflicting requirements, or unavoidable domain complexity instead.
- Offer a simpler framing tied to the same intended outcome. Explain exactly which complexity would disappear and which tradeoffs or constraints remain. A proposal that quietly drops a real requirement is not a successful reframing.
- Identify the smallest check that can distinguish the original framing from the alternative. Use available evidence or a reversible experiment where practical; ask a focused question only when necessary information is missing.
Communicate the decision
Tell the user plainly, in their language:
- The observed complexity or loop.
- The intended outcome and the assumption being questioned.
- The suspected false problem and proposed reframing.
- The evidence or check needed, followed by a recommended next step.
Keep this proportional to the problem; a short paragraph often suffices. Do not silently pivot or keep elaborating the same design without addressing the diagnosis.
If the evidence supports the new framing, continue within the authorized scope. If it would change the user's intended outcome or a confirmed constraint, present that change for a decision before doing dependent work. If the original requirement survives scrutiny, say so and resume solving it; do not force a reframing or repeat the audit without new evidence.
Example
A notification service keeps adding exceptions to an “exactly once” delivery mechanism. The intended outcome may be preventing duplicate user-visible notifications. If that is confirmed, durable deduplication at the display boundary could meet the outcome without requiring exactly-once transport. If downstream actions must also occur exactly once, display deduplication alone does not satisfy the requirement.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

