Stop Repeating Yourself to Claude Code: Write One Rules Page

Stop Repeating Yourself to Claude Code: Write One Rules Page

Hi there.
Do you explain the same things to Claude Code at the start of every new chat?
I'm not a developer, so I write my project rules once and let Claude read them every time.
Here is how I use one rules file in the project folder.
This is for anyone tired of repeating the same setup talk.

An AI helper reading one rules page before starting work

What the rules file is

If a file named CLAUDE.md sits at the top of your project folder, Claude Code reads it when it starts.
It is a plain text file you can write in Notepad.
Anything you put there you do not have to explain again in a new chat.

What I put in mine

My file has five parts.

  1. Who I am: a non-developer who needs plain-language explanations
  2. What the project is: one or two short paragraphs
  3. Do and don't: publish outside only after my approval, never type passwords in chat
  4. Folder layout: which file lives where
  5. What "done" means: how to check that the work is finished

Tips for writing it

  • Short and clear beats long. Too long and the important rules get buried.
  • Instead of "do a good job," write something checkable, like "run this command and finish only when you see success."
  • When a rule changes, edit the file right away. An old rule left in place gets followed.
  • Never write passwords, keys or tokens in it.

How you know it worked

Open a new chat and ask, "Summarize this project's rules." If your own words come back, it worked.

If it doesn't work

  • If the rules seem ignored, check that the file is named exactly CLAUDE.md and sits in the top project folder.
  • Claude sometimes reads a rule and still breaks it. Do not rely on the file alone for important rules; add a real block, such as an approval screen.

One-line summary

A rules file is a handover note for your AI. Write it well once and you save the explaining time every day.

What is the first rule you would give your AI?
Tell me in the comments.

Related posts:

Thanks for reading.

Comments

Popular posts from this blog

Claude Code on Windows for Non-Developers: 6 Snags I Hit and How I Got Past Them

Day One With an AI Agent Team: 6 Things That Broke (and the Fixes)

Updating 20 Live Blogger Posts at Once Without Changing a Single URL