Introduce Parameter Object

Removes smells

Referenced by patterns

Symptom

The agent sees the same field group appearing across multiple signatures; every site re-parses the same shape and verifies the same ordering.

Goal

The clump becomes a named value object the agent passes through as a single token; structure validation happens once at construction.

Before the refactoring

function recordTemperature(low, high, value) { /* ... */ }
function alertIfOutOfRange(low, high, reading) { /* ... */ }

After the refactoring

class NumberRange {
  constructor(low, high) { this.low = low; this.high = high; }
}
function recordTemperature(range, value)   { /* ... */ }
function alertIfOutOfRange(range, reading) { /* ... */ }

Example source: Illustrative example written for this site, not a quotation from any source.

Pressure

Adding or reordering a field touches every signature; the agent must find and update each consistently or risk silent positional drift.

Tradeoff

Constructing the object at every call adds an allocation and a name the agent must learn; if the clump appears in <3 places the wrapper is overhead.

Relief

The bundled parameter carries the values together as one typed object; the agent matches one field per name at each call site instead of N positional arguments where a mis-alignment passes the type checker.

Trap

Wrapping coincidental field groups creates fake value objects the agent must construct and destructure with no comprehension gain.