Skip to content

Lecture 03『なぜあなたの AI は、言うことを聞かないのか』— コンテキストという考え方 (DRAFT)#29

Draft
watanabe-kohei-jp wants to merge 5 commits into
mainfrom
feat/lecture-03-llm-fundamentals
Draft

Lecture 03『なぜあなたの AI は、言うことを聞かないのか』— コンテキストという考え方 (DRAFT)#29
watanabe-kohei-jp wants to merge 5 commits into
mainfrom
feat/lecture-03-llm-fundamentals

Conversation

@watanabe-kohei-jp

@watanabe-kohei-jp watanabe-kohei-jp commented May 21, 2026

Copy link
Copy Markdown
Collaborator

概要

Issue #27 で提案している章構成変更に対応する新 03。今回の刷新で、「LLM は記憶を持たない」を中核に据えつつ、context rot(長文劣化)を直接の原因として伝える 13 スライド構成に再設計した。CLAUDE.md・skills・subagent・/compact を「コンテキスト管理の応用」として位置づける。

対象読者: Claude Code 未経験 or 使いこなせていない日本語エンジニア。

中核の発想

  • 直接の原因:あなたが情報を渡しすぎ → コンテキスト肥大化 → context rot(長文ほど効きが落ちる)
  • その土台:LLM は記憶を持たない。毎ターン全部送り直すしかない(メモリレス)

両方を視覚的に伝えるため、スライド 4–6 で「結果 → 中身 → 前提」の論理順を取った。

13 スライド構成

# スライド 役割
1 Cover タイトル
2 つかみ あるある 4 コマ(実体験リサーチ:Zenn / Qiita / X 出典)
3 種明かし AI は情報を浴びて パンク している(パンクイラスト)
4 Ch1 効果 ChatGPT UI 左右比較で context rot を体感的に示す
5 Ch2 中身 1 つの ChatGPT 画面に 5 源泉(前提の指示/過去のやり取り/添付/ツール出力/いまの一言)を引き出し線でラベル
6 Ch3 前提 Context × LLM の 2 ボックス概念直説:「LLM は覚えていない。毎回コンテキストを読み直す」
7 道具 1: CLAUDE.md 起動時にコンテキスト先頭に注入される指示
8 道具 2: `/compact` 系 `/compact` / `/clear` / `/context`
9 道具 3: skills と subagent 指示のパッケージ化と作業の分離
10 Coda まとめ
11 AI Buddy: 一緒に育てる GitHub への投稿提案
12 AI Buddy: 実務につなぐ As-is / To-be / PoC
13 Credits 貢献者一覧

今回(最新コミット)の変更要旨

スライド 4–6 のビジュアルを「コンテキスト中心の連続した物語」に統一:

  • スライド 4(効果):従来の劣化曲線グラフ → ChatGPT UI 左右比較(短い会話で「YES」即答 vs 長い会話の末尾で長文・的外れ)。下に補強グリッド(token / 主要モデル context window / 上限挙動 / Lost in the Middle 2023)。
  • スライド 5(中身):従来の 5 カード → 1 つの ChatGPT 画面に 5 源泉を内包。「画面の中ぜんぶがコンテキスト」を 1 枚で示す。
  • スライド 6(前提):従来の漫画 3 コマ → Context × LLM の 2 ボックス概念直説。スライド 5 で導入した「コンテキスト」をそのまま運用するため物理メタファーを剥がし、認知負荷を最小化。Codex research(OpenAI / Anthropic / 3Blue1Brown / MDN / Dual Coding Theory / Mayer multimedia principles 参照)で方針確定。

設計の検討経緯

スライド 6 は計 13 案を比較プレビューで突き合わせ、Codex に research を依頼して以下の論理で 2 ボックス案に確定:

  1. スライド 5 で「コンテキスト」概念は既に導入済み
  2. ここで新しい物理メタファーを挟むと germane load が比喩解読に消費される
  3. 「Context が育つ/LLM は空のまま/毎ターン頭から読み直す」を直接見せる方が認知負荷最小
  4. `memory = 0` より「記憶なし」のシンプルな日本語が非エンジニア層に届く

