TraverSpec Graph Explorer

Visualize a TraverSpec spec graph as an interactive, explorable node diagram right inside VS Code.

TraverSpec stores a project's specification as a graph: epics, features, data models, API contracts, business rules, and decisions as individual markdown files, connected by typed edges in a single traverspec/graph.yaml. This extension renders that graph so you can browse it visually instead of jumping between files.

Requirements

Your workspace needs a traverspec/graph.yaml file. If you don't have a TraverSpec project yet, see the TraverSpec CLI for how to set one up.

Usage

Open the graph from the TraverSpec icon in the activity bar, or run TraverSpec: Open Graph from the Command Palette.

The graph opens with epics visible and everything else collapsed. Click an epic to focus on it and reveal its features. From there, expand any node to reveal what it connects to, one column at a time. Nodes you've expanded stay visible even if you switch focus to another epic.

Click a node's body to open its markdown source in a preview panel beside the graph. Use the filter controls on each node to narrow down which connected entity types, edge types, and directions are shown.

The graph reloads automatically whenever graph.yaml changes on disk.

Why a graph view

A graph.yaml file is easy for a script (or an AI agent) to walk, but not easy for a person to read directly. This extension exists to make the same graph legible to a human: what depends on what, which features share a data model, where a business rule is actually enforced.

License

MIT