legacy-migration

What problem does it solve?

Migrating features from a legacy codebase to a new implementation can be risky, leading to regressions or accumulating dead code. This Skill provides a systematic workflow for safely porting features, verifying parity, and atomically removing legacy code, ensuring a clean and modern kernel.

Core Features & Use Cases

• Systematic Feature Porting: Follow a structured process to move features from src.legacy/ to the new kernel/ implementation.
• Parity Verification: Rigorously confirm that the new implementation matches the behavior of the legacy code.
• Atomic Code Removal: Safely remove old code in the same commit as feature completion, preventing dead code accumulation.
• Use Case: You've reimplemented the memory management subsystem. Use this Skill to verify its functional equivalence with the legacy version, update the FEATURE_COMPARISON.md documentation, and then confidently remove the old src.legacy/memory code in a single, atomic commit.

Quick Start

Identify features for migration

cat docs/planning/legacy-migration/FEATURE_COMPARISON.md | grep "❌"

Remove legacy files and update docs in the SAME commit

git rm src.legacy/path/to/feature.rs git add docs/planning/legacy-migration/FEATURE_COMPARISON.md git commit -m "Complete Feature X implementation and remove legacy"