reorganize

Migrate flat memory files into a domain/category/file.md hierarchy.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/VinhHung1999/memory-system-plugin --skill reorganize
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reorganize
Source: https://github.com/VinhHung1999/memory-system-plugin/tree/main/plugins/memory-system/skills/reorganize
Command: npx skills add https://github.com/VinhHung1999/memory-system-plugin --skill reorganize

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrate flat memory files into a two-level hierarchy (domain/category/file.md) to improve organization, searchability, and long-term maintainability of memory insights.

Core Features & Use Cases

  • Scans ~/.claude/memory/ for domains with flat files and migrates them into the five subcategories: bugs, patterns, decisions, procedures, and structure.
  • Preserves content and history where possible, supports per-domain scoping, and offers a dry-run option for safe planning.

Quick Start

Move flat memory files under ~/.claude/memory/ into the new domain/category/file.md structure with a safe, git-aware migration.

Frequently Asked Questions about reorganize

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate flat memory files into a structured hierarchy?

Migrating flat memory files into a structured hierarchy involves transforming files under ~/.claude/memory/ into a two-level domain/category/file.md structure. This process organizes memory insights into specific subcategories like bugs, patterns, decisions, procedures, and structure.

Can I preview memory reorganization before applying changes?

Yes, you can preview memory reorganization before applying changes. The process supports a dry-run option, allowing you to safely plan the migration from flat files into the domain/category/file.md structure and review changes before they are executed.

Does the memory migration preserve git history?

Yes, the memory migration preserves git history. It uses a git-mv-based migration approach to move flat files into the structured domain/category hierarchy, ensuring that file history is maintained while improving organization and searchability.

What is the best way to organize flat Claude memory files?

The best way to organize flat Claude memory files is to migrate them into a two-level hierarchy with five subcategories: bugs, patterns, decisions, procedures, and structure. This improves organization, searchability, and long-term maintainability of memory insights.

Can I scope the memory migration to a specific domain?

Yes, you can scope the memory migration to a specific domain. The process offers optional per-domain scoping, allowing you to target and reorganize individual flat memory domains rather than migrating the entire ~/.claude/memory/ directory at once.