@nahisaho/shikigami 1.19.3 → 1.20.0

package/.github/prompts/shikigami-full-research.prompt.md

@@ -34,15 +34,15 @@ tools: ['shikigami-planner', 'shikigami-deep-research', 'shikigami-consulting-fr
 |-------|------|--------|-------------|
 | **0: 初期化** ⚠️必須 | `npx shikigami new` 実行 | CLI | manifest.yaml |
 | **1: 目的探索** | 5 Whys, JTBD分析, 計画立案 | shikigami-planner | - |
-| **2: Deep Research** | Think→Report→Action反復 | shikigami-deep-research | research/ |
+| **2: Deep Research** | Think→Report→Action反復（**思考フロー記録**）🆕 | shikigami-deep-research | research/ |
 | **3: 分析** | フレームワーク適用, MECE検証 | shikigami-consulting-framework | research/ |
-| **4: レポート** | ハルシネーション検出, 引用管理 | shikigami-writing | reports/ |
+| **4: レポート** | ハルシネーション検出, 引用管理, **思考フロー出力**🆕 | shikigami-writing | reports/ |
 | **5: 完了** | manifest.yaml更新 | - | - |
 
 ```
 Phase 0 → Phase 1 → Phase 2 → Phase 3 → Phase 4 → Phase 5
-   ↑          ↑
- search禁止   search解禁
+   ↑          ↑                            ↑
+ search禁止   search解禁          思考フロー出力(v1.20.0)
 ```
 
 ---
@@ -79,6 +79,19 @@ projects/pjXXXXX_<Name>_YYYYMMDD/
 | トレーサビリティ | 全情報に出典 |
 | 構造性 | MECE・ピラミッド準拠 |
 | 実用性 | 即行動可能な示唆 |
+| **透明性**🆕 | 思考フローで判断過程を可視化 |
+
+---
+
+## 思考フロー可視化（v1.20.0）🆕
+
+**レポートに自動出力される内容**:
+- 🗺️ フローマップ（Mermaidダイアグラム）
+- 📜 思考ログ（時系列の判断記録）
+- 🔀 重要な判断ポイント（仮説修正・方針転換）
+- 📈 思考メトリクス（調査ラウンド数、検証率等）
+
+**記録タイミング**: 各Phase内のすべての判断・アクションを記録
 
 ---
 

package/.github/prompts/shikigami-report-writing.prompt.md

@@ -35,11 +35,20 @@ tools: ['shikigami-writing']
 | 不確実性マーキング | 単一ソースは⚠️マーク |
 | 論理構造 | MECE・ピラミッド準拠 |
 
-### Step 4: 出力
+### Step 4: 思考フロー出力（v1.20.0）🆕
+
+調査プロセスの透明性を確保するため、以下を自動出力:
+- 🗺️ フローマップ（Mermaid）
+- 📜 思考ログ（判断の時系列記録）
+- 🔀 ピボット記録（仮説修正・方針転換）
+- 📈 思考メトリクス（調査品質指標）
+
+### Step 5: 出力
 
 **必須要素**:
 - エグゼクティブサマリー（1ページ）
 - Mermaidダイアグラム（可視化）
+- 📐 思考フロー・トレースセクション 🆕
 - 参考文献リスト（URL付き）
 - バージョン番号（v1.0形式）
 

package/.github/skills/shikigami-deep-research/SKILL.md

@@ -26,6 +26,8 @@ license: MIT
 
 **目的**: 現状分析・仮説生成・次アクション決定
 
+**⚠️ 思考フロー記録必須（v1.20.0）**: 各Thinkステップで判断内容と理由を明記
+
 ```markdown
 ## 🧠 Think - ラウンド [N]
 
@@ -36,6 +38,7 @@ license: MIT
 **未解決の疑問**: [リスト]
 **ギャップ**: 目標[X] vs 現状[Y]
 **次アクション**: SEARCH / VISIT / VERIFY / COMPLETE
+**選択理由**: [なぜこのアクションを選んだか] 🆕
 ```
 
 ---
@@ -111,6 +114,20 @@ manifest.yaml `personas[].domain_knowledge.level` で調整:
 ### ソース批評自動呼び出し（v1.16.0）
 完了時に `@source-critique` 自動実行（ソース数≥5）
 
+### 思考フロー記録（v1.20.0）🆕
+各Think/Search/Visit/Verifyステップを自動記録し、shikigami-writingに引き継ぎ
+
+**記録内容**:
+| 項目 | 説明 |
+|------|------|
+| タイムスタンプ | 各ステップの実行時刻 |
+| 判断内容 | 何を判断・決定したか |
+| 信頼度 | その判断の確信度（0.0-1.0） |
+| ソース | 参照した情報源 |
+| 次アクション理由 | なぜその次のアクションを選んだか |
+
+**ピボット検出**: 仮説修正・方針転換を自動検出して強調記録
+
 ---
 
 ## 保存先

package/.github/skills/shikigami-writing/SKILL.md

@@ -12,6 +12,7 @@ license: MIT
 | Deep Research完了時 | レポート構成設計・生成 |
 | Qiita記事作成時 | Qiita記法準拠で生成 |
 | レポート修正時 | 新バージョンで保存（上書き禁止） |
+| 思考フロー出力要求時 | 思考プロセスを可視化してレポートに追加 |
 
 ---
 
@@ -49,7 +50,8 @@ license: MIT
 3. 調査結果（トピック別）
 4. 分析・考察
 5. 結論・提言
-6. 参考文献（URL必須）
+6. **📐 思考フロー・トレース**（v1.20.0）🆕
+7. 参考文献（URL必須）
 
 ### 引用ルール（必須）
 - すべての事実・数値にソースURL付与
@@ -160,6 +162,26 @@ ASCII図を自動検出してMermaidに変換
 ### 参考文献自動整形（v1.11.0）
 ソース種別判定→統一フォーマット
 
+### 思考フロー可視化（v1.20.0）🆕
+レポート作成に至るまでの思考プロセスを自動追跡・可視化
+
+**含まれる内容**:
+- 🗺️ フローマップ（Mermaidダイアグラム）
+- 📜 思考ログ（時系列の判断記録）
+- 🔀 重要な判断ポイント（仮説修正・方針転換）
+- 📈 思考メトリクス（調査ラウンド数、検証率等）
+
+**自動記録されるステップ**:
+| Phase | ステップ |
+|-------|---------|
+| 0: 初期化 | プロジェクト作成、ナレッジ継承 |
+| 1: 目的探索 | 目的発見、仮説生成、計画立案 |
+| 2: Deep Research | Think/Search/Visit/Verify/Report更新 |
+| 3: 分析 | フレームワーク選択・適用、洞察抽出 |
+| 4: レポート | 構成設計、生成、品質検証、引用整形 |
+
+**設定**: `configs/thinking-flow.yaml`
+
 ---
 
 ## 32テンプレート（v1.9.0）

package/.github/skills/shikigami-writing/configs/thinking-flow.yaml

@@ -0,0 +1,219 @@
+# Thinking Flow Configuration (v1.20.0)
+# レポート生成に至るまでの思考フローを可視化
+
+# 思考ステップの種類定義
+step_types:
+  # Phase 0: プロジェクト初期化
+  - id: project_init
+    name: "プロジェクト初期化"
+    phase: 0
+    icon: "🚀"
+    description: "プロジェクトフォルダ作成・ナレッジ継承確認"
+    
+  # Phase 1: 目的探索
+  - id: purpose_discovery
+    name: "目的探索"
+    phase: 1
+    icon: "🎯"
+    description: "5 Whys/JTBDによる真の目的発見"
+    
+  - id: hypothesis_generation
+    name: "仮説生成"
+    phase: 1
+    icon: "💡"
+    description: "初期仮説の設定と検証計画"
+    
+  - id: research_planning
+    name: "計画立案"
+    phase: 1
+    icon: "📋"
+    description: "調査タスク分解・優先度設定"
+
+  # Phase 2: Deep Research
+  - id: think
+    name: "思考"
+    phase: 2
+    icon: "🧠"
+    description: "現状分析・ギャップ認識・次アクション決定"
+    
+  - id: search
+    name: "検索"
+    phase: 2
+    icon: "🔍"
+    description: "Web検索による情報収集"
+    
+  - id: visit
+    name: "詳細調査"
+    phase: 2
+    icon: "📖"
+    description: "ページ訪問・詳細情報抽出"
+    
+  - id: verify
+    name: "検証"
+    phase: 2
+    icon: "✅"
+    description: "交差検証・ソース信頼性評価"
+    
+  - id: evolving_report
+    name: "レポート更新"
+    phase: 2
+    icon: "📄"
+    description: "暫定レポートの漸進的更新"
+
+  # Phase 3: 分析
+  - id: framework_selection
+    name: "フレームワーク選択"
+    phase: 3
+    icon: "🔧"
+    description: "最適フレームワークの選定"
+    
+  - id: framework_analysis
+    name: "フレームワーク分析"
+    phase: 3
+    icon: "📊"
+    description: "SWOT/3C/MECE等の適用"
+    
+  - id: insight_extraction
+    name: "洞察抽出"
+    phase: 3
+    icon: "💎"
+    description: "分析結果からの重要示唆導出"
+
+  # Phase 4: レポート生成
+  - id: structure_design
+    name: "構成設計"
+    phase: 4
+    icon: "🏗️"
+    description: "レポート構成・テンプレート選択"
+    
+  - id: content_generation
+    name: "コンテンツ生成"
+    phase: 4
+    icon: "✍️"
+    description: "本文・図表の生成"
+    
+  - id: quality_check
+    name: "品質検証"
+    phase: 4
+    icon: "🔬"
+    description: "ハルシネーション検出・整合性確認"
+    
+  - id: citation_formatting
+    name: "引用整形"
+    phase: 4
+    icon: "📚"
+    description: "参考文献の統一フォーマット化"
+    
+  - id: finalization
+    name: "最終化"
+    phase: 4
+    icon: "🎉"
+    description: "レポート完成・保存"
+
+# 接続（フロー遷移）定義
+transitions:
+  project_init:
+    next: [purpose_discovery]
+    
+  purpose_discovery:
+    next: [hypothesis_generation]
+    
+  hypothesis_generation:
+    next: [research_planning]
+    
+  research_planning:
+    next: [think]
+    
+  think:
+    next: [search, visit, verify, framework_selection]
+    decision_point: true
+    decision_question: "次のアクションは？"
+    
+  search:
+    next: [think, evolving_report]
+    
+  visit:
+    next: [think, evolving_report]
+    
+  verify:
+    next: [think, evolving_report]
+    
+  evolving_report:
+    next: [think, framework_selection]
+    decision_point: true
+    decision_question: "調査は十分か？"
+    
+  framework_selection:
+    next: [framework_analysis]
+    
+  framework_analysis:
+    next: [insight_extraction, framework_analysis]
+    loop_allowed: true
+    
+  insight_extraction:
+    next: [structure_design]
+    
+  structure_design:
+    next: [content_generation]
+    
+  content_generation:
+    next: [quality_check]
+    
+  quality_check:
+    next: [content_generation, citation_formatting]
+    decision_point: true
+    decision_question: "品質基準を満たすか？"
+    
+  citation_formatting:
+    next: [finalization]
+    
+  finalization:
+    next: []
+    terminal: true
+
+# 可視化設定
+visualization:
+  # Mermaidダイアグラム生成設定
+  mermaid:
+    theme: "default"
+    direction: "TB"  # Top to Bottom
+    node_styles:
+      completed: "fill:#10b981,stroke:#059669,color:#fff"
+      in_progress: "fill:#3b82f6,stroke:#2563eb,color:#fff"
+      pending: "fill:#e5e7eb,stroke:#9ca3af,color:#374151"
+      skipped: "fill:#fbbf24,stroke:#d97706,color:#1f2937"
+      failed: "fill:#ef4444,stroke:#dc2626,color:#fff"
+    
+  # タイムラインビュー設定
+  timeline:
+    show_duration: true
+    show_sources_count: true
+    show_confidence: true
+    
+  # サマリービュー設定
+  summary:
+    show_key_decisions: true
+    show_pivots: true
+    show_dead_ends: true
+
+# メトリクス計算
+metrics:
+  # 思考の深さ
+  depth:
+    formula: "max(phase_transitions)"
+    target: 4
+    
+  # 検証率
+  verification_rate:
+    formula: "verified_facts / total_facts * 100"
+    target: 70
+    
+  # 反復回数
+  iteration_count:
+    formula: "count(think_steps)"
+    note: "多すぎると非効率、少なすぎると浅い"
+    
+  # ソース多様性
+  source_diversity:
+    formula: "unique_domains / total_sources * 100"
+    target: 60

package/.github/skills/shikigami-writing/templates/report-templates/thinking-flow-report-template.md

@@ -0,0 +1,256 @@
+# [レポートタイトル] - 思考フロー付きレポート
+
+**作成日時**: [YYYY-MM-DD HH:MM] (JST)
+**バージョン**: v[X.Y]
+**プロジェクトID**: pjXXXXX
+
+## 変更履歴
+
+| バージョン | 日時 | 変更内容 |
+|-----------|------|----------|
+| v1.0 | [YYYY-MM-DD HH:MM] (JST) | 初版作成 |
+
+---
+
+## 🎯 エグゼクティブサマリー
+
+### 一言で言うと
+
+> **[この報告の本質を1文で]**
+
+### 主要な発見事項
+
+| # | 発見 | 信頼度 | ソース |
+|---|------|--------|--------|
+| 1 | [発見1] | ⭐⭐⭐⭐⭐ | [[1]](#ref-1) |
+| 2 | [発見2] | ⭐⭐⭐⭐ | [[2]](#ref-2), [[3]](#ref-3) |
+| 3 | ⚠️ [単一ソースの発見] | ⭐⭐⭐ | [[4]](#ref-4) |
+
+### 推奨アクション
+
+1. **[アクション1]** - 優先度: 高
+2. **[アクション2]** - 優先度: 中
+3. **[アクション3]** - 優先度: 低
+
+---
+
+## 📋 背景・目的
+
+### 調査背景
+
+[なぜこの調査が必要になったか]
+
+### 調査目的（JTBDで特定）
+
+| Jobs to Be Done | 説明 |
+|-----------------|------|
+| 機能的ジョブ | [達成したいタスク] |
+| 感情的ジョブ | [感じたい/避けたい感情] |
+| 社会的ジョブ | [他者からの評価] |
+
+### 調査スコープ
+
+- **対象**: [調査対象]
+- **期間**: [対象期間]
+- **除外事項**: [調査対象外]
+
+---
+
+## 🔬 調査結果
+
+### トピック1: [トピック名]
+
+[調査結果の詳細]
+
+| 項目 | 内容 | ソース |
+|------|------|--------|
+| [項目1] | [内容] | [[1]](#ref-1) |
+| [項目2] | [内容] | [[2]](#ref-2) |
+
+### トピック2: [トピック名]
+
+[調査結果の詳細]
+
+---
+
+## 📊 分析・考察
+
+### 適用フレームワーク
+
+[フレームワーク分析結果]
+
+### 重要な洞察
+
+| 洞察 | 根拠 | 示唆 |
+|------|------|------|
+| [洞察1] | [根拠] | [アクション示唆] |
+| [洞察2] | [根拠] | [アクション示唆] |
+
+---
+
+## ✅ 結論・提言
+
+### 結論
+
+[主要な結論]
+
+### 提言
+
+| 提言 | 期待効果 | 必要リソース | 優先度 |
+|------|----------|--------------|--------|
+| [提言1] | [効果] | [リソース] | P0 |
+| [提言2] | [効果] | [リソース] | P1 |
+
+### 次のステップ
+
+1. [ステップ1]
+2. [ステップ2]
+3. [ステップ3]
+
+---
+
+## 📐 思考フロー・トレース（v1.20.0）🆕
+
+> このレポートはどのような思考プロセスを経て作成されたかを示します。
+> 読者はこのセクションで調査の透明性・信頼性を確認できます。
+
+### 🗺️ フローマップ
+
+```mermaid
+flowchart TB
+    subgraph Phase0["Phase 0: 初期化"]
+        A[🚀 プロジェクト初期化]
+    end
+    
+    subgraph Phase1["Phase 1: 目的探索"]
+        B[🎯 目的探索]
+        C[💡 仮説生成]
+        D[📋 計画立案]
+    end
+    
+    subgraph Phase2["Phase 2: Deep Research"]
+        E[🧠 Think #1]
+        F[🔍 Search]
+        G[📖 Visit]
+        H[✅ Verify]
+        I[📄 Report更新]
+        E2[🧠 Think #2]
+        E3[🧠 Think #3]
+    end
+    
+    subgraph Phase3["Phase 3: 分析"]
+        J[🔧 フレームワーク選択]
+        K[📊 フレームワーク分析]
+        L[💎 洞察抽出]
+    end
+    
+    subgraph Phase4["Phase 4: レポート"]
+        M[🏗️ 構成設計]
+        N[✍️ コンテンツ生成]
+        O[🔬 品質検証]
+        P[📚 引用整形]
+        Q[🎉 完成]
+    end
+    
+    A --> B --> C --> D --> E
+    E --> F --> I --> E2
+    E2 --> G --> I
+    E2 --> H --> I --> E3
+    E3 -->|"十分"| J
+    J --> K --> L --> M
+    M --> N --> O
+    O -->|"OK"| P --> Q
+    
+    classDef completed fill:#10b981,stroke:#059669,color:#fff
+    class A,B,C,D,E,F,G,H,I,E2,E3,J,K,L,M,N,O,P,Q completed
+```
+
+### 📜 思考ログ
+
+| # | 時刻 | ステップ | 判断内容 | 信頼度 |
+|---|------|---------|---------|--------|
+| 1 | [HH:MM] | 🚀 初期化 | プロジェクト作成、関連ナレッジ[X]件継承 | - |
+| 2 | [HH:MM] | 🎯 目的探索 | [特定された真の目的] | ⭐⭐⭐⭐ |
+| 3 | [HH:MM] | 💡 仮説生成 | [初期仮説の内容] | ⭐⭐⭐ |
+| 4 | [HH:MM] | 📋 計画立案 | タスク[X]件、推定時間[Y]分 | - |
+| 5 | [HH:MM] | 🧠 Think #1 | [現状分析の結果] | ⭐⭐⭐ |
+| 6 | [HH:MM] | 🔍 検索 | クエリ: "[検索語]" → [X]件取得 | - |
+| 7 | [HH:MM] | 📖 詳細調査 | [URL] から [抽出内容] | ⭐⭐⭐⭐ |
+| 8 | [HH:MM] | 🧠 Think #2 | **仮説修正**: [修正内容] | ⭐⭐⭐⭐ |
+| 9 | [HH:MM] | ✅ 検証 | [X]ソースで交差検証完了 | ⭐⭐⭐⭐⭐ |
+| 10 | [HH:MM] | 🔧 FW選択 | [選択したフレームワーク]を適用 | - |
+| 11 | [HH:MM] | 💎 洞察抽出 | [主要な洞察] | ⭐⭐⭐⭐ |
+| 12 | [HH:MM] | 🔬 品質検証 | ハルシネーション検出: [X]件修正 | - |
+| 13 | [HH:MM] | 🎉 完成 | スコア: [X]/10 | - |
+
+### 🔀 重要な判断ポイント（ピボット記録）
+
+| ポイント | 元の方向 | 変更後 | 変更理由 |
+|---------|---------|--------|----------|
+| **仮説修正** | [元の仮説] | [修正後の仮説] | [理由] |
+| **スコープ変更** | [元のスコープ] | [修正後] | [理由] |
+| **追加調査** | - | [追加内容] | [発見されたギャップ] |
+
+### 🚧 デッドエンド（中止した調査）
+
+| 調査内容 | 中止理由 | 得られた学び |
+|---------|---------|-------------|
+| [調査1] | [理由] | [学び] |
+
+### 📈 思考メトリクス
+
+| 指標 | 値 | 評価 | 説明 |
+|------|-----|------|------|
+| 調査ラウンド数 | [X] | ✅/⚠️/❌ | 3-7が目安 |
+| 交差検証率 | [X]% | ✅/⚠️/❌ | 70%以上が目標 |
+| ソース多様性 | [X]ドメイン | ✅/⚠️/❌ | 5+が目標 |
+| 仮説修正回数 | [X] | - | 柔軟な思考の証 |
+| デッドエンド数 | [X] | - | 探索の幅 |
+| 総所要時間 | [X]分 | - | - |
+
+### 🎯 思考の質スコア
+
+```
+[██████████░░░░░░░░░░] 総合: [X]/10
+
+内訳:
+├─ 情報収集の深さ:    [X]/10 ████████░░
+├─ 検証の厳密さ:      [X]/10 █████████░
+├─ 分析の論理性:      [X]/10 ███████░░░
+├─ 洞察の独自性:      [X]/10 ██████░░░░
+└─ 結論の実用性:      [X]/10 ████████░░
+```
+
+---
+
+## 📚 参考文献
+
+<a id="ref-1">[1]</a> [タイトル1](URL1) - YYYY-MM-DD, ドメイン種別: [公式/学術/メディア]
+
+<a id="ref-2">[2]</a> [タイトル2](URL2) - YYYY-MM-DD, ドメイン種別: [公式/学術/メディア]
+
+<a id="ref-3">[3]</a> [タイトル3](URL3) - YYYY-MM-DD, ドメイン種別: [公式/学術/メディア]
+
+<a id="ref-4">[4]</a> [タイトル4](URL4) - YYYY-MM-DD, ドメイン種別: [公式/学術/メディア] ⚠️ 単一ソース
+
+---
+
+## 付録
+
+### A. 検索クエリログ
+
+| # | クエリ | 言語 | 結果数 | 使用数 |
+|---|--------|------|--------|--------|
+| 1 | [クエリ1] | 日本語 | [X] | [Y] |
+| 2 | [クエリ2] | English | [X] | [Y] |
+
+### B. 訪問ページログ
+
+| # | URL | 抽出内容 | 信頼度 |
+|---|-----|---------|--------|
+| 1 | [URL1] | [内容サマリー] | ⭐⭐⭐⭐ |
+| 2 | [URL2] | [内容サマリー] | ⭐⭐⭐⭐⭐ |
+
+---
+
+*このレポートはSHIKIGAMI v1.20.0で生成されました。思考フロー可視化機能により、調査プロセスの透明性を確保しています。*

package/.github/skills/shikigami-writing/templates/thinking-flow-template.md

@@ -0,0 +1,153 @@
+# 思考フロートラッキング テンプレート
+
+このテンプレートはレポート生成時に思考の流れを自動記録するためのものです。
+
+---
+
+## 🧭 思考フロー・トラッカー
+
+### フォーマット
+
+各思考ステップを以下の形式で記録:
+
+```yaml
+thinking_flow:
+  project_id: "pjXXXXX"
+  started_at: "YYYY-MM-DD HH:MM"
+  completed_at: "YYYY-MM-DD HH:MM"
+  
+  steps:
+    - id: 1
+      type: "purpose_discovery"
+      timestamp: "YYYY-MM-DD HH:MM:SS"
+      input: "ユーザーの質問・要求"
+      reasoning: "なぜこの判断をしたか"
+      output: "このステップの結果"
+      confidence: 0.85
+      sources: []
+      duration_sec: 120
+      
+    - id: 2
+      type: "hypothesis_generation"
+      # ...
+```
+
+---
+
+## 📊 思考フロー可視化セクション（レポート用）
+
+レポートに挿入する形式:
+
+```markdown
+## 📐 思考フロー・トレース
+
+> このレポートはどのような思考プロセスを経て作成されたかを示します。
+
+### 🗺️ フローマップ
+
+\`\`\`mermaid
+flowchart TB
+    subgraph Phase0["Phase 0: 初期化"]
+        A[🚀 プロジェクト初期化]
+    end
+    
+    subgraph Phase1["Phase 1: 目的探索"]
+        B[🎯 目的探索]
+        C[💡 仮説生成]
+        D[📋 計画立案]
+    end
+    
+    subgraph Phase2["Phase 2: Deep Research"]
+        E[🧠 Think #1]
+        F[🔍 Search]
+        G[📖 Visit]
+        H[✅ Verify]
+        I[📄 Report更新]
+    end
+    
+    subgraph Phase3["Phase 3: 分析"]
+        J[🔧 フレームワーク選択]
+        K[📊 フレームワーク分析]
+        L[💎 洞察抽出]
+    end
+    
+    subgraph Phase4["Phase 4: レポート"]
+        M[🏗️ 構成設計]
+        N[✍️ コンテンツ生成]
+        O[🔬 品質検証]
+        P[📚 引用整形]
+        Q[🎉 完成]
+    end
+    
+    A --> B --> C --> D --> E
+    E --> F --> I
+    E --> G --> I
+    E --> H --> I
+    I -->|"十分"| J
+    I -->|"不十分"| E
+    J --> K --> L --> M
+    M --> N --> O
+    O -->|"OK"| P --> Q
+    O -->|"修正"| N
+    
+    classDef completed fill:#10b981,stroke:#059669,color:#fff
+    classDef current fill:#3b82f6,stroke:#2563eb,color:#fff
+    classDef pending fill:#e5e7eb,stroke:#9ca3af
+    
+    class A,B,C,D,E,F,G,H,I,J,K,L completed
+    class M,N current
+    class O,P,Q pending
+\`\`\`
+
+### 📜 思考ログ
+
+| # | 時刻 | ステップ | 判断内容 | 信頼度 |
+|---|------|---------|---------|--------|
+| 1 | 10:00 | 🎯 目的探索 | JTBDで「業務効率化」が真のゴールと判明 | ⭐⭐⭐⭐ |
+| 2 | 10:15 | 💡 仮説生成 | 「ツールAが最適」という初期仮説を設定 | ⭐⭐⭐ |
+| 3 | 10:30 | 🔍 検索 | 「ツールA 比較 2026」で検索、10件取得 | - |
+| 4 | 10:45 | 🧠 Think | 仮説と矛盾するデータ発見、仮説を修正 | ⭐⭐⭐⭐ |
+| 5 | 11:00 | ✅ 検証 | 3ソースで価格情報を交差検証 | ⭐⭐⭐⭐⭐ |
+
+### 🔀 重要な判断ポイント
+
+| ポイント | 判断 | 理由 |
+|---------|------|------|
+| **仮説修正** | ツールA → ツールB | 価格差が想定の2倍、ROI見込みが逆転 |
+| **追加調査** | セキュリティ機能 | 顧客要件の優先度が高いと判明 |
+| **フレームワーク選択** | SWOT + TCO分析 | 競合比較と費用対効果の両面が必要 |
+
+### 📈 思考メトリクス
+
+| 指標 | 値 | 評価 |
+|------|-----|------|
+| 調査ラウンド数 | 5 | ✅ 適切（3-7が目安） |
+| 交差検証率 | 78% | ✅ 良好（70%以上が目標） |
+| ソース多様性 | 12ドメイン | ✅ 良好 |
+| 仮説修正回数 | 2 | ✅ 柔軟な思考 |
+| デッドエンド | 1 | 📝 「ツールC調査→中止」 |
+```
+
+---
+
+## 🔧 実装ガイド
+
+### ステップ記録タイミング
+
+| イベント | 記録する内容 |
+|---------|-------------|
+| Phase開始 | タイムスタンプ、インプット |
+| 判断実施 | reasoning、confidence、代替案 |
+| ツール使用 | ツール名、パラメータ、結果サマリー |
+| 仮説変更 | 変更前/後、変更理由 |
+| Phase完了 | アウトプット、次ステップ |
+
+### confidence（信頼度）の基準
+
+| 値 | 星 | 意味 |
+|----|-----|------|
+| 0.9-1.0 | ⭐⭐⭐⭐⭐ | 複数信頼ソース、矛盾なし |
+| 0.7-0.9 | ⭐⭐⭐⭐ | 2+ソース、軽微な矛盾 |
+| 0.5-0.7 | ⭐⭐⭐ | 単一ソース or 一部未確認 |
+| 0.3-0.5 | ⭐⭐ | 推定・仮説段階 |
+| 0.0-0.3 | ⭐ | 情報不足、要追加調査 |

package/AGENTS.md

@@ -345,18 +345,60 @@ Phase 5: Completion（完了）
 
 | 項目 | 詳細 |
 |------|------|
-| **バージョン** | 1.19.0 |
+| **バージョン** | 1.20.0 |
 | **言語** | TypeScript |
 | **ランタイム** | Node.js >= 20.0.0 |
 | **Agent Skills** | 4スキル |
 | **Prompts** | 12プロンプト |
 | **フレームワーク** | 53定義 |
 | **MCPツール** | 7ツール |
-| **レポートテンプレート** | 10種類 |
+| **レポートテンプレート** | 33種類 |
 | **テスト数** | 250+ |
 
 ---
 
+## 🆕 v1.20.0 新機能（思考フロー可視化）
+
+### Thinking Flow Visualization - レポート作成過程の透明性向上
+
+レポート作成に至るまでの**思考プロセス**を自動追跡・可視化し、レポートに出力する新機能を追加しました。
+
+#### 出力される内容
+
+| 項目 | 内容 |
+|------|------|
+| 🗺️ フローマップ | Phase 0-4の全ステップをMermaidダイアグラムで可視化 |
+| 📜 思考ログ | 時系列での判断記録（タイムスタンプ、判断内容、信頼度） |
+| 🔀 ピボット記録 | 仮説修正・方針転換の検出と記録 |
+| 📈 思考メトリクス | 調査ラウンド数、交差検証率、ソース多様性等 |
+
+#### 思考ステップの種類（18種類）
+
+| Phase | ステップ |
+|-------|----------|
+| 0: 初期化 | プロジェクト作成、ナレッジ継承 |
+| 1: 目的探索 | 目的発見、仮説生成、計画立案 |
+| 2: Deep Research | Think/Search/Visit/Verify/Report更新 |
+| 3: 分析 | フレームワーク選択・適用、洞察抽出 |
+| 4: レポート | 構成設計、生成、品質検証、引用整形 |
+
+#### レポート構成の変更
+
+```
+[旧] 1.サマリー → 2.背景 → 3.結果 → 4.分析 → 5.結論 → 6.参考文献
+[新] 1.サマリー → 2.背景 → 3.結果 → 4.分析 → 5.結論 → 6.📐思考フロー → 7.参考文献
+```
+
+#### 新規追加ファイル
+
+| ファイル | 用途 |
+|---------|------|
+| `configs/thinking-flow.yaml` | 思考ステップ定義・可視化設定 |
+| `templates/thinking-flow-template.md` | 思考フロー記録テンプレート |
+| `templates/report-templates/thinking-flow-report-template.md` | 思考フロー付きレポートテンプレート |
+
+---
+
 ## 🆕 v1.19.0 新機能（構造化プロンプト生成＋ユーザー確認フェーズ）
 
 ### Phase 0.5: Prompt Refinement（構造化プロンプト生成）

package/CHANGELOG.md

@@ -5,6 +5,39 @@ All notable changes to SHIKIGAMI will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.20.0] - 2026-01-25
+
+### Added
+
+- **思考フロー可視化機能（Thinking Flow Visualization）**
+  - レポート作成に至るまでの思考プロセスを自動追跡・可視化
+  - 新規設定ファイル: `shikigami-writing/configs/thinking-flow.yaml`
+  - 新規テンプレート: `thinking-flow-template.md`, `thinking-flow-report-template.md`
+
+- **思考フローの記録内容**
+  - 🗺️ フローマップ: Phase 0-4の全ステップをMermaidダイアグラムで可視化
+  - 📜 思考ログ: 時系列での判断記録（タイムスタンプ、判断内容、信頼度）
+  - 🔀 ピボット記録: 仮説修正・方針転換の検出と記録
+  - 📈 思考メトリクス: 調査ラウンド数、交差検証率、ソース多様性等
+
+- **レポート構成の更新**
+  - 調査レポートに「📐 思考フロー・トレース」セクションを追加
+  - 33テンプレートに増加（thinking-flow-report-template追加）
+
+### Changed
+
+- **shikigami-deep-research**: Think フェーズに「選択理由」フィールドを追加
+- **shikigami-writing**: 起動条件に「思考フロー出力要求時」を追加
+- **shikigami-full-research.prompt.md**: 品質基準に「透明性」を追加
+- **shikigami-report-writing.prompt.md**: Step 4として思考フロー出力を追加
+
+### Technical Details
+
+- 思考ステップタイプ: 18種類（Phase 0-4に対応）
+- 信頼度スケール: 0.0-1.0（⭐1-5で表示）
+- 可視化出力: Mermaid flowchart TB形式
+- メトリクス計算: 深さ、検証率、反復回数、ソース多様性
+
 ## [1.17.0] - 2026-01-19
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nahisaho/shikigami",
-  "version": "1.19.3",
+  "version": "1.20.0",
   "description": "GitHub Copilot Agent Skills for Deep Research & Consulting - AI-Powered Research Assistant with 50+ Consulting Frameworks",
   "keywords": [
     "github-copilot",