idea-shaping — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited idea-shaping (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
Before you specify what to build, decide whether the idea is worth building and clearly understood. Most weak features trace back to a fuzzy idea nobody pressure-tested — a solution handed as a problem, an unexamined assumption, or the first option never compared to doing less.
Shaping is cheap. Building is expensive. A sharp pursue / park / drop with reasoning is a valid outcome; a vague "yes let's try" is not.
This skill precedes [[spec-first]] for engineering specs and [[product-brief]] when stakeholders need alignment on a PRD or RFC. For recording a significant chosen direction, see [[decision-docs]].
Skip when the problem is already shaped, evidenced, and agreed — go straight to [[spec-first]] or [[product-brief]]. Skip for pure execution on a locked spec.
Not this skill alone: cross-team sign-off on a large initiative → shape first, then [[product-brief]].
Work in order. Don't write requirements until the problem statement survives pressure.
Write what was said verbatim, then separate layers:
Raw request: "Add a leaderboard to increase engagement"
Solution proposed: leaderboard
Problem (unknown): ??? engagement with what, for whom, why nowPeople hand you solutions and call them problems. Your job is to dig to the need.
Clarifying questions (ask until answers are concrete):
If answers are vague ("engagement is low"), push for observable behavior ("users abandon onboarding at step 3").
A good problem statement has who, pain, context, and why alternatives fail — no solution baked in.
Template:
[Who] experiences [pain] when [context/situation],
because [cause or constraint].
Today they [current behavior/workaround], which [cost of workaround].Examples:
Good: New sellers abandon listing creation after uploading photos because they don't
know if pricing is competitive; they guess or leave and never publish.
Bad: We need a pricing recommendation feature.Solution disguised as problem — rewrite:
| Disguised | Reframed |
|---|---|
| "We need push notifications" | Buyers miss time-sensitive deals because they don't check email within the offer window |
| "Build a mobile app" | Field technicians can't complete jobs when offline; they paper notes and re-enter later |
| "Add AI chat" | Support can't scale; wait time is 48h and CSAT dropped — unclear if chat is the fix |
If you can't write the statement without naming your favorite solution, you haven't finished shaping.
List what the idea assumes without evidence:
| Assumption | Evidence we have | Confidence |
|---|---|---|
| Sellers quit because of pricing, not photos/UX | One support ticket | Low |
| Recommendations will increase publish rate | None | Guess |
| Sellers will trust algorithmic prices | Competitor survey | Medium |
Circle the riskiest assumption — if it's wrong, the whole idea fails. That's what you validate first, cheapest.
Common hidden assumptions:
Building is the most expensive experiment. Prefer fast learning on the riskiest assumption:
| Method | Cost | Good for |
|---|---|---|
| 5–8 user interviews | Hours | Pain real? workaround? language? |
| Data analysis | Hours–days | Drop-off funnel, cohort, support tags |
| Concierge / manual | Days | Deliver outcome by hand before automating |
| Fake door / prototype | Days | Click interest without full build |
| Survey | Days | Breadth — weak on depth; triangulate |
| Spike / technical prototype | Days | Feasibility, latency, cost — not user value alone |
Record what you learned and update assumptions. "We talked to 6 sellers; 4 cited pricing anxiety, 2 cited photo quality" beats "users want this."
If validation fails the riskiest assumption → drop or pivot before [[spec-first]].
The first idea is rarely the best. Sketch at least three approaches:
Problem: sellers abandon listing due to pricing uncertainty
A) ML price recommendation at upload
B) Show market range from public data (read-only, no ML)
C) Human pricing review for first 10 listings (concierge)
D) Improve copy explaining how to price (education only)
E) Do nothing — focus on photo upload UX instead (if data shows that's the drop)Alternatives force trade-offs into the open. Skipping this step is how teams build expensive A when B would have worked.
Score or rank options against what matters for this decision — not every criterion every time.
Typical criteria:
| Criterion | Questions |
|---|---|
| User value | How much pain removed? For how many? |
| Evidence | What validates the riskiest assumption? |
| Effort | Build time, ongoing maintenance, ops burden |
| Risk | Technical, legal, reputational, metric cannibalization |
| Strategic fit | Aligns with company focus, moat, roadmap |
| Time | Urgency — deadline, season, competitive window |
Be honest about trade-offs:
Option B is faster but may not be enough for power sellers;
Option A is high upside but 3-month build and needs pricing data we don't have yet.Avoid false precision — "score 7.2" without reasoning helps no one. Narrative trade-offs help.
Record a clear decision with why:
| Decision | When | Record |
|---|---|---|
| Pursue | Problem sharp, riskiest assumption validated or acceptable, best option chosen | Chosen approach + why not others |
| Park | Maybe later — missing data, dependency, strategy timing | What must change to revisit; review date |
| Drop | Wrong problem, failed validation, better alternative elsewhere | Why not — prevents relitigation |
Decision: PURSUE option B (market range display) for v1.
Why: interviews + funnel data support pricing anxiety; B ships in 2 weeks vs 3 months for ML.
Park A for Q3 if B moves publish rate +10%.
Drop C — ops cost not scalable."No" with reasoning is success. "Let's just try it" without criteria is not.
| Next step | When |
|---|---|
| [[spec-first]] | Engineering team ready to build; problem shaped for one team |
| [[product-brief]] | Stakeholders, sign-off, cross-team initiative, PRD/RFC needed |
| [[decision-docs]] | Significant strategic choice others will question later |
| Spike ticket only | Technical feasibility unknown — time-boxed, not a feature commit |
Handoff packet (paste into spec or brief):
Problem statement:
Assumptions (validated / still open):
Chosen direction:
Alternatives rejected and why:
Success signal (how we'll know it worked):
Out of scope for this round:
Open questions for spec:Exec one-liner in Slack
Capture verbatim → problem excavation in 30 min → one-page shape → pursue/park/drop before anyone estimates.
Engineer proposed solution
"Let's use Kafka" → what problem? at what scale? what fails today? → maybe a queue isn't the issue.
Competitive parity ("Competitor has X")
What user job does X serve for our users? Is parity strategic or anxiety? Often a smaller local win beats feature cloning.
Internal tool / automation
Who does manual work today? How many hours? What's the error rate? Internal ROI can be clear without user interviews — still shape the problem.
"We should add AI / LLM"
What task, what input, what output, what failure cost? ([[llm-feature-engineering]]) — AI is an implementation option, rarely the problem statement.
Customer feature request
Thank → understand job → check if request is representative → shape for segment size, not one loud customer.
Two good ideas, one team
Shape both lightly → compare criteria → pick one → park the other with review trigger (metric, date).
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.