How can I check if my new rules are being recognized?

You can run the /memory command in the Claude Code terminal to see which rules are currently loaded and verify your configuration.

When should I move my rules out of CLAUDE.md?

You should consider migrating when CLAUDE.md exceeds 300 lines, specific sections grow beyond 50 lines, or when you have rules that only apply to certain file patterns.

Should I delete everything from CLAUDE.md after migrating?

No, keep high-level project overviews, technology stacks, and primary development commands in CLAUDE.md, while moving detailed implementation rules to the rules folder.

Where should the migrated rule files be stored?

Migrated rules should be placed in the .claude/rules/ directory. This structure allows Claude to automatically load context based on the files you are currently editing.

How do I apply rules only to specific files?

You can use the 'paths' property in the YAML frontmatter of your rule file (e.g., **/*.ts) to ensure those rules only load when relevant files are in context.

Memory Migration Guide

Name: Memory Migration Guide
Author: biwakonbu

bybiwakonbu

학습 및 문서화

Provides systematic guidance for migrating project rules from CLAUDE.md to modular rule files to optimize AI context and maintainability.

소개

The Memory Migration Guide is a specialized skill designed to help developers manage growing project documentation within Claude Code. It provides a structured framework for identifying when a monolithic CLAUDE.md file becomes inefficient and offers a step-by-step process for refactoring instructions into the .claude/rules/ directory. By implementing these patterns, users can reduce token overhead, prevent rule conflicts, and ensure that Claude receives the most relevant context for specific file types through path-based rule application, ultimately leading to more accurate and efficient AI interactions.

주요 기능

0 GitHub stars
Identifies critical signs for when to split large CLAUDE.md files to prevent bloat
Provides step-by-step shell commands and templates for modular rule creation
Offers a decision matrix for categorizing global vs. file-specific rules
Demonstrates path-based rule configuration for targeted AI context application
Includes troubleshooting steps for verifying rule loading and resolving conflicts

사용 사례

Separating language-specific standards from general project overviews for cleaner context
Organizing complex testing or security protocols into dedicated, path-specific rule files
Refactoring a bloated CLAUDE.md file that has exceeded manageable line counts

소개

주요 기능

0 GitHub stars
Identifies critical signs for when to split large CLAUDE.md files to prevent bloat
Provides step-by-step shell commands and templates for modular rule creation
Offers a decision matrix for categorizing global vs. file-specific rules
Demonstrates path-based rule configuration for targeted AI context application
Includes troubleshooting steps for verifying rule loading and resolving conflicts

사용 사례

Separating language-specific standards from general project overviews for cleaner context
Organizing complex testing or security protocols into dedicated, path-specific rule files
Refactoring a bloated CLAUDE.md file that has exceeded manageable line counts