stalemapとは？
stalemap は、モデルの学習データのカットオフ後に API が変わったプロジェクトの npm 依存関係を見つけ、その変更をコーディングエージェントに渡します。設定されたモデルのカットオフ日を models.dev から求め、その少なくとも 30 日前までに公開された最新の安定版をモデルが知っているバージョンとみなし、あなたが固定しているバージョンと比べます。
比較では両バージョンの .d.ts 型ファイルをダウンロードして TypeScript コンパイラ API で差分を取り、changelog と GitHub Releases から破壊的変更の項目を加えます。エージェントは結果を三つの形で受け取ります。AGENTS.md か CLAUDE.md に書かれる順位付きのメモ(既定で 1,800 トークン)、編集のたびにプロジェクト自身の tsc を実行して各エラーに該当するメモを添えるガード、そして search_changes という MCP ツールです。
npm パッケージ、Claude Code プラグイン、GitHub Action、Cursor・Codex・OpenCode 向けのセットアップコマンドとして提供されています。コードは MIT で、リポジトリは 2026年10月19日に作成され、最新リリースは 10月20日の 0.4.1 です。
stalemapは使う価値があるか？
stalemap が狙うのは特定の失敗 です。エージェントは、あなたが固定したバージョンではなく、学習したバージョンのライブラリに合わせてコードを書いてしまいます。README の例は、AI SDK 7 に対する maxSteps、zod 4 に対する required_error、Next 16 に対する middleware.ts です。ドキュメントのページ全体を取ってくる代わりに、二つのバージョンの型定義を比べ、あなたのコードが import している API で変わった部分だけをエージェントに渡します。
根拠はほとんどのエージェント向けツールより確かです。33 の人気 npm パッケージが 2026年7月から10月に出した変更から作った 66 タスクの、ブラインドかつ事前登録されたテストで、claude-sonnet-5-5 は stalemap ありでセッションの 89% に合格し、補助なしでは 68%、編集ごとに単純な tsc --noEmit フックを走らせた場合は 73% でした。主要な比較の区間は 13.6 から 28.3 ポイントです。作者は上限も示しており、変更を名指しする手書きの一行ヒントでは 98% に達しました。ツール、テスト環境、プロトコルは同じ作者によるものですが、タスクは別のセッションが書き、独立したレビュアーが確認しています。計測したのは Claude の二つのモデルだけです。
使うのは無料ではありません。セッションあたりのコストの中央値は claude-sonnet-5-5 で $0.041 から $0.050 に、claude-sonnet-4-5 では $0.085 から $0.124 に上がり、セッション時間も 47 秒から 79 秒に延びました。コードがマシンの外に出ることはありませんが、パッケージ名とバージョンは npm レジストリ、GitHub、models.dev に送られ、任意の --llm、--examples、--guides モードでは型の差分と import した API の名前が Claude に送られます。
制約は README にはっきり書かれて います。package.json は一つだけでワークスペース非対応、@types パッケージは比較しない、使用箇所の追跡は import した名前と x.member のアクセスまで、そして Cursor、Codex、OpenCode 向けのセットアップは実際の環境で試されていません。Context7 は最新ドキュメントを必要に応じて提供することで多くの言語をカバーします。stalemap はより厳格な道具で、エージェントが尋ねようと思わなくても、編集時のガードが古い呼び出しを捕まえます。
真価を発揮する場面
Next.js 16 と AI SDK 7 のアプリを Claude Code で開発する個人開発者
もうコンパイルできない middleware.ts や maxSteps のコードをエージェントに書かせたくない
二つの /plugin コマンドで Claude Code プラグインを入れます。メモはセッション開始時に読み込まれ、ガードが編集ごとにコンパイルエラーと修正方法を伝えます。セッションは少し高くなり、claude-sonnet-5-5 の中央値でタスクあたり約 $0.009 増えます。
開発者 20 人の TypeScript 受託開発会社のテックリード
Renovate がメジャーバージョンを上げたときに、エージェント向けの指示を最新に保ちたい
メモのブロックをコミットし、model を指定して GitHub Action を追加します。npx stalemap check はブロックが古いと CI を失敗させ、コメントモードでは依存関係に触れるプルリクエストに変更点を投稿します。コメントモードには pull-requests: write が必要です。
Claude Code ではなく Cursor か Codex を使う開発者
作業中のエージェントに、必要なときに最新の API 変更を渡したい
stalemap setup --agent cursor(または codex)を実行すると、メモの書き込み、MCP サーバーの登録、編集後ガードの設定がプロジェクトファイルとして行われます。作者によれば、この手順は実際の Cursor や Codex の環境ではまだ試されていません。
導入前に確認すること
- 導入
- Claude Code で /plugin marketplace add Umair/stalemap、続けて /plugin install stalemap@stalemap。または npx stalemap でプレビューし、npx stalemap sync でブロックを書き込みます。どの MCP クライアントからでも npx -y stalemap@latest mcp で起動できます。
- 連携
- MCP ツール 4 個(search_changes、package_changes、project_changes、check_notes)、Claude Code の SessionStart と PostToolUse フック、Cursor・Codex・OpenCode 向けセットアップ、GitHub Action、npm・pnpm・yarn・bun のロックファイルに対応。
- データとプライバシー
- ソースコードはローカルで解析され、アップロードされません。パッケージ名とバージョンは npm レジストリ、GitHub、models.dev に送られます。--llm、--examples、--guides は型の差分、リリースノートの抜粋、import した API 名を Claude に送ります。キャッシュは ~/.cache/stalemap に置かれます。MIT。
- 大規模利用時のコスト
- ツールは無料です。作者のベンチマークでは、セッションあたりのコスト中央値が claude-sonnet-5-5 で $0.041 から $0.050 に、claude-sonnet-4-5 で $0.085 から $0.124 に上がりました。任意の Claude による要約は、自分のキーでの API 呼び出しが増えます。
- 制限
- JavaScript と TypeScript のみ。package.json は一つ。@types パッケージは比較しない。挙動の変更はリリースノートかアップグレードガイドに書かれている場合だけ検出。エージェントが正しいメモを無視することがある。
良い点
- モデルによるドキュ メント要約ではなく、実際の型定義を比較
- 編集時のガードが、コンパイラエラーごとに該当する変更メモを添える
- 上限とコストも公開した、ブラインドかつ事前登録のベンチマーク
- ソースコードはアップロードされず、解析はローカル
- Claude Code プラグイン、MCP サーバー、CLI、GitHub Action
気になる点
- JavaScript と TypeScript のみ。package.json は一つ、ワークスペース非対応
- セッションコストの中央値が上がる(claude-sonnet-5-5 で約 22%)
- Cursor、Codex、OpenCode 向けのセットアップは実環境で未検証
- メンテナーは一人。2026年10月19日作成
おすすめの人
Next.js、AI SDK、zod のように変化の速いパッケージについて、コーディングエージェントが古いバージョン向けのコードを書き続けてしまう TypeScript 開発者。
stalemap：よくある質問
- stalemapは使う価値があるか？
- 現実的で高くつく問題に対する狭い解決策で、異例なほど丁寧なベンチマークに裏付けられていますが、JavaScript と TypeScript 専用で、メンテナーは一人だけです。 評価は5点満点中3.8点です。
- stalemapの料金は？
- MIT で無料。任意の --llm、--examples、--guides 機能は、自分の Anthropic キーか Claude Code のログインで Claude を呼び出します。
- stalemapの欠点は？
- JavaScript と TypeScript のみ。package.json は一つ、ワークスペース非対応; セッションコストの中央値が上がる(claude-sonnet-5-5 で約 22%); Cursor、Codex、OpenCode 向けのセットアップは実環境で未検証; メンテナーは一人。2026年10月19日作成.
- stalemapは誰に向いているか？
- Next.js、AI SDK、zod のように変化の速いパッケージについて、コーディングエージェントが古いバージョン向けのコードを書き続けてしまう TypeScript 開発者。
- チームや本番環境でstalemapを使うと費用はいくらか？
- ツールは無料です。作者のベンチマークでは、セッションあたりのコスト中央値が claude-sonnet-5-5 で $0.041 から $0.050 に、claude-sonnet-4-5 で $0.085 から $0.124 に上がりました。任意の Claude による要約は、自分のキーでの API 呼び出しが増えます。
- stalemapは企業データを扱っても安全か？
- ソースコードはローカルで解析され、アップロードされません。パッケージ名とバージョンは npm レジストリ、GitHub、models.dev に送られます。--llm、--examples、--guides は型の差分、リリースノートの抜粋、import した API 名を Claude に送ります。キャッシュは ~/.cache/stalemap に置かれます。MIT。
回答確認日：2026年11月5日