Adopt

5 surfaces

Surfaces

Integrations

Strategy & Discovery

2
VistalyProductboard

Research & Insights

1
Dovetail

Knowledge & Docs

1
Notion

Design

1
Figma

Analytics

1
PostHog
DeliveryBeta

Coming from Shortcut

38% entity overlap

Import

The only delivery tool with native OKRs: Objective and Key Result map directly, no custom fields needed.

The structural finding

Shortcut's native Objective + Key Result layer means the UPG integration bridges shorter than Linear or Jira. The chain objective → key_result → epic → user_story is fully typed in both systems.

What UPG adds

1

The discovery layer above your OKRs: user opportunities and research evidence that explain why each objective was set.

2

Release context below your stories: the release each epic ships in.

3

Cross-domain traceability: from a Shortcut story → through the epic → to the outcome it serves.

Schema mapping

Direct matches
Objective→objective
Key Result→key_result
Epic→epic
Story (feature)→user_story
Story (bug)→bug
Story (chore)→task
Team→team
Document→document
Maps with caveats
Iteration (sprint)→(no UPG equivalent; sprint is team process)
Label→(property tag on node)
What UPG adds
opportunitypersonahypothesisfeature_requestresearch_studyrelease
Skipped:Workflow states · Velocity stats · Comments

The key edge

The single most important semantic relationship this integration enables.

objective_achieved_through_key_result

Defined in the UPG specification

Sample import

A Shortcut OKR + delivery chain: Objective → Epic → Stories

Input (from Shortcut)
Output (UPG nodes)
Objective
Accelerate time-to-value for new signups
→
objective
Accelerate time-to-value for new signups
Key Result
Reduce setup time to under 5 minutes
current: 12min, target: 5min
→
key_result
Reduce setup time to under 5 minutes
↳ objective_achieved_through_key_result
Epic
Guided setup wizard
→
epic
Guided setup wizard
↳ epic_specified_by_user_story
Story (feature)
Show contextual hints during workspace creation
→
user_story
Show contextual hints during workspace creation
↳ epic_specified_by_user_story

Roundtrip

API ROUNDTRIPPlanned
Shortcut ──import──▶ UPG ──enrich──▶ UPG ──push via REST──▶ Shortcut

Import OKRs and epics → add discovery context in UPG → push opportunity and outcome links back to Shortcut via API.

Writes back
  • ·Opportunity descriptions added to Shortcut epic descriptions
  • ·Outcome links surfaced in epic metadata
  • ·Research evidence notes added to epics as linked documents

How to import your Shortcut data

Via the CLI (coming soon)

The Shortcut adapter is built and tested. A one-command import via the UPG CLI is in development:

npx unified-product-graph import --from shortcut

This will fetch your Shortcut data, map entity types automatically, and write everything to your graph. Today you can use the Markdown import or the adapter directly in code.

▸ For developers: use the adapter directly
import { ShortcutAdapter } from '@unified-product-graph/adapters'
// Pass pre-fetched Shortcut data as SourceItem[]
const adapter = new ShortcutAdapter()
const result = await adapter.convert(items)
// result.nodes → typed UPG entities
// result.edges → canonical relationships
// result.warnings → items needing review

Get started

The Shortcut adapter ships in @unified-product-graph/adapters. Install it, then run the import command.

# one-time install
$ npm install -g unified-product-graph

# then import
$ upg import --from notion

Other tools in Delivery

← All integrations