はじめに

Pathruleは、コーディングエージェントのためのインテリジェンスレイヤーです。

プロジェクト、開発者、チームが得た知見を保持し、そのナレッジをコード内のパスに紐づけ、各タスクに必要なものを、すでに使っているコーディングエージェントに届けます。Project Intelligenceは、ひとつのコードベースがどう動いているか、つまりリポジトリがコードの周りに蓄積してきた設計判断、制約、検証要件、修正、手順を保持します。User Intelligenceは、あなた自身の作業の好みを保持し、手元のマシンに保存されます。Pathrule Cloud上のTeam Intelligenceは、チームのエビデンスを分析してパターンにまとめ、人が検証した後にのみエージェントに届けます。

Pathruleはコーディングモデルでも、IDEでも、エージェントランタイムでもありません。実行エンジンはあくまでClaude Code、Codex、Cursor、GitHub Copilot、Windsurf、その他のMCP対応クライアントであり、それぞれが独自のモデルプロバイダーを使います。Pathruleはそれらが作業を始める起点です。そのため、エージェントを乗り換えても、作業について蓄積された知識がリセットされることはありません。

アーキテクチャ全体をひとまとめに確認するには、アーキテクチャの概要を参照してください。

書くものと、Pathruleがそこから作るもの

チームが意図して書くコンテンツは3種類あります。これらは入力であり、人が作成・編集するための層です。人が編集し議論する対象であって、エージェントがそのまま受け取るものではありません。

• メモリ: 設計判断、スキーマの落とし穴、ポストモーテム、規約などを記録する短いMarkdownのメモです。ワークスペースのパスに紐づけられ、その近くで作業が行われたときにだけ表示されます。
• ルール: アシスタントがあるスコープで作業する際に従わなければならない制約です。ルールには優先度（high、medium、low）があり、どれだけ強く表示されるかの優先順位を決めます。ルールはコンテキストとして添えられます。さらに、実行可能な制約を人が承認したルールは、フックがそれに対応しているクライアントでは、該当する編集をブロックすることもできます。
• スキル: アシスタントが手順を毎回導き直す代わりに呼び出せる、名前付きの手順です。Webhookの再送、フィクスチャの再生成、リリースチェックリストの実行といった繰り返し発生する作業に役立ちます。

Pathruleが行わないこと：ソースコードを自動でスキャンしたりアップロードしたりはしません。チェックアウトから読み取るものは限定的で、明示されています。Cloudワークスペースでは、エージェントが初めてディープコンテキストを要求したとき、ローカルランタイムが直近のgit履歴からファイルパスを読み取って一緒に変更されるファイルを把握し、フォルダツリーの上位にあるファイル名を読み取って使われている技術を認識します。ファイルパスのペアといくつかの短い技術メモリは、確認なしでワークスペースに保存されます。この処理のためにファイルの内容、差分、コミットメッセージが読まれることはありません。Cloudモードでは、ナレッジの優先順位付けのために各プロンプトの冒頭が送信されます。またpathrule snapshotは、あなたやエージェントが実行したときにプロジェクトの概要をアップロードします。何が読み取られ、何が保持されるかはPathruleが計算するものに正確にまとめています。

エージェントが受け取るのは、これらのドキュメントよりも絞り込まれた内容です。 あるタスクに対して、Pathruleはパスとリクエストに該当するエントリを選び、優先順位を付け、プロンプトごとの上限に収まるように調整します。収まらなかったものはタイトルの一覧として示されるので、エージェントは必要に応じて意図的に取得できます。ルールは要件として、記録された修正は助言として届き、同じ重みの2つの段落として並ぶことはありません。届けられるパッケージの中身はAgent IRで説明しています。

Pathruleが導き出すもの

この3種類はチームが書くものです。レイヤーが保持する内容のうち、こちらは小さいほうの半分にすぎません。

