Skip to main content

Domain glossary standard

One canonical, versioned ubiquitous-language glossary per product, stored in-repo and injected into every prompt — so agents never invent plausible-but-wrong domain terms.

Why it exists​

An agent asked about a "carrier" will confidently produce something; whether it's right depends on whether our meaning is in front of it. In insurance the traps are everywhere: insurer vs carrier, claim vs loss, MTA vs endorsement, broker vs agent. A shared glossary is the cheapest defence against subtle, confident domain errors.

The rules​

  • One glossary per product, versioned in-repo alongside the domain brief.
  • Every domain term used in a PFD or spec resolves here — no orphan terms (the Definition of Ready gate checks this).
  • Injected into agent context — the glossary is loaded into every domain-touching agent session, so the ubiquitous language is used verbatim.
  • Owned by SMEs, maintained as the language evolves.

Standards referenced: DDD ubiquitous language.