後付け
後付け
読書案内
この読書案内は、本文と repo artifact を読んだあとに、どの source を足すと理解が深まるかを整理したものである。網羅よりも、Prompt / Context / Harness の主要論点を支える durable な source を優先する。
この読書案内は、本文と repo artifact を読んだあとに、どの source を足すと理解が深まるかを整理したものである。網羅よりも、Prompt / Context / Harness の主要論点を支える durable な source を優先する。
使い方
- 最初に戻る先は常に本書の本文と repo artifact である
- その次に、使っている tool や platform の official docs を読む
- 書籍や handbook は、組織へ持ち帰るときの判断軸を補強するために使う
- ここで挙げる source は、学術的な完全性より再利用価値を優先している
Source hierarchy
2026 年版では、source を次の順で使い分ける。
- 本文と
sample-repo: recurring case と artifact の責務を理解するための正本 - official docs / protocol 仕様: runtime の挙動、権限、pricing、protocol detail を確認するための一次情報
- 書籍 / handbook: review、運用、信頼性の判断軸を補強するための二次情報
本文と tool 挙動が食い違うときは、設計原則は本文で保持し、実行条件は一次情報で読み替える。
Prompt と要求定義
| source | 何を補強するか | 関連章 |
|---|---|---|
| OpenAI / Codex の official docs | Prompt Contract、tool use、agent 実行境界、eval 前提 | CH02, CH04 |
| Anthropic の official docs | prompt 設計、tool use、agent 振る舞いの比較観点 | CH02, CH04 |
| 利用中モデルの official eval docs | case 設計、rubric、version comparison | CH04 |
| Michael Nygard の Architecture Decision Records (ADR) | 決定理由を短く残す書き方 | CH03 |
| 組織内の product spec / acceptance criteria template | exploratory dialogue から実装準備ができた artifact へ落とす基準 | CH03 |
Context と repo 設計
| source | 何を補強するか | 関連章 |
|---|---|---|
| MCP の仕様と利用中 runtime の official docs | instruction layering、tool/resource 接続、context source の境界 | CH05, CH06, CH08 |
| A2A の仕様、あるいは同等の agent handoff 仕様 | agent 間の task 移譲、handoff、状態共有の考え方 | CH07, CH11 |
| GitHub / 利用中 VCS platform の official docs | issue、PR、review、branch protection、artifact 追跡 | CH03, CH06, CH10 |
| 組織内の repo-map、architecture、coding standards | repo context の正本化、ownership の明確化 | CH06 |
| handoff / incident / change log の組織ルール | session memory、restart packet、handoff contract | CH07, CH11 |
検証・信頼性・運用
| source | 何を補強するか | 関連章 |
|---|---|---|
| OpenAI / Codex の official docs | verify 境界、権限、resume、evidence の実装差分 | CH09, CH10, CH11, CH12 |
| Google の SRE 関連 docs と書籍 | reliability、運用責務、service の考え方 | CH09, CH10, CH12 |
| Betsy Beyer ほか, The Site Reliability Workbook | checklist、runbook、運用設計の実装寄りの進め方 | CH09, CH10, CH11, CH12 |
| Nicole Forsgren, Jez Humble, Gene Kim, Accelerate | metrics、throughput、運用改善の見方 | CH10, CH12 |
| 組織内の approval / permission policy | human approval gate、越権防止、監査性 | CH09, CH12 |
| 組織内の PR template / review checklist / merge policy | Goal、Changed Files、Scope and Non-goals、Verification、Evidence / Approval、review budget の運用 |
CH10, CH12 |
使い分けの原則
- Prompt の議論で迷ったら、まず official docs と local eval に戻る
- Context の議論で迷ったら、repo artifact と ownership の正本に戻る
- Harness と運用の議論で迷ったら、verify、evidence、approval boundary、review policy の順に戻る
- 書籍や handbook は、local artifact の代わりではなく、判断軸を補うために使う