Skip to content

borghei/Claude-Skills / engineering/domain-modeling

domain-modeling

Verified

Keep 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.

FileKindSize
SKILL.mdskill md13.9 KB
assets/GLOSSARY-template.mdmarkdown2.1 KB
assets/adr-template.mdmarkdown1.1 KB
assets/sample_GLOSSARY.mdmarkdown2.3 KB
assets/sample_adr_set.jsonconfig3.0 KB
assets/sample_conversation.txtmarkdown1.4 KB
assets/sample_feature_notes.mdmarkdown517 B
references/decision-records.mdmarkdown6.3 KB
references/glossary-practice.mdmarkdown7.4 KB
scripts/adr_lint.pyexecutablescript9.3 KB
scripts/glossary_lint.pyexecutablescript8.8 KB
scripts/term_extract.pyexecutablescript9.6 KB

assets/sample_adr_set.json

View on GitHub
{
  "description": "Decision records for the subscription billing context. Deliberately flawed: 0002 is superseded by a record that does not exist, 0005 claims to supersede 0002, 0003 is missing, 0004 is used twice, one 0004 has an invalid status, a non-ISO date and no Decision section.",
  "files": {
    "0001-bill-in-arrears-per-subscription.md": "# 0001. Invoice each Subscription in arrears, one Invoice per billing period\n\n**Status:** accepted\n**Date:** 2026-03-02\n**Deciders:** Billing product lead, Payments engineering\n\n## Context\nCustomers with several Subscriptions asked for one combined Invoice. Combining them\nties unrelated renewal dates together and makes proration across Plans ambiguous.\n\n## Decision\nWe will issue one Invoice per Subscription per billing period, after the period ends.\nCombined statements, if wanted later, are a read-only summary, not an Invoice.\n\n## Alternatives considered\n- One combined Invoice per Customer per month: rejected, forces aligned renewal dates.\n- Invoicing in advance: rejected, refunds on Cancellation become routine.\n\n## Consequences\nCustomers with many Subscriptions receive many Invoices. Proration stays local to one Subscription.\n",
    "0002-retry-failed-charges-nightly.md": "# 0002. Retry failed Charges in a nightly batch\n\n**Status:** superseded by 0006\n**Date:** 2026-04-11\n\n## Context\nFailed Charges were retried immediately, which hit gateway rate limits.\n\n## Decision\nWe will retry failed Charges once per night for three nights.\n\n## Consequences\nRecovery takes up to three days.\n",
    "0004-pause-shifts-renewal-date.md": "# 0004. A pause shifts the renewal date\n\n**Status:** done\n**Date:** 14/05/2026\n\n## Context\nCustomers want to pause instead of cancel. Finance does not want zero-value Invoices.\n\n## Discussion\nPause could produce zero Invoices, or shift the renewal date. Most people preferred shifting.\n",
    "0004-grace-period-before-suspension.md": "# 0004. Seven-day grace period before suspension\n\n**Status:** proposed\n**Date:** 2026-05-20\n\n## Context\nA single failed Charge currently suspends access immediately.\n\n## Decision\nAccess continues for a seven-day grace period after a failed Charge.\n\n## Consequences\nSome unpaid usage is written off.\n",
    "0005-use-the-word-subscription-everywhere.md": "# 0005. Rename membership to Subscription in code, docs and support macros\n\n**Status:** accepted\n**Supersedes:** 0002\n**Date:** 2026-06-01\n\n## Context\nSupport, sales and code used membership, contract and subscription for the same concept,\nand two incidents came from a membership flag that meant something narrower.\n\n## Decision\nWe use Subscription as the only name. Identifiers are renamed as files are touched;\nsupport macros are renamed in one batch.\n\n## Options considered\n- Keep membership in support only: rejected, tickets are copied into engineering issues verbatim.\n\n## Consequences\nA long tail of identifiers keeps the old name until the files are next edited.\n"
  }
}
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: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall