test-first-by-evidence

Installation
SKILL.md

Test First by Evidence

Core principle. A test you did not watch fail proves nothing. It might test the wrong thing, and you would never know.

  • Keep hypotheses and proof separate. Debugging may use recorded incidents and controlled experiments before a local occurrence. Implementation starts from a test that exposes the relevant defect or missing behaviour, not necessarily the whole incident.
  • The weight sits in Watch it fail. Everything else is what to do once the red is real.
  • You opened this in the middle of something. This is how to do that work, not a replacement for it. Name what you were doing before you start, and return to it when this is done.

The law

NO PRODUCTION CODE WITHOUT A TEST YOU WATCHED FAIL
  • Code written before its test is unproven, and gets re-derived from a red rather than wrapped in a test that passes immediately.
  • Make it recoverable before removing anything. Discarding work the human has not agreed to discard is not yours to do.
  • A test that passes the first time you run it is not a test yet. It describes what the code already does.
  • A test that errors is not a red. An error is a broken test; a failure is a working test with nothing to satisfy it.
Installs
28
First Seen
Aug 15, 2026
test-first-by-evidence — gabrielmoreira/skills