Carousel · 8 slides
Six lines for a per-project CLAUDE.md
Most project files are wishes. Every line in this one has to earn its place. As posted on TikTok, Instagram, and LinkedIn — the full story, one slide per card.
Six lines Claude obeys beat six hundred it skims.
Most project files are wishes. Every line in this one has to earn its place.
Six slots, one job each.
- 01Stack lock — what this is built with, and what it is not
- 02Package manager — the one allowed install command
- 03Test gate — what must pass before anything is called done
- 04Style rule — the convention that protects the design system
- 05Banned thing — the mistake you never want to see again
- 06Tone rule — how the words should read
The whole rulebook fits in one cat.
# studio-demo
- Stack: static HTML + CSS only. No frameworks,
no build step, no JavaScript.
- Package manager: pnpm only - never npm install.
- Before claiming done: open index.html in a
browser and check it renders.
- Styling: use the CSS variables in style.css.
- Banned: emojis anywhere in markup or copy.
- Tone: plain English, no marketing superlatives.If deleting a line changes nothing, it's noise.
Every line passes the same test: if I deleted it, would Claude's behavior change? Noise crowds out the lines that matter.
Same question, two answers.
Without the file: "npm is as good a choice as any — it'll just create package-lock.json."
With the file: two rule violations cited before anything runs — the pnpm mandate and the no-JavaScript stack lock — plus the compliant path instead.
Past 200 lines, adherence measurably drops.
These files are context, not configuration — Claude weighs them like a long brief. A 600-line file gets skimmed, and your critical rule sits in paragraph forty hoping to be noticed.
Write it in five minutes.
- CLAUDE.md at the project root, next to the code
- Fill the six slots — concrete enough to verify
- Trip a constraint on purpose and watch it fire
- Secrets and runbooks stay out — the file ships with the repo
- Every-time rules graduate to hooks; judgment stays here
One idea from one lesson.
Track 1 (23 lessons) is free.