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.