Know Tool: Specification Graph Manager FAQs

Question 1

What is a specification graph in the context of the Know Tool?

Accepted Answer

A specification graph is a directed acyclic graph (DAG) that represents software systems as interconnected nodes (Entities, References, and Meta) to provide a single, explicit source of truth for your system architecture.

Question 2

What is the 'Single Product Chain' mental model?

Accepted Answer

It is a flow that connects the system from who uses it to how it works: Project → User → Objective → Feature → Action → Component → Operation.

Question 3

What are the three primary node types used by this skill?

Accepted Answer

The graph consists of Entities (structural nodes like features or components), References (terminal nodes with implementation details like logic or data models), and Meta (project metadata like phases and decisions).

Question 4

How does the Know Tool prevent architectural drift?

Accepted Answer

It uses strict, unidirectional dependency rules and validation commands like 'know check' to identify circular dependencies, orphaned nodes, and missing links between high-level specifications and actual code.

Question 5

Can I link my code directly to the specification graph?

Accepted Answer

Yes, the tool supports cross-graph navigation and commands like 'know graph cross connect' to create bidirectional links between spec features and code modules, allowing you to see implementation coverage.

Know Tool: Specification Graph Manager

Key Features

Use Cases

Know Tool: Specification Graph Manager

Key Features

Use Cases