msgstack
001The graph model

A system of record for
what you're allowed to say.

The graph is not a wiki and not a brand book. It is structured, machine-readable truth: domains owned by departments, filled with atomic entries, each carrying a lifecycle state, a generation contract, and a named accountable owner.

A figure on an observatory terrace beneath a faint constellation, one star glowing emberTHE RECORD
PLATE IVTruth, kept where agents can find it.
002Anatomy of a assertion

Atomic, by design.

One claim per entry. Each carries its section type, priority, lifecycle status, content tier, owner, and change history — small enough to govern, precise enough to cite.

👤SME Owner🛡️Spec🔒Rule: TLS 1.3📊Fact: API Limit📄Dev Spec🤖Support Bot
Graph Owner
003Content tiers — the generation contract

Status says ready. Tier says how.

The tier is a per-entry contract defining how much latitude an LLM has — and it decides the retrieval path. Tier 1 never touches vector approximation: graph traversal only, reproduced verbatim, validated after generation.

Tier 1
Locked · Verbatim
GRAPH TRAVERSAL ONLY

Returned and used exactly as written. No paraphrasing, no approximation. A paraphrase is a hard conflict.

Tier 2
Structured · Guided
HYBRID RETRIEVAL

Substance and positioning preserved; phrasing adapts to the channel and audience.

Tier 3
Grounded · Flexible
VECTOR RETRIEVAL

Direction and tone consistent with the graph; full phrasing latitude for the model.

004Sub-canons — canons within canons

Global truth, local latitude.

Divisions and product lines nest under parent canons with one of four inheritance relationships — resolved at read time, so a regional team's grounding is always the correct blend of corporate standard and local override.

I

Full Inheritance

Child inherits every parent element, no overrides. The regional site says exactly what HQ says.

II

Selective Override

Child inherits all, but may override specific entries — local pricing, local SLAs.

III

Autonomy with Vocabulary Constraints

Child writes its own graph but must conform to the parent's controlled vocabulary — banned terms stay banned.

IV

Complete Autonomy

Fully independent — zero inheritance, zero constraints. A subsidiary with its own brand.

005The vocabulary

Spec

A governed container for facts about one service, policy scope, or component. Ingested OpenAPI files and READMEs are source documents that fill a spec — not specs themselves.

Assertion

One atomic fact, typed: a constraint, SLA, deprecation, config default, interface contract, decision. Carries status, tier, and an owner.

Entity

A concept assertions refer to — a service, endpoint, component. Entities are workspace-scoped, not spec-scoped, which is what lets a traversal leave one spec and arrive in another.

Edge

A typed, directed relationship: DEPENDS_ON, INFORMS, SUPERSEDES, CONTRADICTS, OWNS, IMPLEMENTS, MENTIONS. Carries confidence and provenance.

Traversal

Breadth-first k-hop expansion from seed assertions, walking edges in both directions with per-relationship weight decay. Returns the path that reached each result.

Fusion

Reciprocal rank fusion of vector recall with graph expansion seeded from its top hits. A fact found by both routes outranks one found by either alone.

Propagation

DEPENDS_ON and INFORMS cascade staleness. Change an assertion and everything downstream is marked outdated, transitively, across specs. The other relationships are navigational.

Content Tier

How much latitude an LLM has with an assertion. Tier 1 is reproduced verbatim and validated after generation; Tier 2 preserves substance; Tier 3 preserves direction.

Provenance

The trace from any generated output back to the exact assertions and source documents that grounded it.