比較
Apothem と手作業の Zed 構成の比較
Zed の扁平な .rules 指示ファイルを手作業で維持するのと、Apothem の共有プロファイルから生成するのとの比較。
Zed はプロジェクトルートにある単一の扁平な .rules ファイルからエージェント指示を
読み込みます（AGENTS.md / CLAUDE.md 系列の隣）。Apothem の zed アダプターは
そのファイルを共有プロファイルから生成します。本ページは、その構成を手作業で維持
するのと Apothem で管理するのとを対比します。
労力の比較
| タスク | 手作業の構成 | Apothem 管理 |
|---|---|---|
| 指示を書く | .rules ファイルを手で書く | 共有コーパスからレンダリング |
以前の .rules を保持する | 自分でわきへコピーするのを忘れないようにする | アダプターが、置き換え前に既存ファイルをバックアップする |
| ルールを他のハーネスと揃えて保つ | 手作業、ツールごと | apothem update で自動 |
| 再利用可能なスキルとコマンドを共有する | 各スキルフォルダーを ~/.agents/skills/ へ手でコピーし、コピーを最新に保つ | アダプターが ~/.agents/skills/ に書き込み、すべてのプロジェクトで 1 つのコピーを共有し、apothem update で更新 |
| 構成が正しいか検証する | 手作業での確認 | apothem verify --harness zed --project <path> |
Apothem が管理するもの
zed アダプターは共有ルールをプロジェクトルートの扁平な .rules ファイルへ生成します。
Zed には PreToolUse フックがないため、ガードレールの意図はツール呼び出しの傍受点では
なくルール本文の中に存在します。グローバルの ~/.config/zed/AGENTS.md 指示ファイルと
.zed/settings.json の MCP コンテキストサーバーブロックはオペレーター所有であり、
手を加えられません。共有ルールへの変更はすべて、次の apothem update 時にファイルを
再生成します。
移行手順
- まだ作成していなければ、
apothem profile initを実行して共有プロファイルを作成します。 - 既存の
.rulesの指示（および共有したいプロジェクト固有のAGENTS.mdの内容）を、共有コーパスへ移します。 apothem install --harness zed --project <path>を実行して.rulesファイルをレンダリングします。以前の.rulesは、先にバックアップされます。apothem verify --harness zed --project <path>を実行して、構成が配置されたことを確認します。- 以降の変更には毎回
apothem update --harness zed --project <path>を使います。