Artful Simplicity

Audit code, tests, and prose for artful simplicity; use for readability, design, refactoring, over-engineering, and redundancy reviews.

transparent-pegasus Updated

File contents

Artful simplicity

A unit is simple when a cold reader can name its one idea, predict its contents from its name, and keep nothing unrelated in mind. Tests state observable behavior and invariants; prose spends exactly the words it needs.

Local reading judges clarity, not necessity. Rewrite may follow from sight only if no observer sees behavior change; delete, fold, and move require, respectively, proof of reachability and consequence, equivalence across observable states and transitions, and independent agreement on the boundary. Seek contradictions, not volume.

Before changing behavior, name the change, the observer, the safety direction, and the broken alternative. Direction decides, not size.

transparent-pegasus/artful-simplicity/tree/main/skills/artful-simplicity commit 8c1366c3fe

Frequently asked questions

npx skillmds@latest add transparent-pegasus/artful-simplicity