| name | framework-migration-code-migrate |
| description | Migrate legacy components into Z Platform incrementally and reversibly. |
| source | {"repository":"cvsz/zeaz-platform","path":"apps/zai-factory/skills-vault/skills/framework-migration-code-migrate/SKILL.md"} |
Incremental Migration
Required sequence
- Inventory source files, dependencies, runtime ports, license, tests, and secrets.
- Define target owner, contract version, compatibility boundary, and rollback point.
- Import the smallest independently testable slice.
- Add tests before switching a caller.
- Run source and target validation.
- Switch traffic/configuration only with explicit operator approval.
- Keep a documented rollback path until stability evidence is collected.
- Remove legacy code only after the agreed retention window.
Prohibited actions
- Bulk-copying monorepo directories.
- Reusing legacy production hostnames, tokens, ports, or deployment identifiers.
- Combining code migration with production deployment.
- Removing a legacy path before target validation and rollback evidence.
Evidence record
Every migration PR updates the migration manifest with source commit, target files, validation commands, outcome, and remaining risk.