RUNBOOK
Trace a dependency
Follow how one system reaches another — typed edges, blast radius, and the cross-repo doc links.
The dependency model
Every member declares its edges in its atlas.json, and atlas assembles them into topology/constellation.json. Edges are typed: build (the strongest coupling), contract (a published interface), runtime (a deployment relation).
Steps
Read the graph on the site —
/systems/<name>shows what a system depends on and what depends on it, each edge typed and (where declared) deep-linked to the target's docs. The interactive view and the stack show the whole shape.Compute the blast radius of a change with the CLI:
node bin/atlas.mjs impact --repo ontos --symbol VIt reports which members and edges a change touches across the constellation.
Verify cross-repo doc links resolve:
node bin/atlas.mjs crosslinks docs .
Notes
- The substance systems form a single vertical stack the dependency graph alone can't derive — see the architecture for why ontos sits at the floor and arche at the top.
designandatlasare orthogonal infrastructure: every system reads them, but they sit under the stack, not in it.