Reversa: A Reverse Documentation Engineering Framework for Converting Legacy Software into Operational Specifications for AI Agents

오래되고 먼지 쌓인 도서관을 상상해 보세요. 수천 권의 필사본으로 가득 차 있습니다. 이 책들은 은행 운영 규칙을 담고 있지만, 더 이상 아무도 쓰지 않는 언어 (예: COBOL) 로 쓰여 있고, 잉크는 바래 있으며, 목차나 색인도 없습니다. 원래 저자들은 이미 오래전에 떠났고, 이 책들을 읽을 수 있는 사람은 은퇴할 나이인 몇몇 매우 늙은 사서들뿐입니다.

이제, 은행이 새로운 컴퓨터에서 운영될 수 있도록 이 규칙들을 새로운 언어 (예: Go) 로 다시 작성하기 위해 초지능적이고 빠른 로봇들 (AI 에이전트) 팀을 고용하고 싶다고 가정해 보세요. 문제는 무엇일까요? 단순히 로봇들에게 "이것을 고쳐라"라고만 말한다면, 그들이 잘못 추측할 수 있습니다. 어떤 규칙이 실제로는 다른 의미를 갖는데도 한 가지 의미로 해석할 수 있고, 이로 인해 은행 시스템이 마비될 수 있습니다.

이 논문은 바로 이 문제를 해결하기 위해 설계된 새로운 프레임워크인 Reversa를 소개합니다. Reversa 를 코드를 즉시 번역하는 마법의 지팡이로 생각하지 말고, 전문적인 "역방향 문서화" 공장으로 생각하세요.

다음은 간단한 비유를 통해 작동 방식을 설명한 것입니다:

1. 문제: "침묵하는" 레거시 시스템

오래된 소프트웨어 시스템은 20 년 전에 주인이 떠난 집과 같습니다. 불은 켜져 있고 냉장고는 윙윙거리지만, 부엌 전등이 왜 현관문과 연결되어 있는지, 혹은 세탁기가 작동하는 동안 오븐을 켜면 어떤 일이 발생하는지 아무도 모릅니다. 규칙은 벽 (코드) 안에 숨겨져 있습니다. 이러한 숨겨진 규칙을 모른 채 리모델링을 시도하면 실수로 동네 전체의 전력을 끊을 수도 있습니다.

2. 해결책: 전문 로봇 탐정 팀

한 명의 로봇에게 집 전체를 읽고 규칙을 추측하게 하는 대신, Reversa 는 각자 특정 업무를 맡은 전문 에이전트 팀을 투입합니다. 마치 생산 라인처럼 작동합니다:

• 정찰병 (Scout): 먼저 집 안을 돌아다닙니다. "좋습니다, 방이 5 개 있고, 지하실이 있으며, 부엌에 이상한 문이 하나 있습니다." (프로젝트 표면 매핑).
• 고고학자 (Archaeologist): 벽을 파헤칩니다. "여기 파이프가 그 밸브에 연결된다는 설계도가 있습니다." (모듈 분석).
• 탐정 (Detective): 단서를 찾습니다. "왜 전등이 문과 연결되어 있을까요? 아, 메모에 보안 기능이라고 되어 있군요." (숨겨진 비즈니스 규칙 추출).
• 건축가 (Architect): 발견한 내용을 바탕으로 새로운 지도를 그립니다. "즉, 부엌이 집의 심장이고, 지하실은 물을 저장하는 곳입니다." (아키텍처 종합).
• 작가 (Writer): 규칙을 명확하게 적어냅니다. "규칙 #1: 문이 열리면 전등이 켜집니다." (명세서 작성).
• 검토자 (Reviewer): 가장 중요한 역할입니다. 작가의 작업을 점검합니다. "잠깐, 전등에 대한 메모를 찾았나요? 없다면 확실히 말할 수 없습니다. 이를 '아마도' 또는 **'인간이 확인해야 함'**으로 표시합시다." (신뢰도와 간극 검토).

