Adopt

5 surfaces
Tools/Areas & Change Log/create_area

create_area

Create a product area entity in the portfolio document (`.upg/portfolio.upg`). Product areas represent the organisational axis (who owns what). Supports nesting via `parent_area_id`. The portfolio document is created on demand.

Areas & Change Logatomic per write; the portfolio file is read, mutated, and flushed in one pass.

Arguments

titlestringrequired

Area name (e.g. "Search", "Payments")

descriptionstringoptional

What this area covers

parent_area_idstringoptional

Parent area ID for creating a sub-area

strategic_prioritystringoptional

Strategic priority of this area

criticalhighmediumlow
ownerstringoptional

Person or team that owns this area

Returns

Shape
{ node, portfolio_file, written_to }

node is the typed UPGProductArea record persisted to portfolio_areas[].

Examples

Live call against the Notion example graph.

Input

{
  "title": "Example node"
}

Output

{
  "node": {
    "id": "n_ntp_s5A9-x-aKjjS",
    "title": "Example node"
  },
  "portfolio_file": "/Users/FH/Documents/_Code/tpc-emdash-packages/packages/upg-mcp-server/.upg/portfolio.upg",
  "written_to": "product_areas"
}

See Also