ubiquitous-language

Extract a DDD glossary from conversations and write UBIQUITOUS_LANGUAGE.md.

12|Updated Dec 25, 2024
One-click install
npx skills add https://github.com/whyte25/reusables --skill ubiquitous-language-whyte25
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ubiquitous-language
Source: https://github.com/whyte25/reusables/tree/main/.agents/skills/ubiquitous-language
Command: npx skills add https://github.com/whyte25/reusables --skill ubiquitous-language-whyte25

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of inconsistent or ambiguous domain terminology by extracting domain concepts from the conversation and consolidating them into a single, canonical glossary.

Core Features & Use Cases

  • Glossary extraction: Pulls domain-relevant nouns and concepts from the conversation and formalizes them as a usable glossary.
  • Ambiguity detection: Flags overloaded terms and recommends canonical choices while listing aliases to avoid.
  • DDD-aligned output: Produces definitions, grouped sections, clear relationships with cardinality, and a short dev ↔ domain expert dialogue example for context.

Quick Start

Ask it to define the team’s ubiquitous language for your domain by reviewing the current conversation and writing the results to UBIQUITOUS_LANGUAGE.md, including flagged ambiguities and an example dialogue.

Frequently Asked Questions about ubiquitous-language

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a DDD ubiquitous language glossary from a conversation?

A ubiquitous language glossary resolves inconsistent domain terminology by extracting domain concepts from your conversation and consolidating them into a single canonical reference with definitions, aliases to avoid, and flagged ambiguities.

What is the best way to resolve ambiguous domain terminology during domain modeling?

Resolving ambiguous domain terminology involves flagging overloaded terms, recommending canonical choices, and listing aliases to avoid. This hardens your domain model by ensuring developers and domain experts share a single, consistent vocabulary.

How does a ubiquitous language glossary handle overloaded terms and aliases?

A ubiquitous language glossary handles overloaded terms by explicitly flagging ambiguous usages, recommending a single canonical definition, and listing alternative terms as aliases to avoid, ensuring domain model consistency.

Do I need an existing domain model to extract a ubiquitous language glossary?

You do not need an existing domain model to extract a ubiquitous language glossary. The tool pulls domain-relevant nouns and concepts directly from your current conversation to formalize the terminology as a usable glossary.

What format does the ubiquitous language glossary output use for documenting domain relationships?

The ubiquitous language glossary outputs a UBIQUITOUS_LANGUAGE.md file containing canonical definitions, grouped sections, clear relationships with cardinality, and a short developer and domain expert dialogue example for context.