Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs_build/dev/ProjectInstructions/README.txt
Original file line number Diff line number Diff line change
Expand Up @@ -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
33 changes: 33 additions & 0 deletions project-instructions/addendums/legacy-migration-policy.md
Original file line number Diff line number Diff line change
@@ -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.
Loading