What should I never include in my CLAUDE.md?

Avoid including sensitive secrets like API keys, temporary notes, redundant change logs, or overly verbose implementation details that waste token memory.

What is the purpose of a CLAUDE.md file?

CLAUDE.md is a markdown file placed in the project root that Claude Code automatically reads to understand the project's purpose, tech stack, commands, and rules.

How long should my CLAUDE.md file be?

The recommended size is under 300 lines. For larger projects, specific implementation patterns and rules should be moved to a dedicated /rules directory to maintain efficiency.

Can I use multiple CLAUDE.md files in one project?

Yes, you can place CLAUDE.md files in subdirectories like /src or /tests to define localized rules that only apply to those specific scopes.

Claude MD Guide

Name: Claude MD Guide
Author: biwakonbu

bybiwakonbu

Learning & Documentation

Provides expert guidance and best practices for structuring CLAUDE.md files to optimize project context for Claude Code.

About

The Claude MD Guide skill helps developers craft the perfect CLAUDE.md file to serve as a high-efficiency memory and instruction set for Claude Code. It provides standardized templates for project overviews, technical stacks, development commands, and coding conventions, ensuring the AI assistant has immediate access to essential project metadata. By offering specific advice on file size limits and modularization strategies, such as when to migrate rules to subdirectories, this skill prevents token bloat and improves the accuracy of Claude's responses within any development environment.

Key Features

Explains hierarchical CLAUDE.md configuration for nested subdirectories
Provides standardized CLAUDE.md templates for different project scales
Offers size optimization recommendations to prevent memory overload
Guides on modularizing detailed rules into a dedicated rules/ directory
Outlines essential project metadata requirements like tech stacks and commands
0 GitHub stars

Use Cases

Standardizing documentation and coding conventions for AI-assisted team workflows
Refactoring a large, messy project configuration into a clean CLAUDE.md structure
Setting up a new project for optimal interaction with Claude Code

About

Key Features

Explains hierarchical CLAUDE.md configuration for nested subdirectories
Provides standardized CLAUDE.md templates for different project scales
Offers size optimization recommendations to prevent memory overload
Guides on modularizing detailed rules into a dedicated rules/ directory
Outlines essential project metadata requirements like tech stacks and commands
0 GitHub stars

Use Cases

Standardizing documentation and coding conventions for AI-assisted team workflows
Refactoring a large, messy project configuration into a clean CLAUDE.md structure
Setting up a new project for optimal interaction with Claude Code