ガーボル・メサーロシュ(Gábor Mészáros)はSeptember 16, 2026、コーディングエージェントのプロジェクト指示は、関連するタスク、パス、タイミングでだけ読み込まれる方がうまく機能すると主張する開発者向け記事を公開した。初期のAGENTS.md構成では、プロジェクトのルートと入れ子になったフォルダに指示ファイルを置き、コードベースの一部にルールを結び付けることで、エージェントがその場所で作業する時だけ目にする形にしていたという。メサーロシュは、バックエンドとフロントエンドの作業が重なる場合、この方式でも「コンテキストの劣化」問題が残ると述べる。異なる領域の指示が、モデルの注意を奪い合うからだ。

記事によると、CursorとClaudeはその後、より細かなパス設定を加え、散在するAGENTS.mdやCLAUDE.mdだけに頼らず、ファイル単位で指示をスコープできるようにした。メサーロシュは、ファイル単位のスコープ指定は狙いを絞る点で有効だが、「すべてを読み込む」ことのコストは残るため、より広い読み込み問題は解決しないと指摘する。彼は、常時読み込まれるCLAUDE.mdの典型例として「three hundred lines」を挙げる。必要な時だけ現れるのではなく、すべてのルールが毎ターン、モデルのコンテキストに残り続ける構図である。

メサーロシュは、この問題をストレージやトークン費用ではなく、注意の配分として捉える。モデルは指示をチェックリストのように処理するのではなく、限られた注意をコンテキストウィンドウ全体に広げるという。彼の例では、「ten rules」なら各ルールに見えるだけの比重があるが、「a hundred」になると、そのターンで必要なルールが「ninety-nine」の無関係なルールと競合する。Reporailsによる「28,721 real repositories」の分析では、指示ファイルの中央値は「about fifty items」で、そのうち実際の指示は「only a dozen」だった。残りの項目も、毎ターン注意を占有していた。

メサーロシュはプログレッシブ・ディスクロージャーを、関連する指示とコンテキストをコーディングエージェントへ段階的に渡す方法と定義する。記事は、この方法を3つの制御に分ける。何を読み込むか、どこで読み込むか、いつ読み込むかだ。「何を読み込むか」は、`git`作業が始まった時に現れるコミット規約のように、ルールをスキルとしてまとめることを意味する。「どこで読み込むか」は、決済コードでだけ表示される決済ルールのように、フォルダやファイルにルールを結び付けることを指す。「いつ読み込むか」は、セッション開始時、または特定の種類の作業が始まった時にルールを発火させることを意味する。

記事はClaude 5世代向けのAnthropicのガイダンスを引用し、タリク・シヒパー(Thariq Shihipar)が、指示ファイルを既知の実践すべてを集める中央リポジトリとして使うことに警告し、チームに「use progressive disclosure heavily」と助言したと伝える。メサーロシュによれば、プログレッシブ・ディスクロージャーはルールの文言を変えるものではない。エージェントがそのルールをいつ保持しなければならないかを変える。目標は、軽量なルートファイルと、合図に応じて現れるルールの組み合わせだ。その結果、あるターンで必要なルールは、コンテキスト内で「one of a hundred」ではなく「one of three」になる。

メサーロシュは、1つの大きなファイルを分割すると、単一の文書をスクロールするだけでは理解できないシステムが生まれると述べる。チームは、どのルールが実際に読み込まれるのか、スコープが狭すぎないか、同じターンで2つのルールが衝突しないか、矛盾するルールがないかを把握する必要がある。シリーズの続きでは、何を読み込むか、ルールをどこにスコープすべきか、静的ページからイベントへ移すべきタイミングを検討するという。Reporailsは、コーディングエージェントの実行中に触れることなく、ローカルで作成されたファイルを読み取り、どのルールが読み込まれ、どこで衝突が起きるかを示せるとも説明している。

ガーボル・メサーロシュ(Gábor Mészáros)はSeptember 16, 2026、コーディングエージェントのプロジェクト指示は、関連するタスク、パス、タイミングでだけ読み込まれる方がうまく機能すると主張する開発者向け記事を公開した。初期のAGENTS.md構成では、プロジェクトのルートと入れ子になったフォルダに指示ファイルを置き、コードベースの一部にルールを結び付けることで、エージェントがその場所で作業する時だけ目にする形にしていたという。メサーロシュは、バックエンドとフロントエンドの作業が重なる場合、この方式でも「コンテキストの劣化」問題が残ると述べる。異なる領域の指示が、モデルの注意を奪い合うからだ。

記事によると、CursorとClaudeはその後、より細かなパス設定を加え、散在するAGENTS.mdやCLAUDE.mdだけに頼らず、ファイル単位で指示をスコープできるようにした。メサーロシュは、ファイル単位のスコープ指定は狙いを絞る点で有効だが、「すべてを読み込む」ことのコストは残るため、より広い読み込み問題は解決しないと指摘する。彼は、常時読み込まれるCLAUDE.mdの典型例として「three hundred lines」を挙げる。必要な時だけ現れるのではなく、すべてのルールが毎ターン、モデルのコンテキストに残り続ける構図である。

メサーロシュは、この問題をストレージやトークン費用ではなく、注意の配分として捉える。モデルは指示をチェックリストのように処理するのではなく、限られた注意をコンテキストウィンドウ全体に広げるという。彼の例では、「ten rules」なら各ルールに見えるだけの比重があるが、「a hundred」になると、そのターンで必要なルールが「ninety-nine」の無関係なルールと競合する。Reporailsによる「28,721 real repositories」の分析では、指示ファイルの中央値は「about fifty items」で、そのうち実際の指示は「only a dozen」だった。残りの項目も、毎ターン注意を占有していた。

メサーロシュはプログレッシブ・ディスクロージャーを、関連する指示とコンテキストをコーディングエージェントへ段階的に渡す方法と定義する。記事は、この方法を3つの制御に分ける。何を読み込むか、どこで読み込むか、いつ読み込むかだ。「何を読み込むか」は、`git`作業が始まった時に現れるコミット規約のように、ルールをスキルとしてまとめることを意味する。「どこで読み込むか」は、決済コードでだけ表示される決済ルールのように、フォルダやファイルにルールを結び付けることを指す。「いつ読み込むか」は、セッション開始時、または特定の種類の作業が始まった時にルールを発火させることを意味する。

記事はClaude 5世代向けのAnthropicのガイダンスを引用し、タリク・シヒパー(Thariq Shihipar)が、指示ファイルを既知の実践すべてを集める中央リポジトリとして使うことに警告し、チームに「use progressive disclosure heavily」と助言したと伝える。メサーロシュによれば、プログレッシブ・ディスクロージャーはルールの文言を変えるものではない。エージェントがそのルールをいつ保持しなければならないかを変える。目標は、軽量なルートファイルと、合図に応じて現れるルールの組み合わせだ。その結果、あるターンで必要なルールは、コンテキスト内で「one of a hundred」ではなく「one of three」になる。

メサーロシュは、1つの大きなファイルを分割すると、単一の文書をスクロールするだけでは理解できないシステムが生まれると述べる。チームは、どのルールが実際に読み込まれるのか、スコープが狭すぎないか、同じターンで2つのルールが衝突しないか、矛盾するルールがないかを把握する必要がある。シリーズの続きでは、何を読み込むか、ルールをどこにスコープすべきか、静的ページからイベントへ移すべきタイミングを検討するという。Reporailsは、コーディングエージェントの実行中に触れることなく、ローカルで作成されたファイルを読み取り、どのルールが読み込まれ、どこで衝突が起きるかを示せるとも説明している。