Systematic approach for migrating patterns between directories in Storybook-based pattern libraries while maintaining cross-references and documentation integrity. Use this skill when reorganizing Storybook structure, moving patterns to new categories, refactoring documentation hierarchy, or performing bulk pattern migrations that require careful tracking of Meta titles, URLs, and cross-references.
Systematic workflow for migrating patterns between Storybook directories. Follow these five phases sequentially. See references/pattern-migration-guide.md for detailed procedures, command examples, and checklists.
.mdx, .mdx + .stories.tsx, complex directories).mdx files — record explicit titles and story referencesgit mv to preserve historyHandle simple files ( only) and complex patterns (with stories/components) per the reference guide.
.mdxStorybook URL rules: <Meta title="Category/Name" /> → ../?path=/docs/category-name--docs (spaces→hyphens, uppercase→lowercase, asterisks removed, slashes→hyphens).
npm run build-storybook — must succeednpm run typecheck — must succeed (if applicable)