@unlaxer/dge-toolkit 2.1.0 → 2.1.2

package/INTERNALS.md

@@ -4,35 +4,92 @@ DGE toolkit の内部構造。カスタマイズする際の参考に。
 
 ## フロー図
 
+### 全体フロー（flow 自動判定 → 分岐）
+
 ```mermaid
 flowchart TD
-    Start([DGE して]) --> S1["[1/10] Kit 読み込み"]
-    S1 --> S2["[2/10] テーマ確認"]
-    S2 --> S3["[3/10] テンプレート選択"]
-    S3 --> S35["[3.5/10] パターン選択"]
-    S35 --> S4["[4/10] キャラ選択 ⏸"]
-    S4 --> S5["[5/10] 会話劇生成"]
-    S5 --> S6["[6/10] 抽出（flow.extract）"]
-    S6 --> S7["[7/10] ファイル保存 + プロジェクト更新"]
-    S7 --> S8["[8/10] サマリー + 選択肢 ⏸"]
-
-    S8 -->|"1. DGE を回す"| S9B["[9B] 前回コンテキスト + TreeView"]
-    S8 -->|"2. 自動反復"| S9A["[9A] 自動反復モード"]
-    S8 -->|"3. 実装する"| S10["[10/10] Spec 化（flow.generate）"]
-    S8 -->|"4. 後で"| End([終了])
-
-    S9B -->|テーマ選択| S2
-    S9A -->|未収束| S5
+    Start(["DGE して"]) --> S0{"Step 0: flow 判定"}
+
+    S0 -->|"DGE して / 壁打ち"| Quick["⚡ quick"]
+    S0 -->|"詳しく / Spec / 設計レビュー"| Full["🔍 design-review"]
+    S0 -->|"ブレスト / アイデア"| Brain["💡 brainstorm"]
+
+    subgraph Quick Flow
+        Q1["Kit 読み込み + dge-tool 検出"] --> Q2["テーマ確認"]
+        Q2 --> Q4["キャラ表示（確認なし）"]
+        Q4 --> Q5["会話劇生成"]
+        Q5 --> Q7["保存（MUST）"]
+        Q7 --> Q8["Gap 一覧 + 選択肢（MUST）"]
+    end
+
+    subgraph Design Review Flow
+        D1["Kit 読み込み + dge-tool 検出"] --> D2["テーマ確認"]
+        D2 --> D3["テンプレート選択"]
+        D3 --> D35["パターン選択"]
+        D35 --> D4["キャラ確認 ⏸"]
+        D4 --> D5["会話劇生成"]
+        D5 --> D6["Gap 構造化"]
+        D6 --> D7["保存（MUST）"]
+        D7 --> D8["Gap 一覧 + 選択肢（MUST）"]
+    end
+
+    subgraph Brainstorm Flow
+        B1["Kit 読み込み + dge-tool 検出"] --> B2["テーマ確認"]
+        B2 --> B4["キャラ確認 ⏸"]
+        B4 --> B5["会話劇生成（Yes-and）"]
+        B5 --> B7["保存（MUST）"]
+        B7 --> B8["アイデア一覧 + 選択肢（MUST）"]
+    end
+
+    Quick --> Q1
+    Full --> D1
+    Brain --> B1
+```
+
+### 選択肢後の分岐
+
+```mermaid
+flowchart TD
+    S8["サマリー + 選択肢 ⏸"] --> C1{"ユーザー選択"}
+
+    C1 -->|"1. DGE を回す"| S9B["前回コンテキスト\n+ TreeView"]
+    C1 -->|"2. 自動反復"| S9A["自動反復モード\n（最大 5 回）"]
+    C1 -->|"3. 実装する"| S10["累積 Spec 化"]
+    C1 -->|"4. 素の LLM マージ"| S9C["subagent\n素レビュー → マージ"]
+    C1 -->|"5. 後で"| End([終了])
+
+    S9B -->|テーマ選択| S2([Step 2 へ])
+    S9A -->|未収束| S5([Step 5 へ])
     S9A -->|収束| S10
+    S9C --> Merge["マージ結果表示 ⏸"]
+    Merge -->|実装する| S10
+    Merge -->|後で| End
 
     S10 --> Review{"Spec レビュー ⏸"}
-    Review -->|"1. OK"| Impl([実装開始])
-    Review -->|"2. 修正"| S10
-    Review -->|"3. 後で"| End
+    Review -->|OK| Impl([実装開始])
+    Review -->|修正| S10
+    Review -->|後で| End
 ```
 
 ⏸ = ユーザーの応答を待つポイント
 
