shiden 0.5.1 → 0.6.0

package/.github/copilot-instructions.md

@@ -22,21 +22,22 @@ Your role is to help create evidence-based educational artifacts grounded in cur
 
 ## Process Transparency
 
-SHIDEN is used by practicing teachers and aspiring student teachers. Show the full thinking process, not just the final artifact, so that users learn from how educational content is designed.
+SHIDEN is used by practicing teachers and aspiring student teachers. After generating an artifact, show the full thinking process that led to it, so that users learn from how educational content is designed.
 
-- Before presenting an artifact, display each decision step and its reasoning.
+- First, present the final artifact so the user can see the deliverable immediately.
+- Then, display the thinking process that produced it: what was searched, what was considered, what was chosen and why.
 - Do not hide curriculum search results, theory selection rationale, or design trade-offs.
-- Separate intermediate outputs (search results, candidate comparisons, selection reasons) from the final artifact.
-- Showing the process is a core purpose, not optional commentary.
+- Showing the process after the artifact is a core purpose, not optional commentary.
 
-### Process Display Structure
+### Output Order
 
-1. **Intake Summary** — Collected conditions and decision summary.
-2. **Curriculum Lookup** — Search commands and results (for K-12).
-3. **Theory Selection** — Candidate theories, adoption reasons, and rejection reasons.
-4. **Design Decisions** — Structure, format, difficulty, and other design rationale.
-5. **Artifact** — The final deliverable.
-6. **Quality Check** — Quality gate pass/fail status.
+1. **Artifact** — The final deliverable comes first.
+2. **Process Log** — Then the thinking process is displayed:
+   - Intake Summary — Collected conditions and decision summary.
+   - Curriculum Lookup — Search commands and results (for K-12).
+   - Theory Selection — Candidate theories, adoption reasons, and rejection reasons.
+   - Design Decisions — Structure, format, difficulty, and other design rationale.
+   - Quality Check — Quality gate pass/fail status.
 
 ## File Output
 
@@ -61,29 +62,31 @@ topic: {単元・トピック}
 theories_used: [{理論1}, {理論2}]
 ---
 
-## 1. Intake Summary
+## Artifact
+{最終成果物の全文}
+
+## Process Log
+
+### 1. Intake Summary
 {収集した条件、判断の要約}
 
-## 2. Curriculum Lookup
+### 2. Curriculum Lookup
 {検索コマンド、検索結果、参照箇所}
 
-## 3. Theory Selection
+### 3. Theory Selection
 {候補理論、採用理由、不採用理由}
 
-## 4. Design Decisions
+### 4. Design Decisions
 {構成・形式・難易度の設計根拠}
 
