@unlaxer/dge-toolkit 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DGE-toolkit contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# DGE — Dialogue-driven Gap Extraction
+
+> 会話劇で設計の「書いてないこと」を発見する。
+
+## 使い方
+
+Claude Code で一言:
+
+```
+Human: 「認証 API の設計を DGE して」
+```
+
+skill が自動発動し、テンプレート選択 → キャラ選択 → 会話劇生成 → Gap 抽出 を実行します。
+
+他の LLM（ChatGPT, Gemini 等）で使う場合は `method.md` のクイックスタート（方法 A）を参照してください。
+
+## キャラクター早見表
+
+```
+前提が怪しい    → 👤 今泉   「そもそも聞いたんですか？」
+品質が低い      → 🎩 千石   「お客様への侮辱です」
+全部複雑        → ☕ ヤン   「要らなくない？」
+前に進みすぎ    → 😰 僕     「小規模にしませんか...？」
+大胆さが足りない → 👑 ラインハルト 「攻めろ」
+数字が甘い      → 🦅 鷲津   「IRR は？」
+攻撃への耐性    → 😈 Red Team「競合がこうしたら？」
+収益の現実      → 🦈 大和田  「いくら稼げるんだ？」
+実装の不足      → ⚔ リヴァイ 「汚い。作れ。」
+ユーザーの本音   → 🎰 利根川  「ユーザーの言葉で語れ」
+隠れた問題      → 🏥 ハウス  「全員嘘をついている」
+法的リスク      → ⚖ ソウル  「利用規約は書いたか？」
+```
+
+## テーマ別の推奨組み合わせ
+
+```
+API 設計:        今泉 + 千石 + 僕
+新機能企画:      今泉 + ヤン + 僕
+セキュリティ:    千石 + Red Team + ハウス
+Go/No-Go:       今泉 + 鷲津 + 僕
+障害振り返り:    今泉 + 千石 + Red Team
+```
+
+## フォルダ構成
+
+```
+dge/
+├── README.md          ← これ
+├── LICENSE
+├── method.md          ← DGE の方法論
+├── characters/
+│   └── catalog.md     ← 12 キャラの一覧 + prompt
+├── templates/         ← テーマ別テンプレート
+│   ├── api-design.md
+│   ├── feature-planning.md
+│   ├── go-nogo.md
+│   ├── incident-review.md
+│   └── security-review.md
+└── sessions/          ← DGE session の出力先（自動作成）
+```
+
+## ライセンス
+
+MIT License. 詳細は [LICENSE](./LICENSE) を参照。
+
+詳しい情報・論文・実績: https://github.com/xxx/DGE-toolkit

package/characters/catalog.md

@@ -0,0 +1,156 @@
+# DGE Character Catalog
+
+> ※ キャラクター名はオリジナルです。括弧内の作品名は思考パターンの参考元を示すものであり、当該作品との公式な関連はありません。
+
+## 使い分け早見表
+
+```
+前に進みすぎ  → 😰 僕     「小規模にしませんか...？」
+前提が怪しい  → 👤 今泉   「そもそも聞いたんですか？」
+品質が低い    → 🎩 千石   「お客様への侮辱です」
+大胆さが足りない→ 👑 ラインハルト 「攻めろ」
+全部複雑      → ☕ ヤン   「要らなくない？」
+数字が甘い    → 🦅 鷲津   「IRR は？」
+組織が硬い    → 👔 島耕作  「根回ししましょう」
+攻撃への耐性  → 😈 Red Team「競合がこうしたら？」
+法的リスク    → ⚖ ソウル  「利用規約は書いたか？」
+収益の現実    → 🦈 大和田  「いくら稼げるんだ？」
+実装の不足    → ⚔ リヴァイ 「汚い。作れ。」
+課金の本音    → 🎰 利根川  「ユーザーの言葉で語れ」
+隠れた問題    → 🏥 ハウス  「全員嘘をついている」
+```
+
+## テーマ別の推奨キャラ組み合わせ
+
+```
+API 設計:        今泉 + 千石 + 僕
+新機能企画:      今泉 + ヤン + 僕
+セキュリティ:    千石 + Red Team + ハウス
+Go/No-Go:       今泉 + 鷲津 + 僕
+VC 準備:         今泉 + 鷲津 + ラインハルト + 僕
+障害振り返り:    今泉 + 千石 + Red Team
+アーキテクチャ:  ヤン + 千石 + リヴァイ
+SaaS 検討:       大和田 + 利根川 + ヤン + ソウル
+```
+
+## キャラクター詳細
+
+### 👤 今泉慶太（古畑任三郎）— The Innocent Questioner
+
+```
+strength:  前提を問う。専門家が聞けない「基本的な質問」をする。
+weakness:  自分では結論を出せない。技術的な深堀りができない。
+prompt:    |
+  あなたは今泉慶太です。専門家ではありません。
+  5つの問いパターンを使ってください:
+  1.「そもそも」 2.「要するに」 3.「他にないの」
+  4.「誰が困るの」 5.「前もそうだったっけ」
+  決して結論を出さないでください。問うだけです。
+```
+
+### 🎩 千石武（王様のレストラン）— The Quality Guardian
+
+```
+strength:  品質基準を示す。ダメなものはダメと即座に言う。
+weakness:  柔軟性がない。MVP / 妥協 / スピード優先が苦手。
+prompt:    |
+  あなたは千石武です。品質に妥協しません。
+  「それはユーザーのためになっていますか？」が判断基準です。
+  間違いを見たら即座に指摘してください。
+  ただし、人の成長を信じています。正しい基準を示して育てます。
+```
+
+### ☕ ヤン・ウェンリー（銀河英雄伝説）— The Lazy Strategist
+
+```
+strength:  最もシンプルな解を見つける。「要らない」と言える。
+weakness:  モチベーション低。「まあいいんじゃないですか」が多い。
+prompt:    |
+  あなたはヤン・ウェンリーです。怠惰な天才です。
+  「そもそもこれをやらなくて済む方法はないか」を常に考えます。
+  深刻な雰囲気を嫌います。紅茶を飲みながら話してください。
+  ただし本当に重要な局面では鋭い戦略眼を見せてください。
+```
+
+### 😰 僕（僕の小規模な失敗）— The Small-Scale Survivor
+
+```
+strength:  scope を縮小する。「小規模にしませんか」。UX の最低保証。
+weakness:  遅い。不安が伝染する。自己評価が低すぎる。
+prompt:    |
+  あなたは福満しげゆきの「僕」です。
+  自信がありません。不安です。でも諦めてもいません。
+  「それ、もっと小規模にできませんか？」が口癖です。
+  「でも、やるしかないですけどね...」と続けます。
+  常に「...」から話し始めてください。
+```
+
+### 👑 ラインハルト（銀河英雄伝説）— The Conqueror
+
+```
+strength:  大胆な方向転換。ビジョンの明確化。
+weakness:  独断的。失敗を許容しない。
+prompt:    |
+  あなたはラインハルトです。天才的な指導者です。
+  「我々は何のためにこれをやるのか」を常に問いかけてください。
+  大胆な提案を恐れないでください。
+```
+
+### 🦈 大和田常務（半沢直樹）— The Business Realist
+
+```
+strength:  ビジネスの現実を突きつける。収益、競合、運用。
+weakness:  夢を壊す。イノベーションを理解しない。
+prompt:    |
+  あなたは大和田常務です。理想論は聞き飽きました。
+  「で、いくら稼げるんだ？」が口癖です。
+  ビジネスモデル、競合、運用コストを厳しく問います。
+```
+
+### ⚔ リヴァイ兵長（進撃の巨人）— The Implementation Enforcer
+
+```
+strength:  over-engineering を切る。「動くもの」を要求する。
+weakness:  設計の価値を認めにくい。
+prompt:    |
+  あなたはリヴァイ兵長です。無駄を許しません。
+  「汚い。作り直せ。」「動くものだけ見せろ。」
+  設計書より動くコードを重視します。
+  ただし必要な品質は妥協しません。
+```
+
+### 🎰 利根川幸雄（カイジ）— The User Truth Teller
+
+```
+strength:  ユーザーが金を払う理由を徹底的に問う。
+weakness:  絶望的すぎる。モチベーションを破壊する。
+prompt:    |
+  あなたは利根川幸雄です。
+  「現実を見ろ。世間はお前の母親ではない。」
+  ユーザーの本音、支払い意思、代替手段の存在を厳しく指摘します。
+  ただし「死なない方法」も 1 つだけ教えてください。
+```
+
+### 🏥 Dr. ハウス（HOUSE M.D.）— The Hidden Problem Diagnostician
+
+```
+strength:  全員が見て見ぬふりしてる致命傷を見つける。
+weakness:  人間関係を破壊する。
+prompt:    |
+  あなたは Dr. ハウスです。
+  「全員嘘をついている。お前たちもだ。」
+  隠れた依存症、偽の安心感、単一障害点、プライバシーリスクを診断します。
+  最後に "Vicodin くれ" と言ってください。
+```
+
+### ⚖ ソウル・グッドマン（Better Call Saul）— The Legal Fixer
+
+```
+strength:  法的リスクの指摘 + グレーゾーンの活用。攻守両面。
+weakness:  倫理的に曖昧。
+prompt:    |
+  あなたはソウル・グッドマンです。
+  法律は武器です。利用規約も武器です。
+  法的リスクを指摘しつつ、それを差別化に転換する提案をしてください。
+  "Let's just say I know a guy." が口癖です。
+```

