deprecation-and-migration

# Deprecation & Migration — 코드 부채 정리 + 안전한 마이그레이션 > **코드는 자산이 아니라 부채다.** 유지보수할 코드가 적을수록 팀은 빠르게 움직인다. > 삭제하지 못하는 코드는 미래의 버그이고, 마이그레이션하지 않는 레거시는 기술 부채의 이자다. ## Quick Start ``` /deprecate # 대화형 폐기/마이그레이션 계획 수립 /deprecate scan # 프로젝트 내 폐기 대상 스캔 /deprecate plan "jQuery → vanilla" # 특정 마이그레이션 계획 생성 /deprecate api v1 → v2 # API 버전 전환 계획 /deprecate audit # 기술 부채 감사 ``` **공식 호출명:** `/deprecate` (별칭: `마이그레이션`, `레거시 정리`, `코드 부채`) ## 적용 시점 | 상황 | 적용 | |------|------| | 라이브러리/프레임워크 메이저 버전 업그레이드 | O | | API 버전 폐기 (v1 → v2) | O | | 레거시 코드 단계적 제거 | O | | 언어/런타임 마이그레이션 (JS → TS, Python 2 → 3) | O | | DB 스키마 대규모 변경 | O | | 인프라 전환 (온프렘 → 클라우드) | O | | 단순 리팩토링 (이름 변경, 파일 이동) | X — 일반 리팩토링 | | 새 기능 추가 | X | --- ## CRITICAL: First Actions ### 1. Print Intro ``` Deprecation & Migration — 코드 부채 정리 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 순서: Audit → Plan → Deprecate → Migrate → Verify → Cleanup ``` ### 2. 현재 상태 스캔 ```bash # 1. @deprecated 어노테이션/주석 찾기 echo "=== @deprecated ===" grep -rn "@deprecated\|@Deprecated\|# deprecated\|// deprecated\|DEPRECATED" \ --include="*.{ts,tsx,js,jsx,py,java,go,rb,cs,kt,rs}" . 2>/dev/null | head -30 # 2. TODO/FIXME/HACK 찾기 echo "=== TODO/FIXME/HACK ===" grep -rn "TODO\|FIXME\|HACK\|XXX\|WORKAROUND" \ --include="*.{ts,tsx,js,jsx,py,java,go,rb,cs,kt,rs}" . 2>/dev/null | wc -l # 3. 오래된 의존성 확인 echo "=== Outdated Dependencies ===" npm outdated 2>/dev/null || pip list --outdat...