検証

  • 全 13 セクション overflow なし(scrollHeight === 1080)
  • `page-number.js` / `ai-focus.js` / `progress-strip.js` 動作確認済み
  • Chrome 実機で各スライドを通読・スクショ確認
  • `sync_listings.py --write` で講義一覧(README / llms.txt / index.html / sitemap.xml)を更新

残作業 / 依存

マージ条件

  1. Issue 教材の章構成を見直す(新 03「LLM の仕組み」を追加、現 03-claude-md を 04 にリネーム) #27 で章構成変更に合意
  2. 章リネーム PR(03-claude-md → 04-claude-md)と整合
  3. 内容のレビュー(特に LLM の説明が正確か)

No-Issue: Issue #27 で提案中の章構成変更を実装する draft

🤖 Generated with Claude Code

watanabe-kohei-jp and others added 3 commits May 21, 2026 13:20
Issue #27 で提案中の章構成変更に対応。

スライド構成:
  Cover → つかみ(時々ハズす体験)
  → 本体 (1) token 予測 (2) プロンプト 3 役 (3) コンテキストエンジニアリング
  → 応用 (1) CLAUDE.md = 常駐文脈(→ 第 4 章へ) (2) skills と subagent
  → AI Buddy 一緒に育てる / 実務につなぐ → Credits

ブラウザ検証: 10 セクション overflow なし、page-number.js / ai-focus.js
動作確認済み。応用 1 から旧 03-claude-md へリンクは TODO(リネーム後
04-claude-md に更新する想定、コメントで明示)。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
PR #29 の draft を、Codex レビューと実体験リサーチ(co-lect-newbies-research.md)
を踏まえて作り直し。

主な変更:
- 中核を「token 予測」→「LLM は記憶を持っていない、毎回送り直し」に
- token 予測の説明を削除、token は容量の単位として 1 行のみ
- つかみを 4 つの実体験(Zenn / Qiita / X / 出典付き)に
- /compact + /clear + /context を 1 スライドに統合(新規)
- 「入力の束」スライドで Claude Code が何を送っているかを可視化
- AI Buddy 2 枚を 1 枚に統合
- CLAUDE.md = 「起動時注入される指示」に表現訂正(Codex 指摘)
- 末尾に参考リンク(Sources)

ブラウザ検証: 全 10 スライド overflow なし、page-number.js / ai-focus.js
動作確認済み。sync_listings.py で README / llms.txt / index.html / sitemap.xml
の講義一覧も最新化。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
watanabe-kohei-jp and others added 2 commits May 25, 2026 16:11
スライド 10 のまとめ+伴走に詰め込みすぎて崩れが出ていたのを、
Coda + AI Buddy 一緒に育てる + AI Buddy 実務につなぐ + Credits の
4 スライドに分割。既存 02 / 04 と同じパターンに揃えた。

- Sources(参考にした実体験)の小さい注釈は削除(ユーザー指示)
- スライド 10 → Coda(pullquote 中心、シンプル)
- スライド 11 → AI Buddy 一緒に育てる(投稿提案プロトコル)
- スライド 12 → AI Buddy 実務につなぐ(ai-focus + As-is/To-be/PoC/改善)
- スライド 13 → Credits

ブラウザ検証: 13 スライド全て scrollHeight === 1080、overflow なし。
sync_listings.py で README / llms.txt / index.html / sitemap.xml も更新。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- スライド 4: ChatGPT UI 左右比較で context rot を体感的に示す
  (ui-effect-comparison.svg)
- スライド 5: 1 枚の ChatGPT 画面に 5 源泉を内包し
  「画面の中ぜんぶがコンテキスト」を表現 (content-onescreen.svg)
- スライド 6: Context × LLM の 2 ボックス概念直説で
  「LLM は覚えていない。毎回コンテキストを読み直す」を伝える
  (memoryless-twobox.svg, タイトル・サブ・aside も整合)
- 03-llm-fundamentals/_assets/ の SVG 群を追加
- ルート index/README/llms.txt の lecture 一覧を同期

Refs #29

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@watanabe-kohei-jp watanabe-kohei-jp changed the title 新 03「LLM はどう動くか — コンテキストとプロンプトの原理」(DRAFT) Lecture 03『なぜあなたの AI は、言うことを聞かないのか』— コンテキストという考え方 (DRAFT) Jun 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant