Workflows
Use CLAUDE.md well
Write a CLAUDE.md that makes every session better.
Goal
Encode your project context, conventions, and constraints so Claude always starts informed.
Outcome: A CLAUDE.md that reduces repeated context-setting and improves every session.
SetupProductivity
BasicSteps
1
Create CLAUDE.md at the repo root
Claude reads this file automatically at session start.
touch CLAUDE.md2
Add project context
Describe what the project is, what it does, and who it is for.
- ·Keep it concise — Claude reads the whole file, so every line should earn its place.
3
Add tech stack and conventions
List the stack, key libraries, and coding conventions Claude should follow.
4
Add commands and scripts
Tell Claude what commands to use for testing, building, and running the project.
- ·Example: "Run tests with: npm test. Build with: npm run build."
5
Add constraints and do-nots
Be explicit about things Claude should avoid or be careful about.
- ·Example: "Do not modify the migrations folder without asking."
6
Ask Claude to help write it
Let Claude draft the initial CLAUDE.md based on your codebase.
claude "read this repo and write a CLAUDE.md that captures the important context for future sessions"