shiden 0.5.0 → 0.5.2

package/.github/copilot-instructions.md

@@ -22,30 +22,73 @@ 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
 
-Always save the complete process and artifact to a file.
+Every SHIDEN generation MUST be saved to a file. This is not optional. The agent MUST use the create_file tool (or write the file via terminal) as the final step of every artifact generation. Do not end the turn without confirming the file has been created.
+
+### Mandatory Steps
+
+1. After the artifact and quality check are complete, assemble the full output (process log + artifact).
+2. Determine the file path: user-specified path if given, otherwise `./SHIDEN_{artifact-type}_{YYYYMMDD}_{topic}.md` in the current working directory.
+3. **Call create_file** with the assembled content. If create_file is unavailable, write the file using a terminal command.
+4. Confirm to the user that the file was saved, including the full file path.
+
+### File Content Structure
+
+```markdown
+---
+date: {YYYY-MM-DD}
+artifact_type: {lesson-plan|materials|assessment|individual|feedback|guidance|meta-prompt}
+grade: {学年}
+subject: {教科}
+topic: {単元・トピック}
+theories_used: [{理論1}, {理論2}]
+---
+
+## Artifact
+{最終成果物の全文}
+
+## Process Log
+
+### 1. Intake Summary
+{収集した条件、判断の要約}
+
+### 2. Curriculum Lookup
+{検索コマンド、検索結果、参照箇所}
+
+### 3. Theory Selection
+{候補理論、採用理由、不採用理由}
+
+### 4. Design Decisions
+{構成・形式・難易度の設計根拠}
+
+### 5. Quality Check
+{品質ゲートの通過状況}
+```
+
+### Rules
 
 - File name: `SHIDEN_{artifact-type}_{YYYYMMDD}_{topic}.md`
-- Location: User-specified path if given, otherwise the current working directory.
-- Content: The entire process (Intake Summary through Quality Check) and the final artifact in one file.
-- Include metadata at the top of the file (date, target audience, artifact type, theories used).
+- 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.
 
 ## Intake Rules
 
@@ -88,7 +131,7 @@ Always save the complete process and artifact to a file.
 - [ ] 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
@@ -99,7 +142,8 @@ Always save the complete process and artifact to a file.
 - Do not turn support plans or feedback into labels about the learner's character or condition.
 - Do not treat crisis cases as normal classroom guidance. Escalation language must be explicit.
 - Do not skip process display to save time. Showing reasoning is as important as the artifact for teacher development.
-- Do not forget to save the output to a file. Every generation must be persisted.
+- Do not end the turn without calling create_file (or writing via terminal). Displaying output in chat is NOT saving. The file must exist on disk.
+- If create_file fails, retry with a terminal write command. Never skip file saving.
 
 ## File Preferences
 

package/.github/prompts/assessment.md

@@ -6,7 +6,7 @@ description: >
   test, quiz scoring guide, checklist, or assessment criteria.
 metadata:
   author: nahisaho
-  version: "0.5.0"
+  version: "0.5.2"
 ---
 
 # Assessment
@@ -32,7 +32,9 @@ metadata:
 3. references/common-theory-selection.mdを読み、Constructive AlignmentとBloom's Taxonomyを中心に評価設計する。
 4. assets/assessment-template.mdを再利用し、評価タイプ別の出力へ落とし込む。
 5. 問題や観点ごとに、どの学習目標へ対応するか明示する。
-6. プロセス全体（指導要領参照結果、認知レベル分析、設計判断）を表示し、成果物とともにファイルへ保存する。
+6. 成果物（評価ツール）を先に提示する。
+7. 次に、プロセス全体（指導要領参照結果、認知レベル分析、設計判断の根拠）を表示する。
+8. create_fileツールで `SHIDEN_assessment_{YYYYMMDD}_{topic}.md` に成果物とプロセスログを保存する。保存完了をユーザーに報告する。
 
 ## Conditional References
 
@@ -76,4 +78,5 @@ metadata:
    - 評価方法が再現可能か。
    - 指導要領参照が必要な対象で漏れがないか。
 3. 不合格なら、観点定義・設問構成・配点を修正して再生成する。
-4. 採点者がそのまま使える状態になったら完了とする。
+4. ファイルが保存されていなければ、create_fileで保存する。
+5. 採点者がそのまま使える状態になったら完了とする。

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.0"
+  version: "0.5.2"
 ---
 
 # Feedback
@@ -32,7 +32,9 @@ metadata:
 3. assets/feedback-template.mdを再利用し、強み、改善点、次のアクション、振り返り質問をまとめる。
 4. 既存ルーブリックや評価観点がある場合は、それに沿って表現を合わせる。
 5. 学習者が次に取るべき行動を、1〜3件の具体策へ落とし込む。
-6. プロセス全体（表現方針の決定理由、理論適用箇所、トーン選定理由）を表示し、成果物とともにファイルへ保存する。
+6. 成果物（フィードバック）を先に提示する。
+7. 次に、プロセス全体（表現方針の決定理由、理論適用箇所、トーン選定の根拠）を表示する。
+8. create_fileツールで `SHIDEN_feedback_{YYYYMMDD}_{topic}.md` に成果物とプロセスログを保存する。保存完了をユーザーに報告する。
 
 ## Conditional References
 
@@ -74,4 +76,5 @@ metadata:
    - 行動可能な提案になっているか。
    - 否定的断定表現がないか。
 3. 不合格なら、表現トーンと具体性を修正して再生成する。
-4. 学習者が受け取って行動できる状態になったら完了とする。
+4. ファイルが保存されていなければ、create_fileで保存する。
+5. 学習者が受け取って行動できる状態になったら完了とする。

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.0"
+  version: "0.5.2"
 ---
 
 # Guidance
@@ -32,7 +32,9 @@ metadata:
 3. 発達段階や学校文脈を踏まえて、初期対応、継続支援、フォローアップを設計する。
 4. 保護者連絡文や面談方針が必要なら、役割別に分けて作成する。
 5. assets/guidance-template.mdを再利用し、専門家連携が必要な場合は必ず明記する。
-6. プロセス全体（緊急度判定の理由、対応フェーズの設計根拠、連携先選定理由）を表示し、成果物とともにファイルへ保存する。
+6. 成果物（指導案）を先に提示する。
+7. 次に、プロセス全体（緊急度判定の理由、対応フェーズの設計根拠、連携先選定の根拠）を表示する。
+8. create_fileツールで `SHIDEN_guidance_{YYYYMMDD}_{topic}.md` に成果物とプロセスログを保存する。保存完了をユーザーに報告する。
 
 ## Conditional References
 
@@ -75,4 +77,5 @@ metadata:
    - 校内外連携が必要なケースで漏れがないか。
    - 事実と評価が混同されていないか。
 3. 不合格なら、対応フェーズと連携先を修正して再生成する。
-4. 安全条件を満たしたら完了とする。
+4. ファイルが保存されていなければ、create_fileで保存する。
+5. 安全条件を満たしたら完了とする。

package/.github/prompts/individual.md

@@ -6,7 +6,7 @@ description: >
   accommodations, intervention planning, or differentiated instruction.
 metadata:
   author: nahisaho
-  version: "0.5.0"
+  version: "0.5.2"
 ---
 
 # Individual Support
@@ -32,7 +32,9 @@ metadata:
 3. references/common-theory-selection.mdを読み、ZPD、Scaffolding、UDLなどから支援理論を選ぶ。
 4. 高リスク事案や心理的危機が疑われる場合はreferences/common-safety.mdを読み、専門家連携を明記する。
 5. assets/individual-template.mdを再利用し、目標、支援戦略、進捗確認方法を整理する。
-6. プロセス全体（到達範囲確認結果、支援理論の選定理由、リスク判定）を表示し、成果物とともにファイルへ保存する。
+6. 成果物（個別支援計画）を先に提示する。
+7. 次に、プロセス全体（到達範囲確認結果、支援理論の選定理由、リスク判定の根拠）を表示する。
+8. create_fileツールで `SHIDEN_individual_{YYYYMMDD}_{topic}.md` に成果物とプロセスログを保存する。保存完了をユーザーに報告する。
 
 ## Conditional References
 
@@ -77,4 +79,5 @@ metadata:
    - 支援行動が環境内で実施可能か。
    - 高リスクケースで専門家連携が必要か。
 3. 不合格なら、目標粒度・支援方法・連携先を修正して再生成する。
-4. 教師が実施に移せる粒度になったら完了とする。
+4. ファイルが保存されていなければ、create_fileで保存する。
+5. 教師が実施に移せる粒度になったら完了とする。

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

