Glossary

CLAUDE.md

CLAUDE.md is the instruction file that Claude Code reads before acting. It exists at two levels: a project file at the repository root, and a user-level file at ~/.claude/CLAUDE.md that applies everywhere and belongs to no repository.

Why it multiplies

Each clone and worktree carries its own project copy. The user-level file sits outside version control entirely — it is where rules go when nobody wants to argue about them in review, and it is invisible to CI.

Measured

A scan of one working machine found 18 versions of the same CLAUDE.md, with no reliable way to say which was current. That is instruction drift in its most common form.

Related

This entry is part of the untactit glossary. Definitions draw on measured write-ups published on the blog.

All terms

Stop guessing what your agents are running.

Connect one workspace and see every skill, rule, and memory your team has in play — in about ten minutes.

Start free Talk to us

No credit card. Works with what you already run.