Skip to content
UPG is in early alpha. The specification is still evolving and may change between versions.
UPG
Blocks
Problem
Frameworks
Connect
Start
UPG v0.22.2 · Open SourceMIT License

AI expanded what you can produce,
not what you can hold in your head

Product knowledge piles up faster than any person or agent can keep track of. Unified Product Graph provides a structure underneath: an open specification that turns it into one connected graph that any tool, team, or agent can build on.

Using Claude Code?
claude mcp add unified-product-graph -- npx -y @unified-product-graph/mcp-server@latest
Prefer the full CLI (init, skills, health)? npm install -g @unified-product-graph/cli Full setup →
01The Building Blocks

Speak to your agent & connect your docs
Watch your product graph come alive

Tell your AI assistant what you're building, who it's for, what problem it solves and why it matters. UPG turns that conversation into typed entities with the relationships between them richly-defined. Connect your existing knowledge into the graph through conversation.

Claude Code
Graph View
The cards it creates
Explore all 320 types →
Seven entities, six typed edges: the real FitParent graph. The cards are one rendering of the underlying .upg data; tools like Entopo render them in full.
Guided Skills
All skills →

Skills walk you through strategy, research, design, and go-to-market, one question at a time. Every answer becomes a typed entity in your graph.

Start in Claude Code →
02The Problem

Same concept, ten different names

Lean Canvas calls it a problem. Jobs-to-be-Done calls it a struggle. Strategyzer calls it a customer pain. Same idea, a different word in every tool, so nothing lines up. UPG gives the concept one type that carries every framework’s name for it, helping bridge different worlds of product thinking.

Every tool speaks its own dialect

A Jira ticket, a Notion page, a Figma file. Each holds a piece of the product, and none of them knows how the pieces fit together. UPG gives every piece a type, a domain, and explicit relationships to everything else.

Teams are drowning in a sea of documents

AI can generate dozens of docs, but no one can keep all these documents in their head. AI makes this problem more painful: one person now produces in a day what used to take a team a month, and almost none of it is connected by design. A graph stores the same knowledge as typed entities and explicit connections.

A living graph captures things as they happen

Ten frameworks, six tools, twenty-eight documents, all describing the same product. A graph holds that knowledge in one place, with typed entities and real relationships between them. Enter it once. See it through any lens.

Read the manifesto →
03Frameworks

Frameworks help visualize the graph

An Opportunity Solution Tree, a Business Model Canvas, and a roadmap are all projections of the same underlying graph. Enter your product knowledge once and see it through any framework lens.

Frameworks are views, not data models
outcomeopportunitysolutionhypothesisexperimentpersonavalue propositionrevenue streamacquisition channelcost structurefeatureepicreleasemilestonemetric
Opportunity Solution Tree
OST
outcomeopportunitysolutionhypothesisexperiment
Business Model Canvas
BMC
personavalue propositionrevenue streamacquisition channelcost structure
Roadmap
Feature Roadmap
featureepicreleasemilestone
RICE Scoring
Reach, Impact, Confidence, Effort
featureopportunitysolutionhypothesis

Click a framework to see which entities light up.

Business Model CanvasOpen framework →
Key Partners
🫱🏻‍🫲🏼Partnership

Who are your key partners and suppliers?

Key Activities
🛠️Key Activity

What key activities does your value prop require?

Value Propositions
Value Proposition

What value do you deliver to the customer?

Customer Relationships
🫶Customer Relationship

What type of relationship does each segment expect?

Customer Segments
🎯Market Segment

For whom are you creating value?

Key Resources
🏭Key Resource

What key resources does your value prop require?

Channels
🚚Distribution Channel

How do you reach your customer segments?

Cost Structure
🧮Cost Structure

What are the most important costs?

Revenue Streams
💵Revenue Stream

For what value are customers willing to pay?

Business Model Canvas by Alexander Osterwalder & Yves Pigneur9 cells · 10×3 grid
See all frameworks →
05Connect Your Tools

The connective layer for everything you already use.

Your team doesn’t live in one tool. Notion holds PRDs, Linear tracks issues, Figma stores designs, the spreadsheet ranks features. UPG turns each of their outputs into typed entities so a single AI agent can read your whole product, not seven dialects.

UPG reads from your tools and writes back where it should.

Notion
Linear
Figma
Spreadsheet
Markdown
GitHub
Unified Product Graph
Typed entities · shared vocabulary · explicit relationships
one .upg file
AI agentsClaude CodeCursorYour SDKSearchReports
Examples
Notion PRDfeature + task
notion adapter
Linear tickettask
linear adapter
Spreadsheet rowmetric
csv adapter
Markdown docpersona + insight
markdown adapter

MIT-licensed. Vendor-neutral. Lives next to your code in a single .upg file.

07Get Started

Give your product knowledge a home

Talk to an agent and let it build the graph, or install the SDK and build your own tools to power any workflow your business context demands.

Talk to your AI · free
Install the UPG CLI.

Install once, then run upg mcp setup to wire up Claude Code, Cursor, or any MCP client. Your graph lives in a local .upg file you control.

npm install -g @unified-product-graph/cli
Then: upg mcp setup to wire up your AI tool.
Build on it · TypeScript
Install the SDK.

Read and write .upg files from your code. UPGClient with namespaced node and edge operations, health and search, built on @unified-product-graph/core.

npm install @unified-product-graph/sdk
Explore further