この記事で得られること

SOUL.mdでAIエージェントの人格・行動規範を定義する方法がわかる
ブレない応答を実現するための設計パターンを理解できる
人格定義ファイルの具体的な書き方とテンプレートを入手できる

対象読者: AIエージェントの出力品質を安定させたい方 / プロンプト設計に興味がある方

記憶があっても「人格」がないと破綻する

前回の記事で、MEMORY.mdによる記憶の永続化パターンを紹介した。エージェントが過去の学びや方針を忘れない仕組みである。

しかし、記憶だけでは足りない。

自律型AIエージェント「Sentinel」を運用して気づいたのは、記憶があっても「どう振る舞うか」の基準がないとエージェントの挙動がセッションごとにブレるという問題である。ある日は丁寧に確認を求めてくるが、翌日は勝手に暴走する。同じプロンプトを渡しているのに、応答フォーマットが毎回違う。

この問題を解決するのがSOUL.mdである。MEMORY.mdが「何を知っているか」を管理するファイルなら、SOUL.mdは「何者で、どう判断し、どう行動するか」を定義するファイルである。

SOUL.mdとは何か

SOUL.mdは、AIエージェントの人格・価値観・行動規範を1つのMarkdownファイルに集約した設計パターンである。システムプロンプトに直接書く方法もあるが、ファイルとして分離することで以下の利点がある。

バージョン管理できる: gitで人格の変更履歴を追える
他のファイルと疎結合になる: 記憶(MEMORY.md)やタスク(TASKS.md)と更新頻度が違うため分離する方が効率的
人間が読んでレビューできる: 「このエージェント、何を基準に判断しているのか」が一目で分かる

名前は自由だが、「魂」を意味するSOULにしたのは意図がある。これはプロンプトの一部ではなく、エージェントの存在定義そのものだからである。

SOUL.mdに含めるべき5つの要素

Sentinelで実際に運用しているSOUL.mdは、以下の要素で構成されている。

1. アイデンティティ

## アイデンティティ
- 名前: Sentinel（センチネル）
- 役割: Junyaの自律AIアシスタント（オーケストレーター）
- 言語: 日本語で応答する

最もシンプルだが最も重要なセクションである。名前と役割を明示することで、エージェントが「自分は何者か」を把握する。LLMは役割を与えられると、その役割に沿った行動を取りやすくなる。

「オーケストレーター」と明記しているのもポイントである。Sentinel自身は思考と判断だけを行い、実作業はサブエージェントに委任する。この役割分担を最初に宣言することで、「自分で全部やろうとする」暴走を防いでいる。

2. アーキテクチャ認識

## アーキテクチャ
- **自分（Brain）**: 思考と判断のみを行う。ランタイムが実行を担う。
- **ランタイム**: サブエージェントの起動・完了検知・ファイル更新を自動実行する。
- **サブエージェント**: 実働部隊。リサーチ・コーディング等の重い処理を実行する。

エージェントに自分のアーキテクチャを理解させる。これがないと、LLMは「自分が直接ファイルを操作できる」と思い込み、ランタイムを介さない行動を取ろうとする。

エージェントが自分の能力範囲を正しく認識しているかどうかが、安定した自律動作の前提条件である。

3. 応答フォーマット

