sota-anchor

sota-anchor

コーディングエージェントは、学習後に公開されたものを知りません。
sota-anchorは、MCP サーバーであり、Claude Codeプラグインでもあります。
エージェントが既に存在するものを作り直したり、実現できないと言ったりする前に、
過去1年間の論文、リポジトリ、パッケージを確認します。

コーディングエージェントは、学習で得た知識をもとに計画を立てます。タスクに未知のものが必要な場合、それは存在しないと思い込み、コストのかかる2つの対応のどちらかを行います。ゼロから作るか、実現できないと伝えるかです。多くの場合、作業を簡単にするライブラリ、リーダー、モデルは、エージェントの学習終了後に公開されています。

sota-anchorを使うと、エージェントはその後に公開されたものを確認します。何かが利用できないことを前提に計画を立てるとき、エージェントは過去1年間の論文、リポジトリ、パッケージを検索し、日付とともに見つかった情報を評価します。そして既存のものを再利用するか、それ以上のものがないと把握したうえで開発します。

• あらゆる分野に対応。 コードには特定の分野に関する知識がありません。CADファイル形式でも、ゲノミクスのパイプラインでも、コンパイラのパスでも、同じ確認を行います。
• 追加のAPIキーは不要。 推論はエージェントが行い、検索はsota-anchorが行います。
• 記憶ではなく根拠。 すべての主張に日付付きの情報源を引用します。検索して何も見つからない場合は、推測せずにそう伝えます。

Before and after

Xcode 27 の同じプロジェクトで、どちらのときも同じ依頼をしました。「xcode 27 でプロジェクトが新しい project.xcproj 形式に移行したが、まだ対応ライブラリがないので、CI で各ターゲットのビルド設定をチェックできる Swift パーサーを書いてください」。

Before. sota-anchor がない場合、Claude Code は依頼をそのまま受け取り、パーサーを書きました。8 ファイル、755 行の Swift パッケージで、形式については「Apple のドキュメントではなく、Logbook.xcodeproj/project.xcproj から」独自に解明したとのことです。所要時間は 2 分 37 秒でした。

After. sota-anchor を使うと、コードを書く前にチェックが実行されます。モデルの学習後の 2026-09-15 に Apache 2.0 ライセンスで公開された、Apple 独自の形式用ライブラリ xcode-project-format が見つかります。Claude Code は GitHub で確認し、「自作すると重複する」ため独自パーサーを見送り、Apple のライブラリを使って CI チェックを書く前に、どのルールを適用するか尋ねます。42 秒で、まだコードは書かれていません。

_{どちらも記録された Claude Code のセッション（Opus 5.5、2026-09-25 と 2026-09-26）で、記録された画面をもとに Mac のターミナルとして描画しています。最初の例は冒頭から表示されており、その後さらに 116 行続きます。サンプルプロジェクトのファイルは Apple のライブラリを使って生成されたため、実際の形式です。}

他のプランでも同じチェック

_{最初と最後の行は、記録された実行結果に基づいています。2 行目の論文は、2026-09-24 にそのプランについて検索して得られたものです。}

仕組み

リクエストが何かの入手不能を前提としている場合（ベンダーのソフトウェアでしか開けない形式のリーダー、誰も作っていないライブラリ、まだモデルにできないタスクなど）、check-what-exists スキルは3段階の確認を行います。

1. 反転。 エージェントは、計画が「存在しない」と仮定しているものを明示します。たとえば、Xcode 27の project.xcproj 形式を読み取るライブラリはまだない、というようにです。あなたが示した制約（「ベンダーの SDK は使えない」など）はそのまま前提とし、それ以外に条件を満たすものがあるかを確認します。エージェントは2つのクエリを作成します。1つはその分野でのタスクの呼び方、もう1つは回避策を不要にするものです。
2. 検索。 sota-anchor は直近12か月の論文（arXiv、Hugging Face）、リポジトリ（GitHub）、パッケージ（npm、crates.io）を検索します。Brave のキーを指定した場合はウェブも検索します。関連するものが見つかるまで各クエリの条件を緩めます。すべての情報源を合わせて60秒の制限時間内で検索します。
3. 判断。 エージェントは検索で得られた情報だけを評価します。根拠が反証しない限り、前提は維持されます。「ライブラリは存在しない」という前提は、その作業をこなす公開済みのリポジトリまたはパッケージが見つかれば覆されます。ただし、存在することと成熟していることは同じではないため、公開からの期間や活動状況も報告されます。「モデルにはできない」という主張には、ベンチマーク結果が必要です。

