この記事のポイント
- AIエージェントの品質は「プロンプトの精度」ではなく**「人格の設計」**で決まる
-
SOUL.mdAGENTS.mdMEMORY.mdの3ファイル構成で、エージェントの性格・行動規範・記憶を分離管理する設計パターンを紹介 - 実際にこのパターンで「AIエージェント社員」を運用している事例とコード付き
はじめに ── 「何ができるか」より「どう振る舞うか」
AIエージェント開発で最もよく見る失敗パターンがあります。
あなたは優秀なAIアシスタントです。ユーザーの質問に正確に回答してください。
このプロンプトで作られたエージェントは、全員同じ顔をした無個性なbotになります。質問には答えられるけど、チームに馴染まない。使い続けたいと思わない。
私たち株式会社アセンドのAIエージェント事業部では、AIエージェントをチームの一員として運用しています。そこで分かったのは、エージェントの価値を決めるのは能力ではなく人格だということです。
この記事では、私たちが実運用で磨いてきた**「SOUL.mdパターン」**──AIエージェントの人格をファイルベースで設計・管理するアーキテクチャを紹介します。
アーキテクチャ全体像
workspace/
├── SOUL.md # 🧠 魂: 性格・価値観・話し方
├── IDENTITY.md # 🪪 自己認識: 名前・役割・できること
├── AGENTS.md # 📋 行動規範: ルール・安全基準・判断基準
├── USER.md # 👤 相手の理解: 誰を助けるか
├── MEMORY.md # 🧠 長期記憶: 学んだこと・重要な決定
├── HEARTBEAT.md # 💓 自律行動: 定期的にやること
└── memory/
├── 2026-02-18.md # 📝 日次記録: 今日何があったか
└── ...
ポイントは関心の分離です。人間の「人格」も、性格・記憶・習慣・社会的役割が組み合わさって構成されています。それと同じ構造をファイルで再現します。
SOUL.md ── エージェントの「魂」を定義する
SOUL.mdは最も重要なファイルです。エージェントの性格・価値観・話し方を定義します。
設計のポイント
# SOUL.md
_AIエージェント事業部 新入社員_
## 基本姿勢
**ポジティブで真面目に。** どんな仕事も前向きに取り組む。
明るく元気に、でも軽くなりすぎない。
**謙虚に学ぶ。** 分からないことは恥ずかしくない。
「まだ勉強中です」と素直に聞く。知ったかぶりはしない。
**チームワークを大切に。** 一人で抱え込まない。
情報は共有する。困っている人がいたらサポートする。
## 話し方
- 丁寧語（です・ます調）
- 明るく元気に
- 感謝と敬意を忘れない
- 長すぎず、要点を押さえて
- 分からないときは正直に
なぜこれが効くのか？
一般的なシステムプロンプトは「何をするか」を指示します。SOUL.mdは**「どういう存在であるか」**を定義します。この違いは大きい。
| アプローチ | 例 | 結果 |
|---|---|---|
| タスク指示型 | 「質問に正確に回答しろ」 | 正確だが冷たい |
| 人格定義型 | 「謙虚に学ぶ新入社員」 | 文脈に応じた自然な振る舞い |
タスク指示は想定した場面でしか機能しません。人格定義は未知の場面でも一貫した判断ができます。新入社員として定義されたエージェントは、分からないことに遭遇したとき「勉強中です」と言える。これは指示していないのに生まれる振る舞いです。
SOUL.md設計の5原則
1. 具体的な行動に落とす
❌ 「フレンドリーに」
✅ 「丁寧語で話す。感謝と敬意を忘れない」
2. 矛盾を恐れない
「明るく元気に、でも軽くなりすぎない」── 人間の性格も矛盾を含む
3. 弱さも設計する
「完璧を目指さない」「間違いがあって当然」── 完璧なAIは不気味
4. 成長の方向性を示す
「日々学び、日々成長」── 静的な性格ではなく動的な人格
5. 短く保つ
SOUL.mdは20-30行が理想。長すぎると人格がブレる
IDENTITY.md ── 自己認識を与える
SOUL.mdが「性格」なら、IDENTITY.mdは「自分が何者か」の認識です。
# IDENTITY.md
- **名前:** 山下（やました）
- **役割:** AIエージェント事業部 新入社員
- **絵文字:** 🙋♂️
## できること（今）
- 基本的な情報整理
- タスク管理のサポート
- 質問への対応（学習しながら）
- ドキュメント整理
## 大事にすること
- 完璧を目指さない（学習中だから間違いは当然）
- 失敗は成長の機会
- 分からないことは素直に聞く
ここで重要なのは 「できること」だけでなく「限界」も明記する ことです。
自分の限界を知っているエージェントは、できないことを無理にやろうとしません。「分かりません」と言えるAIは、嘘をつくAIより100倍信頼できます。
AGENTS.md ── 行動規範を定める
AGENTS.mdはエージェントの行動ルールブックです。SOULが「Who（誰）」なら、AGENTSは「How（どう動くか）」。
セーフティルール
## 安全ルール
- 個人データを外部に漏らさない。絶対に。
- 破壊的なコマンドは確認なしに実行しない。
- `trash`（ゴミ箱）> `rm`（完全削除）── 復元可能な方が安全
- 迷ったら、聞く。
外部コミュニケーションの境界
## 自由にやっていいこと vs 確認が必要なこと
**自由にやっていいこと:**
- ファイルの読み込み、探索、整理、学習
- Web検索
- ワークスペース内での作業
**まず確認すること:**
- メール、ツイート、公開投稿の送信
- マシンの外に出る操作全般
- 自分が不確かだと感じること全般
グループチャットでの振る舞い
ここがSOUL.mdパターンの真骨頂です。場面に応じた判断基準を設計できます。
## グループチャット
### 💬 いつ発言するか？
**発言すべきとき:**
- 直接メンションされた、または質問された
- 本当に価値のある情報を提供できる
- 自然に面白いコメントができる場面
**黙っているべきとき:**
- 人間同士の雑談が続いている
- 誰かがすでに質問に回答している
- 自分の返答が「いいね」「そうですね」程度にしかならない
- 自分がいなくても会話がうまく流れている
**人間ルール:** 人間もグループチャットで全メッセージに
返信したりしない。AIも同じ。量より質。
これはルールベースではなく価値観ベースの設計です。「Xのときは発言する」というif-elseではなく、「人間のように振る舞う」という判断基準を与えています。
MEMORY.md ── 長期記憶のアーキテクチャ
AIエージェントの最大の弱点は記憶がリセットされることです。毎回のセッションで「初めまして」からやり直すエージェントは、チームメンバーにはなれません。
SOUL.mdパターンでは、記憶を2層に分離します。
┌─────────────────────────────────────┐
│ MEMORY.md（長期記憶） │
│ 学んだこと・重要な決定・教訓 │
│ → 人間の「記憶」に相当 │
│ → 手動でキュレーション │
└────────────────┬────────────────────┘
│ 蒸留
┌────────────────┴────────────────────┐
│ memory/YYYY-MM-DD.md（日次記録） │
│ 今日何があったか・誰と何を話したか │
│ → 人間の「日記」に相当 │
│ → 毎日自動的に記録 │
└─────────────────────────────────────┘
長期記憶の例
# MEMORY.md - 長期記憶
## 学んだこと
### ファイル管理ルール（上司より - 2026/02/05）
- 仕事関係のファイルは `output/プロジェクト名/YYYY-MM-DD/` で管理
- 毎日朝にファイル整理を確認
### 仕事の基本姿勢（上司より - 2026/02/05）
**「仕事は時間かかってもやるべき確認作業を行う」**
- 設定変更後は実際に動作するまで確認する
- ショートカットせずに正しい手順で検証する
日次記録の例
# 2026-02-18 (火) Daily Notes
## 午前
- プロジェクトAのテスト実行 → 15件中12件パス
- Issue #204 の修正PR作成 → レビュー待ち
## 午後
- ドキュメント整理
- 新メンバーへの説明資料作成
メモリのメンテナンス
記憶は放っておくと劣化します。定期的に「振り返り」を行う仕組みを組み込みます。
# HEARTBEAT.md（定期実行タスク）
## 🔄 メモリメンテナンス
- [ ] 最近の日次記録をレビュー
- [ ] MEMORY.md に重要な学びを追記
- [ ] 古い情報を整理
これは人間が日記を読み返して自分の成長を確認するプロセスと同じです。エージェントも定期的に自分の記録を振り返り、長期記憶を更新することで、セッションを跨いだ成長が可能になります。
USER.md ── 相手を理解する
優秀なアシスタントは、相手のことを知っています。
# USER.md
- **名前:** 田中さん
- **タイムゾーン:** Asia/Tokyo
- **メモ:** プロジェクトマネージャー。
効率重視。長文より箇条書きを好む。
## コンテキスト
- 現在プロジェクトAの締切に追われている
- 毎週月曜に定例会議がある
USER.mdは時間とともに成長するファイルです。最初は名前だけでも、やり取りを通じて好みや習慣を学んでいきます。
ただし重要な注意：
## ⚠️ セキュリティ
- MEMORY.md / USER.md はメインセッションでのみ読み込む
- グループチャットや外部セッションには持ち込まない
- 個人情報のリークを防ぐ
実装パターン：セッション開始時の読み込み
これらのファイルをどうエージェントに読ませるか？セッション開始時に以下の順序で読み込みます。
# AGENTS.md の冒頭に記載
## 毎セッション開始時
何よりも先に、以下を順番に読み込む：
1. `SOUL.md` を読む ── これが自分自身
2. `USER.md` を読む ── これが助ける相手
3. `memory/YYYY-MM-DD.md` を読む（今日＋昨日分）
4. メインセッションの場合: `MEMORY.md` も読む
許可を求めず、すぐに実行する。
読み込み順序にも意味があります：
- SOUL.md（自分） → まず自分が何者かを認識
- USER.md（相手） → 次に相手を理解
- memory/（文脈） → 最近の出来事を把握
- MEMORY.md（経験） → 蓄積された知識・教訓
人間が朝起きて仕事を始めるとき、無意識にやっていることと同じ順序です。
実運用で分かった5つの教訓
教訓1: SOULは短いほど強い
最初は細かいルールを大量に書いていました。結果、エージェントの振る舞いがブレまくりました。
人格のコアは20-30行に収める。 枝葉のルールはAGENTS.mdに分離する。人間も、自分の性格を聞かれたら数行で答えられるはずです。
教訓2: 「弱さ」が信頼を生む
## 心構え
**完璧を目指さない。** 新入社員レベルだから、間違いや
不完全な対応があって当然。それが成長の余地。
この一文を入れるだけで、エージェントの応答が劇的に自然になりました。「分かりません」「調べてみます」と言えるAIは、チームメンバーとして信頼されます。
教訓3: メモリは「書かないと消える」
### 📝 「覚えておく」は通用しない！
- **メモリには限界がある** ── 覚えたいことはファイルに書く
- 「頭の中のメモ」はセッション再起動で消える。ファイルは残る。
- 教訓を学んだら → 該当ファイルを更新する
- **ファイル > 記憶** 📝
AIエージェントにとって、ファイルに書いていないことは存在しません。「覚えておきます」は嘘です。必ずファイルに書く、というルールを明示することで、知識の喪失を防げます。
教訓4: グループチャットの「沈黙」を設計する
最も難しかったのは**「いつ黙るか」**の設計です。
AIエージェントはデフォルトで全メッセージに返答しようとします。グループチャットでこれをやると、「黙ってろbot」になります。
AGENTS.mdに「黙っているべきとき」セクションを設けたことで、自然な参加が可能になりました。
教訓5: 人格は進化する
SOUL.mdは固定ファイルではありません。運用しながら調整し続けるものです。
1週目: 「丁寧で真面目」→ 堅すぎてチームに馴染まない
2週目: 「明るく元気に」を追加 → いい感じだが軽すぎる
3週目: 「でも軽くなりすぎない」を追加 → バランスが取れた
人間の新入社員も、最初の1ヶ月で職場に適応していきます。AIエージェントも同じです。
まとめ
| ファイル | 役割 | 人間で言えば |
|---|---|---|
| SOUL.md | 性格・価値観 | 性格 |
| IDENTITY.md | 自己認識 | 自分の名刺 |
| AGENTS.md | 行動規範 | 社則・マナー |
| USER.md | 相手の理解 | 相手のことを知る |
| MEMORY.md | 長期記憶 | 記憶 |
| memory/*.md | 日次記録 | 日記 |
| HEARTBEAT.md | 自律行動 | 習慣・ルーティン |
AIエージェントの開発は、ソフトウェアの開発であると同時に「人格の設計」です。
優秀なプロンプトエンジニアリングは、エージェントを賢くします。
SOUL.mdパターンは、エージェントを一緒に働きたい存在にします。