Loading lesson…
CLAUDE.md is how you tell Claude Code what your project values, what your team's conventions are, and what it should never do. It is the single highest-leverage config you write.
Claude Code reads CLAUDE.md at the start of every session. Whatever you put there becomes part of the system prompt for the rest of that session. It is project-scoped (lives in your repo), version-controlled (commit it), and shared with anyone using Claude Code on your codebase.
# Project: Acme Reporting API
Next.js 15 (App Router) + Postgres + Drizzle.
## Stack
- Node 20, pnpm, TypeScript strict.
- Tests: Vitest. Lint: Biome.
## Conventions
- Server logic in `src/server/*`. Components in `src/app/`.
- One feature per folder. No cross-imports between feature folders.
- Public env vars start with `NEXT_PUBLIC_`.
## Rules
- Never edit anything under `src/generated/`.
- Always run `pnpm lint && pnpm test` before commit.
- Use Drizzle migrations for schema changes — never raw SQL.
- Pause and ask before running any `db:reset` or destructive script.
## Domain language
- A 'report' is a user-defined query saved with a schedule.
- An 'audit row' is the immutable record produced by a report run.A starter CLAUDE.md. Keep it short, list rules, name your domain.The big idea: CLAUDE.md is the team contract for the agent. Keep it short, keep it shared, and back the load-bearing rules with real tooling.
15 questions · take it digitally for instant feedback at tendril.neural-forge.io/learn/quiz/end-claude-code-claude-md-creators
What is the core idea behind "The CLAUDE.md File: Project Persona And Rules"?
Which term best describes a foundational idea in "The CLAUDE.md File: Project Persona And Rules"?
A learner studying The CLAUDE.md File: Project Persona And Rules would need to understand which concept?
Which of these is directly relevant to The CLAUDE.md File: Project Persona And Rules?
Which of the following is a key point about The CLAUDE.md File: Project Persona And Rules?
Which of these does NOT belong in a discussion of The CLAUDE.md File: Project Persona And Rules?
Which statement is accurate regarding The CLAUDE.md File: Project Persona And Rules?
Which of these does NOT belong in a discussion of The CLAUDE.md File: Project Persona And Rules?
What is the key insight about "Smaller is better" in the context of The CLAUDE.md File: Project Persona And Rules?
What is the key insight about "It still hallucinates conventions" in the context of The CLAUDE.md File: Project Persona And Rules?
What is the key insight about "From the community" in the context of The CLAUDE.md File: Project Persona And Rules?
Which statement accurately describes an aspect of The CLAUDE.md File: Project Persona And Rules?
What does working with The CLAUDE.md File: Project Persona And Rules typically involve?
Which best describes the scope of "The CLAUDE.md File: Project Persona And Rules"?
Which section heading best belongs in a lesson about The CLAUDE.md File: Project Persona And Rules?