How to Write a CLAUDE.md: The File with 187k GitHub Stars
PawelHuryn · x · 2026-07-04
A deep dive into CLAUDE.md best practices. The author points out that since CLAUDE.md is loaded every turn, each line acts as a 'rent' paid per request. Therefore, it should focus on project-specific, hard-learned rules (like user-initiated version upgrades or three testing categories) rather than repeating default model behaviors. He emphasizes that matching existing code styles is already a default behavior for Claude Code, hardcoded into the Opus 4.8 system prompt.
More from coding & agent
- Looking for a classifier of software engineering task shapes to pick models per task — StewartalsopIII · 2026-09-11
- Steal this idea: prompt-to-hardware where agents assemble custom devices — paraschopra · 2026-09-11
- Model Is the Least Interesting Part: A Guide to Six Core AI Architectures from RAG to Multi-Agent — goyalshaliniuk · 2026-09-11
- Non-coder builds layered memory architecture: 20k tokens tracks a year of agent conversations — matteoianni · 2026-09-11
- Warp's six non-engineering teams all run on Linear and Claude Code — mon__lim · 2026-09-11
- 9-year backend dev: AI code isn't the problem, the rate of making a mess is — Sweaty-Landscape-561 · 2026-09-11