@unlaxer/dge-toolkit 2.1.1 → 2.2.0

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/flows/brainstorm.yaml

@@ -1,5 +1,6 @@
 name: brainstorm
 display_name: "💡 ブレスト — アイデアを発散させる"
+auto_merge: false  # ブレストは素のレビュー不要
 
 trigger_keywords: ["ブレスト", "brainstorm", "アイデア", "発想"]
 

package/flows/design-review.yaml

@@ -1,5 +1,6 @@
 name: design-review
 display_name: "🔍 設計レビュー — 仕様の穴を見つけて Spec に変換"
+auto_merge: true
 
 trigger_keywords: ["詳しく", "本格的に", "full", "設計レビュー", "Spec"]
 

package/flows/quick.yaml

@@ -1,5 +1,6 @@
 name: quick
 display_name: "⚡ クイック — 会話劇で Gap を見つける"
+auto_merge: true  # 素の LLM レビューを自動でバックグラウンド実行。false で無効化
 
 trigger_keywords: ["DGE して", "DGE", "壁打ち", "gap を探して"]
 

package/package.json

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

package/skills/dge-session.md

@@ -59,6 +59,8 @@ built-in + カスタムキャラを統合表示。
 ### Step 5: 会話劇生成（全 flow 共通）
 - flow の extract.marker を使う（デフォルト: `→ Gap 発見:`、brainstorm: `→ アイデア:`）
 - 先輩（ナレーション）で背景設定 → キャラ対話 → マーカー挿入
+- **auto_merge が true（デフォルト）の場合**: 会話劇生成と同時に、バックグラウンドで isolated subagent を起動して素の LLM レビューを開始する。subagent は `isolation: "worktree"` で DGE の context を持たない。会話劇が終わる頃には素のレビューも完了している。
+- auto_merge を OFF にしたい場合: 「マージなしで DGE して」と指示するか、flow YAML で `auto_merge: false` を設定
 
 ### Step 6: 構造化（flow による）
 - quick / design-review: Gap に Category + Severity を付与
@@ -84,29 +86,39 @@ flow の output_dir に保存（デフォルト: `dge/sessions/`）。
 
 **Flow**: [flow 名]
 **テーマ**: [テーマ]
-**Gap/アイデア数**: N 件
 
-| # | Gap/Idea | Severity |
-|---|---------|----------|
+### DGE の発見
+**Gap 数**: N 件（Critical: X / High: X / Medium: X）
+
+| # | Gap | Severity |
+|---|-----|----------|
 （主要なものを表示）
 
+### 素の LLM の発見（auto_merge ON の場合）
+**Gap 数**: N 件（isolated subagent による独立レビュー）
+
+### マージ結果（auto_merge ON の場合）
+| # | Gap | Source | Severity |
+|---|-----|--------|----------|
+| 1 | ... | DGE のみ | High |
+| 2 | ... | 両方 | Critical |
+| 3 | ... | 素のみ | Medium |
+
+DGE のみ: N 件（深い洞察） / 素のみ: N 件（網羅的） / 両方: N 件（確実に重要）
+
 **全文**: `[ファイルパス]`
 ```
 
-**Tool mode**: Bash で実行:
-```
-dge-tool prompt <flow>
-```
-→ 番号付き選択肢が返る。そのまま表示。失敗したらデフォルト選択肢でフォールバック。
+auto_merge OFF の場合はマージ結果を省略し、DGE の発見のみ表示。
 
-**Skill mode**: 選択肢は flow YAML の post_actions から表示。YAML がない場合のデフォルト:
+選択肢は flow YAML の post_actions から表示。デフォルト:
 ```
 1. DGE を回す
 2. 実装できるまで回す
 3. 実装する
-4. 素の LLM でも回してマージ
-5. 後で
+4. 後で
 ```
+auto_merge OFF の場合のみ追加: `5. 素の LLM でも回してマージ`
 
 **ユーザーの応答を待つ。**
 
@@ -133,8 +145,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.1
+2.2.0