@unlaxer/dge-toolkit 2.0.1 → 2.1.1

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

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+const VERSION = '1.0.0';
+const command = process.argv[2];
+const arg = process.argv[3];
+
+function findFlowsDir() {
+  // Look for dge/flows/ from current directory
+  const candidates = ['dge/flows', 'flows'];
+  for (const dir of candidates) {
+    if (fs.existsSync(dir)) return dir;
+  }
+  return null;
+}
+
+function cmdSave() {
+  const file = arg;
+  if (!file) {
+    console.error('ERROR: file path required. Usage: echo "content" | dge-tool save <file>');
+    process.exit(1);
+  }
+
+  const dir = path.dirname(file);
+  fs.mkdirSync(dir, { recursive: true });
+
+  let content = '';
+  process.stdin.setEncoding('utf8');
+  process.stdin.on('data', chunk => { content += chunk; });
+  process.stdin.on('end', () => {
+    fs.writeFileSync(file, content);
+    const bytes = Buffer.byteLength(content);
+    console.log(`SAVED: ${file} (${bytes} bytes)`);
+  });
+}
+
+function cmdPrompt() {
+  const flow = arg || 'quick';
+  const flowsDir = findFlowsDir();
+  const yamlFile = flowsDir ? path.join(flowsDir, `${flow}.yaml`) : null;
+
+  if (yamlFile && fs.existsSync(yamlFile)) {
+    const content = fs.readFileSync(yamlFile, 'utf8');
+    const lines = content.split('\n');
+
+    // Extract display_name from post_actions section
+    let inPostActions = false;
+    const actions = [];
+    for (const line of lines) {
+      if (line.match(/^post_actions:/)) {
+        inPostActions = true;
+        continue;
+      }
+      if (inPostActions && line.match(/^\S/) && !line.match(/^\s/)) {
+        break; // End of post_actions section
+      }
+      if (inPostActions) {
+        const match = line.match(/display_name:\s*"(.+?)"/);
+        if (match) actions.push(match[1]);
+      }
+    }
+
+    if (actions.length > 0) {
+      actions.forEach((a, i) => {
+        console.log(`  ${i + 1}. ${a}`);
+      });
+      return;
+    }
+  }
+
+  // Default choices
+  console.log('  1. DGE を回す');
+  console.log('  2. 実装できるまで回す');
+  console.log('  3. 実装する');
+  console.log('  4. 素の LLM でも回してマージ');
+  console.log('  5. 後で');
+}
+
+function cmdVersion() {
+  console.log(`dge-tool v${VERSION}`);
+}
+
+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)
+  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`);
+}
+
+// Dispatch
+switch (command) {
+  case 'save':
+    cmdSave();
+    break;
+  case 'prompt':
+    cmdPrompt();
+    break;
+  case 'version':
+  case '-v':
+  case '--version':
+    cmdVersion();
+    break;
+  case 'help':
+  case '-h':
+  case '--help':
+  case undefined:
+    cmdHelp();
+    break;
+  default:
+    console.error(`ERROR: unknown command "${command}". Run "dge-tool help" for usage.`);
+    process.exit(1);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unlaxer/dge-toolkit",
-  "version": "2.0.1",
+  "version": "2.1.1",
   "description": "DGE (Dialogue-driven Gap Extraction) — 会話劇で設計の穴を発見するメソッドkit",
   "license": "MIT",
   "repository": {
@@ -18,7 +18,8 @@
   ],
   "bin": {
     "dge-install": "./install.sh",
-    "dge-update": "./update.sh"
+    "dge-update": "./update.sh",
+    "dge-tool": "./bin/dge-tool.js"
   },
   "files": [
     "LICENSE",
@@ -34,6 +35,7 @@
     "INTERNALS.md",
     "CUSTOMIZING.md",
     "dialogue-techniques.md",
+    "bin/",
     "install.sh",
     "update.sh"
   ],

package/skills/dge-session.md

@@ -36,6 +36,9 @@
 3. `dge/custom/characters/*.md` があれば Prompt Core を読む
 4. `dge/patterns.md` を読む
 5. `dge/version.txt` があれば 1 行表示
+6. **dge-tool 検出**: Bash で `dge-tool version` を実行。
+   - 成功 → `🔧 Tool mode (dge-tool vX.X.X)` と表示。以降 Step 7, 8 で dge-tool を使用
+   - 失敗 → Skill mode（従来通り）。dge-tool なしでも全機能動作
 
 ### Step 2: テーマ確認（全 flow 共通）
 明確なら次へ。不明確なら掘り下げる。
@@ -62,6 +65,15 @@ built-in + カスタムキャラを統合表示。
 - brainstorm: アイデアに分類を付与（severity なし）
 
 ### Step 7: 保存（全 flow 共通、MUST）
+
+**Tool mode**: Bash で実行:
+```
+echo "<session 全文>" | dge-tool save <output_dir>/<theme>.md
+```
+→ "SAVED: ..." が返れば成功。失敗したら Write ツールでフォールバック。
+
+**Skill mode**: Write ツールでファイル保存。
+
 flow の output_dir に保存（デフォルト: `dge/sessions/`）。
 プロジェクトファイルがあれば更新。
 
@@ -81,7 +93,13 @@ flow の output_dir に保存（デフォルト: `dge/sessions/`）。
 **全文**: `[ファイルパス]`
 ```
 
-選択肢は flow YAML の post_actions から表示。YAML がない場合のデフォルト:
+**Tool mode**: Bash で実行:
+```
+dge-tool prompt <flow>
+```
+→ 番号付き選択肢が返る。そのまま表示。失敗したらデフォルト選択肢でフォールバック。
+
+**Skill mode**: 選択肢は flow YAML の post_actions から表示。YAML がない場合のデフォルト:
 ```
 1. DGE を回す
 2. 実装できるまで回す

package/version.txt

@@ -1 +1 @@
-2.0.1
+2.1.1