레거시 코드 현대화를 위한 2단계 AI 워크플로우

r/ClaudeAI의 레딧 게시물은 단순히 AI에게 '레거시 스파게티 코드를 리팩터링해 달라'고 요청하는 것에 반대하며, AI가 기존의 결함 있는 구조를 유지하려는 경향이 있다고 지적합니다. 대신, LLM 추론을 더 효과적으로 활용하는 두 단계의 '리버스 엔지니어링' 워크플로를 제안합니다.

직접 리팩터링의 문제점

오래된 코드를 AI 에이전트에 붙여넣고 '이 코드를 리팩터링해서 깔끔하게 만들어 주세요'와 같은 요청을 하면, 결과는 종종 동일한 나쁜 아키텍처의 다듬어진 버전일 뿐입니다. AI는 제공한 코드에 편향되어 있습니다—처음부터 결함이 있더라도 여러분의 구조, 변수 이름, 논리 흐름을 유지하려고 합니다.

두 단계 '리버스 엔지니어링' 프로세스

1단계: 의도 추출하기 (The 'What')

AI에게 코드를 수정하라고 요청하지 마세요. 대신, 코드 구조를 무시하고 비즈니스 로직을 추출하도록 요청하세요. 구체적으로, 파일을 기반으로 상위 수준의 비즈니스 요구사항 문서를 작성하도록 합니다. 이를 통해 기술 부채 없이 순수한 로직을 얻을 수 있습니다.

2단계: '깨끗한 상태'에서 구축하기 (The 'How')

새로 작성된 BRD를 '마스터 아키텍트' 프롬프트에 입력합니다. 이제 AI는 오래된 실수를 수정하는 것이 아니라, 현대적 모범 사례를 사용해 처음부터 솔루션을 구축합니다. 이 접근 방식은 중간 BRD 계층이 기술 중립적이기 때문에 기술 마이그레이션(예: 레거시 Java에서 현대적 Node.js로)도 용이하게 합니다.

게시물은 2단계에 사용된 구체적인 '마스터 아키텍트' 프롬프트가 레딧 스레드의 첫 번째 댓글에 제공된다고 언급합니다.