SDK Guide
Bootstrapping a Graph
Use the region-anchored playbooks shipped in @unified-product-graph/core/playbooks to scaffold the first 100 nodes of a brand-new product graph without staring at a blank file.
Why playbooks
A blank UPG document is intimidating. 312 entity types, 36 domains, 10 regions — you can’t will yourself to type the first node. Playbooks are the answer: each is a region-anchored sequence of moves that scaffolds a real shape from cold start (Discovery Research Validation, Business Growth Funnel, GTM Audience-First, etc.). They’re both spec data (importable from /playbooks) and prose (rendered at /docs/playbooks).
import { DISCOVERY_RESEARCH_VALIDATION_PLAYBOOK } from '@unified-product-graph/core/playbooks'
console.log(DISCOVERY_RESEARCH_VALIDATION_PLAYBOOK.region)
// → the canonical region this playbook anchors to
for (const step of DISCOVERY_RESEARCH_VALIDATION_PLAYBOOK.steps) {
console.log(`→ ${step.title}`)
}The bootstrap pattern
Pick the playbook whose region matches what you’re building. Walk its steps; each step creates 5–15 nodes with their canonical edges already wired. Stop when the playbook ends — you now have ~100 nodes in a connected, validatable shape. Continue with adjacent playbooks (cross-region) or with hand-authored detail.
import { ALL_PLAYBOOKS } from '@unified-product-graph/core/playbooks'
// Find every playbook anchored on the user-research region
const userResearch = ALL_PLAYBOOKS.filter(p => p.region === 'user_research')
console.log(`${userResearch.length} playbooks to choose from`)