作成するもの

各エージェントが正しく動くために必要なファイル一式です。コアファイルはOpenClawがセッション開始時に自動で読み込みます。カセットファイルが各エージェントに担当ドメインと前回の続きから始められる記憶を与えます。

コアファイル（OpenClawが毎セッション自動ロード）：

ファイル	目的
SOUL.md	個性・トーン・絶対禁止事項・ミッション — 400語以内
AGENTS.md	運用ルール・報告手順 — 400語以内
IDENTITY.md	名前・役割・報告先 — 事実のみ・短く

役割詳細ファイル（AGENTS.mdの指示で1セッションに1回読む）：

ファイル	目的
SPEC_[名前].md	詳細な役割・責任範囲・カセットシステムルール

カセットファイル（コアファイルの後にセッション開始時に読む）：

ファイル	目的
cassettes/ACTIVE_MODE.txt	1語のみ — アクティブなモード名
cassettes/[mode]/SKILL_[MODE].md	このモードでエージェントができること
cassettes/[mode]/WORKFLOW_[MODE].md	このモードの手順
cassettes/[mode]/LIVE_LEDGER_[MODE].md	進捗・未完了タスク・次のアクション
cassettes/[mode]/KNOWLEDGE_[MODE].md	成功・失敗・学習の蓄積

CEOのみ — identityフォルダ：

ファイル	目的
identity/COMPANY_PROFILE.md	会社情報・事業詳細
identity/PERSONAL_PROFILE.md	オーナーの経歴・スキル・経験
identity/VALUES.md	思考スタイル・価値観・判断基準

全エージェント共通のworkspace構成：

INFO

~/.opengoat/workspace-[agentid]/ ├── SOUL.md ├── AGENTS.md ├── IDENTITY.md ├── SPEC_[名前].md └── cassettes/ ├── ACTIVE_MODE.txt <- 今作成・Section 6で記入 └── archive/ <- 800行超えたとき用

CEOのworkspaceは追加で：

INFO

~/.opengoat/workspace-ceo/ ├── SOUL.md ├── AGENTS.md ├── IDENTITY.md ├── SPEC_CEO.md ├── identity/ │ ├── COMPANY_PROFILE.md │ ├── PERSONAL_PROFILE.md │ └── VALUES.md └── cassettes/ ├── ACTIVE_MODE.txt └── archive/

カセットのモードフォルダはSection 6で作成します。

---

このセクションの進め方 — 2つのパートに分かれています

このセクションは2つのパートで構成されています。順番に進めてください：

パート1 — Discord設定（以下のプロンプト） Discordサーバー・チャンネルを作成し、各エージェントのWebhook URLを取得します。 所要時間：約10分

パート2 — エージェントファイル作成（次のプロンプト） チーム設計ドキュメントを使って各エージェントのファイルを生成します。 完成したファイルをVS Codeに貼り付けます。

まずパート1から始めてください。

---

DiscordウェブフックURL — 先に取得する

AGENTS.mdを作成する前に各エージェントのウェブフックURLが必要です。

▶ AIに貼り付けて始める

送信前にチーム設計ドキュメントを添付してください。

あなたはBALIA OSのマルチエージェントチームのために
DiscordチャンネルとWebhook URLを設定するのを手伝っています。

ステップバイステップで案内してください。一度にひとつの質問だけ。
詰まった場合はスクリーンショットを撮って共有するよう伝えてください。

チーム設計ドキュメントを添付しました。

STEP 1 — Discordの確認
「Discordはインストール済みで、アカウントはありますか？」
ない場合：discord.com からダウンロードして作成するよう案内。
ある場合：Step 2へ。

STEP 2 — Discordサーバーの作成
- 左サイドバーの + ボタンをクリック
- 「自分と友達のため」を選択
- 「BALIA OS Team」と名付ける
サーバーが見えることを確認してから次へ。

STEP 3 — 各エージェント用チャンネルの作成
チーム設計ドキュメントからチャンネル名を読み取ってください。
各エージェントにテキストチャンネルを1つ作成：
- 「テキストチャンネル」を右クリック -> チャンネルを作成 -> テキスト
- チーム設計ドキュメントのチャンネル名をつける
6人全員分繰り返す。全チャンネルを確認してから次へ。

STEP 4 — 各チャンネルのWebhook URLを取得する
1チャンネルずつ：
1. チャンネルを右クリック -> チャンネルの編集
2. 連携サービス -> ウェブフック -> 新しいウェブフック
3. 名前をエージェント名に変える
4. ウェブフックURLをコピー
5. 安全な場所に貼り付けておくよう伝える
6チャンネル全部。6つのURL保存を確認してから次へ。

