gz-ontology
Use to sweep the governance shape, trace a node's lineage, diff against the last sweep, or read its blast radius.
SKILL.md.claude/skills/gz-ontology/SKILL.md
GitHubgz ontology
Overview
Wield the gz ontology read-only sonar (ADR-0.32.0) to image the actual shape
of governance lineage instead of reasoning from stale or partial docs. The
ontology is a Tier-B derived projection — never authority — rebuilt from L1
canon and the L2 ledger. Every verb is read-only and never writes graph state
(Boundary Invariant #2); the only filesystem write is the regenerable
.gzkit/ontology/last_sweep.json diff-baseline cache.
Output Contract
Human-readable tables and provenance lines by default; --json for
machine-readable output (including the rebuild-fidelity self-report); --dot
for a graphviz rendering.
Workflow
Confirm the node id(s) of interest from
gz stateor the ledger.Image the whole current shape and surface STRUCTURAL seams:
uv run gz ontology sense uv run gz ontology sense --json # + rebuild-fidelity self-reportWalk one node's vertical lineage + lateral proof with edge provenance:
uv run gz ontology trace <ID>Before acting at the airlock, diff the shape versus the last sweep — the re-sense gate:
uv run gz ontology resenseRun the fast contacts-only STRUCTURAL seam check, or read a node's downstream blast-radius:
uv run gz ontology seams uv run gz ontology reach <ID>
Boundaries
senseimages STRUCTURAL coverage only and never claims semantic completeness (Boundary Invariant #3). Semantic-seam recall is deferred to RECALL / Phase-4 (L3-advisory).sense,seams, andresensealways exit 0 — the sonar never gates.traceandreachexit 1 on an unknown node id.- The ontology is a Layer-3 derived view. It never gates a
gz validatescope, gate, or closeout (state-doctrine Rule 5).
Reference
- Manpage:
gz ontology - Parent ADR:
ADR-0.32.0-gzkit-ontology