Knowledge Graph (BKN)
2D & 3D Knowledge Graph (BKN) Complete Guide
Visualize your project's architecture, dependencies, features, services, and tasks as an interactive graph network with sub-millisecond recursive path queries.
Interactive force-directed graph rendering interconnected nodes, services, and live dependencies.Live Interface
1. Exploring 2D Canvas & 3D Force-Directed Graph
- 1Click the 'Graph' tab in the left sidebar to open the Blueprint Knowledge Network (BKN).
- 2Toggle between 2D Canvas and 3D Force-Directed Graph using the view mode toggle in the top-right toolbar.
- 3Use mouse drag to pan or rotate the coordinate plane; scroll or pinch to zoom with dynamic depth-of-field.
- 4Click on any node to open the Node Inspector panel, displaying properties, description, status, and linked edges.
2. Creating & Connecting Graph Nodes
- 1In the Graph view, click the '+ Add Node' button in the toolbar.
- 2Provide a node name, select an entity label (Service, Feature, Database, API Endpoint, Task), and write a description.
- 3To connect two nodes, click and drag from the connection handle of the source node to the target node.
- 4Select the relationship type (depends_on, calls, documents, implements).
3. Dependency Tracing & Recursive CTE Path Queries
- 1Locate the Filter Bar at the top of the canvas to isolate specific subsystems by label or status.
- 2Select any node and click 'Trace Dependencies' to highlight all connected upstream parents and downstream children.
- 3Evaluate change blast radiuses instantly across your entire technology stack.
Relationship Types
Standard semantic edge definitions
depends_onIndicates an architectural, build, or runtime dependency
callsIndicates an API, RPC, or network endpoint invocation
documentsLinks a technical specification document to a service or feature
implementsRelates an engineering module to a strategic goal or requirement
Technical Specifications & Code Snippets
// PostgreSQL Recursive CTE Graph Query (sql)
WITH RECURSIVE graph_tree AS (
SELECT id, name, label, 0 AS depth
FROM bkn_nodes WHERE id = $1
UNION ALL
SELECT n.id, n.name, n.label, gt.depth + 1
FROM bkn_nodes n
JOIN bkn_edges e ON e.target_id = n.id
JOIN graph_tree gt ON gt.id = e.source_id
WHERE gt.depth < 4
)
SELECT * FROM graph_tree;Pro Tips & Architectural Best Practices
•Use dependency tracing before modifying an API or database schema to see all reliant features and tasks.
•Use the 2D view for spatial manual layouts and switch to 3D for large-scale multi-cluster exploration.
Have questions about this workflow?
Use our interactive search console to filter through all guides and articles.