원문: @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 한 페이지에 모인다.

단계

단계명령결과
0modernize의도를 INTENT.md에 기록
1modernize-preflight사람만 답할 질문 5개, 빌드 가능 여부 확인
2modernize-assess인벤토리·복잡도·부채·보안, 권장 패턴
3modernize-map의존성·데이터 흐름·진입점 대화형 지도
4modernize-extract-rules업무 규칙을 file:line 인용 Given/When/Then 카드로, 두 번째 에이전트가 재확인
4bmodernize-review사람이 이상한 규칙을 확인·수정
5modernize-brief단계별 계획. 승인 전에는 아무것도 빌드하지 않음
6uplift / transform / reimagine같은 기술 버전 업 / 모듈 단위 재작성 / 새 아키텍처 재구축
7modernize-verify독립 재검증, 모듈별 판정
8modernize-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개 띄우므로 사용량이 크다. 전체가 아니라 모듈 하나로 파일럿을 권한다.

관련