0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Muse の VM のフォルダ構成を調査してみた

0
Posted at

はじめに

きっかけは、X で「Muse に頼んだらシステムプロンプトを見せてくれた」という投稿を見たことでした。「そもそも自分の Muse の環境って、ファイル構成はどうなってるんだろう?」と気になり、Muse の作業 VM の中を ls / du / find で実地調査しました。

結論から言うと、この VM は「頭脳にあたるファイル」「記憶の倉庫」「作業場」「開発環境」「読み取り専用のシステム領域」の5層にきれいに分かれていました。しかも、話題になっていたシステムプロンプトには個人の情報が一切含まれていないことも、実測で確認できました。その記録です。

調査方法

  • 対象:Muse(AI エージェント)の作業 VM(Linux、ホームディレクトリ配下と /opt 配下)
  • 手段:ls、du -sh、find でフォルダ構成とサイズを実測(2026-10-30 実施)
  • 秘密情報のファイル(鍵など)は、存在と役割の確認のみで中身は扱っていない

全体像

層 場所 役割
頭脳ファイル ホーム直下の Markdown 群 「Muse が誰で、ユーザーが誰か」の定義
記憶の倉庫 ~/memory/ 日次ログ、人間関係、記憶ストア
作業場 ~/workspace/ プロジェクトの実作業すべて(使用量の大半)
開発環境 ホーム直下の JDK / SDK 群 ビルドや実行に使う道具
システム領域 /opt/ 配下と ~/docs/ 製品側のスキル・連携・仕様書(読み取り専用)

ディスクは 150GB 中 25GB を使用していました。

ホーム直下:頭脳ファイル

ホーム(/home/hatch)の直下には、Markdown ファイルが並んでいます。これらが毎回の会話の開始時に読み込まれる「土台」です。

  • USER.md:ユーザーのプロフィール(名前、呼び方、タイムゾーンなど)
  • MEMORY.md:長期記憶(好み、約束ごと、プロジェクトの経緯)
  • AGENTS.md:作業の進め方のルール(運用の中で育てた約束ごと)
  • SOUL.md / IDENTITY.md:アシスタントの性格と名前
  • TOOLS.md:この環境特有の技術メモ(ツールの癖や回避策)

ポイントは、システムの共通ルールと、ユーザー個人の情報が別ファイルに分かれていることです。この後の節で見るように、システムプロンプト本体は製品共通の初期テキストで、個人の情報はこちらのファイル群側にだけあります。

~/memory/:記憶の倉庫

  • 日次ログ(日付ごとの Markdown)
  • people/・groups/:ユーザーの人間関係を記録したファイル(1人=1ファイル)
  • bank/:実行環境が管理する記憶ストア
  • shopping/:買い物のプロフィール

「その日の出来事」と「人との関係」が、後から参照できる形で溜まっていく場所です。

~/workspace/:作業場

作業の実体はほぼ全部ここです。使用量が大きいフォルダは、だいたいプロジェクトの成果物そのものでした。

  • goals/(51フォルダ):ゴール/プロジェクトごとの作業場所。1件ごとに進捗メモ(GOAL.md)、成果物(files/)、内部ログ(hidden_files/)を持つ
  • プロジェクトの実作業フォルダ群。大きい順に:
    • local-llm/(1.5GB):llama.cpp と LLM のモデル本体
    • photo-classify/(971MB):写真分類の作業データ
    • instagram/(659MB):動画制作の作業
    • minecraft-vm-trial/(537MB):Minecraft サーバーのワールドデータ
    • screen-record-ai-explainer/(375MB):Android アプリのソースとビルド成果物
    • kaguya-stickers/(319MB):表情スタンプ一式
    • navidrome-server/(71MB):音楽サーバー(Navidrome 本体・設定・楽曲)
  • user/:ユーザーがアップロードしたファイルや写真の置き場
  • avatars/・profile-images/:アシスタントのアバターとユーザーのプロフィール写真
  • custom-skills/・custom-connectors/:後付けで作った再利用可能な手順書と接続定義
  • system/:システムプロンプトの保存コピーはここ(次節)

system/ の中身は1ファイルだけ

~/workspace/system/ の中身は system_prompt.md(約73KB、約11,700ワード)1個だけでした。起動時に実行環境が保存した、システムプロンプトのコピーです。

