reversa

Reversaは、AIコーディングエージェントがレガシーシステムを安全に扱えるように、それらのシステムから仕様をリバースエンジニアリングするためのフレームワークです。プロジェクトのルートで `npx reversa install` を実行してインストールすると、専門化されたAIエージェントのチームがワークスペースに配備されます。 中核となるパイプラインはDiscoveryフェーズ（`/reversa`）であり、Reversaエージェントが5つのステップで調整します。Scoutはプロジェクトの表面をマッピングし、Archaeologistはモジュールと制御フローを分析し、Detectiveは暗黙のビジネスルールとアーキテクチャ上の意思決定を抽出し、ArchitectはC4図とERDを統合し、Writerはコードへのトレーサビリティを備えた実行可能な運用契約を作成します。Visor（スクリーンショットからのUIドキュメント）、Data Master（データベース分析）、Design System（デザイントークン抽出）、Soul Extractor（エグゼクティブサマリー仕様）などのオプションのエージェントも利用できます。 Discoveryに加えて、Reversaは複数のワークフローをサポートしています。 - `/reversa-new` — 1行のアイデアから完全な仕様まで、グリーンフィールドプロジェクトを作成 - `/reversa-forward` — 仕様からコードへ、一度に1機能ずつシステムを進化 - `/reversa-migrate` — レガシーシステムを最新のスタックで再構築 - `/reversa-docs` — 抽出された知識を静的HTMLミニサイトとしてレンダリング - `/reversa-debugger` — 仕様まで因果的に追跡可能な形で欠陥を追跡 - `/reversa-refactor` — 動作を変更せずにコード品質を改善 - `/reversa-pricing-*` — 仕様から作業量とコストを見積もり 自律型バリアント（`/reversa-autonomous`、`/reversa-new expresso`、`/reversa-forward-autonomous`）は、最初の1回のヒアリング後にパイプラインをエンドツーエンドで実行します。すべての書き込みは `.reversa/` と出力フォルダに制限され、既存のプロジェクトファイルには一切触れません。中断したセッションを再開できるよう、チェックポイントは `.reversa/state.json` に保存されます。 このフレームワークは、SDD仕様、要件ドキュメント、ロードマップ、アクションプラン、トレーサビリティマトリックスを含む構造化された成果物を生成します。出力は、仕様用の `_reversa_sdd/` と欠陥追跡用の `_reversa_bugs/` に格納され、どちらもバージョン管理下に置かれます。