principle-explain-the-number

Installation
SKILL.md

Explain the number

A measured number is a claim about what was measured, and it is only as good as the account of what bounds it. A speedup made of cache hits, or a one-time load landing on whichever arm ran first, passes every check and means nothing.

When: a claim rests on a measured number: a benchmark, a speedup, a latency, a size, a pass rate, or a count of runs.

  • Name what bounds the number (the CPU, the disk, the network, a lock, the harness itself), and show it with a measurement, not a guess.
  • Rule out what else it could be measuring: a warm cache, a one-time load or compile, the order the arms ran in, a repeated input, background load. When order can matter, run the arms interleaved or in both orders.
  • Measure both sides the same way: the same input, machine, build mode, and settings.
  • Keep the run count, the spread, and the setup with the number. A difference smaller than the spread is no difference.
  • Report the number with its unit, its run count, its spread, and what bounds it.

Where it stops: verify decides when a claim needs evidence; this principle decides what evidence a number needs. What to measure, and the target, belong to the plan of the work that measures it.

Installs
3
Repository
pwguler/skills
GitHub Stars
10
First Seen
4 days ago