ubiquitous-language

Extract domain-specific terms from conversations into a Markdown glossary.

2|Updated Jul 11, 2024
One-click install
npx skills add https://github.com/nicograef/handbook --skill ubiquitous-language-nicograef
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ubiquitous-language
Source: https://github.com/nicograef/handbook/tree/main/.claude/skills/ubiquitous-language
Command: npx skills add https://github.com/nicograef/handbook --skill ubiquitous-language-nicograef

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill resolves communication gaps and technical debt caused by inconsistent terminology, ensuring that developers and domain experts share a single, precise language.

Core Features & Use Cases

  • Glossary Generation: Automatically extracts domain-relevant terms from conversations and organizes them into a structured Markdown file.
  • Conflict Detection: Identifies and flags ambiguous terms, synonyms, and overloaded concepts that lead to implementation errors.
  • Use Case: During a complex project discovery phase, use this Skill to reconcile conflicting definitions of "Order" and "Account" to ensure the codebase reflects the actual business domain.

Quick Start

Analyze the current conversation to extract domain terms and generate a ubiquitous language glossary in the docs directory.

Frequently Asked Questions about ubiquitous-language

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

FAQPage Schema
How do I extract a domain-driven design glossary from project discussions?

To extract a domain-driven design glossary from project discussions, the Skill analyzes conversational input to identify domain-specific terminology, resolving semantic ambiguities by examining nouns and verbs to produce a canonical Markdown file.

What is a ubiquitous language glossary and when do I need one for domain modeling?

A ubiquitous language glossary is a canonical collection of domain-specific terms shared by developers and domain experts. You need one during software architecture design and domain modeling to resolve communication gaps and prevent implementation errors caused by inconsistent terminology.

How do I detect conflicting terminology and synonyms during a project discovery phase?

To detect conflicting terminology and synonyms during a project discovery phase, the Skill identifies and flags ambiguous terms, synonyms, and overloaded concepts, helping reconcile definitions of terms like "Order" and "Account" so the codebase reflects the actual business domain.

Can I generate technical documentation in Markdown format from conversational input?

Yes, you can generate technical documentation in Markdown format from conversational input. The Skill performs structured analysis of conversations to produce a canonical glossary file in Markdown format, typically outputting the result to the docs directory.

What's the best way to resolve semantic ambiguities in domain modeling terminology?

The best way to resolve semantic ambiguities in domain modeling terminology is to perform structured analysis of nouns and verbs from domain expert conversations, extracting a canonical glossary that flags overloaded concepts and enforces a single, precise language across the team.

Why does inconsistent terminology cause technical debt in software architecture design?

Inconsistent terminology causes technical debt in software architecture design because it creates communication gaps between developers and domain experts, leading to overloaded concepts and implementation errors where the codebase fails to reflect the actual business domain.