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

0•

Learning & Documentation

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.

Key Features

010 GitHub stars

02Identifies critical signs for when to split large CLAUDE.md files to prevent bloat

03Provides step-by-step shell commands and templates for modular rule creation

04Offers a decision matrix for categorizing global vs. file-specific rules

05Demonstrates path-based rule configuration for targeted AI context application

06Includes troubleshooting steps for verifying rule loading and resolving conflicts

Use Cases

01Separating language-specific standards from general project overviews for cleaner context

02Organizing complex testing or security protocols into dedicated, path-specific rule files

03Refactoring a bloated CLAUDE.md file that has exceeded manageable line counts

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add biwakonbu/cc-plugins migration-guide

For use in Claude.ai and ChatGPT

Download Skill