CLAUDE.md
ELI5 — The Vibe Check
CLAUDE.md is a special file you put in your project to give Claude Code persistent instructions — your project's personality file. Stack preferences, coding conventions, deployment rules, things to never do — it's all in there. Think of it as onboarding documentation, but for your AI assistant. The better your CLAUDE.md, the better your AI partner.
Real Talk
CLAUDE.md is a project configuration file for Claude Code that provides persistent instructions, coding conventions, and project context. It's read automatically at the start of each session, serving as a system prompt for the coding assistant. It typically includes tech stack details, coding standards, deployment procedures, and project-specific rules.
Show Me The Code
# CLAUDE.md
## Stack
- Next.js 14 with App Router
- TypeScript strict mode
- Tailwind CSS + shadcn/ui
## Rules
- Always use server components by default
- Never use `any` type
- Run `npm test` before committing
When You'll Hear This
"Update the CLAUDE.md with our new API patterns." / "Claude follows the CLAUDE.md instructions — it knows to use our custom hooks."
Related Terms
Claude Code
Claude Code is like having a senior developer living inside your terminal.
Cursor Rules
Cursor Rules (formerly .cursorrules) are instructions you put in your project to tell Cursor IDE how to behave — like a CLAUDE.md but for Cursor.
Developer Experience
Developer Experience is everything about how pleasant or miserable it is to work with a piece of software as a developer.
Documentation
Documentation is written explanation of how your code works and why.