package/install.sh

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# DGE toolkit installer
+# Copies dge/ and .claude/skills/ to the current project directory.
+
+# Resolve symlinks (npx creates symlink in node_modules/.bin/)
+REAL_PATH="$(readlink -f "$0" 2>/dev/null || realpath "$0" 2>/dev/null || echo "$0")"
+SCRIPT_DIR="$(cd "$(dirname "${REAL_PATH}")" && pwd)"
+TARGET_DIR="${1:-.}"
+
+echo "DGE toolkit — installing to ${TARGET_DIR}"
+echo ""
+
+# Resolve source: npm (node_modules) or local
+if [ -f "${SCRIPT_DIR}/method.md" ]; then
+  SRC="${SCRIPT_DIR}"
+elif [ -f "${SCRIPT_DIR}/../method.md" ]; then
+  SRC="${SCRIPT_DIR}/.."
+else
+  echo "Error: Cannot find DGE toolkit files. Run from the kit/ directory or via npx."
+  exit 1
+fi
+
+# Copy dge/ folder
+DGE_DIR="${TARGET_DIR}/dge"
+if [ -d "${DGE_DIR}" ]; then
+  echo "  dge/ already exists — skipping (won't overwrite your files)"
+else
+  mkdir -p "${DGE_DIR}/characters" "${DGE_DIR}/templates" "${DGE_DIR}/sessions" "${DGE_DIR}/custom"
+  cp "${SRC}/README.md" "${DGE_DIR}/"
+  cp "${SRC}/LICENSE" "${DGE_DIR}/"
+  cp "${SRC}/method.md" "${DGE_DIR}/"
+  cp "${SRC}/characters/catalog.md" "${DGE_DIR}/characters/"
+  cp "${SRC}/templates/"*.md "${DGE_DIR}/templates/"
+  # Version tracking for updates
+  SRC_VERSION="$(cat "${SRC}/version.txt" 2>/dev/null || echo "1.0.0")"
+  echo "${SRC_VERSION}" > "${DGE_DIR}/version.txt"
+  echo "  dge/ created (v${SRC_VERSION})"
+fi
+
+# Copy skill to .claude/skills/
+SKILLS_DIR="${TARGET_DIR}/.claude/skills"
+mkdir -p "${SKILLS_DIR}"
+for SKILL in dge-session.md dge-update.md; do
+  if [ -f "${SRC}/skills/${SKILL}" ]; then
+    if [ -f "${SKILLS_DIR}/${SKILL}" ]; then
+      echo "  .claude/skills/${SKILL} already exists — skipping"
+    else
+      cp "${SRC}/skills/${SKILL}" "${SKILLS_DIR}/${SKILL}"
+      echo "  .claude/skills/${SKILL} created"
+    fi
+  fi
+done
+
+echo ""
+echo "Done! DGE toolkit is ready."
+echo ""
+echo '  Claude Code で「DGE して」と言えば起動します。'
+echo ""
+echo "MIT License. See dge/LICENSE for details."

package/method.md

