---
창작 제목: "코드에 갇힌 지식을 꺼내는 법 — 레거시를 AI 에이전트용 계약서로 되돌리다"
원제: "Reversa: 레거시 코드에서 AI 코딩 에이전트용 명세를 역으로 추출하는 다중 에이전트 프레임워크에 대한 연구"
출처: https://discuss.pytorch.kr/t/reversa-ai/11785
정리: 다비(davi.kr) — https://davi.kr/
태그: [Reversa, 레거시현대화, 역방향문서화, 다중에이전트, SDD, COBOL, 코딩에이전트]
문서의 목적: 레거시 코드에서 AI 에이전트가 바로 쓸 수 있는 운영 명세를 추출하는 Reversa 프레임워크의 구조·수치·한계를 빠르게 파악한다.
---

> 원문: https://discuss.pytorch.kr/t/reversa-ai/11785
> 논문: https://arxiv.org/abs/2605.18684 · 저장소: https://github.com/sandeco/reversa

# 코드에 갇힌 지식을 꺼내는 법

## 쉬운 설명

새 프로그램을 만들 때는 사람이 "이렇게 만들어 줘"라는 설명서(명세)를 쓰고 AI가 그대로 코딩합니다. 그런데 10년 된 시스템에는 설명서가 아예 없습니다. 규칙은 코드 속 `if` 문에만 남아 있고, 왜 그렇게 만들었는지는 아무도 모릅니다. AI 에이전트 입장에서는 **무엇을 건드리면 안 되는지 알 방법이 없는** 상태입니다.

**Reversa**는 이 순서를 거꾸로 돌립니다. 오래된 프로젝트에 설치하면 AI 에이전트 6종(Scout·Archaeologist·Detective·Architect·Writer·Reviewer)이 5단계로 코드를 훑어, 업무 규칙·구조·아키텍처 결정을 뽑아 **다른 AI가 그대로 읽고 쓸 수 있는 명세**로 바꿉니다. 브라질 연구자 2명(Sanderson Oliveira de Macedo, Ronaldo Martins da Costa)이 2026년 5월 18일 arXiv에 논문을 공개했고, MIT 라이선스입니다.

핵심은 **문장마다 붙는 3단계 확신 등급**입니다. 🟢 CONFIRMED(코드에서 직접 확인, 파일:줄 인용 가능) / 🟡 INFERRED(추론이라 틀릴 수 있음) / 🔴 GAP(사람이 확인해야 함). "틀린 문장을 자신 있게 쓰는 것"이 "빈칸을 남기는 것"보다 나쁘다는 실험 결과(Macke & Doyle, NAACL 2024)를 근거로 삼은 설계입니다.

## 활용 방법

1. Node.js 18.20.2 이상을 준비하고 레거시 프로젝트 최상위에서 `npx reversa install` 실행. Claude Code·Codex·Cursor 등 **13종 엔진** 지원, 별도 API 키 불필요(이미 쓰는 에이전트에 위임).
2. 설치 시 언어 항목 주의 — **기본값이 `pt-br`/`Português`** 라 그냥 넘기면 산출물과 폴더명까지 포르투갈어로 나옵니다.
3. `/reversa`(Codex는 `reversa`)로 시작. 단계마다 `CONTINUAR` 입력이 필요한 사람 확인 지점이 있고, 진행 상태는 `.reversa/state.json`에 저장돼 끊겨도 이어집니다.
4. 결과 확인 후 `/reversa-forward`(기능 확장) · `/reversa-migrate`(현대 스택 이전) · `/reversa-docs`(HTML 사이트)로 분기. `npx reversa export-diagrams`로 Mermaid 다이어그램을 SVG/PNG로 뽑으세요.
5. **시작 전 반드시 Git 커밋 + 원격 백업**. 저장소가 직접 권고합니다.

## 전문가 의견 (사실 기반)

- **검증된 성과**: COBOL ATM(모듈 5개)을 Go로 옮긴 사례에서 자동화 테스트가 **0건이던 시스템에서 Gherkin 동등성 시나리오 53건**을 산출. 마이그레이션 작업 11건 중 9건 완료.
- **97.1%라는 숫자는 조심해서 읽으세요.** 주장 517건(확정 490 / 추론 24 / 빈틈 3)에 `(490+24×0.5)/517` 식을 적용한 값이며, 논문 스스로 **"파이프라인이 자기 분류를 요약한 값일 뿐 사실 정확도가 아니다"**라고 못 박았습니다. 외부 감사 없음.
- **논문이 측정하지 않은 지표 2개**: 전문가 정밀도, 에이전트 유용성. 즉 "Reversa 명세가 있으면 AI가 더 잘한다"는 통제 비교가 **없습니다**.
- **일반화 금지 조건**: 대상은 사용자 1명·운영 미사용·기존 테스트 0인 교육용 프로젝트. 산업용·규제 도메인·복잡한 외부 연동에는 바로 적용 불가.
- **현실적 부담**: 교육용 ATM 하나에서 주장 517건. 검토 인력이 없으면 안 읽히는 문서만 늘어납니다. 에이전트 실행 비용도 기존 요금제에서 그대로 발생합니다.

## Bottom Line

명세 없는 레거시를 AI 에이전트에 맡기려는 팀이라면 지금 당장 사본 저장소에 `npx reversa install`을 실행하십시오. 쓰기 범위가 자기 폴더로 제한돼 도입 위험은 낮습니다. 다만 **INFERRED·GAP 항목 검증 시간을 일정에 먼저 잡아 두십시오.** 이 도구는 불확실성을 없애는 것이 아니라 눈에 보이게 만드는 것입니다.

---
*정리: 다비(davi.kr) — https://davi.kr/*