Burak Reis

My CLAUDE.md is mostly a list of what I don't want

Working with Claude, the thing that helped me most was writing down in CLAUDE.md what I don't want, and why.

Burak Reis3 min read

The most tiring part of working with Claude was starting from zero in every new session. It doesn't know what I disliked yesterday or why I turned something down. Raising the same objections over and over, I realized something was going wrong.

Now every project folder has a file that Claude reads before it starts work. It's called CLAUDE.md. There's also a handoff note describing where the project stands so far. When a new session opens, the first thing it does is read those two.

Looking through them, one thing caught my eye: most of the rules don't start with "do." They start with "don't."

The list of things I've rejected in CLAUDE.md

Let me copy a few exactly as they are. In the project where I gave an album cover some motion, the list includes:

  • Don't redraw the cover photo or the people in it with generative AI. Stay true to the original image.
  • Don't imitate the Apple interface by hand. Where possible, use Apple's official Figma components.
  • Don't guess data like track names or durations.
  • Don't add annoying sound effects.

Behind each one there's a disappointment. I didn't like the hand-drawn phone interface; the spacing, the light and the button labels were all off. We dropped it and carried on from Apple's own design file. I also really didn't like what one video tool had given me before, and that tool now sits on the list under "don't use."

The folder for my shopping assistant project has similar ones. Product information is never made up; whatever the brand's site says, that's it. Anywhere a real brand appears, there's a concept note. The text in the videos is in whatever language the screen is in, and there are no decorative dots.

Taste can't be described, they say

People say taste can't be put into words. It's an "I'll know it when I see it" kind of thing. But looking at these files, I saw that my taste is mostly made of the things I reject. Describing what I want is hard. Saying what I don't want, and why, is easy.

And that's exactly what Claude is good at. It's weak at guessing and very good at following rules. When I say "make it more elegant," it doesn't know what to do. When I say "don't use middle dots, because they look artificial to me," it never uses them again.

One more example. That project's first film was 14 seconds long, and watching it, even I couldn't tell what was going on. It became a rule: the interface plays at real speed, only one thing changes per screen, and text stays on screen for three or four seconds.

The decisions are mine

These files are, in a way, my taste in written form. They get a little longer with every correction I make.

But I decide which rules go in. When Claude suggests something, adding sound effects to a video, say, saying "no" is my job too.