原典ノート
短い原文要約、日本語の技術読解、英日キーワード、実装入口を固定テンプレートで揃えます。
読み方
目的から探す
読み方
5 本
まず理解する
新しい概念や仕様の立ち位置を、実装前に短時間でつかむための原典。
01
OpenAI / Data Governance
Zero Data Retention は「何も残らない」ではなく、「何がどこに残るかを切り分ける」話
OpenAI / 公式ドキュメント上では公開日未記載 / まず理解する
02
Retrieval / Embeddings
Embeddings は「検索の前に何を同じ意味として近づけるか」を決める層だ
Google AI for Developers / 公開日未記載（最終更新: 2026-05-29 UTC） / まず理解する
03
Specification / Resources
MCP Resources は「全部 tool にする雑設計」をやめるための基礎仕様
Model Context Protocol / 2025-06-18 / まず理解する
04
Open-source / Tutorial
Tiny Agents は、MCP 時代の agent 実装を小さく理解する入口になる
Hugging Face / 2025-04-25 / まず理解する
05
Specification / Architecture
MCP は tool だけではない。resources と prompts を含む設計として読む
Model Context Protocol / ドキュメントページ / まず理解する
読み方
8 本
実装前に読む
API、SDK、設定、ワークフローなど、手を動かす前に前提を揃える原典。
01
Managed Agents / Configuration
Define your agent は「長いプロンプト」ではなく再利用できる設定資産を作る話
Anthropic / 公式ドキュメント上では公開日未記載 / 実装前に読む
02
MCP / Debug Workflow
MCP Inspector は「ホスト上で何となく動いた」を分解して壊しながら確かめる道具
Model Context Protocol / 公式ドキュメント上では公開日未記載 / 実装前に読む
03
Tools / Function Calling
Function calling は「AIに外部処理を任せる境界」を雑にしないための基本部品
OpenAI / 公式ガイド上では公開日未記載 / 実装前に読む
04
Retrieval / Managed File Search
File Search は「RAG を自作するか否か」ではなく責務の切り方を問い直す
OpenAI / 公式ガイド上では公開日未記載 / 実装前に読む
05
State / Conversations
Conversations API は「前の response をつなぐだけ」の限界を超える state の器
OpenAI / 公式ガイド上では公開日未記載 / 実装前に読む
06
Migration guide / Schema
Gemini Interactions API の `steps` 移行は、SDK 更新より parser 棚卸しが本体
Google AI for Developers / 公式ガイド最終更新: 2026-06-01 UTC / 実装前に読む
07
Responses API / Job Control
Background mode は「長時間 reasoning を同期HTTPで待つな」という運用変更
OpenAI / 公開日未記載 / 実装前に読む
08
API / Agent
Responses API の組み込みツールは、Agent 実装の責任分界を変える
OpenAI / 2025-05-21 / 実装前に読む
読み方
14 本
運用で事故を防ぐ
権限、秘密情報、境界、監査、失敗時処理など、本番運用で効く原典。
01
MCP / Authorization
Enterprise-Managed Authorization は「各自で OAuth 接続」から「会社の権限設計でつなぐ」へ進める
Model Context Protocol / 2026-06-18 / 運用で事故を防ぐ
02
Open-source / Agent Architecture
agent は一種類ではない。コードを書かせるか、JSON に閉じるかで責任が変わる
Hugging Face / 公式ドキュメント上では公開日未記載 / 運用で事故を防ぐ
03
Claude Code / Settings
Claude Code settings は「見せない」ではなく「読ませない」で秘密を守る
Anthropic / 公式ドキュメント上では公開日未記載 / 運用で事故を防ぐ
04
MCP / Security
MCP Security Best Practices は「つながる」より先に、誰の権限を誰が横取りできるかを見る
Model Context Protocol / 公式ドキュメント上では公開日未記載 / 運用で事故を防ぐ
05
Coding Agents / Permissions
Claude Code permissions は「承認が出るから安全」という雑な期待を壊す
Anthropic / 公式ドキュメント上では公開日未記載 / 運用で事故を防ぐ
06
Coding Agents / Hooks
Claude Code hooks は「守ってほしいお願い」を実行境界へ移す
Anthropic / 公式ドキュメント上では公開日未記載 / 運用で事故を防ぐ
07
Agents / Sandbox Execution
Sandbox Agents は「agent 本体」と「作業用 compute」を同じものとして扱う雑設計をやめさせる
OpenAI / 公式ガイド上では公開日未記載 / 運用で事故を防ぐ
08
Credentials / Migration
Gemini API key の制限強化は、雑な PoC 鍵運用を 403 に変える
Google AI for Developers / 公開日未記載（最終更新: 2026-06-10 UTC） / 運用で事故を防ぐ
09
Identity / Credentials
Workload identity federation は「OpenAI API key を配る前提」を崩す
OpenAI / 公式ガイド上では公開日未記載 / 運用で事故を防ぐ
10
Safety / Moderation
Moderation を別APIの前処理で終わらせる時代が終わりつつある
OpenAI / 公式ガイド上では公開日未記載 / 運用で事故を防ぐ
11
Connectivity / MCP
Secure MCP Tunnel は「private MCP を公開せずに使う」責任境界を具体化した
OpenAI / 公式ガイド上では公開日未記載 / 運用で事故を防ぐ
12
Specification / Permission Boundary
MCP Roots は「tool 接続規格」ではなく permission 境界の primitive
Model Context Protocol / 2025-06-18 / 運用で事故を防ぐ
13
Managed Agent / Security
Gemini API の managed agents は「sandbox がある」だけでは安心できない
Google AI for Developers / 2026-05-19 / 運用で事故を防ぐ
14
Security / Engineering
Claude を安全に走らせる論点は、賢さより先に blast radius をどう切るか
Anthropic / 2026-05-25 / 運用で事故を防ぐ
読み方
4 本
評価・品質を見る
Evals、ベンチマーク、品質劣化、回帰確認、観測の考え方を扱う原典。
01
Managed Agents / Outcome Evaluation
Define outcomes は「終わったはず」を rubric と grader で検査可能にする
Anthropic / 公式ドキュメント上では公開日未記載 / 評価・品質を見る
02
Evals / Infrastructure Noise
agentic coding benchmark の 2点差は、モデル差ではなく RAM の差かもしれない
Anthropic / 2026-02-05 / 評価・品質を見る
03
Prompting / Migration
Prompt Objects 廃止は「prompt を管理画面で育てる運用」をやめる合図
OpenAI / 公式ガイド上では公開日未記載 / 評価・品質を見る
04
Postmortem
Claude Code の品質低下報告から読む、AI coding tool 運用の現実
Anthropic / 2026-04-23 / 評価・品質を見る
読み方
3 本
モデル更新を追う
モデル名、リリース、仕様変更、互換性への影響を追うための原典。
01
Models / Release Channel Policy
Gemini の model 名は「性能ラベル」ではなく運用契約として読む
Google AI for Developers / 公開日未記載（最終更新: 2026-06-15 UTC） / モデル更新を追う
02
Realtime API / Voice
GPT-Realtime-2 は、音声UIを「会話」から実行ワークフローへ寄せる
OpenAI / 2026-05-07 / モデル更新を追う
03
Release notes
Gemini API の release notes は、仕様変更を追うための一次情報になる
Google AI for Developers / 2026-01-05 / モデル更新を追う