| name | quiz-add |
| description | 概念Sectionの確認問題（question.md）と模範解答（model-answer.md）を quiz/ 配下に追加・編集するときに使う。「確認問題を作って」「このSectionのquizを追加して」「模範解答を書いて」「概念チェック問題を用意して」などで使う。quiz/ は curriculums/ と同じ階層をミラーし、各Sectionをディレクトリで表す。1文の記述式問題・本文のみ（見出し行なし）・模範解答は別ファイル、という規約に従う。小テスト／確認問題／記述式クイズの作成・編集に関わる依頼なら使うこと。 |
確認問題の追加 (quiz-add)
quiz/ は、各概念Sectionの最後に LMS で表示する「確認問題」と、AI採点・コーチのフィードバックに使う「模範解答」を管理するディレクトリです。受講生は問題文に対して自由記述で解答します。
作業前に quiz/README.md を読んでください（この規約の一次情報です）。
ディレクトリ構成（curriculums/ をミラー）
各Sectionは .md ファイルではなくディレクトリで表し、中に2ファイルを置きます。
quiz/
└── {tutorial}/
└── {chapter}/
└── {N}-{M}-{S}_{見出し名}/
├── question.md # 問題文（1文・記述式）
└── model-answer.md # 模範解答（AI採点・コーチFB用）
- ディレクトリ名は
curriculums/ のSectionファイル名から拡張子 .md を除いたものと完全一致させる。
- LMS / AI は
quiz/{tutorial}/{chapter}/{section}/question.md の固定パスで取得する。
ファイルの中身の規約
- question.md: 1文の記述式問題を1問だけ書く。AIが評価しやすいよう、問われている観点が明確な1文にする。見出し行（
#）は付けず、本文のみにする。
- 例:
Laravelの「ミドルウェア」とは何か、リクエストとレスポンスの流れに触れながら、あなた自身の言葉で説明してください。
- model-answer.md: 問題に対する模範解答（解答例）を書く。AI採点とコーチのフィードバックの拠り所になる。見出し行は付けず、本文のみにする。
対象Sectionの選定方針
「概念・仕組みの理解」を自分の言葉で説明する価値があるSectionが対象です。
- 対象に含む: 「〜とは」「〜の基礎」「設計」「考え方」など。
- 対象外:
- ハンズオン / 演習Section（実装課題で別途アウトプットするため）
- インストール・環境構築などの手順Section
- 細かい文法・SQL・実装手順のみのSection（コードで確認する方が適切なため）
追加手順
- 対象Sectionのディレクトリを
curriculums/ と同じパス構成で作成する。
- 対応する
curriculums/ のSection本文を読み、そのSectionで実際に説明されている内容に基づいて出題する（教材にない知識を問わない）。
question.md に1文の問題を書く（本文のみ）。model-answer.md に模範解答を書く（本文のみ）。
