borghei/Claude-Skills / engineering/domain-modeling
domain-modeling
VerifiedKeep a project glossary of domain terms and lightweight decision records, and catch banned synonyms in docs and code. Use when terms are used inconsistently, writing a GLOSSARY.md, or recording a design decision.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.9 KB |
| assets/GLOSSARY-template.md | markdown | 2.1 KB |
| assets/adr-template.md | markdown | 1.1 KB |
| assets/sample_GLOSSARY.md | markdown | 2.3 KB |
| assets/sample_adr_set.json | config | 3.0 KB |
| assets/sample_conversation.txt | markdown | 1.4 KB |
| assets/sample_feature_notes.md | markdown | 517 B |
| references/decision-records.md | markdown | 6.3 KB |
| references/glossary-practice.md | markdown | 7.4 KB |
| scripts/adr_lint.pyexecutable | script | 9.3 KB |
| scripts/glossary_lint.pyexecutable | script | 8.8 KB |
| scripts/term_extract.pyexecutable | script | 9.6 KB |
assets/GLOSSARY-template.md
View on GitHub# Glossary — <Context name>
<One or two sentences: which part of the business this language covers and who
uses it. Headings are the canonical terms; anything listed under Avoid should not
appear in new docs, tickets, UI copy or identifiers.>
<!--
Rules for editing this file
- One `### Term` block per concept. The heading is the word everyone should use.
- Definition: what the thing IS, in at most two sentences, in business language.
No tables, columns, classes, endpoints or flags — those change; the concept does not.
- Avoid: the synonyms people actually say, comma-separated. Each alias maps to exactly one term.
- Owner: the role that settles disputes about the meaning.
- Related: other terms in this file that a reader should look at next.
- Status: agreed | proposed | deprecated. Proposed terms are still being argued about.
- Only terms specific to this domain. Generic engineering words do not belong here.
- Group terms under `## Group` headings once there are more than about ten.
Check with: python3 scripts/glossary_lint.py --glossary GLOSSARY.md --scan docs/ src/
-->
## <Group>
### <Term>
**Definition:** <What it is, in one or two sentences.>
**Avoid:** <Synonym one>, <Synonym two>
**Owner:** <Role>
**Related:** <Other term>
**Status:** proposed
### Order
**Definition:** A Customer's confirmed request to buy one or more products at agreed prices, which can be fulfilled in several Shipments.
**Avoid:** Purchase, Basket, Transaction
**Owner:** Commerce product lead
**Related:** Customer, Shipment
**Status:** agreed
<!--
Multiple contexts: when one word means different things in different parts of the
system (a "Product" in the catalogue vs in billing), give each context its own
GLOSSARY.md next to its code, and keep a short root GLOSSARY.md that lists the
contexts, where each glossary lives, and how terms translate between them:
## Contexts
- Catalogue — src/catalogue/GLOSSARY.md — what is sold and how it is described
- Billing — src/billing/GLOSSARY.md — what is charged and when
## Translations
- Catalogue "Product" -> Billing "Plan" (one Product can be sold as several Plans)
-->
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |