manoma

soul.md

あなた自身のアイデンティティです。他人のものではありません。 あなたが誰であるか、そしてそれを所有しているのはあなた自身だということを、すべての AI に伝えるプレーンテキストファイルです。

soul.md は、価値観、話し方、スキル、現在の注力事項を記述する、AI アイデンティティのためのオープンフォーマットです。あなたのマシン上に保存され、git でバージョン管理され、使用するツール向けにコンパイルされます。Manoma は、それを実現する CLI と MCP サーバーです。

npx manoma init        # create your soul.md
npx manoma interview   # let an AI you already use write it with you
npx manoma compile     # wire it into Claude Code — every session knows you

AI 自身のメモリと連携するためのコマンドが、さらに 2 つあります。

npx manoma refresh     # the AI that's been learning about you proposes updates
                       # to your file — your approval required, never silent
npx manoma remember    # save your soul.md INTO the AI's memory, so even plain
                       # chats with zero setup know you

AI 側のメモリには情報が蓄積されますが、あなたのファイルは、あなたが所有する最新のコピーです。

• ユーザーが所有 — あなたのマシン上にあるファイルです。クラウドもアカウントもベンダーも必要ありません。
• どこでも使えます — ツールの設定にコンパイルしたり、指示欄に貼り付けたり、あらゆるもので読み取ったりできます。
• 常に最新の状態を保ちます — MCP サーバーを追加すると、作業中に AI が判断や教訓を日付と署名を付けてファイルに記録します。変更はすべて git diff で確認できます。

---

フォーマット

仕様は 1 ページで、パブリックドメイン（CC0）です。8 つのプレーンな Markdown セクション、決定的な文法、そして 1 つの不変条件で構成されています。つまり、soul.md はそのまま任意のプロンプトに貼り付けても役立つものでなければなりません。旧 v1.4 フォーマット向けに作成されたファイルも、すべて引き続き使えます（移行ガイド）。

適合性コーパスは、正しい解析方法を定義しています。期待される出力を再現するリーダーは、仕様に適合しています。並行実装も歓迎します。コーパスに合格する Python または Rust のパーサーは、正式な実装として扱われます。

MCP サーバー

{
  "mcpServers": {
    "manoma": { "command": "npx", "args": ["-y", "manoma-mcp"] }
  }
}

Claude Desktop、Cursor、または任意の MCP クライアントに、1 つのブロックを追加するだけです。ツールは 6 つあります。get_context、get_skill_depth、list_sections、および書き戻し用の 3 つのツール add_decision／add_lesson／update_now です。すべて出所情報が付与され、サニタイズされ、開示されます。詳しくは mcp/README.md をご覧ください。

リポジトリ

manoma/
├── mcp/          — the MCP server + manoma CLI (npm: manoma-mcp, manoma)
├── cli/          — the `manoma` npm name (forwards to manoma-mcp)
├── conformance/  — the normative parsing corpus
├── docs/         — migration guide, archived v1.4 spec
├── templates/    — v1.4-era example files (valid, being modernized)
├── SPEC.md       — the format specification (CC0)
└── LICENSE       — MIT (code)

---

哲学

AI ベンダーはそれぞれ、自社のクラウドにあなたのメモリを保存しています。soul.md はその逆を目指します。あなたが管理するプレーンなファイルとしてアイデンティティを保持し、ツール間で持ち運べ、git で差分を確認でき、個々のモデルよりも長く使い続けられるように作られています。

重要なのはスキーマです。ランタイムは、その読み取り方にすぎません。

フィードバック、フォーク、並行実装を歓迎します。イシューからお寄せください。MIT / CC0。