How do I install the Ddd When To Wrap Primitives skill?

Run npx skillmds@latest add amadeus-dlc/ddd-when-to-wrap-primitives in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ddd When To Wrap Primitives safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ddd When To Wrap Primitives?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ddd When To Wrap Primitives free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ddd When To Wrap Primitives?

amadeus-dlc (@amadeus-dlc) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ddd When To Wrap Primitives by amadeus-dlc

Name: Ddd When To Wrap Primitives
Author: amadeus-dlc

Ddd When To Wrap Primitives

Use when deciding whether a primitive value should become a domain-specific type or value object. Balances primitive obsession against value-object obsession using risk, invariants, behavior, and cost. Trigger for wrapping strings/ints/UUIDs, value object decisions, too many tiny types, or whether a primitive is good enough.

amadeus-dlc d94b6a0 2 files · 2.4 KB Updated Sep 17, 2026

File contents

When To Wrap Primitives

Wrap primitives when the wrapper changes correctness, not when it only signals virtue.

Wrap When

The value has a domain name and invariant.
Two values of the same primitive type can be confused.
Validation is repeated or easy to forget.
Behavior naturally belongs with the value.
Invalid states cause meaningful business risk.

Do Not Wrap Yet When

The value has no behavior or invariant.
The wrapper would only forward primitive operations.
The type is local, temporary, or purely technical.
The team would pay high ceremony for little safety.

Workflow

List candidate primitives and their risks.
Score invariant strength, misuse risk, behavior, reuse, and migration cost.
Wrap the highest-value candidates first.
Keep construction explicit and error reporting useful.

Detailed Reference

For non-trivial implementation, review, or refactoring work, read references/details.md before giving final guidance. It contains the detailed rules, examples, smells, and migration notes that do not belong in the short invocation body.

Output

Return a wrap/keep table with rationale and example APIs for the chosen wrappers.

Frequently asked questions