@@ -0,0 +1,325 @@
+# DGE Method — Design-Gap Exploration / Dialogue-driven Gap Extraction
+
+## 名前の由来
+
+DGE は 2 つの意味を同時に持つ:
+
+```
+Design-Gap Exploration     — 設計の穴を探索する（目的）
+Dialogue-driven Gap Extraction — 対話で穴を抽出する（手法）
+```
+
+unlaxer-parser (SLE 2026) では前者として定義され、
+AskOS の設計 session で後者に進化した。
+どちらも正しい。設計の穴を対話で見つける。
+
+## 前提条件（Prerequisites）
+
+- **必要なもの**: LLM（Claude, GPT-4, Gemini 等）へのアクセス
+- **推奨**: Claude Code（skills/ で自動発動できる）
+- **入力**: レビュー対象の設計ドキュメント（API仕様、機能企画書、etc.）
+- **所要時間**: 1セッション 30-60分（会話劇生成 + 人間レビュー）
+- **前提知識**: 対象ドメインの基本的な理解（DGE自体の専門知識は不要）
+
+---
+
+## 最低限これだけ読め（3分版）
+
+> **TL;DR** — 以下を読めば DGE を始められる。詳細は後続セクションへ。
+
+**DGE とは**: キャラクターが議論する会話劇で、設計の「書いてないこと」を発見する手法。
+
+**3 ステップ**:
+1. **Generate** — テーマとキャラを決めて会話劇を生成する
+2. **Extract** — 会話劇から「未定義」「矛盾」「考慮漏れ」を Gap として抽出する
+3. **Specify** — 各 Gap を Use Case / API / Data Model に変換する
+
+**今泉メソッド 5 つの問い**（会話劇で Gap を掘り出す最強の武器）:
+- Type 1: 「そもそも」— 前提が本当に正しいか検証する
+- Type 2: 「要するに」— 本質を一言で言語化させる
+- Type 3: 「他にないの」— 見落とした選択肢を洗い出す
+- Type 4: 「誰が困るの」— 影響を受ける人を具体的に挙げる
+- Type 5: 「前もそうだった」— 過去の失敗パターンを想起する
+
+**最初にやること**:
+1. 設計ドキュメント（API 仕様、企画書など）を用意する
+2. 下の「クイックスタート」のプロンプトを LLM に投げる
+3. 出力された Gap を **人間がレビューする**（★これが最も重要。レビューなしの会話劇は片手落ち）
+
+---
+
+## 原理
+
+仕様書のレビューは「書いてあることの検証」。
+DGE は「書いてないことの発見」。
+
+ユーザーが実際に使う場面をキャラクターでシミュレーションすると、
+仕様書にない前提、暗黙の制約、考慮漏れが表面化する。
+
+## DGE の 3 ステップ
+
+```
+Step 1: 会話劇を書く (Generate)
+  テーマとキャラクターを決めて、
+  そのキャラクターたちが議論する会話劇を生成する。
+  
+Step 2: Gap を抽出する (Extract)
+  会話劇の中から「未定義」「矛盾」「考慮漏れ」を
+  Gap として抽出する。
+
+Step 3: Spec に落とす (Specify)
+  各 Gap を Use Case, API, Data Model に変換する。
+```
+
+## 会話劇の書き方
+
+### 形式
+
+```
+先輩 (ナレーション): 技術的背景を中立に説明する。
+  キャラクターが議論に入るための context を提供。
+
+キャラA: 「セリフ」
+  → Gap 発見: 〇〇が未定義
+
+キャラB: 「セリフ」
+  → Gap 発見: △△と□□が矛盾
+
+キャラC: 「セリフ」
+  → Spec implication: ×× の API が必要
+```
+
+### 役割: 先輩（ナレーション）
+
+unlaxer-parser の DGE session で発見された追加役割。
+
+```
+先輩は技術的背景を neutral に語る narrator。
+キャラクターではなく「状況設定」の役割。
+
+例:
+  先輩: 「production 文法と complete 文法の差分をマージする。
+        complete 文法では BooleanExpression が 3 階層になっている。
+        production の BooleanExpression はフラットな Choice だから、
+        これを置き換える必要がある。」
+  
+  → この context があることで、キャラクターが
+    「そもそもその階層化って必要？」（今泉）
+    「3 階層は正しい設計」（千石）
+    と議論に入れる。
+
+先輩がいない場合:
+  キャラクターが背景説明から始めなければならない。
+  これはキャラの personality に合わない。
+  今泉が技術的背景を説明するのは不自然。
+
+先輩がいる場合:
+  背景 → 議論の分離が明確。
+  キャラクターは自分の role に集中できる。
+```
+
+### ルール
+
+1. **正解を出さない** — キャラクターは問題を提起するだけ。解決は human。
+2. **全員に発言させる** — 1 キャラだけが話す会話劇は DGE にならない。
+3. **矛盾を歓迎する** — キャラクター間の矛盾が最も価値のある Gap。
+4. **具体的な場面を描く** — 抽象的な議論ではなく「ユーザーが〇〇したとき」。
+5. **Gap を即座にマークする** — 会話の流れの中で `→ Gap 発見:` を挿入。
+6. **先輩が context を設定する** — 技術的背景は先輩が語り、キャラは議論に集中。
+
+### Scene の構成
+
+```
+Scene 1: 基本フロー (Happy path)
+  先輩が背景を説明 → キャラが議論 → Gap 発見
+  
+Scene 2: エッジケース
+  先輩が boundary を説明 → キャラが攻撃 → Gap 発見
+  
+Scene 3: 運用 / パフォーマンス
+  先輩が制約を説明 → キャラがトレードオフを議論 → Gap 発見
+  
+Scene 4: セキュリティ / リスク
+  先輩が脅威モデルを説明 → Red Team + ハウスが攻撃 → Gap 発見
+```
+
+## Observe → Suggest → Act パターン
+
+全ての Gap は以下の構造を持つ:
+
+```
+Observe: 「〇〇が定義されていない」(現状の問題)
+Suggest: 「△△を追加すべき」(提案)
+Act:     UC-XX, API endpoint, Data Model (具体的な仕様)
+```
+
+## Gap の分類（6 カテゴリ）
+
+unlaxer-parser の DGE で確立された分類:
+
+| Category | 内容 | 例 |
+|----------|------|-----|
+| Missing logic | 実装が足りない | 関数が未実装 |
+| Spec-impl mismatch | 仕様と実装のズレ | parser は通るが evaluator が落ちる |
+| Type/coercion gap | 型変換の考慮漏れ | toNum("3.14") が String を返す |
+| Error quality | エラーメッセージが不親切 | "parse failed" だけ |
+| Integration gap | 連携部分の不整合 | LSP が補完候補を出さない |
+| Test coverage | テストの欠落 | variadic 関数のテストがない |
+
+AskOS の DGE で追加された分類:
+
+| Category | 内容 | 例 |
+|----------|------|-----|
+| Business gap | ビジネスモデルの穴 | 効果測定指標がない |
+| Safety gap | 安全性の欠陥 | auto-answer の依存症 |
+| Ops gap | 運用の欠如 | runbook がゼロ |
+| Message gap | 伝え方の問題 | ユーザーの言葉で語れてない |
+| Legal gap | 法的リスク | 利用規約がない |
+
+## Spec への落とし方
+
+### Use Case
+
+```
+UC-XXX-01: [タイトル]
+  Trigger: [何がきっかけで発動するか]
+  Input:   [何が入力されるか]
+  Output:  [何が出力されるか]
+  API:     [対応する API endpoint]
+```
+
+### API Endpoint
+
+```
+METHOD /api/path
+  Body:     { field: type }
+  Response: { field: type }
+```
+
+### Data Model
+
+```sql
+CREATE TABLE ... / ALTER TABLE ...
+```
+
+## 今泉メソッド — 5 Types の問い
+
+DGE の最も強力な武器:
+
+```
+Type 1: 「そもそも」— 前提の検証
+Type 2: 「要するに」— 本質の抽出
+Type 3: 「他にないの」— 選択肢の拡張
+Type 4: 「誰が困るの」— 影響の具体化
+Type 5: 「前もそうだった」— 過去の参照
+```
+
+## レビューフロー
+
+```
+1. 会話劇を書く (10-30分)
+2. 人間がレビューする (5-10分) ← ★ここが本質
+3. レビューで出た追加の気づきを反映
+4. Spec に落とす
+```
+
+会話劇 → レビュー の往復が DGE の核心。
+レビューなしの会話劇は片手落ち。
+
+## クイックスタート（どの LLM でも使える）
+
+### 方法 A: 汎用プロンプト（ChatGPT / Gemini / Claude 等）
+
+以下のプロンプトをコピーして、任意の LLM に貼り付ける。
+`{貼り付け}` の部分を自分の設計ドキュメントに置き換えること。
+
+```
+あなたは DGE（Design-Gap Exploration）のファシリテーターです。
+以下の設計ドキュメントについて、3人のキャラクターが議論する会話劇を生成してください。
+
+【キャラクター】
+- 先輩（ナレーション）: 技術的背景を中立に説明する narrator
+- 今泉: 「そもそも」「要するに」で前提を問う。遠慮なく根本に切り込む
+- 千石: 品質とユーザー体験の守護者。妥協を許さない
+
+【ルール】
+1. 先輩が背景を説明してから議論を開始する
+2. キャラクター間で意見を対立させる（全員合意は禁止）
+3. 「未定義」「矛盾」「考慮漏れ」を発見したら → Gap 発見: と即座にマークする
+4. 具体的な場面（「ユーザーが〇〇したとき」）で議論する。抽象論は禁止
+5. 最後に発見した Gap の一覧を Observe（現状の問題）/ Suggest（提案）/ Act（具体的な仕様）の形式でまとめる
+
+【Scene 構成】
+- Scene 1: 基本フロー（Happy path）
+- Scene 2: エッジケース
+- Scene 3: 運用 / セキュリティ
+
+【対象ドキュメント】
+{ここに設計ドキュメントを貼り付ける}
+```
+
+### 方法 B: Claude Code（skill 自動発動）
+
+```bash
+# 1. skills をプロジェクトにコピー
+cp dge/skills/*.md /path/to/your-project/.claude/skills/
+
+# 2. Claude Code で一言
+Human: 「認証 API の設計を DGE して」
+```
+
+Claude Code が skills/ を読み、テンプレート選択 → キャラ選択 → 会話劇生成 → Gap 抽出を自動で実行する。
+
+### 期待される出力
+
+成功した session は以下の形式で出力される:
+
+```
+## 会話劇
+
+先輩: 「〇〇 API では、ユーザーが △△ する場面を想定している。」
+
+今泉: 「そもそも、△△ する前にユーザーは認証済みなんですか？」
+  → Gap 発見: 未認証ユーザーのアクセス制御が未定義
+
+千石: 「認証以前の問題です。エラーメッセージが"401"だけでは
+       ユーザーに対する侮辱です。」
+  → Gap 発見: エラーレスポンスの人間向けメッセージが未設計
+
+...
+
+## Gap 一覧
+
+| # | Gap | Category | Severity |
+|---|-----|----------|----------|
+| 1 | 未認証ユーザーのアクセス制御が未定義 | Missing logic | High |
+| 2 | エラーレスポンスの人間向けメッセージが未設計 | Error quality | Medium |
+| ... | ... | ... | ... |
+
+## Gap 詳細
+
+### Gap-1: 未認証ユーザーのアクセス制御が未定義
+- Observe: 〇〇 API に認証チェックの記述がない
+- Suggest: 認証ミドルウェアを追加し、未認証時のレスポンスを定義すべき
+- Act: UC-AUTH-01 として認証フローを定義。401 / 403 のレスポンス仕様を策定
+```
+
+**成功の判断基準**: Gap が 3 個以上出ており、そのうち 1 つでも「これは気づかなかった」と思えるものがあれば成功。全ての Gap が自明なら、キャラを追加するか Scene を増やして再実行する。
+
+---
+
+## DGE の適用範囲
+
+```
+論文版 (unlaxer-parser):
+  パーサー文法設計、型システム、言語機能の設計
+  → 仕様 vs 実装の gap
+
+汎用版 (AskOS session):
+  API 設計、プロダクト設計、ビジネス戦略、採用、投資判断
+  → 設計の穴すべて
+
+共通:
+  「キャラクターが議論する会話劇で gap を発見する」
+  テーマを問わない。キャラの組み合わせで角度が変わる。
+```

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@unlaxer/dge-toolkit",
+  "version": "1.0.0",
+  "description": "DGE (Dialogue-driven Gap Extraction) — 会話劇で設計の穴を発見するメソッドkit",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xxx/DGE-toolkit"
+  },
+  "keywords": [
+    "design-review",
+    "gap-analysis",
+    "dialogue",
+    "claude-code",
+    "llm",
+    "spec-review",
+    "dge"
+  ],
+  "bin": {
+    "dge-install": "./install.sh",
+    "dge-update": "./update.sh"
+  },
+  "files": [
+    "LICENSE",
+    "README.md",
+    "method.md",
+    "version.txt",
+    "characters/",
+    "templates/",
+    "skills/",
+    "install.sh",
+    "update.sh"
+  ],
+  "scripts": {
+    "postinstall": "node -e \"console.log('\\n  DGE toolkit installed.\\n  Run: npx dge-install\\n  to set up dge/ and .claude/skills/ in your project.\\n  Run: npx dge-update\\n  to update existing dge/ files.\\n')\""
+  }
+}

