Skip to content
01 / 73Principles5 min readUpdated Oct 2, 2026

The Algorithm

Apply to any non-trivial change before designing it. Make the requirement less dumb, delete, optimize, accelerate, automate, in that order, then run it again on the result. The reply names the requirement you questioned and what you deleted.

Dylan GatteyDylan GatteyAuthor
Directory
Install this skill
$ npx skills add dhanji4U/skills --skill the-algorithm --global

Then type /the-algorithm in your coding agent.

Five steps, in order, for any change bigger than an edit you can see at a glance. The order is the principle. Each step is cheap only after the one before it, and the common failure is doing a late step on something an early step would have removed. Adapted from Elon Musk’s five-step engineering process.

  1. Make the requirements less dumb. Assume the requirement is wrong and make it less wrong. It comes from a person, not a department. “The ticket”, “the linter”, “the reviewer”, or “the old code did it” is a source, not a reason; find the person and their reasoning. If you do not agree with the reasoning, do not accept the requirement, however smart the person who gave it, the human included. No is a valid outcome.
  2. Delete the part or process step. Try hardest to delete the part, flag, layer, retry, or step entirely before touching step 3. Optimizing something that should not exist is the biggest mistake smart people make. If you never add anything back, you did not delete enough. Leaf: pstack principle-subtract-before-you-add.
  3. Optimize what survived. Third step, not first. Have one part do many things instead of a parallel copy per caller. Look hardest at boundaries between owners and layers, where a wrapper wraps a wrapper. Leaves: pstack principle-laziness-protocol, principle-minimize-reader-load.
  4. Accelerate. Be the part: walk one change through edit, build, check, and review yourself and note where you wait, crawl, or bounce. Tighten that. Leaf: pstack principle-sequence-verifiable-units.
  5. Automate last, or you automate something that should not exist. Volume alone does not justify it; precision and reviewability do. pstack principle-build-the-lever still applies. It runs on what survived.

Run it again. This is not a one-time gate. Rerun it on the result before you ship; the second pass deletes more.

The tell. A citation of this principle names the requirement you made less dumb, who owned it, and what you deleted. A citation with neither means you skipped it.

Part of the open-source dhanji4U/skills repository.Directory →