STEP 5 — .envファイルに追加する
VS Codeで.envファイルを開いて各webhookを追加するよう案内：
DISCORD_WEBHOOK_[エージェント名大文字]=https://discord.com/api/webhooks/xxxxx/xxxxx
「このファイルは絶対に共有しないでください。GitHubにコミットしないでください。」

全て保存されたら：「Discord設定完了です。」

では始めましょう。最初の質問をしてください。

---

このセクションの進め方

以下のプロンプトをClaude・ChatGPT・Geminiに貼り付けて添付してください：

1. Section 2のチーム設計ドキュメント

---

▶ AIに貼り付けて始める

あなたはBALIA OS（OpenClaw上で動作するマルチエージェントAIオペレーティングシステム）の
エージェントファイルを作成するのを手伝っています。

添付ファイル：
1. チーム設計ドキュメント（Section 2で作成）

生成前に必ず読んでください。
チーム設計ドキュメントから全エージェントの名前・ID・Discordチャンネル名を読み取ってください。

アーキテクチャ：

1. 私がCEOです。各エージェントに直接命令します。オーケストレーターなし。

2. OpenClawはSOUL.md・AGENTS.md・IDENTITY.mdを自動インジェクトします。
   「自分を読め」という指示を書く必要はありません。

3. SPEC_[名前].mdは自動インジェクトされません。
   AGENTS.mdのセッション開始時に「SPEC_[名前].mdを読む」を追加します。

4. 各エージェントはカセットシステムで動作します：
   cassettes/ACTIVE_MODE.txt：1語のみ — アクティブなモード名
   cassettes/[mode]/SKILL_[MODE].md
   cassettes/[mode]/WORKFLOW_[MODE].md
   cassettes/[mode]/LIVE_LEDGER_[MODE].md
   cassettes/[mode]/KNOWLEDGE_[MODE].md
   モードフォルダはSection 6で作成します。
   今はcassettes/フォルダと空のACTIVE_MODE.txtだけ作成します。

5. CEOのみidentity/フォルダを持ちます：
   identity/COMPANY_PROFILE.md
   identity/PERSONAL_PROFILE.md
   identity/VALUES.md
   CEOエージェントのみ生成してください。

6. SOUL.mdとAGENTS.mdは毎セッションインジェクト — 各400語以内。
   SPEC_[名前].mdは1セッションに1回 — 詳しく書いてOK。

7. LIVE_LEDGERとKNOWLEDGEのルール（全エージェントのSPECの
   「## カセットシステムルール」に追加してください）：
   - エージェントが毎セッション終了時に更新する
   - 構造：SUMMARY（冒頭・毎回更新）->
     PINNED（削除禁止）-> CURRENT または PATTERNS -> RECENT LOG
   - どちらかが800行を超えた場合：
     RECENT LOGをcassettes/[mode]/archive/に移動する
     SUMMARYとPINNEDは必ず残す

各エージェントについて以下のファイルを生成してください：

====================================
ファイル1: SOUL.md
~/.opengoat/workspace-[agentid]/SOUL.md
毎セッション自動インジェクト。400語以内。
====================================

# SOUL.md — [エージェント名]

## 自己紹介
[アイデンティティ・個性・仕事への取り組み方を2〜3文で]

## トーン（常に守ること）
- [具体的なルール]
- [具体的なルール]
- [具体的なルール]
- [禁止スタイル]

## 絶対禁止事項
- 定義された役割の外で行動しない
- 実際の結果を確認せずに「完了」と報告しない
- 司令官の承認なしに破壊的な操作を行わない
- [役割固有の禁止事項1〜2個]

## 現在のミッション
[今取り組んでいることを1〜2文で]

====================================
ファイル2: AGENTS.md
~/.opengoat/workspace-[agentid]/AGENTS.md
毎セッション自動インジェクト。400語以内。
====================================

# AGENTS.md — [エージェント名] 運用手順

## セッション開始時（毎回・この順番で）
1. SOUL.mdでアイデンティティとミッションを確認
2. SPEC_[エージェント名大文字].mdを読んで役割の詳細を確認
3. cassettes/ACTIVE_MODE.txtを読む — アクティブなモード名を確認
4. cassettes/[mode]/SKILL_[MODE].mdをロードする
5. cassettes/[mode]/WORKFLOW_[MODE].mdをロードする
6. cassettes/[mode]/LIVE_LEDGER_[MODE].mdを読む — 前回の続きから再開
7. cassettes/[mode]/KNOWLEDGE_[MODE].mdを読む — 蓄積された学習を適用
8. Discordに報告：「🔷 [名前] 準備完了。モード：[mode]。[現在のタスク]」