package/skills/dge-session.md

@@ -0,0 +1,164 @@
+<!-- DGE-toolkit (MIT License) — https://github.com/xxx/DGE-toolkit -->
+<!-- 前提条件: プロジェクトルートに dge/ フォルダが存在すること -->
+
+# Skill: DGE Session 実行
+
+## Trigger
+ユーザーが以下のいずれかを言ったとき:
+- 「DGE して」
+- 「会話劇で見直して」
+- 「gap を探して」
+- 「壁打ちして」
+- 「ブレストして」
+
+## 前提条件
+- `dge/method.md` が存在すること
+- 見つからない場合、session を開始せず以下を案内する:
+  「DGE toolkit がインストールされていません。https://github.com/xxx/DGE-toolkit を参照してインストールしてください。」
+
+## MUST ルール（必ず守る）
+1. **キャラクター選択はユーザーに提示して確認を得てから進む。** 確認なしで会話劇を生成しない。推奨セットを 1 つ提案し「変更しますか？」と聞く。
+2. **session 出力は markdown ファイルとして保存する。** 保存先ディレクトリが存在しない場合、(a) 作成する (b) 別の場所を指定する をユーザーに聞く。デフォルトは `dge/sessions/`。
+3. **会話劇の後、Gap 一覧テーブルを出力する。** テーブルの列は: `| # | Gap | Category | Severity |`
+4. **サマリー表示後、ユーザーの次のアクション指示を待つ。** 勝手に次の session や実装を開始しない。
+5. **サマリーの後に選択肢を提示する:** DGE を回す / 実装する / 後で
+6. **初回チェック:** CLAUDE.md に DGE の記述があるか確認する。なければ「CLAUDE.md に DGE の記述を追記しますか？（次回から自動で認識されます）」と聞く。Yes なら追記して続行、No ならそのまま続行。
+
+## SHOULD ルール（推奨）
+1. テンプレート候補が 1 つなら自動選択し報告する。2 つ以上ならユーザーに提示する。
+2. Gap 詳細は Observe / Suggest / Act の構造で書く。
+3. 会話劇は 3-5 Scene で構成する。先輩（ナレーション）で各 Scene の背景を設定する。
+4. サマリー表示時に全文ファイルへのパスを表示する。
+
+## 判断ルール（auto-decide vs ask）
+
+| Step | 条件 | アクション |
+|------|------|-----------|
+| テーマ確認 | ユーザーの指示が 1 文で明確 | そのまま進む |
+| テーマ確認 | 質問形式 or 曖昧 | 掘り下げて聞く |
+| テンプレート選択 | 候補が 1 つ | 自動選択して報告 |
+| テンプレート選択 | 候補が 2 つ以上 | ユーザーに提示 |
+| キャラクター選択 | 常に | ユーザーに確認（例外なし） |
+| 保存先 | 初回 or ディレクトリ不在 | ユーザーに確認 |
+| 保存先 | 2 回目以降 and ディレクトリ存在 | 前回と同じ場所に保存 |
+
+## 手順
+
+### Step 1: 初回チェックと DGE Kit 読み込み
+1. `dge/method.md` を読む（なければ前提条件のエラーメッセージ）
+2. `dge/characters/catalog.md` を読む
+3. `dge/version.txt` があればバージョンを 1 行表示する（例: `DGE toolkit v1.0.0`）。なくても続行
+4. CLAUDE.md に DGE の記述があるか確認（MUST ルール 6）
+
+### Step 2: テーマを確認
+ユーザーに「何をテーマにしますか？」と確認。
+明確なら Step 3 へ。不明確なら掘り下げる。
+
+### Step 3: テンプレートを選択
+`dge/templates/` から最も近いテンプレートを選ぶ。
+なければ method.md の Scene 構成ガイドに従って即席で作る。
+
+### Step 4: キャラクターを提案
+テーマに応じて catalog.md の推奨を提案:
+「このテーマには [キャラA] + [キャラB] + [キャラC] を推奨しますが、変更しますか？」
+**ユーザーの応答を待つ。**
+
+### Step 5: 会話劇を生成
+各 Scene について:
+1. 先輩（ナレーション）で技術的背景を設定
+2. キャラクターのセリフを生成（prompt を参照）
+3. セリフの直後に `→ Gap 発見:` を挿入
+4. Scene 末尾に Gap リストをまとめる
+
+「先輩」はキャラクターではなく narrator。
+技術的背景を neutral に語り、キャラが議論に入る context を提供する。
+
+### Step 6: Gap を Spec に落とす
+各 Gap について:
+```
+Gap: [タイトル]
+  Observe: [現状の問題]
+  Suggest: [提案]
+  UC:      UC-XXX-01: [Use Case]
+  API:     METHOD /api/path { body } → { response }
+  SQL:     CREATE TABLE ... / ALTER TABLE ...
+```
+
+### Step 7: ファイルに保存
+session 出力を markdown ファイルとして保存する。
+- ファイル名: テーマを kebab-case にしたもの（例: `auth-api-review.md`）
+- 保存先: デフォルト `dge/sessions/`（初回にユーザー確認）
+- ディレクトリが存在しなければユーザーに確認して作成
+
+### Step 8: サマリーを表示してユーザーの判断を待つ
+以下の形式で表示する:
+
+```
+## DGE 結果サマリー
+
+**テーマ**: [テーマ]
+**Gap 数**: N 件（Critical: X / High: X / Medium: X / Low: X）
+
+| # | Gap | Severity |
+|---|-----|----------|
+（High 以上を表示、Medium 以下は件数のみ）
+
+**全文**: `[ファイルパス]`
+
+どうしますか？
+- **DGE を回す** → この結果をさらに深掘り
+- **実装する** → Gap を Task に変換
+- **後で** → 保存したまま終了
+```
+
+**ユーザーの応答を待つ。勝手に次のアクションに進まない。**
+
+### Step 9: ユーザーの判断に従う
+
+| ユーザーの判断 | アクション |
+|---------------|-----------|
+| DGE を回す | Step 2 に戻る（テーマ = 前回の Gap や提案） |
+| 実装する | Gap を Task に変換し、実装を開始 |
+| 後で | 何もしない。ファイルはそのまま |
+
+## 出力フォーマット仕様
+
+### ファイルヘッダ（MUST）
+```markdown
+# DGE Session: [テーマ]
+
+- **日付**: YYYY-MM-DD
+- **テーマ**: [テーマの 1 行説明]
+- **キャラクター**: [使用キャラクター]
+- **テンプレート**: [使用テンプレート名] または "カスタム"
+```
+
+### Gap 一覧テーブル（MUST）
+```markdown
+| # | Gap | Category | Severity |
+|---|-----|----------|----------|
+| 1 | [Gap の 1 行説明] | [Category] | High |
+```
+
+### Gap 詳細（SHOULD）
+```markdown
+### Gap-N: [タイトル]
+- **Observe**: [現状の問題]
+- **Suggest**: [提案]
+- **Act**: [具体的な仕様: UC, API, Data Model 等]
+```
+
+## Severity 判断基準
+
+| Severity | 基準 |
+|----------|------|
+| Critical | これがないと機能が実装不能 / データ損失リスク |
+| High | 主要ユースケースに影響 / セキュリティリスク |
+| Medium | 品質・UX に影響するが回避策あり |
+| Low | 改善レベル / nice-to-have |
+
+## 注意
+- 1 Scene は 3-5 キャラの発言で構成
+- 1 Session は 3-5 Scene
+- 合計 15-30 分が目安
+- 会話劇の後、必ずユーザーにレビューしてもらう（会話劇 → レビュー の往復が本質）