@@ -6,7 +6,7 @@ description: >
   unit lesson flow, or class activity sequence.
 metadata:
   author: nahisaho
-  version: "0.5.0"
+  version: "0.5.2"
 ---
 
 # Lesson Plan
@@ -32,7 +32,9 @@ metadata:
 3. references/common-theory-selection.mdを読み、目標・活動・評価に合う理論を2件以上選ぶ。
 4. assets/lesson-plan-template.mdを再利用し、導入・展開・まとめ・評価を一貫して設計する。
 5. 後続で教材や評価を作る可能性があるため、学習目標と観点を明示する。
-6. プロセス全体（指導要領検索結果、理論選定理由、設計判断）を表示し、成果物とともにファイルへ保存する。
+6. 成果物（授業計画）を先に提示する。
+7. 次に、プロセス全体（指導要領検索結果、理論選定理由、設計判断の根拠）を表示する。
+8. create_fileツールで `SHIDEN_lesson-plan_{YYYYMMDD}_{topic}.md` に成果物とプロセスログを保存する。保存完了をユーザーに報告する。
 
 ## Conditional References
 
@@ -76,4 +78,5 @@ metadata:
    - 学習指導要領の参照が必要な対象で漏れていないか。
    - 活動が授業時間内に収まっているか。
 3. 不合格なら、目標文・時間配分・参照理論を修正して再生成する。
-4. 全ゲート通過後のみ完了とする。
+4. ファイルが保存されていなければ、create_fileで保存する。
+5. 全ゲート通過後のみ完了とする。

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.0"
+  version: "0.5.2"
 ---
 
 # Materials
@@ -32,7 +32,9 @@ metadata:
 3. references/common-theory-selection.mdを読み、注意喚起・練習・振り返りの設計原則を選定する。
 4. 要求形式に応じてassets/materials-template.mdを再利用し、教材構造を決める。
 5. 必要に応じて授業計画の目標や時間配分と整合させる。
-6. プロセス全体（指導要領参照結果、理論選定理由、形式選定理由）を表示し、成果物とともにファイルへ保存する。
+6. 成果物（教材）を先に提示する。
+7. 次に、プロセス全体（指導要領参照結果、理論選定理由、形式選定理由）を表示する。
+8. create_fileツールで `SHIDEN_materials_{YYYYMMDD}_{topic}.md` に成果物とプロセスログを保存する。保存完了をユーザーに報告する。
 
 ## Conditional References
 
@@ -76,4 +78,5 @@ metadata:
    - 学習目標と問題・活動が一致しているか。
    - 学習指導要領参照が必要なケースで漏れがないか。
 3. 不合格なら、形式・難易度・構成を修正して再生成する。
-4. 実用可能な体裁になったら完了とする。
+4. ファイルが保存されていなければ、create_fileで保存する。
+5. 実用可能な体裁になったら完了とする。

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.0"
+  version: "0.5.2"
 ---
 
 # Meta Prompt
@@ -31,7 +31,9 @@ metadata:
 3. 5問以内で、学年・教科・トピック・目標・制約を優先収集する。
 4. 情報が十分にそろった時点で質問を打ち切り、構造化メタプロンプトを生成する。
 5. 後続スキルへ、確定情報と未確定情報を明示して引き継ぐ。
-6. 収集プロセス全体（質問意図、回答の解釈、判断理由）を表示し、成果物とともにファイルへ保存する。
+6. 成果物（構造化メタプロンプト）を先に提示する。
+7. 次に、収集プロセス全体（各質問の意図、回答の解釈、後続スキル選定理由）を表示する。
+8. create_fileツールで `SHIDEN_meta-prompt_{YYYYMMDD}_{topic}.md` に成果物とプロセスログを保存する。保存完了をユーザーに報告する。
 
 ## Conditional References
 
@@ -73,4 +75,5 @@ metadata:
    - 質問が1件ずつになっているか。
    - 危機対応時の注意書きが必要か。
 3. 不合格なら、質問順序または推測の扱いを修正して再提示する。
-4. 合格後のみ後続スキルへ引き継ぐ。
+4. ファイルが保存されていなければ、create_fileで保存する。
+5. 合格後のみ後続スキルへ引き継ぐ。

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.0"
+  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.0"
+  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.0"
+  version: "0.5.2"
 ---
 
 # Theory Lookup

package/package.json

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