Symptom

Function signatures use raw strings and numbers where domain concepts hide; the agent cannot tell from the type whether an argument is the right kind of thing.

Goal

Each domain concept has its own typed wrapper; the agent's type checker catches wrong-primitive-in-wrong-slot before runtime.

Before the refactoring

function priceFor(cents, currency) {
// ...
}

After the refactoring

class Money { /* amount + currency, with arithmetic */ }
function priceFor(money) {
// ...
}
Example source: Illustrative example written for this site, not a quotation from any source.
Pressure

The agent must inspect call-site context (variable names, surrounding code) to verify a primitive is the right kind; validation and formatting scatter.

Tradeoff

Each wrapper is a class the agent must instantiate at every entry point; for primitives without domain rules the wrapper is overhead with no return.

Relief

Wrong-primitive misuse becomes a type error the agent catches without runtime testing; behavior accretes around the concept where the agent expects to find it.

Trap

Wrapping every primitive — including ones with no domain rules — adds boilerplate the agent must navigate at every signature with no reasoning benefit.