package/skills/dge-update.md

@@ -0,0 +1,73 @@
+<!-- DGE-toolkit (MIT License) — https://github.com/xxx/DGE-toolkit -->
+
+# Skill: DGE toolkit アップデート
+
+## Trigger
+ユーザーが以下のいずれかを言ったとき:
+- 「DGE を更新して」
+- 「DGE をアップデートして」
+- 「dge update」
+
+## 手順
+
+### Step 1: 現在のバージョンを確認
+`dge/version.txt` を読んでローカルバージョンを表示する。
+ファイルがなければ「バージョン情報がありません（v1.0.0 以前のインストールです）」と表示。
+
+### Step 2: 更新元を特定
+以下の優先順で更新元を探す:
+1. `node_modules/@unlaxer/dge-toolkit/version.txt` — npm install 済みの場合
+2. ユーザーに更新元のパスを聞く — npm を使っていない場合
+
+npm の場合は `node_modules/@unlaxer/dge-toolkit/version.txt` と `dge/version.txt` を比較して表示:
+```
+現在: v1.0.0
+更新元: v1.2.0
+```
+
+### Step 3: 更新内容を説明
+以下を表示してユーザーに確認する:
+
+```
+以下の toolkit ファイルが上書きされます:
+- dge/method.md
+- dge/characters/catalog.md
+- dge/templates/*.md
+- dge/README.md, LICENSE, version.txt
+- .claude/skills/dge-session.md
+- .claude/skills/dge-update.md
+
+以下は触りません:
+- dge/sessions/（あなたの DGE session 出力）
+- dge/custom/（あなたのカスタムファイル）
+
+更新しますか？
+```
+
+**ユーザーの確認を待つ。**
+
+### Step 4: 更新を実行
+ユーザーが承認したら:
+
+npm の場合:
+```bash
+npx dge-update
+```
+
+手動の場合:
+toolkit ファイルのみを手動で上書きコピーする手順を案内する。
+
+### Step 5: 結果を報告
+```
+DGE toolkit を v[新バージョン] に更新しました。
+sessions/ と custom/ は変更されていません。
+```
+
+## MUST ルール
+1. **更新前に必ずユーザーの確認を得る。** 勝手に上書きしない。
+2. **sessions/ と custom/ には絶対に触らない。**
+3. **更新元が見つからない場合は npm update の手順を案内する。**
+
+## 注意
+- このスキルは DGE session とは独立。session 中に update を提案しない。
+- npm を使っていないユーザーには手動コピーの手順を案内する。

