Adopt

5 surfaces
Tools/Spec Introspection/list_approaches

list_approaches

List the 5 canonical `UPGApproach` records: Plan, Inspect, Prioritise, Trace, Reflect. An approach is the path of arrival to a region of the graph (final approach to an airport, coastline approach). Each record carries id, label, description, `question_answered`, `signature_hint`, `framework_id_examples`. Optional `framework_id` narrows to approaches whose `framework_id_examples` include it.

Spec Introspectionatomic (read-only)

Arguments

framework_idstringoptional

Exact-match framework id. Narrows to approaches whose framework_id_examples include it (discoverability surface; full reverse lookup is on UPGFramework.approach_ids).

Returns

Shape
{ count, approaches: UPGApproach[] }

Examples

Live call against the Notion example graph.

Output

{
  "count": 5,
  "approaches": [
    {
      "id": "plan",
      "label": "Plan",
      "description": "The path of arrival to \"what should I build next?\". Plan engages a region by surveying its entity coverage against canonical expectations and surfacing the missing scaffolding: the entities a healthy region carries that this graph does not. Cartographic sense: you are walking the coastline of a region and noting where the contour is incomplete, not deciding a strategy. Frameworks like Now/Next/Later, MoSCoW, and Wardley Mapping live within Plan as the named techniques for organising the gap-filling sequence.",
      "question_answered": "what should I build next?",
      "signature_hint": "({ region?: UPGRegionId }) → { missing_entities, coverage_score }",
      "framework_id_examples": [
        "now-next-later",
        "moscow",
        "wardley-map",
        "okr-framework",
        "three-horizons"
      ]
    },
    {
      "id": "inspect",
      "label": "Inspect",
      "description": "The path of arrival to \"what's broken?\". Inspect engages a region or a set of entities by running canonical health checks (anti-pattern audits, drift reports, lint passes) and emitting a structured violation list with severity, kind, target entity, description, and fix hint. Cartographic sense: you are surveying the coastline for hazards before approach; the violations are the
… (truncated)

See Also