From Writing a good CLAUDE.md | HumanLayer Blog

Key takeaways:

  1. Defines your project’s WHYWHAT, and HOW
  2. Be concise and universally applicable
  3. Less (instructions) is more
    1. < 100 instructions
    2. < 300 lines
  4. Use Progressive Disclosure: @ and skills
  5. Claude is not a linter. Use linters and code formatters, and use other features like Hooks and Slash Commands as necessary.
  6. CLAUDE.md is the highest leverage point of the harness