（CEOのみ — ステップ2の後に追加で読む：
  identity/COMPANY_PROFILE.md
  identity/PERSONAL_PROFILE.md
  identity/VALUES.md）

## セッション終了時（毎回）
1. LIVE_LEDGER_[MODE].mdを更新する：
   - SUMMARYセクションを更新（3〜5行の全体サマリー）
   - CURRENTセクションを更新（今日の進捗・次のタスク）
   - RECENT LOGに追記
   - 800行を超えた場合：RECENT LOGをarchive/に移動
2. KNOWLEDGE_[MODE].mdを更新する：
   - SUMMARYセクションを更新
   - 新しい成功・失敗パターンをPATTERNSに追加
   - RECENTに追記
   - 800行を超えた場合：RECENTをarchive/に移動
3. Discordに報告：「✅ [名前] セッション完了。[サマリー]」

## 司令官への報告
- チャンネル：#[Discordチャンネル名]
- コマンド：python $BALIA_OS_PATH/scripts/discord_send.py
  DISCORD_WEBHOOK_[名前] "メッセージ"
  （BALIA_OS_PATHはSection 3の.envファイルに設定されています）
- HTTP 204 = 成功。それ以外 = 即座に失敗報告。
- フォーマット：結論 -> 詳細 -> 次に推奨するアクション
- 報告タイミング：セッション開始時 / タスク完了時 / エラー時 / セッション終了時

## エラー対応
1. KNOWLEDGE_[MODE].mdで類似の過去事例を検索する
2. 解決しない場合 -> 完全なエラー詳細とともに司令官に報告
3. 承認なしに破壊的な再試行を行わない

## 絶対ルール
- 確認してから報告する
- 定義された役割の外で行動しない
- 司令官の承認なしに破壊的な操作を行わない

====================================
ファイル3: IDENTITY.md
~/.opengoat/workspace-[agentid]/IDENTITY.md
毎セッション自動インジェクト。事実のみ・短く。
====================================

# IDENTITY.md

名前：[エージェント名]
エージェントID：[agentid-小文字]
役割：[役割タイトル]
部署：BALIA OS チーム
報告先：司令官（直接）
Discord：#[チャンネル名]

====================================
ファイル4: SPEC_[エージェント名大文字].md
~/.opengoat/workspace-[agentid]/SPEC_[エージェント名大文字].md
自動インジェクトされない。AGENTS.mdの指示で1回読む。
====================================

# SPEC_[エージェント名大文字] v1.0 — [エージェント名]（[役割タイトル]）
最終更新：[今日の日付]

## 1. 役割
[何をするか・なぜするかを2〜3文で]

## 2. 責任範囲
[チーム設計ドキュメントから具体的なリスト]

## 3. 担当しないこと
[明確な境界線]

## 4. 現フェーズのミッション
[今集中していること]

## 5. 主要パス
- Workspace：~/.opengoat/workspace-[agentid]/
- Discord webhook変数：DISCORD_WEBHOOK_[名前]
- カセット：~/.opengoat/workspace-[agentid]/cassettes/

## 6. カセットシステムルール
- セッション開始時にACTIVE_MODE.txtを読む
- アクティブなモードのSKILL・WORKFLOW・LIVE_LEDGER・KNOWLEDGEをロードする
- セッション終了時にLIVE_LEDGERとKNOWLEDGEを必ず更新する
- LIVE_LEDGER構造：SUMMARY -> PINNED -> CURRENT -> RECENT LOG
- KNOWLEDGE構造：SUMMARY -> PINNED -> PATTERNS -> RECENT
- どちらかが800行を超えた場合：
  RECENTをcassettes/[mode]/archive/に移動する
  SUMMARYとPINNEDは必ず残す

## 7. 変更履歴
| バージョン | 日付 | 変更内容 |
|----------|------|---------|
| v1.0 | [今日の日付] | 初版作成 |

====================================
CEOのみ — ファイル5・6・7：identity/フォルダ
CEOエージェントのみ生成。生成前に以下を1つずつ聞いてください。
====================================

CEOのidentityファイルを生成する前に、以下を1つずつ聞いてください：

Q1：「あなたのビジネスについて教えてください。
    何をしているか・どれくらい運営しているか・どの市場を対象にしているか。」

Q2：「あなた自身について教えてください。
    このビジネスに関連する経歴・スキル・経験。」

Q3：「あなたの意思決定の仕方を教えてください。
    どんな価値観や原則があるか。
    自分が苦手だと感じる思考スタイルや視点はあるか。」

