Domain Vocabulary Modeling
Create a traceable proposed language model for the domain.
Workflow
- Name the scope, intended users, and authoritative evidence sources.
- Extract terms as they are actually used. Preserve conflicting definitions and overloaded words.
- For each concept, record
Term,Proposed definition,Evidence,Examples,Non-examples,Relationships,Invariants,Authority, andStatus. - Separate business concepts from storage names, API fields, UI labels, implementation classes, and vendor terminology.
- Identify synonyms, homonyms, missing concepts, ambiguous boundaries, and terms whose meaning changes by context.
- Test the model against representative scenarios and existing interfaces. Record contradictions rather than silently choosing a definition.
- Mark every entry as observed, proposed, ratified, rejected, or unresolved. Name the decision owner for ratification when known.
Boundaries
- Do not rename code, schemas, or public interfaces without separate implementation authority.
- Do not declare a proposed definition canonical from repetition alone.
- Keep private product language in its owning repository or private overlay.
Output
Return the vocabulary table, relationship notes, contradictions, ratification needs, and migration implications.