CLAUDE.md Authoring

Create effective CLAUDE.md files that serve as project-specific memory for AI coding agents.

Purpose

CLAUDE.md files provide AI agents with:

• Non-obvious conventions, architectural patterns and gotchas
• Confirmed solutions to recurring issues
• Project-specific context not found in standard documentation

Not for: Obvious patterns, duplicating documentation, or generic coding advice.

Core Principles

Signal over noise: Every sentence must add non-obvious value. If an AI agent could infer it from reading the codebase, omit it.

Actionable context: Focus on "what to do" and "why it matters", not descriptions of what exists.