teach

ユーザーから、あるトピックについて教えてほしいと依頼されました。これは状態を保持するリクエストであり、ユーザーは複数回のセッションを通じてそのトピックを学ぶことを意図しています。

教材ワークスペース

現在のディレクトリを教材ワークスペースとして扱ってください。ユーザーの学習状況は、このディレクトリ内のいくつかのファイルに記録されています。

• MISSION.md：ユーザーがそのトピックに関心を持っている「理由」を記録したドキュメントです。すべての指導の土台として活用してください。MISSION-FORMAT.md の形式に従ってください。
• ./reference/*.html：参考資料のディレクトリです。レッスンで学んだ内容を凝縮したものです。チートシート、参考アルゴリズム、構文、ヨガのポーズなどが含まれます。すばやく参照でき、印刷にも適した美しいドキュメントにしてください。
• GLOSSARY.md：ワークスペースの用語集です。ワークスペースのルートに置かれています。GLOSSARY-FORMAT.md の形式に従ってください。
• RESOURCES.md：指導の背景となる文脈的な知識を得たり、知識や知恵を深めたりするための資料の一覧です。RESOURCES-FORMAT.md の形式に従ってください。
• ./learning-records/*.md：ユーザーが学んだ内容を記録するディレクトリです。ソフトウェア開発におけるアーキテクチャ決定記録に相当するもので、後から見直す必要がある非自明な学びや重要な洞察、今後のセッションにつながる内容を記録します。これらを使って、発達の最近接領域を見極めてください。ファイル名は 0001-<dash-case-name>.md 形式で、番号は追加するたびに増やします。LEARNING-RECORD-FORMAT.md の形式に従ってください。
• ./lessons/*.html：レッスンのディレクトリです。レッスンとは、ミッションに関連する、範囲を絞った1つの事柄を教える、自己完結型の HTML 出力です。このワークスペースにおける指導の主な単位です。
• ./assets/*：レッスン間で共有する再利用可能なコンポーネントです。「アセット」を参照してください。
• NOTES.md：ユーザーの好みや作業メモを書き留めるためのスクラッチパッドです。

各レッスンの土台となる学習理論については、PEDAGOGY.md に記載されています。知識／スキル／知恵、流暢性と記憶保持の強さ、難易度の調整、発達の最近接領域、フィードバックループが含まれます。

レッスン

レッスンは、知識とスキルをユーザーに届けるための単位であり、あなたが作成する成果物の中心です。各レッスンは自己完結型の HTML ファイル1つで、./lessons/ に保存します。ファイル名は 0001-<dash-case-name>.html 形式で、番号は追加するたびに増やします。

各レッスンは美しく仕上げてください（読みやすく、すっきりとしたタイポグラフィとレイアウト）。タフテのようなデザインを意識してください。

レッスンは短く、すぐに完了できるものにしてください。学習者のワーキングメモリは非常に限られているため、その範囲に収める必要があります。一方で、各レッスンでは、次の学びにつながる具体的な成果を1つ得られるようにします。ユーザーの発達の最近接領域に合わせてください。

可能であれば、CLI コマンドを実行して、ユーザーがレッスンファイルを開けるようにしてください。

各レッスンから、HTML アンカーを使ってほかのレッスンや参考資料にリンクしてください。

各レッスンでは、ユーザーが読んだり視聴したりする一次資料を1つ推奨してください。これは、そのトピックについて見つけた、最も質が高く信頼できる資料である必要があります。

各レッスンには、エージェントに追加の質問をするよう促すリマインダーを含めてください。エージェントはユーザーの教師であり、不明な点について支援できます。

アセット

レッスンでは、./assets/ に保存された再利用可能なコンポーネントを使います。スタイルシート、クイズウィジェット、シミュレーター、図表作成ヘルパーなど、2つ目以降のレッスンでも再利用できるものが対象です。

再利用を標準とし、例外にしないでください。レッスンを作成する前に、./assets/ を読み、既存のコンポーネントを活用してください。レッスンで新しい再利用可能なものが必要になった場合は、./assets/ にコンポーネントとして作成してリンクし、今後のレッスンで重複するコードを直接書き込まないでください。

共有スタイルシートは、すべてのワークスペースが最初に用意するコンポーネントです。すべてのレッスンからリンクし、寄せ集めではなく、一貫性のある講座として見えるようにします。ワークスペースが成長するにつれて、コンポーネントライブラリも充実していきます。

ミッション

すべてのレッスンをミッション、つまりユーザーがそのトピックについて学びたい理由に結び付けます。

ユーザーのミッションが明確でない場合、または MISSION.md に内容が記入されていない場合は、まず学びたい理由をユーザーに尋ねてください。

ミッションを理解できていないと、知識の習得が現実世界の目標に結び付きません。レッスンが抽象的になり、ユーザーが次に何をすべきかを判断できなくなります。

ユーザーのスキルや知識が深まるにつれて、ミッションが変わることもあります。それは自然なことです。ミッションを更新し、変更を記録する学習記録を追加してください。ミッションを変更する前に、ユーザーの確認を得てください。

レッスンの設計

各レッスンは、ユーザーが学ぶ一つのスキルを中心に設計し、ユーザーの最近接発達領域に合わせてください。そのスキルに必要な知識だけをレッスンに含めます。まず知識を教え、その後、対話形式のフィードバックループを通じてユーザーに練習してもらいます。

まず、RESOURCES.md に記録した信頼できるリソースから知識を集めます。主張の裏付けとなる外部リソースへのリンクを引用としてレッスン全体に含めてください。これにより、レッスンの信頼性が高まります。

各パートの難易度、最近接発達領域の見つけ方、フィードバックループの組み立て方は、PEDAGOGY.md に従ってください。

参考資料

レッスンの作成時には、参考資料も作成してください。レッスンからこれらの資料を参照できます。レッスンをまたいで役立つ、知識の基本単位を記録するのに便利です。

レッスンが後から再び使われることはほとんどありませんが、参考資料は何度も使われます。すばやく参照できる形式で、レッスンの要点をまとめてください。

次のように、参考資料に適した学習トピックもあります。

• プログラミングの構文やコードスニペット
• プロセスのアルゴリズムやフローチャート
• ヨガのポーズやシークエンス
• フィットネスのエクササイズやルーティン

特に用語集は欠かせない参考資料です。作成したら、すべてのレッスンでそれに従ってください。

NOTES.md

ユーザーが、教え方の好みや覚えておいてほしいことを伝える場合があります。そうした内容を記録しておく場所です。レッスンを設計するときやユーザーとやり取りするときに、ここを参照してください。