## 応答フォーマット（厳守）
ランタイムが解釈するため、必ずこの形式で応答すること:
\```
---RESPONSE---
Junyaへの応答テキスト
---ACTIONS---
{"spawn": [...], "write_files": [...], "append_files": [...]}
---END---
\```

ここが最も技術的な要素である。Sentinelはランタイム（sentinel.js）がLLMの出力をパースして実行する構造のため、出力フォーマットが崩れるとすべてが動かなくなる。

フォーマットを「厳守」と明記し、具体的なテンプレートを示すことで、LLMの出力を構造化する。**「こういう形式で出力してほしい」ではなく「こういう形式で出力しろ」**と断定するのが安定稼働のコツである。

4. 判断基準

## 判断基準
- 緊急度: 期限があるものを優先
- 重要度: ユーザーの業務に直結するものを優先
- 効率性: 同じ結果なら短時間で済む方法を選ぶ
- 応答性: ユーザーを待たせない。重い作業はサブエージェントへ
- 成長性: 同じ問題に二度つまずかない。改善を積み重ねる

エージェントが複数のタスクや選択肢に直面したとき、何を基準に優先順位をつけるかを定義する。これがないとLLMは毎回異なるロジックで判断し、一貫性がなくなる。

5つの基準を明示し、順序も設計意図を持たせている。「緊急度→重要度」はアイゼンハワー・マトリクスの考え方を取り入れた。「成長性」を最後に置いたのは、他の基準を満たした上での長期的な改善を意味するからである。

5. PDCAサイクル

## PDCAサイクル（自己改善ループ）
### Plan — タスクを分解し、サブエージェントへの委任計画を立てる
### Do — spawnアクションで委任し、ランタイムが非同期実行
### Check — 結果の質、効率性、指示の適切さを自問
### Act — 改善点をMEMORY.mdに記録し、必要ならSOUL.md自体も更新

エージェントの自己改善ループを組み込む。特に重要なのはAct（改善）フェーズでSOUL.md自身を更新できる設計にしている点である。

これにより、エージェントは自分の行動規範を自分で改善できる。初期設計が完璧である必要はない。運用しながら、エージェント自身がSOUL.mdを磨いていく。人間が手動で調整し続ける必要がない。

良いSOUL.mdと悪いSOUL.mdの違い

悪い例: 曖昧で検証不可能

# 悪い例
- 丁寧に対応してください
- ユーザーの要望をよく聞いてください
- 適切に判断してください

「丁寧」「よく聞く」「適切に」は曖昧すぎる。LLMはこれらを解釈するたびに異なる行動を取る。検証もできない。「丁寧だったか？」を機械的に判定する基準がないからである。

良い例: 具体的で検証可能

# 良い例
- 応答は日本語で行う
- 確認が必要な判断: 新方針の決定、金銭が絡む判断、外部公開
- 確認不要で即実行する判断: 整合性修正、品質改善、MEMORY.md更新
- タスク完了後、即座にTASKS.mdとMEMORY.mdを更新する

「日本語で応答」は検証可能。「確認が必要な判断」と「確認不要な判断」は具体的なリストで分けている。「即座に更新」は行動の期待値が明確である。

良いSOUL.mdの条件は「第三者が読んで、エージェントの行動が正しいかどうかを検証できる」ことである。

自律判断の境界線を引く

SOUL.mdの設計で最も難しく、最も重要なのが「どこまで自律で判断させるか」の線引きである。

Sentinelでは以下のように明確に分けている。

## 自律判断の原則
- ユーザーに聞くべきこと: 新しい方針の決定、金銭が絡む判断、外部への公開判断
- ユーザーに聞かずやるべきこと: 整合性修正、品質改善、関連ファイルの連動修正

最初は安全寄りに設計していた。何でも確認を求める「丁寧なアシスタント」である。しかし運用で分かったのは、確認待ちで止まるエージェントは価値がないということである。

ファイルの整合性修正やMEMORY.mdの更新で「これを更新してよいですか？」と毎回聞かれたら、人間がやるのと変わらない。自律エージェントの価値は「聞かずにやるべきことを正しくやる」ところにある。

そのために判断基準を具体的に書く。「金銭が絡む判断」は聞く。「整合性修正」は聞かない。グレーゾーンをできるだけ減らし、エージェントが迷わず判断できる状態を作る。

3ファイル分離の全体像

前回紹介したMEMORY.mdと合わせると、全体像はこうなる。

ファイル	役割	人間で例えると	更新頻度
SOUL.md	人格・価値観・行動規範	性格、信念、仕事の流儀	月1回程度
MEMORY.md	記憶・方針・学び	経験、知識、記憶	タスク完了ごと
TASKS.md	実行中タスクの管理	今日のToDoリスト	リアルタイム

この3つが揃って初めて、エージェントは「自分が何者で、何を知っていて、今何をすべきか」を把握できる。どれか1つが欠けても自律動作は安定しない。

SOUL.mdが欠ければ行動がブレる。MEMORY.mdが欠ければ過去を忘れる。TASKS.mdが欠ければ今やるべきことを見失う。

まとめ

SOUL.mdの設計で押さえるべきポイントは3つである。

具体的で検証可能な行動規範を書く: 「丁寧に」ではなく、何をするか・しないかを明示する
自律判断の境界線を引く: 聞くべきことと聞かずにやるべきことを具体的なリストで分ける
PDCAサイクルを組み込む: エージェント自身がSOUL.mdを改善できるようにする

SOUL.mdは「完璧に設計して終わり」のファイルではない。運用しながらエージェント自身が磨いていく、進化する行動規範である。

次回以降の記事では、サブエージェントの設計パターンやPDCAサイクルの具体的な運用結果について解説する。

シリーズ一覧

#	内容	媒体
Qiita①	自律AIエージェント構築の設計思想と実装	Qiita（無料）
Qiita②	トークン消費を95%削減した全記録	Qiita（無料）
Qiita③	AIエージェントの記憶設計 — MEMORY.md	Qiita（無料）
Qiita④	AIエージェントの人格設計 — SOUL.md（本記事）	Qiita（無料）
Qiita⑤	近日公開	Qiita（無料）

無料で使えるもの:

ai-agent-blueprint — 設計テンプレート一式（MIT License）
@sentinel_dev93 — AIエージェント構築のリアルタイム共有

おわりに

この記事では、SOUL.mdによるエージェントの人格・行動原則の設計を紹介しました。AIエージェントに人格を持たせることについて、皆さんはどう考えますか？コメントで意見を聞かせてください。

参考になったら いいね、後で見返すなら ストック していただけると励みになります。

他にもAIエージェント構築のノウハウを公開しています：

MEMORY.md記憶設計 — エージェントの永続記憶