# Domain Vocabulary Modeling

> Build a proposed domain vocabulary from current code, documents, and stakeholder language, including concepts, definitions, relationships, invariants, authorities, examples, and contradictions. Use when inconsistent terms are causing design or communication errors; do not treat the result as ratified without owner evidence.

- Skill: `jovanipink/domain-vocabulary-modeling` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add jovanipink/domain-vocabulary-modeling`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jovanipink/domain-vocabulary-modeling/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- License: MIT
- Author: JovaniPink (https://skillmd.com/u/jovanipink)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jovanipink/domain-vocabulary-modeling

---


# Domain Vocabulary Modeling

Create a traceable proposed language model for the domain.

## Workflow

1. Name the scope, intended users, and authoritative evidence sources.
2. Extract terms as they are actually used. Preserve conflicting definitions and overloaded words.
3. For each concept, record `Term`, `Proposed definition`, `Evidence`, `Examples`, `Non-examples`, `Relationships`, `Invariants`, `Authority`, and `Status`.
4. Separate business concepts from storage names, API fields, UI labels, implementation classes, and vendor terminology.
5. Identify synonyms, homonyms, missing concepts, ambiguous boundaries, and terms whose meaning changes by context.
6. Test the model against representative scenarios and existing interfaces. Record contradictions rather than silently choosing a definition.
7. 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.