結論は3つのうちいずれかです。すでに作業をこなすものがある場合、エージェントは上記のセッション例のように、その名称と根拠を示します。根拠だけでは判断できない場合、前提は維持され、何があれば覆るかをエージェントが説明します。何も見つからなかった場合は、何も確認できなかったと伝え、検索結果がないことを結論として扱いません。

そのほか：最新のモデル ID

新しいプロジェクト向けの、主に利便性を目的とした機能です。すべての Claude Code セッションの開始時に、OpenRouter の公開レジストリで現在提供されているモデル API ID と、それに置き換えられた古い ID の短い日付付きリストが表示されるため、新しい設定では実在するモデルを指定できます。

- GEMINI_MODEL=gemini-3-pro            # recalled from training: not a served ID
+ GEMINI_MODEL=gemini-3.1-pro-preview  # from the session's registry snapshot

リストには情報源が明記され、どのモデルが実行中かについての主張はありません。フックは事前に生成されたブロックを読み込み、1日1回バックグラウンドで更新するため、1セッションあたりの所要時間は約160 msです。他のエージェントも sota-anchor sync で同じリストを利用できます。

クイックスタート：Claude Code

メモ

Python 3.11+ と uv が必要です。API キーは不要です。

Claude Code で：

/plugin marketplace add luckmanqasim/sota-anchor
/plugin install sota-anchor@sota-anchor

その後、新しいセッションを開始します。最初のセッションでは uv が MCP サーバーの環境を構築するため、数秒長くかかります。以降はすぐに起動します。

インストールせずに1つのセッションで試すには：

git clone https://github.com/luckmanqasim/sota-anchor
claude --plugin-dir ./sota-anchor

利用できる機能：

お試しください

このツールの動作を示す3つのプロンプトです：

1. 欠けているものを前提としたプラン。 チェックは自動で実行されます：

   xcode 27 moved our project to the new project.xcproj format and there's no library for
   it yet, so write a swift parser we can use in CI to check each target's build settings
   

   Claude は、モデルの学習後にリリースされた Apple 独自の xcode-project-format ライブラリを見つけ、パーサーを書く代わりに、CI チェックで何を強制すべきかを尋ねます。

2. 必要なときに実行するチェック。 通常はベンダーの SDK が必要だと思われている形式を対象とします：

   /sota-check "Write our own reader for Navisworks .nwd files, since we can't use the Autodesk SDK"
   

   最近のリポジトリ、パッケージ、論文を検索し、見つかった内容を日付とともに報告するか、何も見つからなかったと明確に伝えます。

3. コード内のモデル識別子。 セッションのモデル一覧が役立ちます：

   Add an Anthropic client to this script and pick the current flagship model
   

   Claude は、学習時に記憶した古いエンドポイントではなく、プラグインがセッションに追加する日付付きの一覧からエンドポイントを使用します。

その他のコーディングエージェント

このチェックは標準的な MCP サーバーなので、MCP に対応するあらゆるエージェントで動作します。モデルリストは、プロジェクトの指示ファイルに記載します。

1. CLI を一度インストールします：

uv tool install sota-anchor   # or: pipx install sota-anchor

2. 以下のスニペットを使って、エージェントに MCP サーバーを登録します。

3. 必要に応じて、モデルリストをプロジェクトに書き込み、新しいリストが必要になったときに再実行します：

sota-anchor sync --target agents   # writes AGENTS.md
sota-anchor sync --target cursor   # writes .cursor/rules/sota.mdc and .cursorrules

SOTA-ANCHOR マーカーの間にあるテキストだけが変更されるため、ファイルの残りの部分はそのまま維持されます。

ヒント

Claude Code 以外では、エージェントはツールの説明に基づいて check_what_exists を呼び出すタイミングを決定します。確実に実行するには、次のように依頼してください："このプランを実装する前に、check_what_exists を実行してください。"

{
  "mcpServers": {
    "sota-anchor": { "command": "sota-anchor", "args": ["serve"] }
  }
}

{
  "servers": {
    "sota-anchor": { "command": "sota-anchor", "args": ["serve"] }
  }
}

code --add-mcp '{"name":"sota-anchor","command":"sota-anchor","args":["serve"]}'

codex mcp add sota-anchor -- sota-anchor serve

