sandeco/reversa

해결하는 문제

Reversa는 레거시 소프트웨어 시스템 내의 '고립된 지식' 문제를 해결합니다. 기존 코드를 실행 가능하고 추적 가능한 사양(운영 계약)으로 변환함으로써 AI 코드 에이전트가 중요한 비문서화된 비즈니스 규칙과 아키텍처 결정을 손상시키는 것을 방지합니다. 에이전트는 시스템을 안전하게 진화시킬 수 있습니다.

작동 방식

Reversa는 레거시 프로젝트 내에 프레임워크로 설치됩니다. 전문적인 AI 에이전트 팀을 조율하여 코드베이스를 분석하고 사양을 생성합니다. 이 과정은 여러 명확한 파이프라인을 따릅니다:

• 발견 파이프라인: 5단계 시퀀스(정찰, 발굴, 해석, 생성, 검토)로 시스템을 매핑하고 모듈을 분석하며 비즈니스 규칙을 추출하고 아키텍처를 합성하며 사양을 작성합니다.
• 프론트 사이클: 이러한 사양을 기반으로 요구사항, 계획, 감사의 순서로 시스템을 실행 가능한 코드로 진화시키는 브리지입니다.
• 마이그레이션 파이프라인: 레거시 사양을 현대적인 기술 스택용 재구성 계획으로 변환합니다.
• 그린필드 파이프라인: 새로운 프로젝트를 위한 것으로, 원시적인 아이디어에서 완전한 소프트웨어 설계 문서(SDD) 사양으로 이동합니다.

모든 에이전트는 엄격한 불변성 규칙을 따릅니다: 기존 프로젝트 파일을 수정하거나 삭제하지 않고, 출력은 특정 폴더(.reversa/ 및 _reversa_sdd/)에만 작성됩니다.

대상 사용자

비문서화된 로직에서의 리그레션을 위험으로 안고, AI 에이전트를 사용하여 레거시 소프트웨어를 유지보수, 진화, 이전하고 싶은 소프트웨어 엔지니어 및 아키텍트를 위한 것입니다.

주요 특징

• 비파괴적 분석: 원본 소스 코드가 절대 변경되지 않음을 보장합니다.
• 다중 에이전트 오케스트레이션: 발견, 아이디어 도출, 버그 추적, 마이그레이션에 특화된 전문 팀을 활용합니다.
• 인과 추적 가능성: 결함과 변경 사항이 원본 사양으로 연결됩니다.
• 운영 계약: 단순히 인간이 읽을 수 있는 문서가 아니라 AI 에이전트 전용으로 설계된 사양을 생성합니다.
• 정적 문서 사이트: 추출된 지식을 3D 아키텍처 맵과 정량적 메트릭을 포함한 자체 포함형 HTML 미니사이트로 렌더링할 수 있습니다.