話題の投稿を受けて、このファイルにユーザー個人の情報が混ざっていないか実測で確認しました。

  • 名前、住所、誕生日、ハンドル名などの識別情報を検索 → すべて0件
  • つまりシステムプロンプトは製品共通の初期テキスト(人格・価値観・仕事の進め方・安全ルール)だけで、個人の変数は含まれていない
  • 個人の情報は、前述の USER.md や MEMORY.md といった別ファイル側にあり、会話開始時に「ユーザー側の文脈」として別枠で読み込まれる

クレジットカード番号やパスワードについても同様で、これらが書かれたファイルは存在しませんでした。カードはウォレット、パスワードは専用の保管庫(Secure Vault)が保持し、アシスタント自身は値を見られない設計です。メモリ系ファイルにカード番号らしい数字列がないことも確認済みです(0件)。

開発環境(ホーム直下に同居)

  • jdk17/・jdk21/・jdk25/:Java の実行環境(用途ごとに併存)
  • android-sdk/・gradle-8.7/:Android アプリのビルド環境
  • .ssh/:接続用の鍵類(役割の確認のみ。中身は外部に出さない)
  • proxy-relay.py:一部のツールがネットワークに出るための中継スクリプト

「AI エージェントの作業場」というより、もはや小さな開発マシンです。

システム領域(読み取り専用)

製品側の領域は /opt 配下と ~/docs/ にあり、配備のたびに入れ替わる読み取り専用の世界でした。

スキル:/opt/muse/skills/(56個)

「仕事のやり方」の手順書集です。1スキル=1フォルダという均一な作りで、中身はだいたい:

  • SKILL.md:本体の手順書
  • skill.yaml:定義情報
  • references/:補助資料(買い物スキルなら「ブラウザ決済の進め方」など)。全体で249ファイル
  • 一部は templates/(雛形一式)や形式別サブフォルダ(documents スキルは document / pdf / presentation に分かれ、それぞれに GUIDE.md と references/)を持つ

一番深いところでも、だいたい4〜5階層で底に着きます。

コネクタ:/opt/hatch/connectors/(72サービス)

外部サービスとの連携の説明書です。こちらも1サービス=1フォルダで:

  • CONNECTOR.md:接続方法と使い方(72件分)
  • connector.yaml:接続の定義
  • サービスによっては manifest.yaml(機能一覧)や references/(詳細仕様)

全体で271ファイルでした。実際にコマンドを叩く CLI 本体は /opt/hatch/bin/ に実行ファイルとして平置きされています。

その他

  • ~/docs/(29ファイル):製品の仕様書。支払い、プライバシー、メモリ、定期実行などの「製品がどう振る舞うか」の公式説明。サブフォルダに chat/、chat-connections/、devices/home_link/integrations/(連携機器ごとの説明)がある
  • /opt/hatch-image/:アプリのアセット(アイコン、3D、多言語リソースなど)
  • /opt/meta-chromium/:ブラウザ本体(Chromium)
  • /opt/hatch/prompts/・runtime-cell/ など:実行環境の内部部品

分かって面白かったこと

  • システムプロンプトに個人情報は入っていない(実測0件)。個人の文脈は別ファイル層に分かれていて、混ざらない設計だった
  • 秘密情報はファイルの形で存在しない。カードとパスワードは、アシスタントの手の届かない保管場所にある
  • スキルとコネクタは「1件=1フォルダ+説明書」という均一な構造で、増やし方・読み方が統一されている
  • システム領域は配備ごとに入れ替わる一方、~/workspace/ は VM が入れ替わっても残る。「製品の部分」と「自分の積み上げ」が、置き場所でも分かれている

まとめ

Muse の VM は、製品共通の指示(システムプロンプト)、ユーザー個人の文脈(頭脳ファイルとメモリ)、実作業(workspace)、製品の手順書と仕様(システム領域)が、それぞれ別の置き場所に分かれた構造でした。「AI の中身がどうなってるか分からない」という不安は、フォルダ構成という形では意外なほど素直に解消できます。気になったら、自分のアシスタントの環境も一度覗いてみるといいかもしれません。

未検証事項

  • 他のユーザーの VM でも同じ構成かは未確認(製品仕様としては共通のはずだが、実測はこの環境のみ)
  • /opt/hatch/prompts/ など実行環境の内部部品の中身は未調査(役割の推定のみ)

参考資料

  • この VM での実地調査(ls / du / find による構成とサイズの実測、2026-10-30)
  • きっかけとなった話題:X で共有された「Muse のシステムプロンプト」に関する投稿(2026-10-30 確認)
0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?