A text file named CLAUDE.md, placed at the root of a project, that Claude Code reads automatically at the start of every session. Think of it as a permanent brief.
What goes in it
# Project context
Stack: Next.js 14, Tailwind CSS, Shadcn/ui, TypeScript
Deployment: Vercel
## Conventions
- Always use the CSS custom properties defined in globals.css
- Never install a dependency without asking first
- Use existing Shadcn components before creating new ones
- Name components in PascalCase, files in kebab-case
## Design tokens
Colors: #295FEC (primary blue), #1E1E1E (text), #F8F9FB (background)
Typography: Public Sans, weight 800 for headings
Spacing: 4px base (use Tailwind classes)
What not to put in it
No secrets, no API keys. This file may end up in your GitHub repo.
Tip: create a basic CLAUDE.md for every new project from the start. Even five lines beat nothing. Claude improvises less when it has context.