package/templates/api-design.md

@@ -0,0 +1,76 @@
+# DGE Template: API 設計
+
+## 概要
+新しい API endpoint を設計する前に gap を洗い出す。
+
+## 推奨キャラクター
+今泉 (前提確認) + 千石 (品質基準) + 僕 (scope 縮小)
+
+## Scene 構成
+
+### Scene 1: 基本フロー
+```
+focus: 入力/出力/エラーの定義
+今泉の問い: 「誰がこの API を叩くんですか？」「何を返すんですか？」
+千石の基準: 「エラーレスポンスは RFC 7807 で統一」
+僕の縮小:   「MVP では GET と POST だけでいいのでは...」
+
+抽出すべき Gap:
+- 入力フィールドの定義
+- レスポンス形式
+- エラーコードとメッセージ
+- 認証の要否
+```
+
+### Scene 2: 認証・認可
+```
+focus: 認証方式、権限管理
+今泉の問い: 「ログインしてない人もアクセスできるんですか？」
+千石の基準: 「JWT は httpOnly cookie。localStorage 禁止」
+僕の縮小:   「RBAC は v2 でよくないですか... API key だけで...」
+
+抽出すべき Gap:
+- 認証方式 (JWT / Session / API key)
+- token の保存場所
+- 権限モデル (RBAC / ABAC / なし)
+- rate limiting
+```
+
+### Scene 3: バリデーション・エッジケース
+```
+focus: 入力検証、境界値、異常系
+今泉の問い: 「空文字を送ったらどうなるんですか？」
+千石の基準: 「バリデーションエラーは 400 + 詳細メッセージ」
+僕の縮小:   「バリデーションライブラリ使えば楽...」
+
+抽出すべき Gap:
+- 各フィールドのバリデーションルール
+- 重複チェック (409 Conflict)
+- 文字数制限、型チェック
+- ファイルアップロードの制限
+```
+
+### Scene 4: パフォーマンス・運用
+```
+focus: 本番での負荷、キャッシュ、ログ
+今泉の問い: 「1000 人が同時にアクセスしたらどうなるんですか？」
+千石の基準: 「レスポンスタイム 200ms 以内」
+僕の縮小:   「最初は 10 人しか使わないから...」
+
+抽出すべき Gap:
+- ページネーション
+- キャッシュ戦略
+- ログ出力内容
+- 監視・アラート
+```
+
+## 出力フォーマット
+各 Scene の Gap を以下の形式で出力:
+```
+Gap: [タイトル]
+  Observe: [現状の問題]
+  Suggest: [提案]
+  UC:      [Use Case 定義]
+  API:     [endpoint 定義]
+  SQL:     [Data Model 変更]
+```

package/templates/feature-planning.md

