skimmable

Run a skimmability pass that trims incidental changes from the diff, reduces function parameters, replaces boolean flags with discriminated unions, and flattens nested conditionals into early returns. The goal is a shorter diff a reviewer can understand in one fast pass.

Model each behaviour as an explicit variant, such as { kind: "draft" } | { kind: "published" }, instead of flags like isDraft. This prevents impossible state combinations and lets switch statements handle every variant exhaustively.

Assert once at boundaries when decoding external data, reading files, or parsing request payloads, then trust the asserted shape inside the typed core. Repeated defensive checks like if (!user) return after validation add noise without safety.

No, the pass is deliberately narrow and avoids behaviour changes unless existing code is obviously dead, redundant, or inconsistent with its types. If a simplification requires a behavioural decision, it is called out separately rather than smuggled into the diff.

Avoid splitting a readable 20-line function into many tiny one-use helpers, which hides the real logic behind indirection. Keep helpers only when they remove real duplication, encode a domain concept, or make the caller meaningfully clearer.