PRINCIPLE // COMPLETENESS // HONESTY

Declared Variants Over Silent Substitution

A smaller tool may be correct. Pretending it is the same tool is not.

active principleeditorial
principlexkl:principle:declared-variantsrepresentation: html
Recommended Cognitive Lensrelease engineerpackage maintainersystems architect

The rule

A constrained environment may legitimately choose a smaller implementation. A production environment may legitimately choose a different implementation. The invariant is disclosure: material capability differences must be visible to the operator and machine-readable where practical.

CODE
IF capability differs materially:
    declare variant
    declare missing capability
    declare compatibility boundary
ELSE:
    do not manufacture distinction

Why XERXES cares

FOUNDER LENS // EDITORIAL

The problem is not minimalism. The problem is hidden diminution. If a system makes a tradeoff, the operator deserves to know the tradeoff exists.

This principle generalizes beyond editors or packages to model fallbacks, API subsets, security modes, generated artifacts, database adapters, and deployment targets.