레거시 코드 AI 분석, AI는 차이를 나누고 확인은 다른 방법이 맡았다

운영 서버와 소스가 달랐을 때 AI에게 맡긴 일은 분류였다

더블테이크 노아 - 3분 분량 - 처음 쓴 날

DOUBLETAKE직무별 AI 활용법

레거시 코드를 AI로 분석하려면

레거시 코드에서 AI는 무엇을 바꿀지 결정하지 않았다. 올리브영의 한 개발자는 운영 서버와 형상관리 소스가 어긋난 시스템을 정리하며 AI에게 차이를 위험도별로 나누게 했고, 맞는지는 교차 검증으로 확인했다. LY 개발자들은 그보다 앞서 데이터 유출부터 막아야 한다고 적었다.

레거시에서 AI를 쓰기 전에 먼저 할 일은?

데이터가 밖으로 나가지 않게 막는 일이다. LY 한창구 님은 레거시 프로젝트를 AI 중심으로 바꾸는 로드맵의 첫 단계를 이렇게 썼다. "AI 도입의 첫 단추는 데이터 유출 리스크를 원천 차단하고 신뢰할 수 있는 가이드라인을 확보하는 것입니다."[2]

코드를 그대로 AI에 붙여 넣기 전에 무엇을 넣어도 되는지부터 정하라는 뜻으로 읽힌다. 오래된 시스템은 코드 어디에 무엇이 섞여 있는지 아는 사람이 적다는 점에서 더 그렇다. 이 부분은 편집팀 해석이다.

같은 글은 바뀌지 않는 것도 짚었다. "기술이 아무리 발전하더라도 요구 사항을 정의하고 검증하는 인간의 프로세스는 변하지 않으며" 라고 적었다[2].

운영 서버와 소스가 다르면 AI에게 무엇을 시키나?

올리브영 사례는 세 번을 시도했다[1].

  • 1차

    한 일
    전부 덮어쓰기
  • 2차

    한 일
    디컴파일러를 JAD에서 CFR로 교체
  • 3차

    한 일
    AI로 소스 차이를 상, 중, 하로 분류하고 교차 검증

2차에서 깨진 것은 도구를 믿은 마음이었다. 글쓴이는 이렇게 적었다. "사실 처음에는 어떤 디컴파일러를 쓰든 같은 결과가 나온다고 착각했습니다."[1] 그리고 방향을 바꿨다. "디컴파일러마다 같은 바이트코드에서 서로 다른 소스를 만든다는 것을 확인하고, 디컴파일러 간 비교 검토에 들어갔습니다."[1]

AI가 맡은 일은 3차의 분류였다. 소스 차이를 위험한 것과 덜 위험한 것으로 나누는 일이다. 맞는지는 AI 혼자 정하지 않고 교차 검증으로 확인했다. 변경 결정이 아니라 분류를 맡긴 점이 이 사례에서 가져올 부분이다.

코드에 묻힌 정책은 어떻게 꺼내나?

LY 윤석범 님은 코드에서 정책을 뽑아 문서로 만드는 구조를 만들었다. "코드에서 비즈니스 정책을 추출해 지식 문서로 정리하고, 코드가 바뀌면 문서도 따라 최신화되는 구조입니다."[3]

이 구조는 문서가 아니라 코드를 기준으로 삼는다. 문서는 손을 놓으면 멈추지만 코드는 지금 돌아가는 동작 그대로다. 문서가 오래전에 멈춘 레거시라면 이쪽이 출발점이 될 수 있다.

레거시 분석을 맡게 되면 무엇부터 하나?

위 기록을 바탕으로 한 편집팀 제안이다.

  1. 1AI에 넣어도 되는 코드와 데이터의 범위를 먼저 정한다
  2. 2AI에게는 고치라고 하지 말고 차이와 위험을 나누라고 시킨다
  3. 3나눈 결과는 결정적 방법 (다른 도구의 결과, 테스트, 실제 실행) 으로 확인한다
  4. 4확인이 끝난 정책은 문서로 남기되 코드가 바뀌면 같이 바뀌게 묶는다

AI가 나눈 결과를 그대로 믿지 않고 확인하는 감각, 백엔드 문항으로 확인해 보자

백엔드 4분 테스트 하기

자주 묻는 질문

레거시 코드를 AI에게 통째로 넘겨 리팩터링해도 되나?
이번 기록 속 팀은 그렇게 하지 않았다. 올리브영 사례에서 AI는 차이를 분류했고 확인은 교차 검증이 맡았다. 그 전에 두 번의 시도가 있었다.
디컴파일러 결과는 믿어도 되나?
올리브영 글쓴이도 처음에는 어느 디컴파일러나 같은 결과를 낸다고 생각했다가 틀렸다. 하나만 보지 말고 둘 이상을 견준다.
레거시 문서가 없으면 어떻게 하나?
LY 사례처럼 코드에서 정책을 뽑아 문서를 만들고, 코드가 바뀔 때 문서도 다시 만들게 하는 방법이 있다.

출처

  1. 1Java 디컴파일러로 운영 서버와 형상관리 소스의 불일치를 해소하다 올리브영 테크블로그, 2026.09.30
  2. 2레거시 프로젝트에서 AI 드리븐 프로젝트로 전환, AX 로드맵 LY Tech Blog, 2026.06.10
  3. 3LLM Wiki: 코드 기준으로 자동 최신화되는 도메인 지식 SSOT 만들기 LY Tech Blog, 2026.08.28

이 글은 더블테이크 노아가 누구나 열어 볼 수 있는 공개 자료만 근거로 썼어요. 초안은 AI 도구로 쓰고, 사람이 출처와 맞춰 보며 고쳤어요. 틀린 내용은 hello@dropdown.xyz로 알려 주세요. 확인하고 고친 날을 글에 남겨요. 편집 원칙 보기