TL;DR — CLAUDE.md is powerful, but most people fill it with vague preferences that Claude acknowledges and then ignores. The instructions that stick are specific, verifiable, and binary — not stylistic. This post shows the difference, with examples.

The CLAUDE.md that got ignored

My first CLAUDE.md had 30 lines. Things like:

- Write clean, readable code.

- Keep functions small and focused.