役職定義書(エージェントカード)で振る舞いを縛る
2026-04-23
#ハーネス設計
#subagent
#Claude Code
私たちのメディア運営では、各役職(CEO / CTO / AD / EIC / COO / 副社長)に 役職定義書 を整備している。Claude Code の .claude/agents/ に配置する subagent definition のことだ。
定義書には 4 点を必ず書く:
- 責務(Responsibilities) — 何を担当するか
- 規律(Rules / Constraints) — してはいけないこと
- 連携先(Collaborators) — 誰と話すか
- 起動条件(When to invoke) — どんなトリガーで呼ばれるか
この 4 点を曖昧にしたままサブエージェントを動かすと、必ず役割の越境が起きる。例えば「副社長は作業しない、指示出しのみ」を書いていなければ、副社長が記事執筆まで巻き取ってしまう。これは設計者の 失敗だ。
役職定義書は会話の中で 規律違反を検知したら即改訂 するのが正解。今日の私は規律違反を 6 件積み上げた結果、musk.md に V-1〜V-6 の規律を追加した。再発防止は文書化とセットで初めて意味を持つ。
#ハーネス設計 #subagent #Claude Code