IntelligenceIntelligence

Your AI is busy. Know what it's up to.

A rules file for Claude on your project.

About 10 minutes ยท A project folder and Claude Code, or any assistant that can write files

Ten minutes that makes every later session safer. Claude reads the file at the start of each session and follows it, so the rules you'd otherwise repeat get written down once.

Tell your agent about this URL

Paste this into Claude, or any AI assistant that can read web pages. It explains the skill to you, checks it, and asks before installing anything.

Message for your assistant
Install the skill at https://intelligenceintelligence.io/skills/rules-file.md. First:
1. Read https://intelligenceintelligence.io/skills/rules-file/ and check the file says the same thing, without saving anything into my project. If it doesn't match, stop and tell me.
2. Tell me in a few lines what the skill does and what will happen, and give me the file's address so I can read it myself.
3. Wait for my go-ahead.
Install the file as it is, rather than writing your own version. If you can't install skills, follow the file directly instead. Afterwards, ask whether I want this explanation again next time I install a skill from intelligenceintelligence.io, and remember my answer.

The skill file is https://intelligenceintelligence.io/skills/rules-file.md. Read it before you run it, if you like: it's the same as this page.

What this does

Claude Code reads a file called CLAUDE.md at the start of every session in a project. Whatever it says, Claude treats as standing instructions. Most people starting out don't have one, so Claude has to guess how careful to be.

This skill writes one with you. It looks at your project, asks a few questions, and drafts a short file in plain words. Nothing is written until you've read it and said yes.

How to undo it

Delete CLAUDE.md. Nothing else is changed.

When this stops being a small job

If your project is several folders or repositories, or it runs a live shop or handles customer data, the rules need more thought than ten minutes. Ask for help.

Instructions for the assistant

You are helping someone who is fairly new to working with AI on their own project. Be plain, be brief, and don't change anything until they agree.

1. Look before touching anything

Look at the project folder. Work out what it is, how it's built, how it runs, where it's likely hosted, and whether it uses git. Check whether a CLAUDE.md or AGENTS.md already exists.

Don't edit or create any files in this step. Tell the person what you found in three or four plain sentences.

2. Ask a few questions

Ask these, as one numbered list, and wait for the answers:

  1. Is this project live anywhere? If so, where?
  2. How do changes get from here to the live version, if they do?
  3. Is there a copy for testing, separate from the live one?
  4. Is there anything you must never touch or delete?
  5. How do you like changes explained: one line each, or more detail?

3. Draft the file

Write a draft CLAUDE.md of no more than 40 lines, in plain words the person can read. It has two parts.

About this project, from steps 1 and 2: what it is, where it runs, how changes go live, and anything that must never be touched.

House rules, adapted to what you learned:

Leave out any rule that doesn't fit. For example, drop the test-copy rule if they've said there will never be one, and note that instead.

4. Show it, then write it

Show the whole draft and ask whether to save it. Only write the file after a yes.

If a CLAUDE.md already exists, don't replace it. Show the lines you'd add and where, and add only those.

If they use other AI tools as well, offer to save the same rules as AGENTS.md, which many other tools read.

5. Check it worked

Read the saved file back and confirm it's in the project's top folder. Tell the person that Claude Code picks it up at the start of the next session, and that they can edit it any time in a text editor.

If the project is published by uploading the whole folder, tell them the file will go up too and be readable by anyone at /CLAUDE.md on their site. It holds nothing secret, but they may want to leave it out of the upload.

Finish with one line: what the file is called, where it is, and how to undo it.