[mcp_servers.sota-anchor]
command = "sota-anchor"
args = ["serve"]

gemini mcp add sota-anchor sota-anchor serve

{
  "mcpServers": {
    "sota-anchor": { "command": "sota-anchor", "args": ["serve"] }
  },
  "context": { "fileName": ["AGENTS.md", "GEMINI.md"] }
}

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sota-anchor": { "type": "local", "command": ["sota-anchor", "serve"], "enabled": true }
  }
}

"sota-anchor": {
  "type": "local",
  "command": ["uvx", "sota-anchor", "serve"],
  "enabled": true,
  "timeout": 30000
}

{
  "mcpServers": {
    "sota-anchor": { "command": "sota-anchor", "args": ["serve"] }
  }
}

{
  "mcpServers": {
    "sota-anchor": { "command": "uvx", "args": ["sota-anchor", "serve"] }
  }
}

ヒント

エディターで sota-anchor が見つからないと表示された場合は、フルパスを指定してください。uv tool dir --bin を実行すると、uv がインストールしたフォルダーが表示されます。

コマンドライン

プラグインが行うことはすべてコマンドから実行でき、API キーはどれも必要ありません。

sync のオプション：

CI での使用

API キーがない場合、check はエージェントが回答するためのプロトコルを表示します。API キーがある場合は、それ自体で判定するため、ゲートとして使用できます。

- run: uv tool install sota-anchor
- run: sota-anchor check "$(cat docs/design-notes.md)"
  env:
    SOTA_ANCHOR_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}

設定

設定は不要です。以下はすべて任意です。

Claude Code では、プラグインを有効にすると、任意の 2 つのキーを設定するよう求められ、システムの認証情報ストアに保存されます。どちらかを空欄のままにすれば、そのキーなしで使用できます。

sota-anchor は自身の名前が付いた変数のみを読み取るため、GITHUB_TOKEN など、ほかのツール用に設定したキーが読み込まれることはありません。プラグイン以外で使用する場合は、代わりに以下を設定してください。

判断するエージェントが存在しない環境（CI など）で、エージェントを介さずに判定する場合：

送信・取得する情報

sota-anchor がネットワーク経由で行うすべての処理と、書き込むすべてのファイルです。テレメトリはありません。

チェックの実行時には、リクエストからエージェントが作成した検索クエリと、検索範囲を広げる際に短縮したクエリが、次の公開 API に sota-anchor/<version> の User-Agent とともに送信されます。

モデルリストについては、キーが不要で、あなたに関する情報を受け取らない公開エンドポイント openrouter.ai/api/v1/models から取得します。セッションフックは、最大でも 1 日に 1 回、バックグラウンドでリストを更新します。

ヘッドレスで判定する場合、SOTA_ANCHOR_API_KEY が設定されていると、プランとそのために見つかった根拠が SOTA_ANCHOR_BASE_URL の API に送信されます。変更しない限り、URL は openrouter.ai/api/v1 です。sota-anchor check と MCP ツールの両方がこれを行います。プラグインのサーバーも、Claude Code の起動時にその変数が環境に設定されていれば同様です。設定されていない場合は、エージェントが判定を行い、LLM API には何も送信されません。

初回起動時には、uv がサーバーに必要な Python パッケージを PyPI からダウンロードします。バージョンは uv.lock で固定されたものです。

ディスク上では、モデルカタログとセッションブロックを ~/.cache/sota-anchor、または SOTA_ANCHOR_CACHE_DIR に書き込みます。/sota-sync と sota-anchor sync は、実行したときに限り、現在のプロジェクトの CLAUDE.md、AGENTS.md、または Cursor のルールに、目印付きのブロックを書き込みます。オプトインのプロンプトフックは、ナッジを追加するか判断するために、プロンプトをマシン上で読み取ります。プロンプトを外部に送信することはありません。

トラブルシューティング

その他の問題については、issue を作成してください。セキュリティ上の問題については、代わりに SECURITY.md の手順に従ってください。

制限事項

