教材の章構成を見直す（新 03「LLM の仕組み」を追加、現 03-claude-md を 04 にリネーム）

[watanabe-kohei-jp]

背景

業務で Claude Code を使い始める読者により自然な学習順序を提供するため、教材の章構成を見直したい。

現状、02（環境構築）→ 03（CLAUDE.md）と進むが、「そもそも LLM はどう動いているのか／プロンプトとは何か／コンテキストとは何か」という基礎理解がない状態で CLAUDE.md の話に入ることになる。

ここに「LLM の仕組み」を 03 として挟むと、CLAUDE.md・skills・slash commands・subagent などの機能がすべて「コンテキスト管理の応用」として位置付けられる強い枠組みになる。

提案する構成

現在

• 00 About
• 01 Claude Code 入門（なぜ学ぶか）
• 02 環境構築
• 03 CLAUDE.md でプロジェクトを記憶させる

新しい構成

• 00 About
• 01 Claude Code 入門
• 02 環境構築
• 03 LLM はどう動くか — コンテキストとプロンプトの原理（新規）
• 04 CLAUDE.md でプロジェクトを記憶させる（現 03-claude-md をリネーム、内容は維持）

新 03 の内容案

具体例サンドイッチ構成（_template/ 参照）：

• つかみ — 「Claude Code が時々文脈を見失う」体験 → なぜ？
• 本体
  • LLM は次の token を予測している
  • コンテキストウィンドウ＝見える範囲は有限
  • プロンプトの 3 役（system / user / assistant）
  • コンテキストエンジニアリング＝必要な情報を必要なときに見せる
• 応用
  • CLAUDE.md = 固定情報を常駐させる仕組み（→ 04 へ）
  • skills / slash commands = 指示をパッケージ化
  • subagent = コンテキスト分離

影響

• 現 03-claude-md/ を 04-claude-md/ にリネーム。内容は維持。Credits / Authors はそのまま
• README.md / sitemap.xml / llms.txt / ルート index.html / 講義間リンクを更新
• 新 03 の用語に合わせて、04 の冒頭に「コンテキスト管理の応用」という位置付けを 1〜2 行追加するかもしれない（協議）

進め方

1. このIssueで合意形成
2. 新 03 を執筆（別 PR）
3. リネーム + 関連リンク更新を PR で出す（新 03 PR と併せるか分けるかは状況次第）

ご意見・反対・修正提案を歓迎します。特に現 03 の著者である @Tsubasasa1857 の意見をいただけると助かります。

No-Issue: curriculum restructure proposal — 03 を「LLM の仕組み」に置き換え、現 03 を 04 にリネーム

🤖 Generated with Claude Code