sandeco/reversa

解決的問題

Reversa 解決了遺留軟體系統中的「知識封閉」問題。透過將現有程式碼轉換為可執行、可追蹤的規格（操作契約），防止 AI 編碼代理破壞關鍵的、未文件化的業務規則與架構決策，讓代理能安全地演進系統。

工作原理

Reversa 作為框架安裝於遺留專案中。它協調一組專業的 AI 代理分析程式碼庫並產生規格。此過程遵循多個明確的管道流程：

• 發現管道： 五階段序列（偵察、挖掘、解釋、生成、審查），用於映射系統、分析模組、提取業務規則、合成架構並撰寫規格。
• 正向循環： 一個橋樑，將這些規格轉化為執行中的程式碼，透過需求、規劃與審計的順序演進系統。
• 遷移管道： 將遺留規格轉換為現代技術堆疊的重建計畫。
• 新專案管道： 適用於新專案，從原始想法直接推進至完整的軟體設計文件（SDD）規格。

所有代理均遵循嚴格的不可變性規則：從不修改或刪除現有專案檔案，僅將輸出寫入特定資料夾（.reversa/ 和 _reversa_sdd/）。

適用對象

希望使用 AI 代理在不破壞未文件化邏輯的前提下維護、演進或遷移遺留軟體的軟體工程師與架構師。

核心亮點

• 非破壞性分析： 原始原始碼絕對不可變，確保安全。
• 多代理編排： 使用專業團隊進行發現、構思、缺陷追蹤與遷移。
• 因果可追溯性： 將缺陷與變更與原始規格關聯，實現可追溯。
• 操作契約： 產生專為 AI 代理設計的規格，而非僅人類可讀的文件。
• 靜態文件網站： 可將提取的知識渲染為包含 3D 架構圖與定量指標的自包含 HTML 小型網站。