Decision Os MCP

🚀 Decision OS MCP

Decision OS のためのMCPサーバーです。Decision OSは、LLMネイティブの意思決定追跡と学習システムです。

🔍 Decision OSとは？

Decision OSは、エンジニアリング作業中に現実が予想を超える瞬間、つまり 新しい圧力 を捉えます。従来のドキュメントとは異なり、LLMが予測できなかったことに焦点を当て、次のような学習ループを作成します。

事例 → 圧力イベント（意外な出来事） → 結果 → 基礎知識（圧縮された学習成果）

🚀 クイックスタート

1. MCPサーバーのインストール

# グローバルインストール
npm install -g decision-os-mcp

# またはnpxを使用（インストール不要）
npx decision-os-mcp

2. プロジェクトへの追加

テンプレートをプロジェクトにコピーします。

cp -r templates/.decision-os /path/to/your-project/

config.yaml を編集し、プロジェクト名を設定します。

3. エージェントの設定

Cursor

プロジェクトの .cursor/mcp.json に以下を追加します。

{
  "mcpServers": {
    "decision-os": {
      "command": "npx",
      "args": ["-y", "decision-os-mcp"],
      "env": {
        "DECISION_OS_PATH": "${workspaceFolder}/.decision-os"
      }
    }
  }
}

Cursorのルールテンプレートをコピーします。

cp templates/.cursor/rules/decision-os.mdc /path/to/your-project/.cursor/rules/

Claude Code / Claude Desktop

Claude Desktopの設定ファイル（macOSでは ~/Library/Application Support/Claude/claude_desktop_config.json）に以下を追加します。

{
  "mcpServers": {
    "decision-os": {
      "command": "npx",
      "args": ["-y", "decision-os-mcp"],
      "env": {
        "DECISION_OS_PATH": "/absolute/path/to/your-project/.decision-os"
      }
    }
  }
}

エージェントの指示テンプレート（.claude/rules/ からAGENTS.mdへのシンボリックリンクを含む）をコピーします。

cp templates/AGENTS.md /path/to/your-project/
cp -R templates/.claude /path/to/your-project/

⚠️ 重要提示

Claude Desktopでは、DECISION_OS_PATH に絶対パスを指定する必要があります（${workspaceFolder} は使用できません）。

AGENTS.md は、OpenAI Codex、Google Jules、Claude Code、Cursor、Aider、Zed、Warp、VS Codeなど、20以上のコーディングエージェントがサポートするオープンスタンダードです。.claude/rules/ のシンボリックリンクにより、Claude Codeも自動的にこれを取得できます。つまり、1つのファイルですべてのエージェントが対応できます。

🛠️ ツール

🌟 コアコンセプト

圧力イベント

主な学習成果です。予期しないことが起こったときに記録されます。

expected: "Supabase insert would throw on null FK"
actual: "RLS silently blocked the write, no error"
adaptation: "Added explicit null-check before insert"
remember: "Supabase RLS fails silently on null FK values"

基礎知識

繰り返される圧力イベントから昇格した圧縮された学習成果です。

id: F-0001
title: "Supabase RLS fails silently on null FK"
default_behavior: "Always validate FK values before insert when using RLS"
context_tags: [SUPABASE, RLS, DATA_MODEL]
confidence: 2  # Out of 3
scope: PROJECT  # or GLOBAL
origin_project: my-project
validated_in: [my-project, other-project]
exit_criteria: "Supabase adds explicit error for null FK violations"
source_pressures: [PE-0003, PE-0007]

階層的な基礎知識（グローバル → プロジェクト）

Decision OSは、Gitの設定と同様のカスケード型スコープモデルをサポートしています。

~/.decision-os/                    # グローバル（ユーザー全体、普遍的な学習成果）
├── config.yaml
└── defaults/foundations.yaml      # GF接頭辞の基礎知識

~/projects/my-app/.decision-os/    # プロジェクト（このコードベースに固有）
├── config.yaml
├── cases/
└── defaults/foundations.yaml      # F接頭辞のプロジェクトの学習成果

解決順序：競合が発生した場合、プロジェクトの設定がグローバルの設定より優先されます。

グローバルな基礎知識は推奨事項であり、ルールではありません。 これらは、特定のテクノロジースタックを超越する普遍的なパターンを表しています。

• ツールの動作（例：「MCP記述子のパスが古くなっている可能性がある」）
• デバッグ戦略（例：「リファクタリングの前に呼び出し元をトレースする」）
• メタ学習（例：「実装する前に要件を検討する」）

グローバルな基礎知識の設定：

# グローバルな.decision-osを作成
mkdir -p ~/.decision-os/defaults
cp templates/global-.decision-os/config.yaml ~/.decision-os/
cp templates/global-.decision-os/defaults/foundations.yaml ~/.decision-os/defaults/

競合検出：get_context が呼び出されると、プロジェクトとグローバルの基礎知識が重複または矛盾する場合に競合が強調表示されます。

事例

圧力イベントのコンテキストを提供する作業の境界付けられた単位（機能、バグ修正、調査）です。

id: 0001-add-tile-caching
title: "Add tile caching"
goal: "Reduce API latency for repeated tile requests"
status: ACTIVE
signals:
  context:
    risk_level: MEDIUM
    affected_surface: [PERFORMANCE_CRITICAL, INTEGRATION]
decisions:
  approach: BUILD
  posture: BALANCED
  validation_level: STANDARD

📁 ディレクトリ構造

# グローバル（ユーザー全体）
~/.decision-os/
├── config.yaml               # スコープ: グローバル
└── defaults/
    └── foundations.yaml      # GF接頭辞の普遍的な学習成果

# プロジェクト（コードベースごと）
your-project/
├── .decision-os/
│   ├── config.yaml           # スコープ: プロジェクト
│   ├── cases/
│   │   ├── 0001-bootstrap/
│   │   │   ├── case.yaml     # 事例のメタデータ
│   │   │   └── pressures.yaml # 圧力イベント
│   │   └── 0002-add-auth/
│   │       └── ...
│   └── defaults/
│       └── foundations.yaml  # F接頭辞のプロジェクトの学習成果
├── .cursor/                  # Cursorの設定
│   ├── mcp.json              # MCPサーバーの設定
│   └── rules/
│       └── decision-os.mdc   # LLMの指示（Cursor形式）
├── .claude/                  # Claude Codeの設定
│   └── rules/
│       └── decision-os.md    # -> ../../AGENTS.mdへのシンボリックリンク
├── AGENTS.md                 # エージェントの指示（Claude Code、Codex、Julesなど）
└── src/

🤖 LLMワークフロー

1. タスク開始時：get_context() を呼び出して、アクティブな事例と基礎知識（関連性でランク付けされた）を読み込みます。
2. 意外なことが起こったとき：迅速なキャプチャには quick_pressure() を、詳細な記録には log_pressure() を呼び出します。
3. BUILD決定の前：check_policy() を呼び出して要件を確認します。
4. タスク終了時：後悔スコアを指定して close_case() を呼び出します。
5. 定期的に：suggest_review() を呼び出して、未抽出の学習成果や忘却の機会を探します。

💡 忘却

このシステムは設計上、忘却するようになっています。事例は一時的なコンテナであり、知識は基礎知識に存在します。

close_case() が 後悔スコア0 で呼び出され、昇格されていない圧力イベントがない 場合、事例は自動的に削除されます。アーカイブされるのではなく、忘却されます。

これにより、.decision-os/cases/ ディレクトリがシンプルに保たれます。未圧縮の学習成果（昇格されていない圧力イベントまたは後悔スコア1以上）が残っている事例のみが残ります。

ライフサイクル：

1. 事例が誕生：作業が開始されると事例が作成されます。
2. 圧力イベントがキャプチャ：意外なことが起こったときに圧力イベントが記録されます。
3. 圧力イベントが昇格：パターンが出現すると、圧力イベントが基礎知識に昇格されます。
4. 事例が忘却：教えるべきことがなくなった事例は忘却されます。
5. 基礎知識が残る：唯一の永続的な知識として基礎知識が残ります。

suggest_review() を使用して、忘却を妨げる事例（後悔スコア0で昇格されていない圧力イベントが残っている）を見つけ、昇格するか破棄するかを決定します。

🎯 アクティブな事例の永続化

アクティブな事例は .decision-os/.active-case に保存され、MCPサーバーの再起動後も保持されます。Cursorが再起動してもアクティブな事例が失われることはありません。

📋 信号語彙

コンテキスト信号（実行前）

• risk_level: 低 / 中 / 高
• reversibility: 容易 / 中 / 困難
• change_frequency: 稀 / 時折 / 頻繁
• affected_surface: コアドメイン / 統合 / データモデル / インフラデプロイ / セキュリティ境界 / UI/UX / パフォーマンスクリティカル
• novelty: 低 / 中 / 高

決定

• approach: 再利用 / 再構築 / 構築 / ハイブリッド
• posture: 最小限 / バランス / 堅牢
• validation_level: 基本 / 標準 / 厳格

結果信号

• regret: 0 - 3（0 = 同じ選択をする、3 = 強い後悔）
• regressions: なし / 軽微 / 重大

🛠️ 開発

# 依存関係のインストール
npm install

# ビルド
npm run build

# ローカルで実行
DECISION_OS_PATH=/path/to/.decision-os npm start

📖 哲学

• 新しい圧力のみを記録：LLMが導き出せることはドキュメント化しない。
• システムは忘却すべき：成功した事例は削除される。知識は基礎知識に存在し、事例には存在しない。
• 仮説であり、公理ではない：基礎知識には信頼度があり、修正可能である。
• 最小限の手続き：小さな語彙、構造化されているが官僚的ではない。
• 先にキャプチャし、後でフィルタリング：不確かな場合は記録する。過剰なキャプチャは、意外な出来事を見逃すよりも良い。
• LLMネイティブ：AI支援のエンジニアリングワークフロー向けに設計されている。

📄 ライセンス

MIT