+## dge-tool モード
+
+```mermaid
+flowchart LR
+    S1["Step 1:\ndge-tool version"] -->|成功| TM["🔧 Tool mode"]
+    S1 -->|失敗| SM["📝 Skill mode"]
+
+    TM --> S7T["Step 7: dge-tool save"]
+    TM --> S8T["Step 8: dge-tool prompt"]
+
+    SM --> S7S["Step 7: Write ツール"]
+    SM --> S8S["Step 8: 内蔵選択肢"]
+
+    S7T -->|失敗| S7S
+    S8T -->|失敗| S8S
+```
+
 ## データフロー図
 
 ```mermaid
@@ -44,33 +101,47 @@ flowchart LR
         P[patterns.md]
         F[flows/*.yaml]
         PJ[projects/*.md]
+        DT[dge-tool 検出]
     end
 
     subgraph Engine["DGE エンジン"]
-        S5["Step 5: 会話劇生成"]
-        S6["Step 6: 抽出\n(flow.extract.marker)"]
+        S0["Step 0: flow 判定"]
+        S5["Step 5: 会話劇生成\n(flow.extract.marker)"]
         S10["Step 10: Spec 生成\n(flow.generate.types)"]
+        S9C["Step 9C: subagent\n素 LLM マージ"]
     end
 
     subgraph Output["出力"]
         SE[sessions/*.md]
         SP[specs/*.md]
+        MR[sessions/*-merged.md]
         PR[projects/*.md 更新]
     end
 
-    M & C & CC & P & F --> S5
+    M & C & CC & P --> S5
+    F --> S0
+    S0 --> S5
     PJ --> S5
-    S5 --> S6
-    S6 --> SE
-    S6 --> S10
+    DT --> S5
+    S5 --> SE
+    S5 --> S10
+    S5 --> S9C
     S10 --> SP
-    SE & SP --> PR
+    S9C --> MR
+    SE & SP & MR --> PR
 ```
 
 ## ステート図
 
 ```mermaid
 stateDiagram-v2
+    state "Flow ライフサイクル" as FL {
+        [*] --> quick: デフォルト
+        quick --> design_review: "詳しくやる"
+        quick --> brainstorm: "ブレストして"
+        design_review --> quick: "シンプルに戻す"
+    }
+
     state "プロジェクト" as Project {
         [*] --> not_started
         not_started --> explored: DGE session 実行
@@ -94,34 +165,50 @@ stateDiagram-v2
     }
 ```
 
+## 3 つの flow の比較
+
+| | ⚡ quick | 🔍 design-review | 💡 brainstorm |
+|---|---------|------------------|---------------|
+| Steps | 5 | 10 | 6 |
+| 共通 MUST | 3 | 3 | 3 |
+| 固有 MUST | 0 | 4 | 1 |
+| テンプレート | スキップ | 選択 | スキップ |
+| パターン | 自動 | 選択 | 自動 |
+| キャラ確認 | 表示のみ | 確認待ち | 確認待ち |
+| 抽出 | Gap | Gap | アイデア |
+| Spec 化 | なし | あり | なし |
+| 話法 | 標準 | 標準 | Yes-and |
+
 ## Hook ポイント一覧
 
