Auditing the component API

A component library is read far more often than it is written, and almost always through autocomplete. Two things drift as it grows: the order props are declared in, and the shape of the sentences describing them. Neither breaks a build. Both are felt every time someone types <.

This is an occasional sweep, not a rule to enforce on every change.

Run it

node .agents/skills/lumos-audit-props/audit-props.mjs

Reports and exits non-zero when it finds something; it never rewrites a file. Every fix is a judgement about wording or intent, and belongs to a person.

What it checks