vd-done-is-executed

Installation
SKILL.md

Done Means Executed — Not Inspected

The failure this prevents: asserting something is finished based on reading the code that would run, or on a related path that does run, instead of running the real thing. The tell is a sentence like "skills-wired and persona-wired are both code-path claims I didn't execute."

The rule

A completion word — done, fixed, passing, working, wired, complete, verified — is a claim that you ran the actual Done criterion and saw the expected result. If you didn't run it, you may not use the word. Say what you actually did instead.

These are NOT done:

  • Code-path verified — you read the code and it should do X. (You traced it; you didn't run it.)
  • Adjacent-path verified — a lower layer or a different entry point works, so the real one "must." (See [[vd-plumbing-vs-behavior]].)
  • Compiles / types pass / builds — it's runnable, not proven correct.
  • Looks right — the strongest signal that you should run it. (See [[vd-run-the-real-path]].)

The loop (run on every completion claim)

Installs
1
First Seen
Jul 13, 2026
vd-done-is-executed — jpoindexter/vd-skills