Skip to content

新 03「LLM はどう動くか — コンテキストとプロンプトの原理」(DRAFT)#29

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

新 03「LLM はどう動くか — コンテキストとプロンプトの原理」(DRAFT)#29
watanabe-kohei-jp wants to merge 4 commits into
mainfrom
feat/lecture-03-llm-fundamentals

Conversation

@watanabe-kohei-jp
Copy link
Copy Markdown
Collaborator

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

概要

Issue #27 で提案している章構成変更に対応する新 03(DRAFT、Codex レビュー+実体験リサーチで全面 revise 済み)。CLAUDE.md・skills・subagent・/compact を「コンテキスト管理の応用」として位置づける枠組みを提示する。

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

中核の発想

LLM は記憶を持たない。毎ターン、過去のやり取り全部を送り直しているだけ。 これが分かると Claude Code のすべての機能が「コンテキスト管理の応用」として理解できる。

10 スライド構成

# スライド 中身
1 Cover LLM はどう動くか / コンテキストとプロンプトの原理
2 つかみ 実体験リサーチから 4 つの困りごと(Zenn / Qiita / X 出典)
3 Ch.1 メモリレス LLM は記憶を持たない、毎ターン送り直し
4 Ch.2 コンテキスト 過去のやり取り+指示+ファイル+ツール結果+入力
5 Ch.3 容量の壁 コンテキストウィンドウ(〜20 万 token)
6 Ch.4 入力の束 Claude Code は何を送っているか
7 道具 1: CLAUDE.md 起動時にプロンプト先頭に注入される指示
8 道具 2: /compact /compact / /clear / /context の使い分け
9 道具 3: skills と subagent 指示のパッケージ化と、作業の分離
10 まとめ + 伴走 + 参考 コンテキスト管理の応用としての Claude Code 機能

実体験リサーチ

つかみと各章の具体例は、~/.claude/plans/co-lect-newbies-research.md(ローカル)の Web リサーチ(Zenn / Qiita / X / Medium / DEV)に根拠を持つ。

  • 「30 分前に決めた方針を Claude が忘れる」
  • 「Co-Authored-By 何度言っても付ける」
  • 「ログを 1 回読ませただけで急に劣化」
  • 「CLAUDE.md の禁止事項を破られる」
  • 「Mid-session で急にバカになる」

Codex レビューも反映:token 予測の説明を削除(業務エンジニアに不要)、CLAUDE.md の説明を「起動時注入」に訂正、AI Buddy を 2 枚→1 枚に統合。

検証

  • 全 10 セクション overflow なし(scrollHeight === 1080)
  • page-number.js / ai-focus.js 動作確認済み
  • 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>
スライド 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>
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