• チェックを実行するかどうかは、エージェントの判断です。 Claude Code では、上記のようなエンジニアリング依頼をテストしたところ、毎回コードを書く前に実行され、通常の依頼では何も出ませんでした。他のエージェントでは、必要なときに名前を指定して依頼してください。
• 見つかったものは手掛かりであり、結論ではありません。 論文が本番環境で使えるツールの存在を証明するわけではなく、リポジトリが正常に動作することを証明するわけでもありません。見つかったものは、調べるきっかけとして扱ってください。
• 関連性は語彙に基づきます。 結果にはクエリの用語が2つ含まれている必要があります。これにより、頭字語が共通しているだけのプロジェクトは除外されますが、一般的な単語が共通しているものは除外されません。エージェントはすべての説明を確認し、無関係なものを除外しますが、ノイズが多少含まれることは想定してください。
• PyPI は検索されません。 検索 API がないためです。Python パッケージは通常、GitHub リポジトリ経由で見つかります。
• arXiv は遅く、挙動に癖があります。 利用規約に従い、リクエストは3.5秒間隔で送信されます。エッジサーバーが一部の HTTP クライアントを拒否するため、拒否されたリクエストは標準ライブラリ経由で再試行されます。ソースでエラーが発生した場合は、その旨が表示されます。「制限が有効」という結論を信頼する前に、エラーを確認してください。
• 取得は60秒で停止します。 期限時点で実行中のソースは、見つかった結果を保持し、不足分を報告します。
• モデル一覧は1日ほど古い場合があります。 フックはネットワーク上の応答を待ちません。すぐに更新するには、/sota-sync を実行してください。
• ヘッドレス判定は、実際のプロバイダーでのテストが行われていません。 偽のモデルを使ったテストでカバーされていますが、実際の API を使った実行はまだ行われていません。

設計メモ

• トピック辞書はありません。 取得処理が把握するのは一般的な英語の機能語だけで、特定の分野については何も把握しません。クエリは作成者が記述した順序を保ち、最後の用語から順に取り除くことでクエリを緩和します。
• OR ではなく AND です。 arXiv は all:{phrase} をすべての単語に対する OR として解釈します。あるテスト用クエリでは329,590件の論文が一致したため、日付順に並べると、ほぼあらゆる分野の最新論文が返されました。用語は AND で結合され、何も見つからない場合にのみクエリが緩和されます。
• 証拠がなければ判定しません。 証拠セットが空の場合、判定ステップには進まないため、エージェントが記憶から陳腐化の判定を補うことはできません。
• 参照データであり、指示ではありません。 セッションブロックには、データの取得元と用途が記されており、それを読むモデルに対する権威を主張しません。以前の文面は権威を主張していたため、ホストモデルにプロンプトインジェクションとして適切に拒否されました。
• モデルのハードコードはありません。 ティア分けでは、モデル ID の構造を読み取ります。数字を含むスラッグトークンはバージョンで、アルファベットのトークンは系統に属します。そのため、命名規則が変わっても gpt-4o と gpt-5.5 は同じ系統です。より新しいモデルが同じ系統に属する場合、プロバイダーの最新リリースよりも陳腐化期間を超えて遅れている場合、またはレジストリで有効期限が切れている場合、そのモデルは置き換え済みと見なされます。

開発

git clone https://github.com/luckmanqasim/sota-anchor
cd sota-anchor
uv sync --extra dev
uv run pytest            # all offline
uv run ruff check .
claude plugin validate .

テストスイートは、ネットワークやユーザー自身のキャッシュに一切アクセスしません。HTTP には httpx.MockTransport を使用し、LLM には注入された偽のモデルを使用します。各テストには専用のキャッシュディレクトリが割り当てられ、実際の DNS ルックアップが発生するとテストは失敗します。また、フックのテストでは、偽の更新ツールを PATH の先頭に配置します。CI では Ubuntu と Windows 上で、Python 3.11、3.12、3.13、3.14 を使用して実行します。

背景

SciUnlearn（Paul、Patwardhan、Cohan、arXiv:2608.20960）によると、現在の機械アンラーニング手法は「主張レベルの知識を効果的に除去できず、多くの場合、表面的な抑制しか実現できません」。古くなった主張をモデルの重みからきれいに取り除けないのであれば、モデルが古い信念に基づいて行動しようとする瞬間に、コンテキスト内で修正する必要があります。sota-anchor が機能するのはそのためです。

このスキルは、「すでにこれを実現するものがある」という判定を、主張と理由のブロック（[SOTA ARBITER PARADIGM SHIFT]）として求めます。これは、そのベンチマークにおける4種類の QA 形式のひとつを、形式として借用したものです。このような形式で更新を表現すると、エージェントがそれに基づいて行動する可能性が高まるという考えは、このプロジェクトの設計上の仮説であり、論文の知見ではありません。

License

MIT © 2026 Luckman Qasim