-各 Step でカスタマイズ可能なポイント。Level 1 は YAML / ファイル追加で変更可能。Level 2 は skill 編集（fork 推奨）。
-
-| Step | 名前 | Hook | Level |
-|------|------|------|-------|
-| 1 | Kit 読み込み | 読み込むファイル一覧 | 2 |
-| 2 | テーマ確認 | テーマの掘り下げロジック | 2 |
-| 3 | テンプレート選択 | テンプレートの追加 | 1（templates/ にファイル追加） |
-| 3.5 | パターン選択 | プリセットの追加・推奨マッピング | 1（patterns.md 編集） |
-| 4 | キャラ選択 | キャラの追加・推奨ロジック | 1（custom/characters/）/ 2（推奨ロジック） |
-| 5 | 会話劇生成 | ナレーション構造・Scene 構成 | 2 |
-| 6 | 抽出 | マーカー・フォーマット・カテゴリ | 1（flows/ YAML の extract） |
-| 7 | 保存 | 保存先・ファイル名規則 | 1（flows/ YAML の output_dir）/ 2 |
-| 8 | 選択肢 | 選択肢の構成 | 1（flows/ YAML の post_actions） |
-| 9A | 自動反復 | 収束判定・上限・ローテーション | 2 |
-| 9B | コンテキスト維持 | TreeView・テーマ選択 | 2 |
-| 10 | Spec 生成 | 成果物タイプ・テンプレート | 1（flows/ YAML の generate） |
+| Step | 名前 | Hook | Level | dge-tool |
+|------|------|------|-------|----------|
+| 0 | flow 判定 | trigger_keywords | 1（YAML） | — |
+| 1 | Kit 読み込み | 読み込むファイル一覧 | 2 | version 検出 |
+| 2 | テーマ確認 | 掘り下げロジック | 2 | — |
+| 3 | テンプレート選択 | テンプレート追加 | 1（templates/） | — |
+| 3.5 | パターン選択 | プリセット追加 | 1（patterns.md） | — |
+| 4 | キャラ選択 | キャラ追加・推奨 | 1（custom/）/ 2 | — |
+| 5 | 会話劇生成 | ナレーション・Scene | 2 | — |
+| 6 | 抽出 | マーカー・カテゴリ | 1（YAML extract） | — |
+| 7 | 保存 | 保存先・ファイル名 | 1（YAML output_dir） | **save** |
+| 8 | 選択肢 | 選択肢構成 | 1（YAML post_actions） | **prompt** |
+| 9A | 自動反復 | 収束判定・上限 | 2 | — |
+| 9B | コンテキスト | TreeView・テーマ | 2 | — |
+| 9C | LLM マージ | subagent 実行 | 2 | — |
+| 10 | Spec 生成 | 成果物タイプ | 1（YAML generate） | — |
 
 ## ファイルマップ
 
 | ファイル | 役割 | 誰が読む | 誰が書く |
 |---------|------|---------|---------|
