全エージェントに指示を配る

ワークスペースで動くすべてのエージェントに、配備の運用者からの方針（フリート方針）を毎回読ませられます。 禁止事項や、この環境でエージェントが気づかずに踏む落とし穴を、ここに書きます。

全体像

あなたがやること	エージェントがやること
workspace/workspace-notes.md に方針を書き、ワークスペースのイメージをビルドし直す	セッションの始まりに、毎回方針を読む
長い手順は workspace/notes/<トピック>.md に書き、方針の末尾の索引に 1 行足す	その場面に来たときに、該当するトピックのファイルを読む

届く場所

方針はイメージに焼き込まれ、各コンテナに配られます。

エージェント	読む場所
claude	/etc/claude-code/CLAUDE.md（managed policy）。セッションのたびに読みます
codex・opencode・agy・copilot・kiro	起動のたびに、同じ本文が各自の指示ファイルに合成されます
cursor	届きません

トピックのファイルは、コンテナでは /usr/local/share/agent-fleet/notes/ に置かれます。 claude・codex・opencode には、Workspace Agent が起動のたびに各トピックを af-<トピック> という名前のスキルとしても登録します。 CLI のスキルの仕組みがその本文へのもう 1 つの道になります。ほかのエージェントは、索引だけが道です。

書く

本体とトピックのファイルの 2 層に分けて、本体を短く保ちます。

書く場所	書くもの
本体（workspace-notes.md）	必要になる前に知っていなければならないことだけ。してはいけないこと（リポジトリを消す、認証情報を平文で書く）、この環境の制約（root がない、Docker がない、メモリを共有している）、ブランチの扱いなど
トピックのファイル	それ以外の手順。本体の索引の 1 行で見つかるようにします

注意

本体の長さは、そのまますべてのセッションのコンテキストの費用になります。 すべてのエージェントが毎回読むので、増やす前に「本当に全員が毎回必要か」を確かめてください。 トピックのファイルは、読まれるまで費用がかかりません。

反映する

1. workspace/workspace-notes.md（またはトピックのファイル）を編集します
2. ワークスペースのイメージをビルドし直します
3. 各メンバーがワークスペースを作り直すか、次にコンテナが作られたときから効きます

メンバーの指示との関係

メンバーが自分で書き足す指示は、この層ではありません。各自の ⚙設定 →「エージェントへの指示」で書きます。 フリート方針とぶつかったときは、フリート方針が優先されます（作業のしかたを一度だけ書いておく）。

関連

• アップグレードする：イメージを入れ替える流れ