@unlaxer/dge-toolkit 2.1.2 → 2.2.1

package/README.md

@@ -29,6 +29,9 @@ Claude Code で話しかけるだけ:
 
 言い方は自由。ニュアンスで自動的に適切なモードが選ばれます。
 
+> **Note: auto-merge について**
+> DGE はデフォルトで会話劇と同時に素の LLM レビューもバックグラウンドで実行し、結果をマージします（auto-merge）。Gap の発見精度が上がりますが、API トークン消費が約 2 倍になります。OFF にするには「マージなしで DGE して」と指示するか、flow YAML で `auto_merge: false` を設定してください。
+
 他の LLM は `method.md` のクイックスタート（方法 A）を参照。
 
 ## キャラクター早見表

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.2",
+  "version": "2.2.1",
   "description": "DGE (Dialogue-driven Gap Extraction) — 会話劇で設計の穴を発見するメソッドkit",
   "license": "MIT",
   "repository": {

package/skills/dge-session.md

@@ -32,13 +32,14 @@
 
 ### Step 1: Kit 読み込み（全 flow 共通）
 1. `dge/method.md` を読む（なければ install 案内）
-2. `dge/characters/catalog.md` を読む
-3. `dge/custom/characters/*.md` があれば Prompt Core を読む
+2. `dge/characters/catalog.md` の **使い分け早見表とテーマ別推奨のみ** を読む（各キャラの prompt は Step 4 で選択後に読む — lazy loading）
+3. `dge/custom/characters/*.md` があれば **ファイル名と冒頭の name/icon のみ** 読む（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 なしでも全機能動作
+5. `dge/flows/{判定した flow}.yaml` を読む。**YAML の must_rules, workflow, post_actions, auto_merge を実際に参照して動作を決定する。** YAML がなければ下記のデフォルト動作。
+6. `dge/version.txt` があれば 1 行表示
+7. **dge-tool 検出**: Bash で `dge-tool version` を実行。
+   - 成功 → `🔧 Tool mode (dge-tool vX.X.X)` と表示
+   - 失敗 → Skill mode（従来通り）
 
 ### Step 2: テーマ確認（全 flow 共通）
 明確なら次へ。不明確なら掘り下げる。
@@ -50,15 +51,19 @@
 プリセットを推奨。quick / brainstorm ではスキップ（自動選択）。
 
 ### Step 4: キャラクター提案
-- **quick**: 推奨セットを 1 行表示。確認は求めない。変更したければユーザーが指示。
+- **quick**: 推奨セットを 1 行表示。確認は求めない。
   `キャラ: 今泉 + 千石 + 僕（変更したい場合は指示してください）`
 - **design-review / brainstorm**: 推奨セットを提示し確認を待つ。
 
-built-in + カスタムキャラを統合表示。
+built-in + カスタムキャラの名前・アイコン一覧を表示（Step 1 で読み込み済み）。
+
+**キャラ確定後、選択された 3-5 名の prompt_core と personality セクションのみ読み込む（lazy loading）。** 19 キャラ全員の prompt を読む必要はない。
 
 ### 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 +89,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 でも回してマージ`
 
 **ユーザーの応答を待つ。**
 
@@ -188,7 +203,8 @@ flow YAML の post_actions の id に応じて分岐:
    2. 後で
    ```
 
-5. **マージ結果をファイルに保存**: `dge/sessions/{theme}-merged.md`
+5. **素の LLM の生出力を保存**: `dge/sessions/{theme}-plain-raw.md`（再現性の担保）
+6. **マージ結果をファイルに保存**: `dge/sessions/{theme}-merged.md`
 
 ### Step 10: 累積 Spec 化（design-review のみ）
 同テーマの全 session Gap を統合 → Critical/High を Spec 化 → `dge/specs/` に保存。

package/version.txt

@@ -1 +1 @@
-2.1.2
+2.2.1