Adopt

5 surfaces
Tools/Spec Introspection/list_scales

list_scales

List every spec-defined assessment scale from `UPG_SCALES` (canonical vocabulary for `UPGAssessment` values). Each scale carries id, label, description, min, max, steps, and per-point labels + descriptions. Non-paginated. External `scale_extensions` are graph-instance–scoped and excluded here.

Spec Introspectionatomic (read-only)

Arguments

No arguments — this tool takes no input.

Returns

Shape
{ scales: UPGScaleDefinition[], total: number }

Examples

Live call against the Notion example graph.

Output

{
  "scales": [
    {
      "id": "reach_5",
      "label": "Reach (5-point)",
      "description": "How many users experience this problem or benefit from this feature",
      "min": 1,
      "max": 5,
      "steps": 5,
      "points": [
        {
          "value": 1,
          "label": "Almost no one",
          "description": "Affects <5% of users"
        },
        {
          "value": 2,
          "label": "A few",
          "description": "Affects 5-20% of users"
        },
        {
          "value": 3,
          "label": "Some",
          "description": "Affects 20-50% of users"
        },
        {
          "value": 4,
          "label": "Most",
          "description": "Affects 50-80% of users"
        },
        {
          "value": 5,
          "label": "Nearly everyone",
          "description": "Affects >80% of users"
        }
      ]
    },
    {
      "id": "frequency_5",
      "label": "Frequency (5-point)",
      "description": "How often the problem or situation occurs",
      "min": 1,
      "max": 5,
      "steps": 5,
      "points": [
        {
          "value": 1,
          "label": "Rarely",
          "description": "Less than once a month"
        },
        {
          "value": 2,
          "label": "Occasionally",
          "description": "A few times a month"
        },
        {
          "value": 3,
          "label": "Sometimes",
… (truncated)

See Also