CLAUDE.md should stay short, with about 40 lines as a practical upper limit, containing only what the agent would get wrong if not told, and the writing principle is to be as accurate as possible rather than as complete as possible.