Notes on building software.
A personal blog of technical articles about software development.
What CLAUDE.md Is and Where It Lives
CLAUDE.md is a plain Markdown file that gives Claude Code persistent instructions about your project, loaded automatically at launch.
The CLAUDE.md Loading Hierarchy
Claude Code loads CLAUDE.md files from several locations, walking up the directory tree at launch and reading subdirectory files only when needed.
Writing a CLAUDE.md That Claude Actually Follows
A CLAUDE.md works best when it uses concrete rules over vague advice and skips anything Claude could already learn from the code.
Importing Files into CLAUDE.md with @
Use an @path reference inside CLAUDE.md to pull in another file, keeping the main memory file short while sharing detailed guidance.
Personal vs Project vs Local Memory
Claude Code has three kinds of memory file: personal for all your projects, project for the team, and local for private per-project notes.
Adding Memory on the Fly with #
Type a line starting with # during a session to save a quick note straight into your CLAUDE.md without leaving the conversation.