{"name":"model-domain-and-glossary-prompt","description":"A prompt that sharpens the words your project uses - the AI challenges vague or clashing terms, tests them with edge-case scenarios, checks the code agrees, and records agreed terms in a GLOSSARY.md and big decisions as short ADRs. Use when names in the code are confusing, one thing has several names (customer, user, account), or you want a glossary.","category":"coding-prompts","tags":["architecture","docs","spec"],"models":["any"],"proven":false,"passing_families":0,"model_testing":"Not yet model-tested; testing Jan 2027","url":"https://theskillvault.ai/skills/model-domain-and-glossary-prompt","api_url":"https://theskillvault.ai/api/skills/model-domain-and-glossary-prompt","raw_url":"https://theskillvault.ai/api/skills/model-domain-and-glossary-prompt/raw","body":"# Model the domain and glossary (prompt)\n\nWhen \"account\" means a customer in one file and a login in another, bugs follow. This prompt pins down the words and writes them down.\n\n## When to use\n- Code names and the words people use do not match.\n- A feature discussion keeps going in circles over what a term means.\n- You want a GLOSSARY.md or a record of key decisions (ADRs).\n\n## Steps\n1. Open the project in your AI tool.\n2. Paste the prompt below and name the area in {{AREA}}.\n3. Answer the questions and scenarios it raises.\n4. Review GLOSSARY.md and any ADRs before committing.\n\n## Prompt\n```text\nHelp me sharpen the domain language for {{AREA}} in this project.\n\n1. Read GLOSSARY.md if it exists, and the code for this area.\n2. List terms that are vague, overloaded or used differently in code and conversation. For each, propose one precise term and say what it is not.\n3. Test each term with one or two concrete edge-case scenarios (\"an order is half shipped and the customer cancels - what is cancelled?\").\n4. Point out anywhere the code contradicts what I say.\n5. As each term is agreed, add it to GLOSSARY.md as:\n   **Term** - one-sentence definition. Not to be confused with: X. Example: ...\n   Keep implementation details out of the glossary.\n6. Only for decisions that are hard to reverse and were a real trade-off, suggest a short ADR in docs/adr/NNNN-title.md (context, decision, consequences). Ask before writing it.\n\nAsk one question at a time.\n```\n\n## How to adapt\n- Big codebase with separate areas? Ask for one GLOSSARY.md per area.\n- Just need names for a new feature? Skip the ADR step.\n\n## Gotchas\n- Glossaries rot when nobody updates them. Link GLOSSARY.md from AGENTS.md or the README.\n- Do not paste confidential business details you would not want in the repo.\n\n## Portability\nWorks with any language, any chat AI or coding agent. No tool lock-in.\n\n## Done when\n- Confusing terms have one agreed meaning in GLOSSARY.md.\n- Code contradictions are listed or fixed.\n- Any hard-to-reverse decision has a short ADR.\n\n## Example prompt\n\"Our code uses customer, user and account interchangeably. Help me model the domain and write a glossary.\"\n\n---\nAdapted from \"domain-modeling\" in mattpocock/skills (MIT, Copyright (c) 2026 Matt Pocock). See LICENSE.txt.","files":["LICENSE.txt"],"license":"MIT","license_name":"MIT License","license_url":"https://opensource.org/license/mit","attribution":"Based on work by Matt Pocock (mattpocock/skills, domain-modeling) (Copyright (c) 2026 Matt Pocock, MIT License), https://github.com/mattpocock/skills/tree/a496f5513d4a4cf889bc48e189e579f4b0bdf6aa/skills/engineering/domain-modeling; adapted by TheSkillVault, https://theskillvault.ai","install":{"claude_code":"curl -fsSL --create-dirs 'https://theskillvault.ai/api/skills/model-domain-and-glossary-prompt/raw' -o ~/'.claude/skills/model-domain-and-glossary-prompt/SKILL.md' && curl -fsSL --create-dirs 'https://theskillvault.ai/api/skills/model-domain-and-glossary-prompt/files/LICENSE.txt' -o ~/'.claude/skills/model-domain-and-glossary-prompt/LICENSE.txt'","cursor":"curl -fsSL --create-dirs 'https://theskillvault.ai/api/skills/model-domain-and-glossary-prompt/raw' -o '.cursor/skills/model-domain-and-glossary-prompt/SKILL.md' && curl -fsSL --create-dirs 'https://theskillvault.ai/api/skills/model-domain-and-glossary-prompt/files/LICENSE.txt' -o '.cursor/skills/model-domain-and-glossary-prompt/LICENSE.txt'","agents":"curl -fsSL --create-dirs 'https://theskillvault.ai/api/skills/model-domain-and-glossary-prompt/raw' -o '.agents/skills/model-domain-and-glossary-prompt/SKILL.md' && curl -fsSL --create-dirs 'https://theskillvault.ai/api/skills/model-domain-and-glossary-prompt/files/LICENSE.txt' -o '.agents/skills/model-domain-and-glossary-prompt/LICENSE.txt'","mcp_url":"https://theskillvault.ai/mcp","cursor_mcp_deeplink":"cursor://anysphere.cursor-deeplink/mcp/install?name=theskillvault&config=eyJ1cmwiOiJodHRwczovL3RoZXNraWxsdmF1bHQuYWkvbWNwIn0%3D","mcp_config":{"mcpServers":{"theskillvault":{"url":"https://theskillvault.ai/mcp"}}}},"bundles":[],"tested_on":[{"family":"chatgpt","name":"ChatGPT","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"claude","name":"Claude","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"gemini","name":"Gemini","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"grok","name":"Grok","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"llama","name":"Llama","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"deepseek","name":"DeepSeek","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"mistral","name":"Mistral","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"qwen","name":"Qwen","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"kimi","name":"Kimi K","outcome":null,"date":null,"source":null,"counts":false,"stale":false}],"proven_rule":{"threshold":5,"window_days":365,"computed_at":"2026-11-02T03:20:33.817Z"}}