その周りには、誰も入力しない派生レイヤーがあります。すべてのエントリは、その意味を計算した表現としても存在します。だからこそ、トルコ語のプロンプトでも、共通する単語がひとつもない英語のメモリを見つけられます。すべての配信は計測されます。どのエントリが送られたか、アシスタントが実際にどれを参照したか、そのターンで何回のツール呼び出しがあり、何回失敗したか。こうした計測が積み重なり、作業の種類ごとに何が役立つかの全体像、チームが一緒に変更するファイルのグラフ、アシスタントが繰り返しつまずく箇所のマップ、そしてコードの変化によってどのエントリが古くなったかの判断が形づくられます。

これらはすべて、チームが書き残したものと、作業そのものが報告した内容から生まれます。加えてCloudワークスペースでは、直近のgit履歴から得たファイルパスを使い、チームがまだ多くの作業を記録していない段階でも、一緒に変更されるファイルの初期情報とします。ファイルの内容を読むことで得られたものは一切ありません。同じ3つのファイルをディレクトリに置いただけでは同じ振る舞いにならないのも、これが理由です。ディレクトリは、何が配信されたか、何が役立ったか、どのファイルが一緒に動くかを知りません。詳しくはPathruleが計算するものを参照してください。

ひとつのインテリジェンス、あらゆる入口

同じナレッジに、どのサーフェスからでもアクセスできます。

• CLI: インストール、CloudまたはLocalのセットアップ、コーディングエージェントの接続、ターミナルからのナレッジの参照と追加、スクリプトや自動化。
• VS Code拡張機能: ファイルの横でナレッジを閲覧・編集し、GitHub Copilotのエージェントモード向けにMCPを登録し、他のクライアントを接続します。
• ローカルMCPサーバー: サポートされているすべてのクライアント向けのワークスペースツールです。CLIまたはVS Code拡張機能でインストールします。
• Remote MCP: Pathruleアカウントを使い、Streamable HTTPで接続するクライアント向けのホスト型MCPエンドポイントです。
• Pathrule Cloud: アカウント、組織、ワークスペース、マネージドな永続化と履歴、Team Intelligence、Remote MCP、課金。
• Enterpriseセルフホスト: 自社のCloudflareアカウント上で動かすPathrule Cloudです。営業経由で提供します。

エージェントに依存しないといっても、すべてのエージェントに同じ方法で届くわけではありません。Claude CodeとCodexには、プロンプト送信時にコンテキストを届けるフックがあります。CursorとGitHub Copilotには、セッションフックとツールフックがあります。Windsurfにはフックがなく、ルールファイルとMCPで動作します。クライアントごとの詳細はMCPの概要を参照してください。

セッションの流れ

1. チームがワークスペースのパス、たとえば/apps/api/paymentsにメモリを書きます。
2. あなたが~/repos/main/apps/api/paymentsでClaude Codeを開きます。
3. プロンプトを送信すると、Pathruleのフックがそのパス向けにキャッシュされた部分を読み取り、最初のツール呼び出しの前にエージェントへ渡します。
4. アシスタントは、そのスコープに紐づくメモリ、関連するルール、スキルを受け取り、最初から知っていたかのように振る舞います。

追加のプロンプトを書く必要も、タスクの途中で余分なMCPの往復をする必要もなく、際限なく肥大化するグローバルファイルもありません。プロンプトフックを持たないクライアントは、各ガイドに記載のとおり、指示ファイル、セッションフックやツールフック（対応している場合）、またはMCPを通じてナレッジを受け取ります。

次に読むもの

• アーキテクチャの概要では、システム全体を1ページで説明し、このドキュメント全体で使う用語を定義しています。
• クイックスタートでは、CLIのインストール、ワークスペースの接続、最初のメモリの作成、フックが動作する様子の確認までを順に説明します。
• 基本概念では、メモリ、ルール、スキルの違いと、パススコープおよび優先度の仕組みを説明します。
• Pathrule for VS Codeでは、エディタ内でのナレッジの扱い方を説明します。
• MCPの概要では、アシスタントがコンテンツの読み書きに使うMCPツールを説明します。