framework-deployment-guide.md
# Framework Deployment Guide
## フレームワーク配置ガイド
Integrated/フレームワーク体系をClaude Code/Claude Chatに配置するための包括ガイド。
---
## 1. 全体構造
### Integrated/ディレクトリ構成
```
Integrated/ # Single Source of Truth
├── core/ # Layer 1: 核心フレームワーク（4つ）
│ ├── ITF_v2_1.md # 思考の体系（マスターフレームワーク）
│ ├── ITF_v2_Quick_Reference.md
│ ├── USM_v1.md # 体系化の方法
│ ├── USM_Quick_Reference.md
│ ├── CEM_v1.md # 協働の方法
│ ├── CEM_Quick_Reference.md
│ ├── AAF_v1.md # 採用設計
│ └── AAF_Quick_Reference.md
│
├── os/ # Layer 1: OS層（6つ）
│ ├── TRUST_v1.md # 認知的検証（横断的）
│ ├── MESH_v1.md # 人間理解4軸
│ ├── SMCP_v1.md # 物語メタ認知プロトコル
│ ├── MESH_SMCP_Integration_v1.md # MESH×SMCP統合
│ ├── ADDE_v1.md # AI駆動開発環境
│ ├── ADDE_Quick_Reference.md
│ └── DBC_v1.md # 契約駆動開発
│
├── Patterns/ # Layer 2: パターン（2つ）
│ ├── Pattern_Index.md # パターン索引
│ ├── TAT_v1.md # 試行増幅転移
│ ├── TAT_Quick_Reference.md
│ ├── DDM_v1.md # 次元発見法
│ ├── DDM_Quick_Reference.md
│ └── Leap_Service_Design.md # Leapサービス設計例
│
├── Architecture/ # 統合アーキテクチャ
│ ├── Framework_Architecture.md # 4層アーキテクチャ
│ ├── Framework_Integration_Map.md # 統合マップ
│ ├── FRAMEWORK_ECOSYSTEM_v2.md # エコシステム概要
│ └── Ecosystem_Overview.md # 全体俯瞰
│
├── reference/ # 参照資料
│ ├── ITF_v2_Gatekeeper.md # ゲートキーパープロトコル
│ └── ITF_v2_Glossary.md # 用語集
│
├── derivation/ # 契約駆動開発
│ ├── README.md # 概要
│ ├── THEORY.md # 理論
│ ├── QUICKSTART.md # クイックスタート
│ ├── INTEGRATION.md # 統合ガイド
│ ├── SYSTEM_PROMPT.md # システムプロンプト
│ └── META_PROMPT.md # メタプロンプト
│
├── sovereign-ai/ # 主権AI（6つ）
│ ├── ESSENCE.md # ★本質（197文字）
│ ├── ARCHITECTURE_v2.md # アーキテクチャ（英語Universal版）
│ ├── ARCHITECTURE_LEVELS_2-4.md # レベル2-4詳細
│ ├── Quick_Reference.md # クイックリファレンス
│ ├── README.md # 日本語概要
│ └── IMPLEMENTATION_GUIDE.md # 実装ガイド
│
├── CLAUDE_CHAT_INSTRUCTIONS.md # ★Claude Chat用プロジェクト指示
├── QUICK_REFERENCES_ALL.md # ★全9フレームワーク統合Quick Reference
│
└── archive/ # アーカイブ（配置不要）
└── (過去バージョン、開発履歴)
```
### フレームワーク階層構造
```
Layer 0（原理層 - 不変）
├── 含んで超える（メタ原理）
├── 2軸×4象限（構造原理）
└── SMCP（メタ認知）
Layer 1（OS層 - 比較的安定）
├── ITF：どう問うか
├── USM：どう構造化するか
├── CEM：どう共に考えるか
├── AAF：どう使われ続けるか
├── TRUST：どう検証するか（横断的）
├── MESH：どう人を理解するか
├── Sovereign AI：どう権限を設計するか
└── ADDE：どう開発を設計するか
Layer 2（パターン層 - 文脈依存）
├── TAT：どう学習→本番を圧縮するか
└── DDM：どう選択空間を拡張するか
Layer 3（実装層 - 具体的実践）
└── プロダクト、サービス、derivation
```
---
## 2. Claude Code 配置
### 配置方法
**原則**: Archive以外すべてを配置
```bash
# frameworks/をワークスペースに配置
docs/frameworks/
# または、プロジェクト内にコピー
cp -r docs/frameworks/* /your/project/frameworks/
```
### 配置ファイル数
| カテゴリ | ファイル数 | 配置 |
| ------------- | ---------- | ------------ |
| core/ | 8 | ✓ |
| os/ | 7 | ✓ |
| Patterns/ | 6 | ✓ |
| Architecture/ | 4 | ✓ |
| reference/ | 2 | ✓ |
| derivation/ | 6 | ✓ |
| sovereign-ai/ | 6 | ✓ |
| ルート | 2 | ✓ |
| archive/ | 約70 | ✗ |
| **合計** | **41** | **配置対象** |
### CLAUDE.mdでの参照
```markdown
## 参照フレームワーク
- **4層アーキテクチャ**: `docs/frameworks/Architecture/Framework_Architecture.md`
- **ITF v2.1**: `docs/frameworks/core/ITF_v2_1.md`
- **TRUST**: `docs/frameworks/os/TRUST_v1.md`
- **主権AI**: `docs/frameworks/sovereign-ai/`
```
---
## 3. Claude Chat 配置
### 最小構成（2ファイル）
```
【プロジェクトの指示】に配置:
→ CLAUDE_CHAT_INSTRUCTIONS.md（131行）
- 基本姿勢（含んで超える）
- 6つの問い（ITF v2.1）
- TRUST検証（3つの問い + Evidence Pyramid）
- 協働の原則（CEM）
- 体系化の原則（USM）
- 三つの警告
- 主権AI原則
- 参照フレームワーク一覧
【ファイル】として配置:
→ QUICK_REFERENCES_ALL.md（399行）
- ITF v2.1 Quick Reference
- USM v1.0 Quick Reference
- CEM v1.0 Quick Reference
- AAF v1.0 Quick Reference
- TRUST v1.0
- TAT v1.0 Quick Reference
- DDM v1.0 Quick Reference
- Sovereign AI v2.0
- ADDE v1.0 Quick Reference
```
### 推奨構成（2ファイル + 主要詳細）
```
【プロジェクトの指示】
→ CLAUDE_CHAT_INSTRUCTIONS.md
【ファイル】として配置:
1. QUICK_REFERENCES_ALL.md ← 必須
2. ITF_v2_1.md ← 思考体系の詳細
3. TRUST_v1.md ← 認知的検証の詳細
4. ESSENCE.md ← 主権AIの本質（197文字）
5. ARCHITECTURE_v2.md ← 主権AIの詳細（必要時）
```
### なぜ2ファイルで足りるか
| 機能 | カバレッジ |
| ---------- | --------------------------------------- |
| 行動指針 | CLAUDE_CHAT_INSTRUCTIONS.md |
| 思考の体系 | QUICK_REFERENCES_ALL.md（ITF） |
| 検証 | QUICK_REFERENCES_ALL.md（TRUST） |
| 協働 | QUICK_REFERENCES_ALL.md（CEM） |
| 構造化 | QUICK_REFERENCES_ALL.md（USM） |
| 採用設計 | QUICK_REFERENCES_ALL.md（AAF） |
| パターン | QUICK_REFERENCES_ALL.md（TAT, DDM） |
| 主権AI | QUICK_REFERENCES_ALL.md（Sovereign AI） |
| 開発環境 | QUICK_REFERENCES_ALL.md（ADDE） |
**詳細が必要な場合のみ個別ファイルを追加**
---
## 4. ファイル一覧（配置対象41ファイル）
### core/ - 核心フレームワーク（8ファイル）
| ファイル | 行数 | 役割 |
| ------------------------- | ---- | ------------------------------------ |
| ITF_v2_1.md | ~800 | 思考の体系（マスターフレームワーク） |
| ITF_v2_Quick_Reference.md | ~150 | ITFクイックリファレンス |
| USM_v1.md | ~400 | 体系化の方法 |
| USM_Quick_Reference.md | ~80 | USMクイックリファレンス |
| CEM_v1.md | ~350 | 協働の方法 |
| CEM_Quick_Reference.md | ~70 | CEMクイックリファレンス |
| AAF_v1.md | ~500 | 採用設計 |
| AAF_Quick_Reference.md | ~100 | AAFクイックリファレンス |
### os/ - OS層（7ファイル）
| ファイル | 行数 | 役割 |
| --------------------------- | ---- | ------------------------ |
| TRUST_v1.md | ~400 | 認知的検証（横断的） |
| MESH_v1.md | ~300 | 人間理解4軸 |
| SMCP_v1.md | ~250 | 物語メタ認知プロトコル |
| MESH_SMCP_Integration_v1.md | ~200 | MESH×SMCP統合 |
| ADDE_v1.md | ~400 | AI駆動開発環境 |
| ADDE_Quick_Reference.md | ~100 | ADDEクイックリファレンス |
| DBC_v1.md | ~200 | 契約駆動開発 |
### Patterns/ - パターン層（6ファイル）
| ファイル | 行数 | 役割 |
| ---------------------- | ---- | ----------------------- |
| Pattern_Index.md | ~100 | パターン索引 |
| TAT_v1.md | ~350 | 試行増幅転移 |
| TAT_Quick_Reference.md | ~80 | TATクイックリファレンス |
| DDM_v1.md | ~350 | 次元発見法 |
| DDM_Quick_Reference.md | ~80 | DDMクイックリファレンス |
| Leap_Service_Design.md | ~200 | Leapサービス設計例 |
### Architecture/ - 統合アーキテクチャ（4ファイル）
| ファイル | 行数 | 役割 |
| ---------------------------- | ---- | ----------------- |
| Framework_Architecture.md | ~300 | 4層アーキテクチャ |
| Framework_Integration_Map.md | ~400 | 統合マップ |
| FRAMEWORK_ECOSYSTEM_v2.md | ~250 | エコシステム概要 |
| Ecosystem_Overview.md | ~150 | 全体俯瞰 |
### reference/ - 参照資料（2ファイル）
| ファイル | 行数 | 役割 |
| -------------------- | ---- | ------------------------ |
| ITF_v2_Gatekeeper.md | ~200 | ゲートキーパープロトコル |
| ITF_v2_Glossary.md | ~300 | 用語集 |
### derivation/ - 契約駆動開発（6ファイル）
| ファイル | 行数 | 役割 |
| ---------------- | ---- | ------------------ |
| README.md | ~100 | 概要 |
| THEORY.md | ~400 | 理論 |
| QUICKSTART.md | ~150 | クイックスタート |
| INTEGRATION.md | ~200 | 統合ガイド |
| SYSTEM_PROMPT.md | ~100 | システムプロンプト |
| META_PROMPT.md | ~100 | メタプロンプト |
### sovereign-ai/ - 主権AI（6ファイル）
| ファイル | 行数 | 役割 |
| -------------------------- | ---- | --------------------------------- |
| ESSENCE.md | 10 | ★本質（197文字） |
| ARCHITECTURE_v2.md | ~600 | アーキテクチャ（英語Universal版） |
| ARCHITECTURE_LEVELS_2-4.md | ~400 | レベル2-4詳細 |
| Quick_Reference.md | ~100 | クイックリファレンス |
| README.md | ~200 | 日本語概要 |
| IMPLEMENTATION_GUIDE.md | ~300 | 実装ガイド |
### ルート - Claude Chat用（2ファイル）
| ファイル | 行数 | 役割 |
| --------------------------- | ---- | --------------------- |
| CLAUDE_CHAT_INSTRUCTIONS.md | 131 | ★プロジェクト指示用 |
| QUICK_REFERENCES_ALL.md | 399 | ★全フレームワーク統合 |
---
## 5. 緊急時リカバリー
### GitHubバックアップ
```bash
# Integrated/はGitHub管理下
git clone https://github.com/seediv/Integrated.git
# または既存リポジトリから取得
cd docs/frameworks
git pull origin main
```
### ローカル復元
```bash
# 全ファイルを新規プロジェクトにコピー
cp -r docs/frameworks/* /path/to/new/project/frameworks/
# archive/は除外
rm -rf /path/to/new/project/frameworks/archive/
```
### Claude Chat再設定
1. **プロジェクトの指示**にCLAUDE_CHAT_INSTRUCTIONS.mdの内容をペースト
2. **ファイル**にQUICK_REFERENCES_ALL.mdをアップロード
3. 必要に応じて追加ファイル（ITF_v2_1.md, TRUST_v1.md, ESSENCE.md）をアップロード
---
## 6. 同期とメンテナンス
### Single Source of Truth
```
Integrated/（正）
↓ 同期
mirror/docs/frameworks/（コピー、/docs/[[...path]]/用）
```
### 同期コマンド
```bash
# Integrated/ → mirror/docs/frameworks/
npm run sync:frameworks
# または手動
cp docs/frameworks/QUICK_REFERENCES_ALL.md \
docs/frameworks/
cp docs/frameworks/CLAUDE_CHAT_INSTRUCTIONS.md \
docs/frameworks/
```
### 更新時の手順
1. Integrated/のファイルを編集
2. `git commit & push`（Integrated/リポジトリ）
3. mirror/docs/frameworks/に同期
4. `git commit & push`（mirrorリポジトリ）
---
## 7. クイック判断フロー
### どの構成を選ぶか
```
Q: Claude CodeかClaude Chatか？
├── Claude Code → Archive以外すべて配置（41ファイル）
└── Claude Chat → 以下へ
Q: 詳細な参照が必要か？
├── 基本的な運用のみ → 最小構成（2ファイル）
│ └── CLAUDE_CHAT_INSTRUCTIONS.md + QUICK_REFERENCES_ALL.md
└── 深い参照も必要 → 推奨構成（2ファイル + α）
└── + ITF_v2_1.md, TRUST_v1.md, ESSENCE.md
```
---
**v1.0 | 2026-01-04**