create-graph-spec

Purpose

Turn a product or engineering intent into a valid graphspec bundle: a directory of OKF markdown concepts, cross-linked by typed relations: frontmatter, that passes npx graph-spec-cli validate --strict clean. The graphspec vocabulary is closed — 13 node types, 16 typed relations — so authoring means mapping the intent onto that vocabulary, never extending it.

Always invoke the CLI as npx graph-spec-cli … — that is the npm package name, and it needs no prior install. The installed binary is named graphspec, so graphspec … also works wherever the package is already installed or on PATH.

Workflow

Copy this checklist and track progress: