problem-framing
Skill2 starsChanged 49 days agoMITView on GitHub
States the problem behind an idea before any solution: who has it, what it costs today, why now, prior art, the riskiest assumption. Use when someone arrives with an idea, a feature request or a vague complaint still mixed with a solution.
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
- Mozurok/fhorja.devtheir own version, first seen Oct 8, 2026
- jtsang4/efficient-codingtheir own version, first seen Sep 12, 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
- jtsang4/efficient-coding★ 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 repository25 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- agent-designSkill
- agents-mdSkill
- bug-diagnosisSkill
- builder-osSkill
- business-caseSkill
- delivery-disciplineSkill
- domain-modelSkill
- evidence-ledgerSkill
- gate-checksSkill
- go-to-marketSkill
- ideation-methodsSkill
- opportunity-mappingSkill
- outcome-reviewSkill
- pressure-testingSkill
- product-analysisSkill
- release-opsSkill
- research-methodsSkill
- spec-writingSkill
- system-designSkill
- tracking-standardsSkill
- using-builder-osSkill
- ux-architectureSkill
- wayfindingSkill
The file
Files
Problem Framing
A solution accepted as a problem can only be built, never tested. Framing climbs from the ask to a cost a specific person bears, then names the one belief that, if false, collapses the whole thing.
Mode. Standalone frames the supplied idea or complaint with its known audience and constraints and returns the problem statement, unknown facts kept unknown (steps 1 to 5). The lifecycle runs every step, writes 00-frame.md and gate 0. Both per operating modes. Load pressure-testing for the rounds and evidence-ledger when tags need checking. Read framing methods when a step needs its worked detail or examples.
Procedure
- Capture the ask verbatim, word for word, before interpreting it: the phrasing carries the assumption you are about to extract. A ticket is read with its history and tagged
[doc:*]. An anomaly (a watched metric outside its bands, an incident) starts from the metric, baseline, breach and window, tagged[data:*]or[doc:*], and climbs from the observed cost; its riskiest assumption is usually about the cause. WherePRODUCT.mdalready evidences the problem and ICP, the work may qualify for the feature track (lifecycle-setup). Done when the ask is quoted exactly with its source. - Climb the ladder. One "why does that matter" at a time, in conversation. Stop when the statement names a cost a specific person bears and the next why would produce a truism. It passes the "so what" test when a role (not an organization) bears the cost, today's workaround is named, and its cost is named (unquantified is acceptable as
[assumption:unvalidated]). Then run the solution-language check (gate 0.1, word list ingate-checks); the product's own nouns are defined inPRODUCT.md→ Language and used as defined. Done when the statement passes both checks. Run the context round. Retrieve known ICP, why-now and prior-art facts first (the prior-art search runs before the round where
web.searchresolved, so that question arrives answered and tagged), then ask what remains as apressure-testinground. Work each answer until it holds:- ICP. One primary, others explicitly secondary, with all five fields: segment, size, trigger, buying power, reachability. Push hardest on size (a number with a source tag; bottom-up beats a borrowed market report) and reachability (five people the person could get on a call this week). When reachability fails, say plainly that phase 1 will stall and that finding reachable users is now the first task.
- Why now. A dated change: behavior shifted, cost collapsed, a constraint lifted. With none evidenced, say so and label candidate structural reasons as hypotheses; "the technology is good enough now" needs the capability and the line it crossed.
- Prior art. The two closest existing solutions, each classified solved well and adopted, solved badly but adopted, or solved and not adopted: a shallow scan, with
product-analysis(competition) when more is needed. "Solved well, adopted" is said directly: stopping here is a legitimate phase 0 outcome and costs a conversation instead of a quarter.
Done when the ICP has all five fields, why-now has a dated change or a stated gap, and prior art has two classified entries.
- Put the riskiest assumption to the person. List the beliefs the frame requires and score each on confidence against collapse. The two or three low-confidence, high-collapse candidates become one round question: each as a falsifiable sentence with the observation that would falsify it and what phase 1 would then test, and a recommendation. An unfalsifiable candidate is a preference: label it and offer the next. Record
**Chosen by:**under## Riskiest assumptionwith the person's answer (gate 0.5). Done when one chosen assumption has its falsifier. - List the open questions: what the frame could not settle (a population nobody has reached, an access rule, a constraint nobody owns), who can answer each, and which phase inherits it. Done when each open question has an owner and a phase.
- Deliver. Standalone returns the framing and its uncertainties. The lifecycle writes
.builderos/initiatives/{initiative}/00-frame.mdper the frame template and runs gate 0 pergate-checks; on a pass, present the frame and ask whoever owns the problem to accept it, then record it with their answer (scripts/bos.mjs record 0 --judged ... --accepted-by "who"where commands run). A failed gate gets the refusal. A project with no.builderos/is reported as uninitialized: initialization is its own step. Done when the frame is delivered and, in the lifecycle, gate 0 is recorded with the person's acceptance.
Watch for
| Do | Instead of |
| Climb the ladder to a borne cost | Taking the first statement as the problem |
[assumption:unvalidated] for an unknown cost | An invented number |
| Start an anomaly from the observed metric and its window | Framing it from the proposed fix |
Capabilities
| Capability | Used for | Floor if absent |
web.search | Prior art scan | Ask the person what they and the ICP use today, tag [doc:user-{date}-{topic}] |
docs.search | Existing strategy notes, earlier attempts at this problem | Skip; note the gap |
repo.read | What was already tried, from README, changelog, issues | Skip |
files.write | A requested file or lifecycle artifact/state | An inline framing needs no write; lifecycle writes require it |
Phase 0 needs no data capability: an idea with nothing connected is the normal entry, and analytics waits for later phases.
Output Contract
## FRAME COMPLETE, followed by the problem, the ICP, the riskiest assumption and who chose it, the open questions, the gate verdict, who accepted, and the research target phase 1 inherits. Standalone output follows the requested format and destination, with no gate claims.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
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.

