File tree Expand file tree Collapse file tree
docs_build/dev/ProjectInstructions
project-instructions/addendums Expand file tree Collapse file tree Original file line number Diff line number Diff line change @@ -44,3 +44,4 @@ READ THIS FIRST
4444Addendum index:
4545- Canonical Repository Structure: project-instructions/addendums/canonical-repository-structure.md
4646- Test Structure Standardization: project-instructions/addendums/test-structure-standardization.md
47+ - Legacy Migration Policy: project-instructions/addendums/legacy-migration-policy.md
Original file line number Diff line number Diff line change 1+ # Legacy Migration Policy
2+
3+ ## Purpose
4+
5+ Reduce technical debt incrementally during normal development.
6+
7+ ## Migration Trigger
8+
9+ Migration review is required when any of these actions touch legacy files:
10+
11+ - File modified
12+ - File renamed
13+ - Bug fix
14+ - Enhancement
15+ - Test modification
16+
17+ ## Migration Process
18+
19+ 1 . Review JS location.
20+ 2 . Review CSS location.
21+ 3 . Review test location.
22+ 4 . Move touched files into canonical structure.
23+ 5 . Update imports.
24+ 6 . Update tests.
25+ 7 . Remove legacy references.
26+
27+ ## Rules
28+
29+ - Legacy files may only be deleted when no active references remain.
30+ - Temporary bridge code must contain ` TEMPORARY_MIGRATION ` and a removal plan.
31+ - No new scattered JS locations.
32+ - No new scattered CSS locations.
33+ - No new scattered test locations.
You can’t perform that action at this time.
0 commit comments