Adopt

5 surfaces
Tools/Spec Introspection/plan

plan

Plan approach: path of arrival to "what should I build next?". Returns the Plan record + invocation params wrapped in `{ approach_id, scope, generated_at, approach, params }`. The LLM consumes `signature_hint` and synthesises `{ missing_entities, coverage_score }` against the live graph. Optional `region` narrows scope.

Spec Introspectionatomic (read-only)

Arguments

regionstringoptional

Optional UPGRegionId. Narrows planning scope to a single region (e.g. "users_needs", "business_gtm_growth"). Omit for whole-graph planning.

Returns

JSON envelope: { approach_id, scope, generated_at, approach, params, missing_entities, coverage_score, expected_count, covered_count, execution_mode: "execution_v0_4_0" }.

Examples

Live call against the Notion example graph.

Output

{
  "approach_id": "plan",
  "scope": null,
  "generated_at": "2026-05-29T20:13:19.977Z",
  "approach": {
    "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"
    ]
  },
  "params": {
    "region": null
  },
  "region": null,
  "missing_entities": [],
  "coverage_score": 1,
  "expected_count": 312,
  "covered_count": 312,
  "execution_mode": "execution_v0_4_0"
}

See Also