레거시 코드 현대화를 위한 2단계 AI 워크플로우
r/ClaudeAI의 레딧 게시물은 단순히 AI에게 '레거시 스파게티 코드를 리팩터링해 달라'고 요청하는 것에 반대하며, AI가 기존의 결함 있는 구조를 유지하려는 경향이 있다고 지적합니다. 대신, LLM 추론을 더 효과적으로 활용하는 두 단계의 '리버스 엔지니어링' 워크플로를 제안합니다.
직접 리팩터링의 문제점
오래된 코드를 AI 에이전트에 붙여넣고 '이 코드를 리팩터링해서 깔끔하게 만들어 주세요'와 같은 요청을 하면, 결과는 종종 동일한 나쁜 아키텍처의 다듬어진 버전일 뿐입니다. AI는 제공한 코드에 편향되어 있습니다—처음부터 결함이 있더라도 여러분의 구조, 변수 이름, 논리 흐름을 유지하려고 합니다.
두 단계 '리버스 엔지니어링' 프로세스
1단계: 의도 추출하기 (The 'What')
AI에게 코드를 수정하라고 요청하지 마세요. 대신, 코드 구조를 무시하고 비즈니스 로직을 추출하도록 요청하세요. 구체적으로, 파일을 기반으로 상위 수준의 비즈니스 요구사항 문서를 작성하도록 합니다. 이를 통해 기술 부채 없이 순수한 로직을 얻을 수 있습니다.
2단계: '깨끗한 상태'에서 구축하기 (The 'How')
새로 작성된 BRD를 '마스터 아키텍트' 프롬프트에 입력합니다. 이제 AI는 오래된 실수를 수정하는 것이 아니라, 현대적 모범 사례를 사용해 처음부터 솔루션을 구축합니다. 이 접근 방식은 중간 BRD 계층이 기술 중립적이기 때문에 기술 마이그레이션(예: 레거시 Java에서 현대적 Node.js로)도 용이하게 합니다.
게시물은 2단계에 사용된 구체적인 '마스터 아키텍트' 프롬프트가 레딧 스레드의 첫 번째 댓글에 제공된다고 언급합니다.
📖 전체 출처 읽기: r/ClaudeAI
👀 See Also
오픈클로가 여전히 다음 프롬프트를 필요로 한다면, 아직 자율적이지 않습니다 — 지속적 워크플로우를 위한 설정 프롬프트
OpenClaw를 채팅 인터페이스가 아닌 코디네이터로 취급하세요. GOALS.md를 공유 로드맵으로 사용하여 한 번에 하나의 Codex 목표씩 처리하세요.
클로드 사용자들은 워드 문서 대신 마크다운을 요청하면 세션이 더 빨라진다고 보고합니다
한 클로드 사용자가 마크다운을 요청하면 워드 문서보다 응답 시간과 토큰 사용량이 크게 줄어든다는 사실을 발견했습니다. AI는 기본적으로 마크다운을 출력하는 반면, .docx 파일을 생성하려면 파이썬 환경을 구동하고 변환 스크립트를 실행해야 합니다.
대부분의 클로드 파이프라인 실패가 모델이 아닌 프롬프트에서 비롯되는 이유와 스킬로 해결하는 방법
Reddit 게시물은 Claude 워크플로우에서 파이프라인 실패의 근본 원인이 프롬프트를 기술(skill)처럼 취급하는 것이라고 주장합니다. 해결책은 입력 계약, 출력 스키마, 학습 파일을 정의하는 것입니다. 즉, 기술이란 v1으로 승격시키는 것입니다.
클로드 AI 사용자, 일반적인 프롬프트 대신 컨텍스트 제공으로 더 나은 결과 얻어 (또는 더 자연스러운 표현: 클로드 AI 사용자들이 일반적인 질문보다 구체적인 상황 설명을 통해 더 좋은 결과를 얻고 있다)
레딧 토론에서 강조되듯, Claude AI로 실제 작업을 수행하는 사용자들은 검색 엔진처럼 다루기보다는 자신의 상황, 시도한 방법, 원하는 결과, 피해야 할 점에 대한 구체적인 맥락을 제공합니다.