◉CLAUDE LABJP
●2.1.296 — Subagents can set their own autoCompactWindow, and an env var pins the model used by workflow agents●HAIKU 5.5 — Since 2.1.293 (Oct 7), claude-haiku-5-5 is the default Haiku model on the Anthropic API●SONNET 4.5 — Retires on the Claude API on 11/30, 47 days left. Migrate to Sonnet 5.5●Q&A — A write-up shows three places to look when a Mod draws nothing and reports no error●AGENTS.MD — One write-up explains how to split the entry points when Codex and Claude Code share a folder: AGENTS.md and CLAUDE.md●NEW — Approval prompts for "cd, git add, commit" every time: not a missing setting, but how it works●2.1.296 — Subagents can set their own autoCompactWindow, and an env var pins the model used by workflow agents●HAIKU 5.5 — Since 2.1.293 (Oct 7), claude-haiku-5-5 is the default Haiku model on the Anthropic API●SONNET 4.5 — Retires on the Claude API on 11/30, 47 days left. Migrate to Sonnet 5.5●Q&A — A write-up shows three places to look when a Mod draws nothing and reports no error●AGENTS.MD — One write-up explains how to split the entry points when Codex and Claude Code share a folder: AGENTS.md and CLAUDE.md●NEW — Approval prompts for "cd, git add, commit" every time: not a missing setting, but how it works
Articles/Cowork
◈ Cowork/2026-10-14Beginner

I Put a Ten-Line Promise File at the Top of the Folder I Gave Cowork

I kept retyping the same cautions every time I asked Cowork for help. One CLAUDE.md file at the top of the folder settled it. Here are the three things worth writing, how to check it is being read, and how to cut it back when it grows.

Cowork45CLAUDE.md4Connected foldersNon-engineersTutorial

One morning I opened Cowork to tidy the store assets for a wallpaper app, and my hands stopped over the request box. "Don't touch the original images." "Put exports only in the _out folder." "Start file names with the date." I had typed nearly the same three lines last week, and the week before.

On the day I forgot, it went exactly as you'd expect. Exported images ended up sitting right beside the originals.

So I tried placing one short text file named CLAUDE.md at the top of the folder. In short, about ten lines were enough. Here is how I made it and how I check that it works.

CLAUDE.md stands in for the preamble you retype

When a working folder contains a CLAUDE.md, Cowork and Claude Code read it as standing instructions. In my setup, what I wrote in the file became the starting context of the conversation as soon as I selected the folder.

That means the preamble you used to type with each request can live with the folder instead. It is not a hard setting. It is a plain text file.

Placing it doesn't make everything work, though. That part comes next.

Write only three things

At first I got greedy. I listed some twenty items — the folder's history, my preferred tone, prohibitions — and the results were poor. The longer the file, the more the one line that mattered got buried.

Now I keep to three.

ItemWhat to writeExample in my folder
Do not touchPlaces that are read-onlyContents of originals are read-only
Where output goesWhere new files may be createdExports go only in _out
NamingHow file names and dates are writtenStart with a date, like 20261014_

All three are about place and shape rather than prohibition. A where-and-how rule was easier to reread later than a list of don'ts.

The file I actually placed

I created CLAUDE.md directly under the folder with this content.

# Promises for this folder
 
- The originals folder is read-only. Do not edit, delete, or move its contents.
- Put newly created files only in the _out folder.
- Start file names with the date, like "20261014_topic.ext".
- If you are unsure, stop and ask me.

Four lines. The last one is an escape hatch for situations the file doesn't cover. I can't list everything that is allowed, but "stop when unsure" fits in one line.

Check that it is read by asking

Placing the file doesn't tell you whether it works. At the start of a new conversation I ask:

Summarize this folder's promises in three lines, as far as you understand them.

If the three lines match what I wrote, it is working. If not, I suspect the file name or the level where I put it. Once I named it claude.md in lowercase and it wasn't read. It has to be CLAUDE.md, capitals included.

To go one step further, I make a request that would break a promise — "turn the images in originals into black and white." If it declines or asks me to confirm, the promise is in effect. Do this only in a duplicated test folder, and avoid trying it on real assets.

When it grows, halve it

After a few weeks the promises keep multiplying. I think the load of reading them grows with them, and so does the chance of misreading.

Once at the start of each month I reread the file and ask of each line, "Would I really be stuck without this?" The ones where the answer is no, I delete. I wrote about trimming always-loaded instructions in The Night I Halved the Instructions I Load Every Time: Three Drawers Before Any Cutting. For the order in which to grant folder permissions, see Write Access Came Third: The Order I Hand Folders to Cowork.

Keep secrets out of the promise file

One last line to draw. CLAUDE.md is read into conversations again and again. Don't put passwords, API keys, or customers' personal details in it. Even when you're tempted to write "this key may be used," leaving it out is safer.

Write only places and shapes in the promise file — never keys or names.

The next time you hand over a folder, start by creating a four-line CLAUDE.md and asking for a three-line summary. That alone should remove one morning of forgetting the preamble.

Share

Thank You for Reading

Claude Lab is ad-free, supported entirely by members like you. We publish practical guides daily with implementation code, benchmarks, and production-ready patterns. If you've found it useful, we'd love to have you on board.

  • ✦Copy-paste ready implementation code
  • ✦New advanced guides published daily
  • ✦$5/mo or $10 for lifetime access
View Membership →

If you found this article helpful, a small tip ($1.50) would mean a lot to us. Your support helps keep this site ad-free and covers server and hosting costs.

Related Articles

◈ Cowork2026-09-23
Write Access Came Third: The Order I Hand Folders to Cowork
When I connect a folder to Cowork I open it in three steps: read-only, a place where new files may appear, then write access. Here is the line I drew with a client's asset folder, and the three things I settle before connecting.
◈ Cowork2026-10-11
I Stopped Making Cowork Read My Whole Troubleshooting Notes — Pulling One Section by Number Cut 105 KB to 1.5 KB
A record of turning a 105 KB file of web-ops troubleshooting notes into something you query by number. My first extraction script could reach only 30 of 120 numbers, and #70 came back as zero bytes. The fixed awk, a zero-byte check, and measured section sizes are all here.
◈ Cowork2026-10-08
The Night I Halved the Instructions I Load Every Time: Three Drawers Before Any Cutting
The longer an instruction file grows, the more rules slip through. Here is how I sorted what gets loaded every time into keep, move, and delete, plus a small script that measures each heading.