環境をまたいだ規約の収束

17 の環境、設定がどこに置かれどんな形をとるかについての 17 通りの見解。Apothem の 仕事は、操作者のワークフローをすべての環境で同一に感じさせることです——規約は一度 書くだけで、Claude Code を使おうと Cursor を使おうと Gemini CLI を使おうと、同じように 振る舞います。本稿では、Apothem が調停する 2 つの分岐を扱います。設定フォーマットと 実施面です。

フォーマットの分岐

各環境は、それぞれ異なるファイル形態からルールを読み込みます。Apothem の プロファイルは、操作者の意図を 1 つの中立な形で保持します。各アダプターはその意図を、 自分の環境が期待する形態へとレンダリングします。

フラットな .md 環境はルールをそのまま受け取ります。.mdc 環境は、各ルールの周りに Cursor のメタデータヘッダーを巻く必要があります。単一ファイル環境は、ルールセット全体を 安定した節順序で 1 つのドキュメントへと平坦化する必要があり、それによって操作者は ターゲットを問わず同じ規約を同じ順序で読めます。中立なプロファイルが唯一の真実の 源です。分岐は各アダプターのレンダリング段階にのみ存在します。

節順序が収束のアンカー

多数のルールを 1 つのドキュメントへ平坦化すると、環境間で順序が入れ替わる恐れがあり、 同じ規約が GEMINI.md とは異なる順序で AGENTS.md に落ちてしまいます。Apothem は 順序をプロファイルのレベルで固定します。ルールセットは宣言された並びを持ち、すべての 単一ファイルアダプターはその順序でそれを巡回します。ある環境で「命名規約はコミット 規約より前に来る」と覚えた操作者は、他のどの環境でも同じ並びを見つけます。収束は レンダリングの偶然ではなく——プロファイルが固定する性質です。

実施の分岐

設定フォーマットは目に見える半分です。より難しい半分は実施です。操作者（または エージェント）が行動するその瞬間に、規約をどう責任を持って守らせるかです。

ネイティブな PreToolUse フック

claude-code、codex、qwen-code はネイティブなフック面を公開しています。PreToolUse フックはツール呼び出しが実行される前に発火し、それを検査し、ブロックまたは書き換えます。 これはリアルタイムの実施です。「計画成果物をグローバルな場所に書き込むことを禁ずる」 というルールは、書き込みがディスクに触れる前にそれを拒否するフックになります。Apothem はこれらのフックを環境のフック設定へ直接物化するので、規約は環境のランタイムによって 実施されます。

その他の環境ではラッパーに基づく規律

残りの環境は、Apothem が所有する同等の実行前フック面を公開していません。環境がそのための ソケットを一切提供しないところに、Apothem はランタイムのゲートを設置できません。代わりに、 規約は物化された設定の中の指示テキストとして運ばれます——エージェントはルールを読んで それに拘束されますが、違反する動作を傍受するランタイムの仕組みはありません。Apothem は 等価性が存在するかのように装うのではなく、違いを明示します。フックに支えられた規約と 指示に支えられた規約は同じ保証ではなく、操作者はどの環境がランタイムで実施し、どの 環境が指示による規律に頼るのかを見て取れます。

収束が実際に意味すること

操作者は 1 つの規約を書きます。Apothem はそれを 17 のフォーマットへとレンダリングし、 各環境がサポートする最も強い実施を付与します——面が存在する場所ではネイティブな フック、存在しない場所では指示テキストです。ワークフローは収束し、保証は環境ごとに 正直に述べられます。

だからこそ apothem verify は全体にわたって重要です。ランタイムのフックがドリフトを 捉えられない場所では、操作者は verify を実行して、プロファイルから逸脱した環境設定を 検出します。verify コマンドは、ネイティブな実施を欠くすべての環境にとっての収束の バックストップです。

各環境の実施面は 環境 で、アダプターの仕組みは アダプター設計の詳細解説 で読めます。