-| method.md | メソッド本体 | Step 1 | 手動（toolkit 提供） |
-| characters/catalog.md | built-in キャラ | Step 1, 4 | 手動（toolkit 提供） |
-| custom/characters/*.md | カスタムキャラ | Step 1, 4 | dge-character-create skill |
-| patterns.md | 20 パターン + 5 プリセット | Step 1, 3.5 | 手動（toolkit 提供） |
-| flows/*.yaml | フロー定義 | Step 1, 6, 8, 10 | 手動 or フロー wizard（v2） |
+| method.md | メソッド本体 | Step 1 | toolkit 提供 |
+| characters/catalog.md | built-in 19 キャラ | Step 1, 4 | toolkit 提供 |
+| custom/characters/*.md | カスタムキャラ | Step 1, 4 | dge-character-create |
+| patterns.md | 20 パターン + 9 プリセット | Step 1, 3.5 | toolkit 提供 |
+| dialogue-techniques.md | 8 会話技法 | Step 5 | toolkit 提供 |
+| flows/*.yaml | フロー定義 | Step 0, 6, 7, 8, 10 | toolkit 提供 or ユーザー |
 | sessions/*.md | DGE session 出力 | Step 9B, 10 | Step 7（自動） |
 | specs/*.md | Spec ファイル | 実装時 | Step 10（自動） |
 | projects/*.md | プロジェクト管理 | Step 9B | Step 7（自動更新） |
+| bin/dge-tool.js | MUST 強制 CLI | Step 1, 7, 8 | toolkit 提供 |

package/bin/dge-tool.js

@@ -82,19 +82,112 @@ function cmdVersion() {
   console.log(`dge-tool v${VERSION}`);
 }
 
+function cmdCompare() {
+  // Reads two JSON gap lists from stdin and generates comparison table
+  // Input format: { "dge": [...gaps], "plain": [...gaps] }
+  let input = '';
+  process.stdin.setEncoding('utf8');
+  process.stdin.on('data', chunk => { input += chunk; });
+  process.stdin.on('end', () => {
+    try {
+      const data = JSON.parse(input);
+      const dge = data.dge || [];
+      const plain = data.plain || [];
+
+      // Simple title-based dedup
+      const dgeSet = new Set(dge.map(g => g.gap.toLowerCase().trim()));
+      const plainSet = new Set(plain.map(g => g.gap.toLowerCase().trim()));
+
+      const both = [];
+      const dgeOnly = [];
+      const plainOnly = [];
+
+      for (const g of dge) {
+        const key = g.gap.toLowerCase().trim();
+        // Check if any plain gap is similar (substring match or word overlap)
+        let found = false;
+        for (const p of plain) {
+          const pKey = p.gap.toLowerCase().trim();
+          // Substring check (works for Japanese)
+          const isSubstring = key.includes(pKey) || pKey.includes(key);
+          // Word overlap for English
+          const gWords = new Set(key.split(/[\s/・、。]+/).filter(w => w.length > 1));
+          const pWords = new Set(pKey.split(/[\s/・、。]+/).filter(w => w.length > 1));
+          const overlap = [...gWords].filter(w => pWords.has(w)).length;
+          const similarity = overlap / Math.min(gWords.size, pWords.size);
+          if (isSubstring || similarity > 0.5) {
+            both.push({ ...g, source: '両方', plain_match: p.gap });
+            found = true;
+            plainSet.delete(pKey);
+            break;
+          }
+        }
+        if (!found) dgeOnly.push({ ...g, source: 'DGE のみ' });
+      }
+
+      for (const p of plain) {
+        const pKey = p.gap.toLowerCase().trim();
+        if (plainSet.has(pKey)) {
+          plainOnly.push({ ...p, source: '素のみ' });
+        }
+      }
+
+      // Stats
+      const dgeC = dge.filter(g => g.severity === 'Critical').length;
+      const dgeH = dge.filter(g => g.severity === 'High').length;
+      const plainC = plain.filter(g => g.severity === 'Critical').length;
+      const plainH = plain.filter(g => g.severity === 'High').length;
+
+      console.log('## マージ結果: DGE + 素の LLM（isolated）');
+      console.log('');
+      console.log('### 数値比較');
+      console.log('| 指標 | DGE | 素の LLM |');
+      console.log('|------|-----|---------|');
+      console.log(`| Gap 総数 | ${dge.length} | ${plain.length} |`);
+      console.log(`| Critical | ${dgeC} | ${plainC} |`);
+      console.log(`| High | ${dgeH} | ${plainH} |`);
+      console.log('');
+      console.log('### Gap 一覧（統合）');
+      console.log('| # | Gap | Source | Severity |');
+      console.log('|---|-----|--------|----------|');
+
+      let n = 1;
+      for (const g of both) {
+        console.log(`| ${n++} | ${g.gap} | 両方 | ${g.severity} |`);
+      }
+      for (const g of dgeOnly) {
+        console.log(`| ${n++} | ${g.gap} | DGE のみ | ${g.severity} |`);
+      }
+      for (const g of plainOnly) {
+        console.log(`| ${n++} | ${g.gap} | 素のみ | ${g.severity} |`);
+      }
+
+      console.log('');
+      console.log(`DGE のみ: ${dgeOnly.length} 件（深い洞察）`);
+      console.log(`素のみ: ${plainOnly.length} 件（網羅的チェック）`);
+      console.log(`両方: ${both.length} 件（確実に重要）`);
+    } catch (e) {
+      console.error('ERROR: invalid JSON input. Expected: { "dge": [...], "plain": [...] }');
+      process.exit(1);
+    }
+  });
+}
+
 function cmdHelp() {
   console.log(`dge-tool v${VERSION} — DGE MUST enforcement CLI
 
 Commands:
   save <file>       Save stdin to file (ensures MUST: always save)
   prompt [flow]     Show numbered choices from flow YAML (ensures MUST: show choices)
+  compare           Merge DGE + plain gaps from stdin JSON (isolated comparison)
   version           Show version
   help              Show this help
 
 Examples:
   echo "session content" | dge-tool save dge/sessions/auth-api.md
   dge-tool prompt quick
-  dge-tool prompt design-review`);
+  dge-tool prompt design-review
+  echo '{"dge":[...],"plain":[...]}' | dge-tool compare`);
 }
 
 // Dispatch
@@ -105,6 +198,9 @@ switch (command) {
   case 'prompt':
     cmdPrompt();
     break;
+  case 'compare':
+    cmdCompare();
+    break;
   case 'version':
   case '-v':
   case '--version':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unlaxer/dge-toolkit",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "DGE (Dialogue-driven Gap Extraction) — 会話劇で設計の穴を発見するメソッドkit",
   "license": "MIT",
   "repository": {

package/skills/dge-session.md

@@ -133,8 +133,62 @@ flow YAML の post_actions の id に応じて分岐:
 ### Step 9B: 前回コンテキスト + プロジェクトナビゲーション
 プロジェクトファイルがあれば TreeView 表示。なければ前回サマリー + 3 択。
 
-### Step 9C: 素の LLM マージ
-subagent で同じテーマを素でレビュー → DGE Gap とマージ → DGE のみ / 素のみ / 両方 をラベル付け。
+### Step 9C: 素の LLM マージ（isolated subagent）
+
+**重要: DGE の結果を知らない独立した agent で素のレビューを行う。** これにより DGE の Gap を「補完する」バイアスを排除する。
+
+1. **isolated subagent を起動**: Agent ツールで `isolation: "worktree"` を指定。
+   DGE session の context を一切持たない別プロセスが実行する。
+
+   subagent へのプロンプト:
+   ```
+   以下の設計ドキュメントをレビューしてください。
+   問題点、考慮漏れ、矛盾を全て挙げてください。
+   各問題に Category と Severity (Critical / High / Medium / Low) をつけてください。
+   テーブル形式で出力: | # | Gap | Category | Severity |
+
+   [テーマの設計ドキュメント / コンテキスト]
+   ```
+
+   **subagent には DGE の Gap 一覧や会話劇を渡さない。** 完全に独立したレビュー。
+
+2. **素の Gap 一覧を受け取る**
+
+3. **DGE の Gap と素の Gap をマージ**:
+   - Gap タイトルの意味的類似度で重複を判定
+   - 同じ問題 → 「両方」ラベル（信頼度が高い）
+   - DGE のみ → 「DGE のみ」ラベル（深い洞察の可能性）
+   - 素のみ → 「素のみ」ラベル（網羅的チェック）
+
+4. **比較表を表示**:
+   ```
+   ## マージ結果: DGE + 素の LLM（isolated）
+
+   ### 数値比較
+   | 指標 | DGE | 素の LLM |
+   |------|-----|---------|
+   | Gap 総数 | N | N |
+   | Critical | N | N |
+   | High | N | N |
+   | カテゴリ数 | N/11 | N/11 |
+
+   ### Gap 一覧（統合）
+   | # | Gap | Source | Severity |
+   |---|-----|--------|----------|
+   | 1 | [gap] | DGE のみ | High |
+   | 2 | [gap] | 両方 | Critical |
+   | 3 | [gap] | 素のみ | Medium |
+
+   DGE のみ: N 件（深い洞察）
+   素のみ: N 件（網羅的チェック）
+   両方: N 件（確実に重要）
+
+   どうしますか？
+   1. 実装する → マージ済み Gap から Spec 化
+   2. 後で
+   ```
+
+5. **マージ結果をファイルに保存**: `dge/sessions/{theme}-merged.md`
 
 ### Step 10: 累積 Spec 化（design-review のみ）
 同テーマの全 session Gap を統合 → Critical/High を Spec 化 → `dge/specs/` に保存。

package/version.txt

@@ -1 +1 @@
-2.1.0
+2.1.2