authoring-claude-md

A CLAUDE.md file acts as project-specific memory for AI coding agents by documenting non-obvious conventions, architectural patterns, and design decisions not evident from code inspection. It ensures future AI interactions remain contextually relevant and efficient.

To create a CLAUDE.md file, document your project's unique architectural choices, coding standards, and recurring issues. Focus on providing actionable context with high signal over noise, while excluding generic advice and temporary notes.

Project memory should include non-obvious conventions, architectural patterns, design decisions, and recurring issues that solve real friction. Exclude generic advice and temporary notes to maintain actionable context and signal over noise.

Update your CLAUDE.md file when new architectural patterns emerge, design decisions change, or recurring issues occur. Contextual enhancement ensures AI coding agents maintain access to relevant project-specific conventions and non-obvious context.

CLAUDE.md works with both new and existing codebases. For existing projects, you can add architectural patterns, design decisions, and project-specific conventions to ensure AI interactions are contextually relevant and efficient.

The best way to document coding conventions for AI agents is creating a CLAUDE.md file focusing on signal over noise. Document non-obvious conventions and design decisions that solve real friction, excluding generic advice and temporary notes.