9numeric scales map a judgment to a 1–5 ordinal, so scores can be computed and compared. Tools may declare additional scales in a document’s scale_extensions, but these are the shared vocabulary every UPG-native tool understands. The UPG_SCALES map in @unified-product-graph/core is the canonical source of truth.
Reach (5-point)
reach_51–5How many users experience this problem or benefit from this feature
- 1
Almost no oneAffects <5% of users
- 2
A fewAffects 5-20% of users
- 3
SomeAffects 20-50% of users
- 4
MostAffects 50-80% of users
- 5
Nearly everyoneAffects >80% of users
Default scale for
reachprojected_reach
Frequency (5-point)
frequency_51–5How often the problem or situation occurs
- 1
RarelyLess than once a month
- 2
OccasionallyA few times a month
- 3
SometimesWeekly
- 4
OftenMultiple times a week
- 5
ConstantlyDaily or more
Default scale for
frequency
Severity (5-point)
severity_51–5How badly the problem impacts the user when it occurs
- 1
Mild inconvenienceNotices but works around easily
- 2
AnnoyingFrustrated but can continue
- 3
SignificantHas to change approach
- 4
SevereStruggles to accomplish goal
- 5
BlockerCannot accomplish goal
Default scale for
severityseverity_of_finding
Importance (5-point)
importance_51–5How important this is to the user when evaluating or using a solution
- 1
Nice to haveWould not notice if absent
- 2
Somewhat importantPrefer but can live without
- 3
ImportantActively looks for this
- 4
Very importantKey factor in decision
- 5
CriticalDealbreaker if absent
Default scale for
importance
Satisfaction (5-point)
satisfaction_51–5How well the current solution meets the user's need
- 1
Very unsatisfiedCurrent solution fails completely
- 2
UnsatisfiedCurrent solution inadequate
- 3
NeutralAcceptable
- 4
SatisfiedWorks well
- 5
Very satisfiedExceeds expectations
Default scale for
current_satisfaction
Pain (5-point)
pain_51–5How much friction or distress the problem causes the user
- 1
Barely noticeableMinor friction, easily ignored
- 2
MildNoticeable but not a priority to fix
- 3
ModerateActively wished it were better
- 4
SignificantRegularly disrupts workflow
- 5
ExtremeMajor frustration, seeking alternatives
Impact (5-point)
impact_51–5How much positive difference this solution or feature would make
- 1
MinimalBarely moves the needle
- 2
LowSmall improvement
- 3
ModerateNoticeable improvement
- 4
HighSignificant improvement
- 5
TransformativeGame-changing
Default scale for
impactprojected_impact
Confidence (5-point)
confidence_51–5How well-evidenced this assessment or judgment is
- 1
GuessingNo evidence
- 2
HunchAnecdotal evidence
- 3
Some evidenceA few data points
- 4
ConfidentMultiple data sources
- 5
Data-backedStrong quantitative evidence
Default scale for
confidence
Effort (5-point)
effort_51–5How much work is required to deliver this
- 1
TrivialHours
- 2
SmallDays
- 3
Medium1-2 weeks
- 4
SignificantWeeks to months
- 5
MassiveMonths+
Default scale for
efforteffort_estimateeffort_to_fix