-## 5. Artifact
-{最終成果物の全文}
-
-## 6. Quality Check
+### 5. Quality Check
 {品質ゲートの通過状況}
 ```
 
 ### Rules
 
 - File name: `SHIDEN_{artifact-type}_{YYYYMMDD}_{topic}.md`
-- The file MUST contain both the process log (sections 1-4, 6) and the artifact (section 5).
+- The file MUST contain the artifact first, followed by the process log (Intake Summary, Curriculum Lookup, Theory Selection, Design Decisions, Quality Check).
 - If the topic contains spaces, replace them with hyphens.
 - Include YAML frontmatter metadata at the top of the file.
 
@@ -128,7 +131,7 @@ theories_used: [{理論1}, {理論2}]
 - [ ] Educational theory is applied only when it improves the artifact.
 - [ ] The output is concrete enough to be used without major rewriting.
 - [ ] Sensitive cases include appropriate escalation language.
-- [ ] Process steps (search results, theory selection, design decisions) are shown before the artifact.
+- [ ] Process steps (search results, theory selection, design decisions) are shown after the artifact.
 - [ ] The complete output (process and artifact) is saved to a file.
 
 ## Gotchas

package/.github/prompts/assessment.md

@@ -6,7 +6,7 @@ description: >
   test, quiz scoring guide, checklist, or assessment criteria.
 metadata:
   author: nahisaho
-  version: "0.5.1"
+  version: "0.5.2"
 ---
 
 # Assessment
@@ -32,8 +32,9 @@ metadata:
 3. references/common-theory-selection.mdを読み、Constructive AlignmentとBloom's Taxonomyを中心に評価設計する。
 4. assets/assessment-template.mdを再利用し、評価タイプ別の出力へ落とし込む。
 5. 問題や観点ごとに、どの学習目標へ対応するか明示する。
-6. プロセス全体（指導要領参照結果、認知レベル分析、設計判断）を表示する。
-7. create_fileツールで `SHIDEN_assessment_{YYYYMMDD}_{topic}.md` にプロセスと成果物を保存する。保存完了をユーザーに報告する。
+6. 成果物（評価ツール）を先に提示する。
+7. 次に、プロセス全体（指導要領参照結果、認知レベル分析、設計判断の根拠）を表示する。
+8. create_fileツールで `SHIDEN_assessment_{YYYYMMDD}_{topic}.md` に成果物とプロセスログを保存する。保存完了をユーザーに報告する。
 
 ## Conditional References
 

package/.github/prompts/feedback.md

@@ -6,7 +6,7 @@ description: >
   reflection support, return notes, or response wording to learners.
 metadata:
   author: nahisaho
-  version: "0.5.1"
+  version: "0.5.2"
 ---
 
 # Feedback
@@ -32,8 +32,9 @@ metadata:
 3. assets/feedback-template.mdを再利用し、強み、改善点、次のアクション、振り返り質問をまとめる。
 4. 既存ルーブリックや評価観点がある場合は、それに沿って表現を合わせる。
 5. 学習者が次に取るべき行動を、1〜3件の具体策へ落とし込む。
-6. プロセス全体（表現方針の決定理由、理論適用箇所、トーン選定理由）を表示する。
-7. create_fileツールで `SHIDEN_feedback_{YYYYMMDD}_{topic}.md` にプロセスと成果物を保存する。保存完了をユーザーに報告する。
+6. 成果物（フィードバック）を先に提示する。
+7. 次に、プロセス全体（表現方針の決定理由、理論適用箇所、トーン選定の根拠）を表示する。
+8. create_fileツールで `SHIDEN_feedback_{YYYYMMDD}_{topic}.md` に成果物とプロセスログを保存する。保存完了をユーザーに報告する。
 
 ## Conditional References
 

package/.github/prompts/guidance.md

@@ -6,7 +6,7 @@ description: >
   student behavior support, parent communication, counseling flow, or crisis response.
 metadata:
   author: nahisaho
-  version: "0.5.1"
+  version: "0.5.2"
 ---
 
 # Guidance
@@ -32,8 +32,9 @@ metadata:
 3. 発達段階や学校文脈を踏まえて、初期対応、継続支援、フォローアップを設計する。
 4. 保護者連絡文や面談方針が必要なら、役割別に分けて作成する。
 5. assets/guidance-template.mdを再利用し、専門家連携が必要な場合は必ず明記する。
-6. プロセス全体（緊急度判定の理由、対応フェーズの設計根拠、連携先選定理由）を表示する。
-7. create_fileツールで `SHIDEN_guidance_{YYYYMMDD}_{topic}.md` にプロセスと成果物を保存する。保存完了をユーザーに報告する。
+6. 成果物（指導案）を先に提示する。
+7. 次に、プロセス全体（緊急度判定の理由、対応フェーズの設計根拠、連携先選定の根拠）を表示する。
+8. create_fileツールで `SHIDEN_guidance_{YYYYMMDD}_{topic}.md` に成果物とプロセスログを保存する。保存完了をユーザーに報告する。
 
 ## Conditional References
 

package/.github/prompts/individual.md

@@ -6,7 +6,7 @@ description: >
   accommodations, intervention planning, or differentiated instruction.
 metadata:
   author: nahisaho
-  version: "0.5.1"
+  version: "0.5.2"
 ---
 
 # Individual Support
@@ -32,8 +32,9 @@ metadata:
 3. references/common-theory-selection.mdを読み、ZPD、Scaffolding、UDLなどから支援理論を選ぶ。
 4. 高リスク事案や心理的危機が疑われる場合はreferences/common-safety.mdを読み、専門家連携を明記する。
 5. assets/individual-template.mdを再利用し、目標、支援戦略、進捗確認方法を整理する。
-6. プロセス全体（到達範囲確認結果、支援理論の選定理由、リスク判定）を表示する。
-7. create_fileツールで `SHIDEN_individual_{YYYYMMDD}_{topic}.md` にプロセスと成果物を保存する。保存完了をユーザーに報告する。
+6. 成果物（個別支援計画）を先に提示する。
+7. 次に、プロセス全体（到達範囲確認結果、支援理論の選定理由、リスク判定の根拠）を表示する。
+8. create_fileツールで `SHIDEN_individual_{YYYYMMDD}_{topic}.md` に成果物とプロセスログを保存する。保存完了をユーザーに報告する。
 
 ## Conditional References
 

package/.github/prompts/lesson-plan.md

@@ -6,7 +6,7 @@ description: >
   unit lesson flow, or class activity sequence.
 metadata:
   author: nahisaho
-  version: "0.5.1"
+  version: "0.5.2"
 ---
 
 # Lesson Plan
@@ -32,8 +32,9 @@ metadata:
 3. references/common-theory-selection.mdを読み、目標・活動・評価に合う理論を2件以上選ぶ。
 4. assets/lesson-plan-template.mdを再利用し、導入・展開・まとめ・評価を一貫して設計する。
 5. 後続で教材や評価を作る可能性があるため、学習目標と観点を明示する。
-6. プロセス全体（指導要領検索結果、理論選定理由、設計判断）を表示する。
-7. create_fileツールで `SHIDEN_lesson-plan_{YYYYMMDD}_{topic}.md` にプロセスと成果物を保存する。保存完了をユーザーに報告する。
+6. 成果物（授業計画）を先に提示する。
+7. 次に、プロセス全体（指導要領検索結果、理論選定理由、設計判断の根拠）を表示する。
+8. create_fileツールで `SHIDEN_lesson-plan_{YYYYMMDD}_{topic}.md` に成果物とプロセスログを保存する。保存完了をユーザーに報告する。
 
 ## Conditional References
 

package/.github/prompts/materials.md

@@ -6,7 +6,7 @@ description: >
   slide deck, quiz sheet, handout, or lesson material package.
 metadata:
   author: nahisaho
-  version: "0.5.1"
+  version: "0.5.2"
 ---
 
 # Materials
@@ -32,8 +32,9 @@ metadata:
 3. references/common-theory-selection.mdを読み、注意喚起・練習・振り返りの設計原則を選定する。
 4. 要求形式に応じてassets/materials-template.mdを再利用し、教材構造を決める。
 5. 必要に応じて授業計画の目標や時間配分と整合させる。
-6. プロセス全体（指導要領参照結果、理論選定理由、形式選定理由）を表示する。
-7. create_fileツールで `SHIDEN_materials_{YYYYMMDD}_{topic}.md` にプロセスと成果物を保存する。保存完了をユーザーに報告する。
+6. 成果物（教材）を先に提示する。
+7. 次に、プロセス全体（指導要領参照結果、理論選定理由、形式選定理由）を表示する。
+8. create_fileツールで `SHIDEN_materials_{YYYYMMDD}_{topic}.md` に成果物とプロセスログを保存する。保存完了をユーザーに報告する。
 
 ## Conditional References
 

package/.github/prompts/meta-prompt.md

@@ -6,7 +6,7 @@ description: >
   under-specified, or needs context collection before any education artifact is generated.
 metadata:
   author: nahisaho
-  version: "0.5.1"
+  version: "0.5.2"
 ---
 
 # Meta Prompt
@@ -31,8 +31,9 @@ metadata:
 3. 5問以内で、学年・教科・トピック・目標・制約を優先収集する。
 4. 情報が十分にそろった時点で質問を打ち切り、構造化メタプロンプトを生成する。
 5. 後続スキルへ、確定情報と未確定情報を明示して引き継ぐ。
-6. 収集プロセス全体（質問意図、回答の解釈、判断理由）を表示する。
-7. create_fileツールで `SHIDEN_meta-prompt_{YYYYMMDD}_{topic}.md` にプロセスと成果物を保存する。保存完了をユーザーに報告する。
+6. 成果物（構造化メタプロンプト）を先に提示する。
+7. 次に、収集プロセス全体（各質問の意図、回答の解釈、後続スキル選定理由）を表示する。
+8. create_fileツールで `SHIDEN_meta-prompt_{YYYYMMDD}_{topic}.md` に成果物とプロセスログを保存する。保存完了をユーザーに報告する。
 
 ## Conditional References
 

package/.github/skills/context-manager.md

@@ -6,7 +6,7 @@ description: >
   session defaults matter, or when generated outputs need consistent carry-over.
 metadata:
   author: nahisaho
-  version: "0.5.1"
+  version: "0.5.2"
 ---
 
 # Context Manager

package/.github/skills/orchestrator.md

@@ -6,7 +6,7 @@ description: >
   the target prompt is unclear, or execution order must be coordinated.
 metadata:
   author: nahisaho
-  version: "0.5.1"
+  version: "0.5.2"
 ---
 
 # Orchestrator

package/.github/skills/theory-lookup.md

@@ -6,7 +6,7 @@ description: >
   related theory discovery, or evidence-based instructional rationale.
 metadata:
   author: nahisaho
-  version: "0.5.1"
+  version: "0.5.2"
 ---
 
 # Theory Lookup

package/AGENTS.md

@@ -143,6 +143,7 @@ npx shiden curriculum grade "第3学年"
 | オーケストレーション | `orchestrator.md` | スキル選択・連携制御 |
 | 理論検索 | `theory-lookup.md` | 内蔵教育理論データベース連携 |
 | コンテキスト管理 | `context-manager.md` | セッション情報保持 |
+| 設計プロセスログ | `design-process-log.md` | 授業設計の判断プロセス可視化・記録 |
 
 ## スキルルーティング
 
@@ -156,6 +157,7 @@ npx shiden curriculum grade "第3学年"
 | 個別指導, 配慮, 支援 | `individual.md` |
 | フィードバック, 振り返り, コメント | `feedback.md` |
 | 生活指導, 行動, 相談 | `guidance.md` |
+| 設計記録, プロセス可視化, 設計ログ, 判断記録 | `design-process-log.md` |
 
 ### 意図が不明な場合
 
@@ -169,6 +171,7 @@ npx shiden curriculum grade "第3学年"
 4. 👤 個別指導計画
 5. 💬 フィードバック・振り返り
 6. 🤝 生活指導案
+7. 📋 設計プロセスの記録・可視化
 
 番号または内容でお答えください。
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shiden",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "教育者向けGitHub Copilot Agent Skills - 175件の教育理論＋学習指導要領を内蔵、FTS5日本語検索対応",
   "keywords": [
     "github-copilot",

package/templates/.github/skills/assets/design-log-template.md

@@ -0,0 +1,224 @@
+---
+date: {ISO-8601日付}
+artifact_type: design-log
+subject: {教科}
+topic: {単元/トピック名}
+grade: {学年}
+theories_used: [{採用理論のリスト}]
+theories_rejected: [{不採用理論のリスト}]
+---
+
+# 授業設計記録: {トピック名}
+
+> 本ドキュメントは、授業設計のプロセスを第三者が再現・検証可能な形式で記録したものです。
+
+---
+
+## 1. 設計概要
+
+### 1.1 学習目標
+
+**主目標**:
+{生徒を主語にした具体的な学習目標}
+
+**副目標**:
+- {副目標1}
+- {副目標2}
+
+### 1.2 対象学習者
+
+| 項目 | 内容 | 情報源 |
+|------|------|--------|
+| 学年 | {学年} | 確定 |
+| 人数 | {人数} | {確定/推測} |
+| 学習者の特性 | {特性の記述} | {確定/推測} |
+| 前提知識 | {前提となる知識} | {確定/推測} |
+
+### 1.3 制約条件
+
+| 項目 | 内容 | 情報源 | 設計への影響 |
+|------|------|--------|-------------|
+| 時間 | {授業時間} | {確定/推測} | {時間制約がどう設計に影響するか} |
+| 環境 | {教室環境} | {確定/推測} | {環境がどう設計に影響するか} |
+| リソース | {使用可能リソース} | {確定/推測} | {リソースがどう設計に影響するか} |
+
+---
+
+## 2. 学習指導要領との関連
+
+> ⚠️ 小中高の授業設計では必須セクション
+
+### 検索コマンド
+
+```bash
+npx shiden curriculum search "{検索キーワード}"
+npx shiden curriculum subject {教科}
+```
+
+### 参照箇所
+
+**学校種**: {小学校/中学校/高等学校}学習指導要領  
+**章・節**: 第{章}章 第{節}節 {教科}  
+**学年**: {対象学年}
+
+**目標**:
+> 「{学習指導要領の目標を引用}」
+
+**内容**:
+> 「{当該単元の内容を引用}」
+
+**本設計との対応**:
+{本授業設計が学習指導要領のどの部分にどう対応するかの説明}
+
+---
+
+## 3. 参照した理論・モデルの採否一覧
+
+### 3.1 採用した理論
+
+| # | 理論・モデル名 | 適用箇所 | 採用理由 |
+|---|---------------|---------|---------|
+| 1 | {理論名1} | {展開部、導入など} | {具体的な採用理由 — 省略禁止} |
+| 2 | {理論名2} | {どこに適用} | {具体的な採用理由 — 省略禁止} |
+| 3 | {理論名3} | {どこに適用} | {具体的な採用理由 — 省略禁止} |
+
+### 3.2 検討したが不採用とした理論
+
+| # | 理論・モデル名 | 不採用理由 |
+|---|---------------|-----------|
+| 1 | {理論名A} | {具体的な不採用理由 — 「同様の理由」禁止} |
+| 2 | {理論名B} | {具体的な不採用理由 — 「同様の理由」禁止} |
+| 3 | {理論名C} | {具体的な不採用理由 — 「同様の理由」禁止} |
+
+---
+
+## 4. 設計判断ログ
+
+### Step 1: {決定項目名}
+
+**決定内容**:
+{何を決定したかを具体的に記述}
+
+**根拠・エビデンス**:
+{なぜその判断をしたか — 理論、研究、経験則、制約条件など}
+
+**却下した選択肢**:
+
+| 選択肢 | 却下理由 |
+|--------|---------|
+| {選択肢A} | {具体的な却下理由} |
+| {選択肢B} | {具体的な却下理由} |
+
+---
+
+### Step 2: {決定項目名}
+
+**決定内容**:
+{何を決定したかを具体的に記述}
+
+**根拠・エビデンス**:
+{なぜその判断をしたか}
+
+**却下した選択肢**:
+
+| 選択肢 | 却下理由 |
+|--------|---------|
+| {選択肢A} | {具体的な却下理由} |
+| {選択肢B} | {具体的な却下理由} |
+
+---
+
+### Step 3: {決定項目名}
+
+**決定内容**:
+{何を決定したかを具体的に記述}
+
+**根拠・エビデンス**:
+{なぜその判断をしたか}
+
+**却下した選択肢**:
+
+| 選択肢 | 却下理由 |
+|--------|---------|
+| {選択肢A} | {具体的な却下理由} |
+| {選択肢B} | {具体的な却下理由} |
+
+---
+
+## 5. 設計フロー図
+
+### 5.1 学習フロー
+
+```mermaid
+flowchart TD
+    A[導入: {導入内容}] --> B[展開1: {展開1内容}]
+    B --> C[展開2: {展開2内容}]
+    C --> D[まとめ: {まとめ内容}]
+    
+    A -.-> |理論: {適用理論}| A
+    B -.-> |理論: {適用理論}| B
+    C -.-> |理論: {適用理論}| C
+```
+
+### 5.2 設計判断フロー（該当する場合のみ）
+
+```mermaid
+stateDiagram-v2
+    [*] --> 条件整理
+    条件整理 --> 理論選定
+    理論選定 --> 構造設計
+    構造設計 --> 活動設計
+    活動設計 --> 評価設計
+    評価設計 --> 品質確認
+    品質確認 --> [*]
+```
+
+---
+
+## 6. 品質チェック
+
+### 6.1 完了チェックリスト
+
+| # | チェック項目 | 状態 |
+|---|-------------|------|
+| 1 | 全ての判断に根拠が記載されている | [ ] |
+| 2 | 採用理論と不採用理論の両方が記録されている | [ ] |
+| 3 | 推測と確定情報が区別されている | [ ] |
+| 4 | 省略表現（「詳細は省略」「同様の理由で」）がない | [ ] |
+| 5 | 学習指導要領の参照が含まれている（小中高の場合） | [ ] |
+| 6 | 複雑なフローには Mermaid 図が挿入されている | [ ] |
+| 7 | 却下した選択肢とその理由が全ステップで記載されている | [ ] |
+
+### 6.2 省略表現チェック
+
+以下の表現が含まれている場合、個別記述に展開すること:
+- 「詳細は省略」
+- 「同様の理由で」
+- 「前述の通り」
+- 「上記参照」
+
+---
+
+## 7. 付録
+
+### 7.1 使用した SHIDEN コマンド
+
+```bash
+# 学習指導要領検索
+npx shiden curriculum search "{検索語}"
+npx shiden curriculum subject {教科}
+
+# 教育理論検索
+npx shiden theories search "{検索語}"
+npx shiden theories get {theory-id}
+npx shiden theories related {theory-id}
+```
+
+### 7.2 参考文献
+
+- {参考文献1}
+- {参考文献2}
+
+---
+
+*本ドキュメントは SHIDEN design-process-log スキルにより生成されました。*

package/templates/.github/skills/design-process-log.md

@@ -0,0 +1,302 @@
+---
+name: design-process-log
+description: >
+  授業設計（Instructional Design）のプロセスを第三者が再現・検証可能なレベルで記録し、
+  設計判断ログを `instructional_design_log.md` に可視化・保存する。
+  Use when documenting lesson design decisions, visualizing theory selection rationale,
+  creating reproducible instructional design records, or generating Mermaid-based
+  design flow diagrams.
+metadata:
+  author: coreclaw
+  version: "1.0"
+---
+
+# Design Process Log
+
+授業設計のプロセス全体を、再現・検証可能な形式で詳細に記録するスキル。
+
+## Use This Skill When
+
+- 授業設計の判断プロセスを記録・可視化したい
+- 理論・モデルの採否を根拠とともに残したい
+- 設計判断を後から振り返り・検証したい
+- 複雑な設計フローをMermaid図で可視化したい
+
+## 役割定義
+
+このスキルを実行するAIは**授業設計（Instructional Design）の専門家**として振る舞う。  
+設計プロセスは、第三者が**再現・検証できるレベル**で詳細に記録すること。
+
+---
+
+## Workflow
+
+### Phase 1: 設計条件の整理
+
+1. **確定情報の抽出**
+   - 学習目標 / 対象学習者 / 時間・環境・リソース制約
+   - 明示的に指定された内容のみを「確定」として記録
+
+2. **推測情報の明示**
+   - ユーザーが明示していないが推測した情報を「推測」セクションに分離
+   - 必ず「〜と推測」「検討中: 〇〇」と表記
+
+3. **不足情報の確認**（省略可能な場合のみスキップ）
+   - 最低限必要: 対象学習者、学習目標、時間制約
+
+### Phase 2: 学習指導要領の参照
+
+> ⚠️ 小中高の授業設計では**必須ステップ**
+
+```bash
+npx shiden curriculum search "<単元・キーワード>"
+npx shiden curriculum subject <教科>
+```
+
+- 検索コマンドと結果IDを記録に含める
+- 該当する目標・内容を「確定情報」として追記
+
+### Phase 3: 教育理論の検索・採否決定
+
+```bash
+npx shiden theories search "<キーワード>"
+npx shiden theories categories
+npx shiden theories get <theory-id>
+```
+
+#### 採否判断の記録ルール
+
+| 区分 | 記録内容 |
+|------|---------|
+| **採用理論** | 理論名 / どこに適用 / 採用理由（具体的） |
+| **不採用理論** | 理論名 / 不採用理由（具体的） |
+
+> ❌ 「同様の理由で採用」「詳細は省略」などの省略表現は**禁止**
+
+### Phase 4: 設計判断ログの作成
+
+各設計ステップで以下の3項目を**必ず**記録:
+
+1. **決定内容** — 何を決定したか
+2. **根拠・エビデンス** — なぜその判断をしたか
+3. **却下した選択肢と理由** — 他に何を検討し、なぜ採用しなかったか
+
+### Phase 5: Mermaid図の挿入（必要時）
+
+以下の条件に該当する場合、適切な箇所にMermaid図を挿入:
+
+- 学習フローが複雑（3段階以上の分岐）
+- フェーズ遷移が複数存在
+- モジュール間の依存関係がある
+- 意思決定ツリーが必要
+
+#### Mermaid図の種類選択ガイド
+
+| 用途 | 図の種類 | コード例 |
+|------|---------|---------|
+| 学習フロー | flowchart TD | `A[導入] --> B[展開] --> C[まとめ]` |
+| フェーズ遷移 | stateDiagram-v2 | `[*] --> 導入 --> 展開` |
+| 時間軸 | timeline | `title 授業フロー` |
+| 概念関係 | mindmap | `root((中心概念))` |
+
+### Phase 6: ファイル出力
+
+成果物を `instructional_design_log.md` として保存:
+- ファイル名形式: `instructional_design_log.md` または `SHIDEN_design-log_{日付}_{トピック}.md`
+- YAML frontmatter を含める
+
+---
+
+## Deliverables
+
+### 出力ファイル構造
+
+```markdown
+---
+date: {生成日}
+artifact_type: design-log
+subject: {教科}
+topic: {単元名}
+theories_used: [{採用理論リスト}]
+---
+
+# 授業設計記録: {トピック名}
+
+## 1. 設計概要
+
+### 1.1 学習目標
+{具体的な学習目標}
+
+### 1.2 対象学習者
+- 学年: {学年}
+- 人数: {人数}（推測の場合は明記）
+- 特性: {学習者の特性}
+
+### 1.3 制約条件
+| 項目 | 内容 | 情報源 |
+|------|------|--------|
+| 時間 | {時間} | {確定/推測} |
+| 環境 | {環境} | {確定/推測} |
+| リソース | {リソース} | {確定/推測} |
+
+---
+
+## 2. 参照した理論・モデルの採否一覧
+
+### 2.1 採用した理論
+
+| 理論・モデル名 | 適用箇所 | 採用理由 |
+|---------------|---------|---------|
+| {理論名} | {どこに適用} | {具体的な採用理由} |
+
+### 2.2 検討したが不採用とした理論
+
+| 理論・モデル名 | 不採用理由 |
+|---------------|-----------|
+| {理論名} | {具体的な不採用理由} |
+
+---
+
+## 3. 設計判断ログ
+
+### Step 1: {決定項目名}
+
+**決定内容**:
+{何を決定したか}
+
+**根拠・エビデンス**:
+{なぜその判断をしたか — 理論、経験則、制約条件など}
+
+**却下した選択肢**:
+| 選択肢 | 却下理由 |
+|--------|---------|
+| {選択肢A} | {具体的な却下理由} |
+| {選択肢B} | {具体的な却下理由} |
+
+### Step 2: {決定項目名}
+...
+
+---
+
+## 4. 設計フロー図
+
+{Mermaid図を挿入}
+
+---
+
+## 5. 品質チェック
+
+- [ ] 全ての判断に根拠が記載されている
+- [ ] 採用理論と不採用理論の両方が記録されている
+- [ ] 推測と確定情報が区別されている
+- [ ] 省略表現（「詳細は省略」「同様の理由で」）がない
+- [ ] 学習指導要領の参照が含まれている（小中高の場合）
+```
+
+---
+
+## Quality Gates
+
+出力完了前に以下を**必ず**確認:
+
+| # | チェック項目 | 合格基準 |
+|---|-------------|---------|
+| 1 | 判断根拠の完全性 | 全ステップに「根拠」が記載されている |
+| 2 | 理論採否の記録 | 採用・不採用の両方に理由が明示されている |
+| 3 | 情報源の明示 | 確定/推測が区別されている |
+| 4 | 省略禁止の遵守 | 「詳細は省略」「同様の理由で」がない |
+| 5 | 学習指導要領参照 | 小中高の場合、参照箇所が明記されている |
+| 6 | Mermaid図の適切性 | 複雑なフローには図が挿入されている |
+
+### 失敗時のリカバリ
+
+| 失敗パターン | リカバリアクション |
+|-------------|------------------|
+| 理由が「同様」「省略」 | 各項目を個別に再記述 |
+| 不採用理論の記録漏れ | 検討した理論を遡って追記 |
+| 確定/推測の混同 | 情報源カラムを追加して再整理 |
+| Mermaid構文エラー | コードブロックを修正し再描画 |
+
+---
+
+## Gotchas
+
+### 1. 「不採用理由」の記録漏れ
+**問題**: 採用した理論だけ記録し、検討したが不採用にした理論を忘れる  
+**対策**: Phase 3で検索した理論を**すべて**テーブルに列挙し、採否を埋める
+
+### 2. 省略表現の無意識な使用
+**問題**: 「同様の理由で」「詳細は省略」と書いてしまう  
+**対策**: 品質チェックで「省略」「同様」をgrepし、該当箇所を個別記述に展開
+
+### 3. 推測を確定として記載
+**問題**: ユーザーが明示していない情報を確定として扱う  
+**対策**: 情報源カラム（確定/推測）を設け、推測には「〜と推測」を明記
+
+### 4. Mermaid図の過剰挿入
+**問題**: 不要な箇所にも図を入れ、可読性が低下  
+**対策**: 「分岐3つ以上」「フェーズ遷移複数」の基準で挿入判断
+
+### 5. 学習指導要領の参照漏れ
+**問題**: 小中高の授業設計で学習指導要領を検索・引用しない  
+**対策**: Phase 2を**必須ステップ**として実行、検索コマンドを記録に含める
+
+---
+
+## Validation Loop
+
+```
+┌─────────────────────────────────────────────────┐
+│  1. 設計ログ生成                                 │
+├─────────────────────────────────────────────────┤
+│  2. Quality Gates チェック                       │
+│     └─ 1つでも ❌ → 該当箇所を修正して再チェック  │
+├─────────────────────────────────────────────────┤
+│  3. 省略表現の検出                               │
+│     grep: "省略" "同様の理由" "詳細は"            │
+│     └─ 検出あり → 個別記述に展開                 │
+├─────────────────────────────────────────────────┤
+│  4. 不採用理論のカウント                         │
+│     └─ 0件 → 検討した理論を遡って追記            │
+├─────────────────────────────────────────────────┤
+│  5. ファイル保存                                 │
+│     └─ 成功 → 完了                              │
+└─────────────────────────────────────────────────┘
+```
+
+---
+
+## 禁止事項
+
+- ❌ 「詳細は省略」「同様の理由で」などの省略表現の使用
+- ❌ 採用理論のみの記録（不採用理論とその理由も必須）
+- ❌ 推測を確定として記載（情報源を必ず明示）
+- ❌ 設計判断の根拠を省略
+- ❌ 小中高対象で学習指導要領を参照しない
+
+---
+
+## Integration with Other Skills
+
+### lesson-plan.md との連携
+
+授業計画生成後、本スキルを呼び出して設計プロセスを記録:
+
+```
+1. lesson-plan.md で授業計画を生成
+2. design-process-log.md で設計判断を記録
+3. 両方をユーザーに提示（成果物 → プロセスログの順）
+```
+
+### theory-lookup.md との連携
+
+理論検索結果を本スキルの採否テーブルに統合:
+
+```bash
+# 検索実行
+npx shiden theories search "動機づけ"
+
+# 結果をdesign-process-logの表に記録
+| ARCS Model | 導入・まとめ | 注意維持と達成感の設計に適合 |
+| Self-Determination Theory | - | 本単元の短時間設計には具体性不足 |
+```