Writing for the agents that read your repo.

November 5, 2026

How Claude Code Uses CLAUDE.md — and How to Write a Good One

A CLAUDE.md file is the project memory Claude Code loads at the start of every session. What goes in it, what a bad file does, and how to write one an agent will actually follow.

8 min read