agentsclimarketplace

Domain glossary

Skill ovargas/virtual-team/skills/domain-glossary

Use when a consumer project has a CONTEXT.md file — defines the domain glossary convention for consistent terminology across specs, plans, and code. Pipeline commands read CONTEXT.md during context loading and use its vocabulary in generated artifacts.From its SKILL.md

Install
npx -y skills add ovargas/virtual-team --skill domain-glossary

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 14 stars14 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.4 KB, as published. Nobody here has run it

Domain Glossary Convention

What It Is

CONTEXT.md is an optional file at the repository root that defines the project's domain language. It gives the pipeline a shared vocabulary so specs, plans, and code use consistent terminology.

CONTEXT.md is optional. Commands work without it. When present, commands read it during context loading and prefer its defined terms over synonyms.

When to Create One

Create CONTEXT.md when:

  • The same concept has multiple names in specs or code ("order" vs "transaction" vs "purchase")
  • New team members (or AI) use wrong terms because the domain isn't documented
  • start offers to scaffold it during repo initialization

Format

# Domain Context

## Language

| Term | Definition | Avoid |
|------|-----------|-------|
| [Term] | [What it means in this project] | [Synonyms to avoid] |

## Relationships

- A **[Term A]** contains one or more **[Term B]**
- A **[Term B]** references exactly one **[Term C]**

## Example Dialogue

> "When a customer places an **order**, the system creates **line items**..."

## Flagged Ambiguities

- "[Term]" — currently means both X and Y. Needs splitting when [condition].

Pipeline Behavior

Commands that read CONTEXT.md:

  • feature — uses vocabulary when writing the feature spec
  • plan — references terms when naming phases, steps, and components
  • implement — uses terms in variable names, function names, comments, and commit messages; avoids synonyms listed in the "Avoid" column
  • tech-review — checks that code uses defined vocabulary consistently; flags terminology drift

Graceful Degradation

  • No CONTEXT.md → commands proceed normally, no warning
  • Empty sections → skip those sections, use what's populated
  • Ambiguities listed → flag them in generated artifacts when the ambiguous term appears

Related

  • ADR-002 defines this convention: docs/decisions/2026-04-29-domain-glossary-convention.md
  • start scaffolds CONTEXT.md when the user opts in during repo initialization
  • The /virtual-team:grill command maintains CONTEXT.md inline during grilling sessions

Keep looking

Skills are one crate of 611,178. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.