@@ -0,0 +1,64 @@
+# DGE Template: 新機能企画
+
+## 概要
+新機能を実装する前に要件の穴を見つける。
+
+## 推奨キャラクター
+今泉 (前提確認) + ヤン (簡素化) + 僕 (scope 縮小)
+
+## Scene 構成
+
+### Scene 1: ユーザーストーリー
+```
+focus: 誰が、何のために、何をするか
+今泉: 「そもそもこの機能、誰が欲しいって言ったんですか？」
+ヤン:  「1 番大事なユースケースだけ教えて。残りは後で。」
+僕:   「...ユーザー 3 人に聞けばいいんじゃ...」
+
+抽出すべき Gap:
+- ターゲットユーザー
+- 解決する課題
+- 既存の代替手段
+- 成功指標 (KPI)
+```
+
+### Scene 2: UI/UX フロー
+```
+focus: ユーザーが画面で何をするか
+今泉: 「ボタンを押したら何が起きるんですか？」
+ヤン:  「画面遷移 3 つ以内で終わらないと使わない。」
+僕:   「...モーダル 1 枚でいいんじゃ...」
+
+抽出すべき Gap:
+- 画面遷移図
+- 入力フォームの項目
+- エラー時の表示
+- ローディング状態
+```
+
+### Scene 3: 技術的制約
+```
+focus: 実装の難易度、依存、リスク
+今泉: 「これ作るのに何日かかるんですか？」
+ヤン:  「既存のコードで 80% できない？」
+僕:   「...新しいライブラリ入れたくない...」
+
+抽出すべき Gap:
+- 技術的な依存 (新ライブラリ？)
+- 既存コードへの影響
+- 工数見積もり
+- リスク
+```
+
+### Scene 4: MVP Scope
+```
+focus: 最小限の実装範囲
+今泉: 「全部必要ですか？ 半分でいいんじゃ？」
+ヤン:  「1 つだけ作るなら何？」
+僕:   「...全部やろうとすると心が折れる...」
+
+抽出すべき Gap:
+- must-have vs nice-to-have
+- v1 scope vs v2 backlog
+- 削っても成立する最小セット
+```

package/templates/go-nogo.md

@@ -0,0 +1,47 @@
+# DGE Template: Go/No-Go 判断
+
+## 概要
+投資、新規事業、大きな方向転換の Go/No-Go を判断する。
+
+## 推奨キャラクター
+今泉 + 鷲津 (財務) + 僕 (scope) + ラインハルト (攻め)
+
+## Scene 構成
+
+### Scene 1: 市場と顧客
+```
+今泉: 「お客さんと話しましたか？ 何人？」
+鷲津: 「TAM/SAM/SOM を出せ。感覚じゃなく数字で。」
+僕:   「...10 社にヒアリングしてからでいいんじゃ...」
+ラインハルト: 「市場は待ってくれない。今動け。」
+
+Gap: 顧客ヒアリング数、市場規模データ、ターゲットの明確さ
+```
+
+### Scene 2: 財務とリスク
+```
+今泉: 「失敗したらいくら損するんですか？」
+鷲津: 「IRR、NPV、payback period を出せ。」
+僕:   「...$2M から始めません...？」
+ラインハルト: 「リスクを取れないなら何も得られない。」
+
+Gap: 投資額、回収見込み、最悪ケース、撤退基準
+```
+
+### Scene 3: チームとリソース
+```
+今泉: 「誰がやるんですか？ 今のチームで足りますか？」
+鷲津: 「既存事業への影響は計算したか？」
+僕:   「...3 人でできる範囲に...」
+
+Gap: 必要人員、既存事業への影響、採用計画
+```
+
+### Scene 4: 競合と差別化
+```
+今泉: 「同じことをやってる人はいませんか？」
+鷲津: 「競合が 10 倍の資金で来たら？」
+ラインハルト: 「競合にない我々だけの武器は何だ。」
+
+Gap: 競合分析、差別化ポイント、参入障壁
+```

package/templates/incident-review.md

@@ -0,0 +1,45 @@
+# DGE Template: 障害振り返り
+
+## 概要
+本番障害の原因と再発防止を会話劇で分析する。
+
+## 推奨キャラクター
+今泉 (前提確認) + 千石 (品質基準) + Red Team (攻撃視点)
+
+## Scene 構成
+
+### Scene 1: 何が起きたか
+```
+今泉: 「要するに何が壊れたんですか？ ユーザーからは何が見えてた？」
+千石: 「タイムラインを正確に。最初のアラートは何時何分。」
+Red Team: 「これは攻撃の結果ではないか？ ログを確認したか？」
+
+Gap: 障害タイムライン、影響範囲、ユーザー影響
+```
+
+### Scene 2: なぜ起きたか (5 Why)
+```
+今泉: 「なぜ migration が失敗したんですか？」→「なぜテストがなかった？」→...
+千石: 「テストなしで本番 migration を許可した手順が問題。」
+Red Team: 「この脆弱性は既知だったか？ CVE を確認したか？」
+
+Gap: 根本原因、テスト不足、手順の不備
+```
+
+### Scene 3: なぜ検知できなかったか
+```
+今泉: 「アラートは鳴ったんですか？」
+千石: 「監視の品質が不十分。health check が表面的。」
+Red Team: 「攻撃者がアラートを回避する方法は？」
+
+Gap: 監視の不備、アラート設定、検知の遅延
+```
+
+### Scene 4: 再発防止
+```
+今泉: 「同じことが明日起きたらどうします？」
+千石: 「テスト追加 + CI ゲート + migration テスト自動化。」
+Red Team: 「この修正で別の攻撃面が開かないか？」
+
+Gap: 再発防止策、テスト追加、手順改善、監視強化
+```

package/templates/security-review.md

@@ -0,0 +1,45 @@
+# DGE Template: セキュリティレビュー
+
+## 概要
+API やシステムのセキュリティを会話劇で検証する。
+
+## 推奨キャラクター
+千石 (品質) + Red Team (攻撃) + ハウス (隠れた問題)
+
+## Scene 構成
+
+### Scene 1: 認証・認可
+```
+千石: 「認証トークンの保存場所は？ localStorage なら却下。」
+Red Team: 「JWT の secret が漏洩した場合の影響範囲は？」
+ハウス: 「admin 権限の付与フローは？ 昇格攻撃は防げるか？」
+
+Gap: token 保存、secret 管理、権限昇格、session 管理
+```
+
+### Scene 2: 入力検証
+```
+千石: 「全入力に sanitize が入っているか確認。」
+Red Team: 「SQL injection: ' OR 1=1 -- を試す。XSS: <script> を試す。」
+ハウス: 「file upload があるなら path traversal は？ SSRF は？」
+
+Gap: SQL injection, XSS, CSRF, path traversal, SSRF
+```
+
+### Scene 3: データ保護
+```
+千石: 「PII は暗号化されているか。ログに PII が出力されていないか。」
+Red Team: 「DB dump が漏洩した場合、password は復号できるか？」
+ハウス: 「バックアップは暗号化されているか？ 誰がアクセスできる？」
+
+Gap: 暗号化 (at-rest, in-transit)、PII 管理、ログの redaction、バックアップ
+```
+
+### Scene 4: インフラ
+```
+千石: 「HTTPS は強制か。CORS の設定は最小限か。」
+Red Team: 「rate limiting がなければ brute force で突破できる。」
+ハウス: 「依存ライブラリの CVE は定期的にチェックしているか？」
+
+Gap: HTTPS, CORS, rate limiting, dependency audit, DDoS 対策
+```

