Skip to content
Spine Docs

Quickstart

This walks through the 30-second proof: ask → find → ship. Every line of output points at a file:line.

1. Extract the graph

Terminal window
orchestrator understand .

Spine parses your code and docs into a deterministic Provenance Knowledge Graph. The layout is seeded — the same commit produces the identical report every time.

2. Ask — what breaks if I change this?

Terminal window
orchestrator blast_radius --symbol validate
→ 7 callers reach this symbol
auth.login              app/auth.py:120
routing.POST /login     routing.py:210
docs/auth.md            MENTIONS

3. Find — what will break silently?

Terminal window
orchestrator regression validate
⚠ 4 reachable symbols have no test
get_user        models.py:70
commit          db.py:88
password_hash   models.py:20

4. Ship — under two gates

Terminal window
orchestrator sdlc feature --safe
✓ branch feature/validate-guard
  3 files · +148 −12 · 6 tests added
⏸ no push, no PR — awaiting your approval

With --safe, Spine writes nothing external: no push, no PR, no tracker update until you approve. See Governance & gates.

Next