Skip to content

Commit 77f04e4

Browse files
authored
PR_26172_OWNER_036-legacy-migration-policy
Merge PR_26172_OWNER_036-legacy-migration-policy
2 parents cabfde6 + c78141b commit 77f04e4

2 files changed

Lines changed: 34 additions & 0 deletions

File tree

docs_build/dev/ProjectInstructions/README.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,3 +44,4 @@ READ THIS FIRST
4444
Addendum 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
Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
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.

0 commit comments

Comments
 (0)