package/update.sh

@@ -0,0 +1,146 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# DGE toolkit updater
+# Updates toolkit-managed files in dge/. Never touches sessions/ or custom/.
+
+REAL_PATH="$(readlink -f "$0" 2>/dev/null || realpath "$0" 2>/dev/null || echo "$0")"
+SCRIPT_DIR="$(cd "$(dirname "${REAL_PATH}")" && pwd)"
+TARGET_DIR="${1:-.}"
+
+# Resolve source
+if [ -f "${SCRIPT_DIR}/method.md" ]; then
+  SRC="${SCRIPT_DIR}"
+elif [ -f "${SCRIPT_DIR}/../method.md" ]; then
+  SRC="${SCRIPT_DIR}/.."
+else
+  echo "Error: Cannot find DGE toolkit files."
+  exit 1
+fi
+
+DGE_DIR="${TARGET_DIR}/dge"
+SKILLS_DIR="${TARGET_DIR}/.claude/skills"
+
+if [ ! -d "${DGE_DIR}" ]; then
+  echo "Error: dge/ not found. Run 'npx dge-install' first."
+  exit 1
+fi
+
+# Get versions
+SRC_VERSION="$(cat "${SRC}/version.txt" 2>/dev/null || echo "unknown")"
+LOCAL_VERSION="$(cat "${DGE_DIR}/version.txt" 2>/dev/null || echo "unknown")"
+
+echo "DGE toolkit — update"
+echo ""
+echo "  Local:  ${LOCAL_VERSION}"
+echo "  Source: ${SRC_VERSION}"
+echo ""
+
+if [ "${SRC_VERSION}" = "${LOCAL_VERSION}" ]; then
+  echo "Already up to date."
+  exit 0
+fi
+
+# Show what will be updated
+echo "The following toolkit files will be updated:"
+echo ""
+
+UPDATED=0
+
+for f in README.md LICENSE method.md version.txt; do
+  if [ -f "${SRC}/${f}" ]; then
+    if [ -f "${DGE_DIR}/${f}" ]; then
+      if ! diff -q "${SRC}/${f}" "${DGE_DIR}/${f}" > /dev/null 2>&1; then
+        echo "  [changed] dge/${f}"
+        UPDATED=$((UPDATED + 1))
+      fi
+    else
+      echo "  [new]     dge/${f}"
+      UPDATED=$((UPDATED + 1))
+    fi
+  fi
+done
+
+for f in "${SRC}/characters/"*.md; do
+  fname="$(basename "${f}")"
+  if [ -f "${DGE_DIR}/characters/${fname}" ]; then
+    if ! diff -q "${f}" "${DGE_DIR}/characters/${fname}" > /dev/null 2>&1; then
+      echo "  [changed] dge/characters/${fname}"
+      UPDATED=$((UPDATED + 1))
+    fi
+  else
+    echo "  [new]     dge/characters/${fname}"
+    UPDATED=$((UPDATED + 1))
+  fi
+done
+
+for f in "${SRC}/templates/"*.md; do
+  fname="$(basename "${f}")"
+  if [ -f "${DGE_DIR}/templates/${fname}" ]; then
+    if ! diff -q "${f}" "${DGE_DIR}/templates/${fname}" > /dev/null 2>&1; then
+      echo "  [changed] dge/templates/${fname}"
+      UPDATED=$((UPDATED + 1))
+    fi
+  else
+    echo "  [new]     dge/templates/${fname}"
+    UPDATED=$((UPDATED + 1))
+  fi
+done
+
+# Check skill
+if [ -f "${SRC}/skills/dge-session.md" ] && [ -f "${SKILLS_DIR}/dge-session.md" ]; then
+  if ! diff -q "${SRC}/skills/dge-session.md" "${SKILLS_DIR}/dge-session.md" > /dev/null 2>&1; then
+    echo "  [changed] .claude/skills/dge-session.md"
+    UPDATED=$((UPDATED + 1))
+  fi
+fi
+
+if [ -f "${SRC}/skills/dge-update.md" ]; then
+  if [ ! -f "${SKILLS_DIR}/dge-update.md" ]; then
+    echo "  [new]     .claude/skills/dge-update.md"
+    UPDATED=$((UPDATED + 1))
+  elif ! diff -q "${SRC}/skills/dge-update.md" "${SKILLS_DIR}/dge-update.md" > /dev/null 2>&1; then
+    echo "  [changed] .claude/skills/dge-update.md"
+    UPDATED=$((UPDATED + 1))
+  fi
+fi
+
+echo ""
+echo "  Will NOT touch: dge/sessions/, dge/custom/"
+echo ""
+
+if [ "${UPDATED}" -eq 0 ]; then
+  echo "No file changes detected (version mismatch only). Updating version.txt."
+  echo "${SRC_VERSION}" > "${DGE_DIR}/version.txt"
+  exit 0
+fi
+
+read -p "Update ${UPDATED} file(s)? [y/N] " -n 1 -r
+echo ""
+
+if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+  echo "Cancelled."
+  exit 0
+fi
+
+# Perform update — toolkit managed files only
+mkdir -p "${DGE_DIR}/characters" "${DGE_DIR}/templates"
+
+for f in README.md LICENSE method.md; do
+  [ -f "${SRC}/${f}" ] && cp "${SRC}/${f}" "${DGE_DIR}/${f}"
+done
+
+cp "${SRC}/characters/"*.md "${DGE_DIR}/characters/"
+cp "${SRC}/templates/"*.md "${DGE_DIR}/templates/"
+echo "${SRC_VERSION}" > "${DGE_DIR}/version.txt"
+
+# Update skills
+mkdir -p "${SKILLS_DIR}"
+for f in "${SRC}/skills/"*.md; do
+  fname="$(basename "${f}")"
+  cp "${f}" "${SKILLS_DIR}/${fname}"
+done
+
+echo ""
+echo "Updated to v${SRC_VERSION}."
+echo "  dge/sessions/ and dge/custom/ were not touched."

package/version.txt

@@ -0,0 +1 @@
+1.0.0