UPG is in early alpha. The specification is still evolving and may change between versions.

Adopt

5 surfaces
Tools/Schema/get_entity_schema

get_entity_schema

Return expected properties, valid statuses, valid edge types, and domain for an entity type. Lets agents construct valid entities without skill prompts. Optional `include` folds in valid child types / super-domain region; optional `resolve_edge_to` folds in the canonical edge for this type → that target.

Schemaatomic (read-only)

Arguments

typestringrequired

Entity type (e.g. "hypothesis", "persona", "opportunity")

includearrayoptional

Optional extra blocks: "valid_children" (folds get_valid_children), "region" (folds get_region_for_entity_type).

resolve_edge_tostringoptional

Optional target entity type. Folds resolve_edge_for_pair(type → target) into a `resolve_edge` block.

Returns

Shape
{ type, alias_of?, domain, expected_properties, edges_out, edges_in, phases?, initial_phase?, terminal_phases?, domain_guide?, valid_children?, region?, resolve_edge? }

Examples

Live call against the Notion example graph.

Input

{
  "type": "person"
}

Output

{
  "type": "person",
  "domain": {
    "id": "team_org",
    "label": "Team & Organisation"
  },
  "expected_properties": {
    "email": {
      "type": "string",
      "description": "Primary contact email. Stable identifier for de-duplication."
    },
    "role_title": {
      "type": "string",
      "description": "Free-text job title. Distinct from the structured `role` entity."
    },
    "time_zone": {
      "type": "string",
      "description": "IANA time zone (e.g. \"Europe/Berlin\"). Useful for capacity / on-call planning."
    }
  },
  "edges_out": [],
  "edges_in": [
    {
      "edge_type": "node_owned_by_person",
      "source_type": "node",
      "reverse_verb": "owns"
    }
  ],
  "domain_guide": {
    "anchor_entity": "team",
    "creation_sequence": [
      "team",
      "role",
      "stakeholder",
      "person",
      "team_okr",
      "retrospective",
      "dependency",
      "department",
      "skill",
      "ceremony",
      "capacity_plan"
    ],
    "position_in_sequence": 3,
    "anti_patterns": [
      {
        "description": "Teams without OKRs: every team needs clear goals"
      },
      {
        "description": "Dependencies without both teams linked: a dependency must connect blocker and blocked"
      },
      {
        "description": "Retrospectives without action items: reflection without action is just venting"
      }
    ]
  }
}

See Also