Skip to main content

Spec Graph

A new paradigm for truly declarative, agentic software development.

Why Spec Graph

Built for agent-driven development

A directed, typed graph of atomic specification nodes that captures everything required to manifest a system.

Complete

Capture every dimension of your system: behavior, architecture, design, technology, domain, and constraints.

Minimal

Every node is load-bearing. If removing it wouldn't cause manifestation ambiguity, it doesn't belong.

Predictable

Two agents given the same spec graph should converge on logically equivalent systems across behavior, architecture, and constraints.

A graph, not a document

Each node is atomic, typed, and connected through forward-only edges. Agents traverse the graph to assemble exactly the context they need.

  • 5 core node types + 7 extensions
  • 7 edge types, all forward-only and node-local
  • JSON Schema Draft 2020-12 validated
  • Namespace-scoped features for modular specs
featureuser-authentication
behaviorlogin-with-email
decisionuse-jwt-tokens
behaviorpassword-reset-flow
domainuser-entity
constraintbcrypt-hashing
Node Types

12 typed building blocks

5 core types for any system, plus 7 extension types for UI, API, data, and pipeline concerns.

feature
behavior
decision
domain
constraint
design_token
ui_contract
api_contract
data_model
artifact

Build with declarative agentic specs

Specify behavior, decisions, domain, and policy in one graph so capable agents can manifest systems predictably.