3. 비밀 무기: "신뢰도"와 "간극"

대부분의 AI 도구는 추측할 때도 100% 확신하는 것처럼 말하려 합니다. Reversa 는 다릅니다. 발견한 모든 규칙에 대해 신호등 시스템을 사용합니다:

• 🟢 초록 (확인됨): 코드에서 이를 찾았습니다. 사실입니다.
• 🟡 노랑 (추론됨): 직접적인 메모는 찾지 못했지만 패턴이 이를 시사합니다. 현명한 추측이지만 주의가 필요합니다.
• 🔴 빨강 (간극): 전혀 모릅니다. 코드에 이 정보가 없습니다. 중지! 인간이 와서 무엇을 해야 할지 알려줘야 합니다.

이것이 중요합니다. 이는 로봇들이 확신 있게 실수를 저지르는 것을 방지합니다. 인간에게 "우리는 규칙의 97% 를 알지만, 나머지 3% 에서는 당신의 도움이 필요합니다"라고 알려줍니다.

4. 결과: 로봇을 위한 "계약서"

출력은 인간이 읽을 지루한 매뉴얼이 아닙니다. 이는 AI 에이전트를 위한 운영 계약서입니다. 다음과 같이 명시합니다:

• "시스템이 무엇을 하는지."
• "증거 (구체적으로 오래된 코드의 어느 파일에서 찾았는지)."
• "아직 모르는 것."

이를 통해 AI 에이전트는 명확한 지도를 가지고 있으며 "전쟁의 안개 (불확실성)"가 어디에 있는지 정확히 알기 때문에, 오래된 시스템을 안전하게 다시 작성 (COBOL 에서 Go 로 이전) 할 수 있습니다.

5. 현실 세계 테스트: ATM 기계

저자들은 이를 실제 (하지만 간단한) 프로젝트인 COBOL 로 작성된 구식 ATM 기계를 Go 로 재구축해야 하는 사례에 테스트했습니다.

• 과정: Reversa 파이프라인을 실행했습니다.
• 결과: 시스템은 517 개의 "주장 (규칙)"을 생성했습니다. 490 개는 사실로, 24 개는 추측으로 표시했고, 3 개의 누락된 부분 (간극) 을 발견했습니다.
• 인간의 역할: 인간이 누락된 부분과 "추측"을 해결하기 위해 개입했습니다.
• 결과: ATM 재구축 계획을 수립하고 53 개의 테스트 시나리오 (예: "$20 을 넣으면$20 을 받아야 함") 를 작성했습니다. 재구축을 성공적으로 시작하여 11 개 주요 작업 중 9 개를 완료했습니다.

이 논문이 주장하지 않는 것

이 논문이 무엇을 말하지 않는지 아는 것이 중요합니다:

• 이것이 완벽하거나 전 세계의 모든 오래된 시스템에 적용된다고 주장하지 않습니다.
• 로봇들이 인간 없이 전체 작업을 수행할 수 있다고 주장하지 않습니다. "빨강" 간극을 해결하려면 여전히 인간이 필요합니다.
• 이것이 기존 방식보다 빠르거나 저렴하다고 주장하지 않습니다. 단지 이것이 가능하며 더 안전하고 체계적인 프로세스를 만든다는 것만 입증했습니다.

요약

Reversa는 오래된 소프트웨어를 범죄 현장처럼 취급하는 프레임워크입니다. AI 탐정 팀을 활용하여 시스템이 무엇을 하는지 신중하게 매핑하고, 무엇을 확신하는지와 무엇을 추측하는지를 명시적으로 표시합니다. 이는 로봇들이 시스템을 파괴하지 않고 오래된 시스템을 업데이트하거나 다시 작성할 수 있도록 하는 안전한 "사용 설명서"를 생성하며, 로봇이 해결하지 못하는 미스터리는 인간이 해결할 수 있도록 인간을 루프 안에 유지합니다.