SS5 Data Migration

Overview

This skill provides a reliable, ordered workflow for executing the necessary data migration tasks after upgrading a Silverstripe 4 project to Silverstripe 5 (specifically for Dynamic Agency Base Site architectures). It ensures all layout, content, and settings data are properly migrated to the new schema formats.

Prerequisites

Before running these migrations, ensure:

1. The codebase is fully deployed and the dev/build has completed successfully.
2. If working locally, you have synchronized the latest production database (e.g., using ddev sync or a similar workflow).

Workspace Migration Skill Strategy

Due to project-specific differences (such as custom element types, obsolete legacy structures, or unique data schema), the exact migration tasks vary per project.

This global skill strongly recommends formalizing a Workspace-Specific Migration Skill (e.g. <project-name>-ss5-migration/SKILL.md) that documents the exact tasks to run in order for that specific site. The following workflow is an example baseline.

Migration Workflow