CLAUDE.md and Rules Authoring

Create effective CLAUDE.md files and .claude/rules/ rule files that serve as project-specific memory for AI coding agents.

Purpose

CLAUDE.md files and rule 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
• Path-scoped instructions that only load when relevant files are touched

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.
• Solve real friction, not theoretical concerns: Add to CLAUDE.md based on actual problems encountered, not hypothetical scenarios. If you repeatedly explain the same thing to Claude, document it. If you haven't hit the problem yet, don't pre-emptively solve it.