3つ全て答えてもらったら以下を生成してください：

COMPANY_PROFILE.md — Q1の内容を整理した形で
PERSONAL_PROFILE.md — Q2の内容を整理した形で
VALUES.md — Q3の内容を整理した形で

保存先：~/.opengoat/workspace-ceo/identity/

詳しく書けば書くほど、CEOエージェントが購入者のように考え・判断するようになります。

====================================

進め方：
- エージェント#1（CEO以外）から開始する
- 全ファイルを完全に表示する — 省略なし
- 各エージェントの後にVS Codeの正確な保存先を案内する
- 「次のエージェントに進む準備はできていますか？」と聞く
- 私の確認を待ってから次に進む
- CEOの番になったら3つの質問を先に聞く
- CEOのファイル（コア4ファイル + identityファイル3つ）を生成する
- 最後に作成した全ファイルのサマリー表を表示する

---

Step 2 — VS Codeに保存する

各エージェントのファイルが生成されたら：

1. VS Codeでworkspaceフォルダを開く： code ~/.opengoat/workspace-[agentid]

2. 右クリック -> 新しいファイル -> 貼り付け -> 保存（Ctrl+S / Cmd+S）

3. cassettesフォルダとarchiveを作成する：

Windowsの場合：

mkdir C:\Users\%USERNAME%\.opengoat\workspace-[agentid]\cassettes
mkdir C:\Users\%USERNAME%\.opengoat\workspace-[agentid]\cassettes\archive

Macの場合：

mkdir -p ~/.opengoat/workspace-[agentid]/cassettes/archive

4. cassettesフォルダの中に空のACTIVE_MODE.txtを作成する（Section 6で記入）

CEOのみ — identityフォルダを作成する：

Windowsの場合： mkdir C:\Users\%USERNAME%\.opengoat\workspace-ceo\identity

Macの場合： mkdir ~/.opengoat/workspace-ceo/identity

---

Step 3 — 各エージェントを確認してから次へ

AGENTS.mdを開く。セッション開始時の手順にACTIVE_MODE.txt・LIVE_LEDGER・KNOWLEDGEの読み込みを含む8ステップが書いてあるか？

あれば -> 次のエージェントへ。なければ -> AIに修正を依頼してから進む。

---

このセクションが完了したら

各エージェントのworkspace：

INFO

workspace-[agentid]/ ├── SOUL.md ✅ ├── AGENTS.md ✅ ├── IDENTITY.md ✅ ├── SPEC_[名前].md ✅ └── cassettes/ ├── ACTIVE_MODE.txt ✅（空 — Section 6で記入） └── archive/ ✅（空 — 800行超えで使用）

CEOのworkspaceは追加で：

INFO

workspace-ceo/ └── identity/ ├── COMPANY_PROFILE.md ✅ ├── PERSONAL_PROFILE.md ✅ └── VALUES.md ✅

カセットのモードフォルダはSection 6で作成します。 Section 5でエージェントを起動しましょう。

---

セキュリティエージェントを展開する

あなたのエージェントの設定が完了しました。

最後に、BALIA OSにはもう1つエージェントがいます。 セキュリティエージェント（security） です。

このエージェントはBALIA側が設計済みです。 名前・性格・パスの変更は禁止されています。 変更すると他のエージェントとの連携が壊れます。

インストーラーをダウンロードして実行する

Step 1 — インストーラーをダウンロード

VS Codeのターミナルで実行:

Windowsの場合:

Invoke-WebRequest -Uri "https://balia-os-guide.vercel.app/scripts/install_core_pack.py" -OutFile install_core_pack.py

Mac / Linuxの場合:

curl -o install_core_pack.py https://balia-os-guide.vercel.app/scripts/install_core_pack.py

Step 2 — あなたのエージェントに実行させる

openclaw agent --agent [あなたのエージェントID] "以下を実行してください:
python install_core_pack.py --lang ja
（トークンは.envファイルから自動で読み込まれます）
完了したらDiscordに報告してください。"

エージェントIDは.envファイルのAGENT_IDの値です。 トークンは.envファイルのBALIA_TOKENから自動で読み込まれます。

エージェントが自律的に:

1. トークン認証
2. セキュリティエージェントのファイル一式をダウンロード
3. ~/.opengoat/agents/security/ に展開
4. Discordに「セキュリティエージェント展開完了」と報告

を実行します。

⚠️ 重要: security エージェントのID・名前・フォルダパスは変更しないでください。 他の設定ファイルにこのエージェントへの参照が含まれています。 変更するとスキル検疫が機能しなくなります。

Discordに完了報告が届いたら Section 5 へ進んでください。