- conforms_to::[[Contract Form Contract]]
- grafted_from::[[DeepContext.com Graph (Allen, 2026)]] ⊕
- extends_contract::[[Markdown Node Contract]]
- authored_by::[[Deep Context Community]]↗
- has_lifecycle::[[Seed Stage]]↗
- has_curation::[[Working Draft]]↗
- in_practice_domain::[[Deep Context Architecture]]↗
Gloss Form Contract
A Gloss is a node whose purpose is to define a term used elsewhere in the graph. It carries enough body to make the term usable on first encounter and carries its working definition in the filename itself, so that a contributor browsing the filesystem reads the definition without opening the file.
A Gloss is not a Reference (which points to external authoritative source material) and not a Contract (which specifies structural requirements). It is the most compact self-contained node the graph supports, but its body may grow when the term is load-bearing enough to deserve elaboration.
Requirements
Inherits Markdown Node Contract
- All requirements of [[Markdown Node Contract]] apply.
- The requirements below are additions or refinements, not overrides.
Filename pattern
Enforces [[Use Double-Hyphen Separator for Gloss Definitions]]↗.
- The filename MUST follow
<Concept> -- <one-clause definition>.md. - The separator between concept and definition MUST be
--(space, double hyphen, space). - The concept side MUST match the wikilink target other nodes use to reference this gloss.
- The definition side MUST be a single clause, no trailing period, no internal
--.
H1
- The H1 MUST be the bare concept name only, matching the concept side of the filename.
- The H1 MUST NOT repeat the definition from the filename.
Body shape
Enforces [[Require Body Elaboration Beyond Filename Definition]]↗.
- The body MAY be a single sentence, a short paragraph, or several paragraphs with H2 subsections. Typical shape is two or three paragraphs: the opening restate-and-elaborate, a paragraph giving concrete elaboration or showing the concept at work, and a paragraph distinguishing the concept from an obvious alternative.
- The first sentence MUST restate the filename definition and elaborate it by one useful clause or contrast — not a verbatim repeat. A body whose only content is the bare definition is not conforming.
- Subsection headings (H2) are permitted when a gloss carries distinct sub-angles that each want their own named section. For a compact gloss, prefer unheaded paragraphs.
- If the content grows beyond what a gloss can comfortably carry (roughly 300 words of body, or more than three sub-sections), consider whether the node wants a different form (Reference, Case Study, Pattern).
Sources section
- When the gloss draws on external sources, a
## Sourcessection MUST appear after the body and before## Relations. - Sources are listed as bulleted URLs with brief annotations. They are not typed edges; the typed edges go in
## Relations.
Relations section
- A Gloss MAY omit
## Relationswhen it has no non-trivial relational edges. - When present, relational edges follow the base Markdown Node Contract.
Identity predicate block
- The identity block above the H1 MUST include
conforms_to::[[Gloss Form Contract]].
Optional scalar metadata
- YAML frontmatter SHOULD include
tagline:— a pithy one-liner that the build pipeline surfaces on the Glosses index page row (per Markdown Node Contract). MAY includecreated:(ISO date) andbrief_summary:(a paragraph-length summary, useful when the body's restate-and-elaborate opening is short enough that an additional paragraph adds orientation). - All three are scalar metadata, not graph-structural. They support human browsing and build-time rendering.
Relations
-
extends_contract::[[Markdown Node Contract]]
- Inherits all base file-form requirements; adds the filename-carries-definition pattern, body-shape allowances, and the standard section order (body → Sources → Relations).
-
conforms_to::[[Contract Form Contract]]
- This file is itself a Contract, so it conforms to the meta-contract that specifies what Contract nodes look like.
-
grounded_in::[[Use Double-Hyphen Separator for Gloss Definitions]]↗
- Grounds the filename pattern Requirement.
-
grounded_in::[[Require Body Elaboration Beyond Filename Definition]]↗
- Grounds the body-shape rule against verbatim repetition of the filename definition.
-
contrasts_with::[[Reference Form Contract]]
- A Gloss defines a term used internally; a Reference points to external authoritative source material. Both may be short, but the purposes are distinct.
-
extended_by::[[Predicate Form Contract]]
- Predicate Form Contract extends Gloss with the Carries, Crescent, and Typing requirements that turn a Gloss-shaped definition into an edge-vocabulary specification.
-
extended_by::[[Touch Point Form Contract]]
- Touch Point Form Contract extends Gloss with reader-orientation requirements (Opening Synthesis, Entry Points, Out of Scope) and the required
frames_lens_on::edge.
- Touch Point Form Contract extends Gloss with reader-orientation requirements (Opening Synthesis, Entry Points, Out of Scope) and the required
-
contrasts_with::[[Touch Point Form Contract]]
- A Gloss defines a single term, often briefly; a Touch Point frames a reader's lens onto a region of the graph. The forms share filename and body shape; they diverge on whom the body addresses (definition reader vs region newcomer).
-
composes_with::[[in_practice_domain -- membership in a Practice Domain]]
- The Predicate that takes a Gloss naming a community of practice as object. Glosses serve dual duty as concept definitions and as Practice-Domain anchors; the predicate makes the Practice-Domain role explicit.