mex (Claude Skill) — インストール & ライブデモ

なぜ使うのか

主な機能

構造化された記憶スキャフォールド：アーキテクチャ・規約・進行中の作業・ブロッカー
記憶の主張と実際のコード・テストを比較する乖離 CLI
セクションごとの鮮度マーカー（最終確認日）
人間とエージェントが共有して使う設計。両方が同じファイルを読む
CLAUDE.md / AGENTS.md と連携

ライブデモ

実際の動作

準備完了

インストール

作者のリポジトリ · Claude Skills の公式ドキュメント

ユースケース

実用的な使い方： mex

プロジェクト開始時にプロジェクト記憶を設定する

👤 新規リポジトリのオーナー ⏱ ~25 min beginner

使うタイミング： プロジェクトの初日。エージェントに素早く立ち上がってほしいとき。

フロー

初期化する

Use mex. Initialize project memory with sections: architecture, conventions, in-flight, blockers.✓ コピーしました

→ テンプレート付きの /.mex/ スキャフォールドが作成される
初期データを入力する

Auto-extract architecture from existing code and a starter convention list.✓ コピーしました

→ 各セクションに初期コンテンツが設定される
鮮度を設定する

Mark each section verified today.✓ コピーしました

→ 鮮度マーカーが設定される

結果： 新プロジェクトが共有エージェントコンテキストを持った状態で始まる。

注意点

自動抽出が無関係な詳細を含めてしまう — 大胆に削る。記憶は原則のためにある。grep の代わりではない

組み合わせ： filesystem

プロジェクト記憶がコードと食い違う箇所を見つける

👤 長期プロジェクトのオーナー ⏱ ~30 min intermediate

使うタイミング： 記憶が数ヶ月前に設定されており、どれだけ古くなっているか不明なとき。

フロー

乖離検出を実行する

Use mex. Run drift detection. Report claims that no longer match reality.✓ コピーしました

→ 主張と証拠の対応付きで乖離レポートが表示される
更新または削除する

For each drift, decide: update memory or fix the code (claim was right and reality drifted).✓ コピーしました

→ アイテムごとの判断が記録される。コード側の修正は PR で開かれる
再確認する

After resolving, mark sections verified today.✓ コピーしました

→ 記憶が再び整合する

結果： 記憶が口伝えではなく信頼できる規約として機能し続ける。

注意点

乖離検出が過剰にフラグを立てる — --strictness を調整する。生きているプロジェクトには 'medium' を使う

組み合わせ： github

進行中の作業をチームメンバーに引き継ぐ

👤 休暇を取る・退職する開発者 ⏱ ~20 min beginner

使うタイミング： 3 つの機能が進行中で、他の誰かに引き継ぐ必要があるとき。

フロー

進行中の作業をキャプチャする

Use mex. For each open branch, write an in-flight entry: goal, current state, next steps, gotchas.✓ コピーしました

→ エントリが /.mex/in-flight/ に作成される
CLI で確認する

Run drift on in-flight; ensure entries reflect actual branch state.✓ コピーしました

→ 乖離なしでクリーン
引き継ぐ

Generate a teammate-ready summary linking each entry to its branch.✓ コピーしました

→ Slack やメールで送れる引き継ぎ文書が完成する

結果： スムーズな引き継ぎ。発掘作業が不要。

注意点

進行中のエントリが曖昧（「X に取り組んでいる」） — テンプレートの「次のステップ」フィールドを必須にする。具体的でなければ役に立たない

組み合わせ

他のMCPと組み合わせて10倍の力を

mex-skill + filesystem

記憶をリポジトリに保存してコミットする

Commit /.mex/ to git so memory travels with the codebase.✓ コピーしました

mex-skill + github

PR で乖離の CI チェックを実行する

On every PR, run mex drift and post the report as a PR comment.✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング	コスト
init	scaffold_options	プロジェクトごとに一度だけ	0
drift	section?, strictness?	週次、または長期ブランチのマージ前	0 (uses local checks + LLM for fuzzy claims)
verify	section	記憶を現実に合わせて更新した後	0
in_flight_add	branch, goal, next_steps	機能ブランチを開始するとき	0
summary	format	引き継ぎ・状況報告	0

コストと制限

運用コスト

APIクォータ: なし — ローカル
呼び出しあたりのトークン: 乖離検出はファジーな主張に LLM を使用。実行ごとに上限あり
金額: 無料
ヒント: CI では strict=high で本物の乖離を検出。日常的なローカルチェックは medium を使う

セキュリティ

権限、シークレット、影響範囲

最小スコープ： filesystem-write

認証情報の保管： なし

データ送信先： 乖離 LLM がリモートプロバイダーに設定されている場合のみ外部通信が発生

記憶にはアーキテクチャの詳細が含まれる。リポジトリがプライベートで公開フォークにミラーされる場合は /.mex/ を gitignore に追加すること

トラブルシューティング

よくあるエラーと対処法

乖離が誤検知を報告する

strictness を下げる。または主張の表現をより検証しやすいものに変更する

記憶が無制限に増える

各セクションにはソフトな上限がある。定期的に統合する。原則を残し、詳細はアーカイブする

CLI が /.mex/ を見つけられない

リポジトリのルートから実行するか、--root <path> を渡す

自動抽出が重要な不変条件を見逃す

自動抽出はスターター。肝心な不変条件は手動で書くこと

代替案

mex 他との比較

代替案	代わりに使う場面	トレードオフ
claude-mem-skill	プロジェクト知識記憶ではなくセッション継続性が欲しいとき	用途が異なる。mex はプロジェクトレベルの不変条件向け
Plain CLAUDE.md	小規模プロジェクトで乖離検出が不要な場合	構造がない。自動的な鮮度チェックがない
pilot-shell-skill	仕様・計画・ゲートと知識の永続化が一緒に欲しいとき	ワークフロー面が大きい。意見が強い

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る