원문: @TechHyung (2026-10-14) · README: anthropics/claude-plugins-official/plugins/code-modernization (2026-11-18
gh api로 확인)
핵심 요지
게시자는 “레거시 코드를 최신 코드로 바꿔 줄 뿐 아니라 제대로 동작하는지까지 검증해 주는” 앤트로픽 플러그인이라고 소개했다. README 기준으로 결과물은 네 가지다. 코드가 무엇이고 무엇을 하는지에 대한 이해, 사람이 승인하는 계획, 현대화된 코드, 그리고 새 코드가 옛 코드처럼 동작한다는 증명이다. 언어 제한이 없고 버전 업, 다른 기술로 재작성, 새 아키텍처로 재구축을 모두 다룬다.
설치: /plugin install code-modernization@claude-plugins-official. 시작은 /code-modernization:modernize. 레거시 소스는 고치지 않고 analysis/<name>/과 modernized/에만 쓰며, 진행 상황은 REPORT.html 한 페이지에 모인다.
단계
| 단계 | 명령 | 결과 |
|---|---|---|
| 0 | modernize | 의도를 INTENT.md에 기록 |
| 1 | modernize-preflight | 사람만 답할 질문 5개, 빌드 가능 여부 확인 |
| 2 | modernize-assess | 인벤토리·복잡도·부채·보안, 권장 패턴 |
| 3 | modernize-map | 의존성·데이터 흐름·진입점 대화형 지도 |
| 4 | modernize-extract-rules | 업무 규칙을 file:line 인용 Given/When/Then 카드로, 두 번째 에이전트가 재확인 |
| 4b | modernize-review | 사람이 이상한 규칙을 확인·수정 |
| 5 | modernize-brief | 단계별 계획. 승인 전에는 아무것도 빌드하지 않음 |
| 6 | uplift / transform / reimagine | 같은 기술 버전 업 / 모듈 단위 재작성 / 새 아키텍처 재구축 |
| 7 | modernize-verify | 독립 재검증, 모듈별 판정 |
| 8 | modernize-harden | 레거시 보안 스캔과 사람이 적용하는 패치 |
사람이 결정하는 지점은 여섯 곳이다: preflight 답, 규칙 검토, 계획 승인, 차이 수용, 증명 서명, 보안 패치 적용.
증명 방식
모델의 의견이 아니라 스크립트가 확인할 수 있는 근거로 판정한다. 가능하면 새 세션에서 돌린다.
- 빌드 결과를 지우고 테스트 전체를 다시 돌린다. 테스트가 하나도 안 돌았거나 건너뛰면 실패다.
- 옛 코드와 새 코드를 같은 입력으로 돌려 바이트 단위로 비교한다. 타임스탬프 같은 가변 필드만 마스킹하고 목록을 남긴다.
- 경계·빈 값·거대 입력·잘못된 레코드 등 새 입력을 10개 이상 만들어 다시 비교한다.
- 일부러 한 줄을 깨뜨려 테스트가 빨개지는지 확인한다(canary).
- 중요(P0) 규칙마다 실제로 실행·통과한 테스트가 있어야 한다.
판정은 scripts/proof_pack.py가 계산하는 PROVEN / PARTLY PROVEN / NOT PROVEN이다. 옛 시스템을 실행할 수 없으면(메인프레임 등) 최대 PARTLY PROVEN이다.
시험 사례 (README)
- AWS CardDemo(COBOL→Java 21): 규칙 35개, 월 이자 작업 재작성. 독립 검증을 다섯 번 돌릴 때마다 테스트가 놓친 차이를 찾아냈고, 마지막에 잘못된 레코드 입력에서 차이 7개가 나와 NOT PROVEN.
- Eclipse Jetty(Java 8→17):
jetty-util테스트 946개가 두 버전에서 같은 결과. 코드 읽기로는 예측 못 한 변화 6개를 실제 빌드로 발견. - osCommerce(PHP→Python·FastAPI): 상품 페이지 슬라이스, 비교 케이스 17,727개 동일, PROVEN.
- 주석·README·
CLAUDE.md에 지시문을 심은 함정 코드베이스에서도 심은 지시를 따르지 않았다.
무거운 단계(extract-rules)는 에이전트를 50~200개 띄우므로 사용량이 크다. 전체가 아니라 모듈 하나로 파일럿을 권한다.
관련
- 같은 주제의 Anthropic 준비 가이드: 2026-09-26-claude-ai-driven-code-modernization
- Claude Code 스킬·플러그인 목록: moc-claude-code