A value tells you WHAT. A $description tells the next pilot WHY - and why saves hours.
The golden rule: never restate the value. "$description": "Blue" on a blue token is noise. Record intent, constraints, where it belongs.
Two tokens here are silent. `color.danger` and `space.touch-target` each need a $description that explains its purpose or rule.
Write at least a dozen characters of real meaning on each. Documentation is a gift to your future self.