EricJujianZou/rederive

rederive は、コードベースの仕組みを、ヒントとしての質問だけを使って、ゼロから自分で再設計させることで教えるツールです。コードを直接説明することは決してありません。自分で設計を再発見するように導きます。

機能

プロジェクトで rederive を実行すると、コードベースがインタラクティブなパズルのようになります。説明やドキュメントを読む代わりに、元の開発者が直面したのと同じ設計問題を解決するよう求められます。解決策を提案すると、rederive が制約で反論し、実際の設計に到達するまで回答を洗練させます。その考え方は、誰かに言われたことを暗記するのではなく、自分で導き出したからこそコードを真に理解できるというものです。

仕組み

1. 「なぜ」から始まります。 自分のプロジェクトで実行すると、なぜそれを構築したのかを尋ねられます。他人のプロジェクトで実行すると、プロジェクトが解決しようとした元の問題を特定し、どう解決するかを尋ねます。
2. 回答中にバックグラウンドエージェントがリポジトリを調査します。 コードを読み、ファイルが互いにインポートする方法を追跡し、設計が変更されたコミットを調べます。コミットメッセージは意図的に無視するため、AI がいくつかの大きなコミットで構築したリポジトリでも問題なく機能します。
3. 5〜10 の設計問題のマップを構築します。システムが実際に構築される順序でリストされます。各問題には、制約と実際の解決策が付属しています。このマップは .rederive/map.md というファイルに保存されます。答えが含まれているため、完了するまで覗かないように指示されます。
4. 行き詰まった場合、問題をいくつかの可能なアプローチに絞り込みます。2 回連続で間違った回答をすると、問題のスケッチを提案します。
5. 進捗ログを保持します。.rederive/log.md に保存されます。どこで苦労したか、自分で何を解決したかが記録されます。最後に読んで、何を練習すべきかを確認できます。

インストール

ターミナルで次のコマンドを実行します。

npx skills add EricJujianZou/rederive

これにより、Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、opencode、Windsurf、Amp、Goose、および約 15 の他のコーディングエージェントにインストールされます。-g を追加すると、現在のプロジェクトだけでなく、すべてのプロジェクトにインストールされます。インストール後、エージェントで /rederive と入力します。

マシンに git、bash、python3 が必要です。

代替のインストール方法もあります。Claude Code プラグインとして、またはリポジトリを手動でクローンしてスキルフォルダをエージェントのスキルディレクトリにコピーする方法です。

使用法

/rederive                                       # 現在いるリポジトリ
/rederive ~/code/myapp                          # ローカルリポジトリ
/rederive https://github.com/expressjs/express  # リモートリポジトリを現在のフォルダにクローン

普通の言葉で話しかけます。行き詰まったことを伝えたり、問題をスキップするよう要求したり、最初からやり直したいと言ったりできます。

プライバシー

すべてはあなたのマシンに留まります。.rederive/ フォルダはリポジトリのローカル git 除外リストに追加されるため、コミットに表示されることはありません。rederive はテレメトリを送信しません。

ライセンス

MIT。

このプロジェクトは「人間の好奇心を回復しようとする、欲求不満の開発者による試み」と自称しています。