@unlaxer/dge-toolkit 2.1.1 → 2.1.2

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.1",
+  "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.1
+2.1.2