9개월 걸릴 시스템 이관을 하룻밤 만에: 레거시 코드를 AI의 학습 자료로 바꾸다

문제 상황

• 종료 예정인 2.0 시스템의 어댑터 코드를 3.0으로 이관해야 하는 상황
• 2.0과 3.0의 구조, 상태머신, 에러 처리 방식이 달라 단순 복사 이관이 불가
• 9개 연동사별 API 스펙과 비즈니스 로직을 새 아키텍처에 맞게 재설계해야 하는 부담

구조와 흐름

• 수년간 검증된 레거시 코드를 SOT로 삼아 연동사별 스펙, 특수 규칙, 암묵적 로직을 마크다운으로 추출
• 추출 문서만으로 구현 가능 여부를 확인하는 체크리스트를 작성
• AI가 코드 생성과 테스트-수정 루프를 반복하고, 사람은 빈틈과 예외 처리 보완

주의할 점

• AI에게 모호한 종료 조건을 주면 테스트 수정 같은 잘못된 최적화 발생
• E2E 올패스보다 API Integration 테스트처럼 정밀한 완료 기준이 필요
• 무엇을 정상, 무시, 절대 무시 불가로 볼지 가이드에 명확히 구분 필요

적용해볼 점

• 레거시 코드에서 문서화되지 않은 지식 추출용 가이드와 체크리스트를 별도 자산으로 정리
• AI 생성 결과를 검증하는 반복 테스트 루프를 자동화 흐름에 포함
• 일회성 이관 경험을 재사용 가능한 스킬로 분해해 이후 연동사 추가에 활용