msgstack
001Schemas

One shape
per kind of spec.

A schema defines which assertion types a spec expects and how they are retrieved. Engineering Spec is the default and covers most services; Service Catalog, Policy Shield and Incident Record handle the ownership, compliance and operational facts that agents get wrong most expensively.

engineering_specACTIVE

Engineering Spec

Engineering

Capabilities, interface contracts, constraints, version policy, deprecations. The default shape for a service or component — and what keeps a copilot from inventing a rate limit.

service_catalogACTIVE

Service Catalog

Platform

Dependencies, owners, SLAs, config defaults. Which services exist, who is accountable for each, and what breaks when one changes.

policy_shieldACTIVE

Policy Shield

Security

Security posture, compliance assertions, approved responses. Retrieved verbatim as Tier 1 assertions — never paraphrased toward.

002The default — Engineering Spec

Typed facts, not prose.

Every Engineering Spec domain is scored 0–100 against the specification. The completeness score drives the missing-sections view and AI-fill prompts — a spec that scores low tells its owner exactly what truth is still undocumented.

Upload a positioning doc, deck, or PDF and the ingestion pipeline extracts, structures, and indexes it against this schema — flagging conflicts with existing graph before anything commits.

The graph model
SCHEMA — engineering_specSCORED 0–100
SummaryREQUIRED2–3 sentence overview of the domain's product or service
Target AudienceREQUIREDTarget buyer and user roles
PositioningREQUIREDCore statement of what the domain targets and why it matters
TaglineREQUIRED≤7 word punchy headline
DifferentiationREQUIREDKey differentiators
AssertionsREQUIREDMin 8 — headlines, benefits, use cases, SLAs, objections
AudiencesREQUIREDMin 1 — buyer/user audiences with triggers and objections
Brand PersonalityOPTIONALTone, voice, word choices
Graph PillarsOPTIONALStrategic theme groupings for entries
Know Your MarketOPTIONALResearch pre-section — vision, before/after, competition
003The full registry

Where the graph layer goes next.

Each type maps to a dynamic schema in v1.0+. Statuses below are honest — this registry mirrors the product spec, not a wishlist.

TypeStatus
engineering_specACTIVE
engineering_specPLANNED · v1.0
policy_shieldPLANNED · v1.0
brand_guideBACKLOG
competitive_briefBACKLOG
corp_narrativeBACKLOG
persona_libraryBACKLOG