From c78141b91b198642cc5db3cc12a5ad6c353d1533 Mon Sep 17 00:00:00 2001 From: DavidQ Date: Mon, 22 Jun 2026 11:56:47 -0400 Subject: [PATCH] PR_26172_OWNER_036-legacy-migration-policy --- docs_build/dev/ProjectInstructions/README.txt | 1 + .../addendums/legacy-migration-policy.md | 33 +++++++++++++++++++ 2 files changed, 34 insertions(+) create mode 100644 project-instructions/addendums/legacy-migration-policy.md diff --git a/docs_build/dev/ProjectInstructions/README.txt b/docs_build/dev/ProjectInstructions/README.txt index 1276f0695..54e708e9c 100644 --- a/docs_build/dev/ProjectInstructions/README.txt +++ b/docs_build/dev/ProjectInstructions/README.txt @@ -44,3 +44,4 @@ READ THIS FIRST Addendum index: - Canonical Repository Structure: project-instructions/addendums/canonical-repository-structure.md - Test Structure Standardization: project-instructions/addendums/test-structure-standardization.md +- Legacy Migration Policy: project-instructions/addendums/legacy-migration-policy.md diff --git a/project-instructions/addendums/legacy-migration-policy.md b/project-instructions/addendums/legacy-migration-policy.md new file mode 100644 index 000000000..5e43679f4 --- /dev/null +++ b/project-instructions/addendums/legacy-migration-policy.md @@ -0,0 +1,33 @@ +# Legacy Migration Policy + +## Purpose + +Reduce technical debt incrementally during normal development. + +## Migration Trigger + +Migration review is required when any of these actions touch legacy files: + +- File modified +- File renamed +- Bug fix +- Enhancement +- Test modification + +## Migration Process + +1. Review JS location. +2. Review CSS location. +3. Review test location. +4. Move touched files into canonical structure. +5. Update imports. +6. Update tests. +7. Remove legacy references. + +## Rules + +- Legacy files may only be deleted when no active references remain. +- Temporary bridge code must contain `TEMPORARY_MIGRATION` and a removal plan. +- No new scattered JS locations. +- No new scattered CSS locations. +- No new scattered test locations.