sandeco/reversa

해결하는 문제

Reversa는 레거시 소프트웨어 시스템에서 '고립된 지식'의 문제를 해결합니다. 생산 환경에서 수년간 문서화되지 않은 비즈니스 규칙과 아키텍처 결정이 누적되면, AI 코드 에이전트는 시스템이 실제로 무엇을 하는지에 대한 공식적인 사양이 없기 때문에 안전하게 개선할 수 없습니다. Reversa는 기존 코드를 운영 사양으로 역설계함으로써, AI 에이전트가 기존 로직을 깨뜨리지 않고 시스템을 진화시킬 수 있는 계약서로 활용할 수 있도록 합니다.

작동 방식

Reversa는 레거시 프로젝트 내에 프레임워크로 설치됩니다. 다단계 '발견(Discovery)' 파이프라인(정찰, 발굴, 해석, 생성, 검토)을 통해 특수화된 AI 에이전트(예: 스카우트, 아카이비스트, 디텍티브 등) 팀을 조율합니다. 이 에이전트들은 코드베이스를 분석하고 비즈니스 규칙과 모듈 계약을 추출하며, 전용 출력 폴더에 추적 가능한 사양(SDD 사양)을 생성합니다.

이러한 사양이 생성된 후, 프레임워크는 다양한 목표를 위한 전용 워크플로우를 제공합니다:

• 진화: /reversa-forward 파이프라인을 통해 사양에서 새 코드로 이동.
• 마이그레이션: /reversa-migrate를 사용하여 현대적인 스택에서 재구축 계획 수립.
• 문서화: /reversa-docs를 통해 추출된 지식을 HTML 미니사이트로 렌더링.
• 그린필드: /reversa-new를 사용하여 원초적인 아이디어에서 새 프로젝트 시작.

대상 사용자

문서가 부족한 상태에서 레거시 시스템을 유지보수, 진화, 마이그레이션하고 싶은 소프트웨어 엔지니어 및 아키텍트.

주요 특징

• 비파괴적 분석: 프레임워크는 기존 프로젝트 파일을 수정하거나 삭제하지 않으며, 모든 쓰기는 특정 .reversa/ 및 _reversa_sdd/ 폴더에만 제한됩니다.
• 에이전트 오케스트레이션: 소프트웨어 라이프사이클의 다양한 단계를 처리하는 10개의 전문 에이전트 팀(발견, 아이디어 창출, 마이그레이션 등)을 활용.
• 운영 계약: 단순히 인간이 읽기 쉬운 문서가 아니라 AI 에이전트를 위한 사양을 생성.
• 에이전트 독립성: API 키를 저장하지 않으며, 사용자 환경에 이미 존재하는 AI 에이전트(예: Claude Code, Cursor, Codex)의 지능을 위임.
• 인과 추적 가능성: 전용 버그 에이전트를 통해 결함을 추적하고 사양으로 직접 연결하여 수정.