後付け
後付け
読書案内
この読書案内は、本文と 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 挙動が食い違うときは、設計原則は本文で保持し、実行条件は一次情報で読み替える。
具体名を足す条件も固定する。読書案内では、通常は 利用中 agent runtime、利用中 VCS / CI、組織内 policy のような category 名で案内する。特定 vendor / product の document 名を挙げるのは、API、CLI、permission、pricing、protocol behavior の確認が必要な場合に限り、確認日と model/runtime profile を evidence 側で追跡する。
Prompt と要求定義
| source | 何を補強するか | 関連章 |
|---|---|---|
| 利用中モデルの official prompting guide | Prompt Contract、制約設計、tool use の前提 | 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 | 何を補強するか | 関連章 |
|---|---|---|
| 利用中 agent runtime の official docs | instruction layering、workspace access、session の持ち方 | CH05, CH06, CH07, CH08 |
| 利用中 VCS / CI / package manager の 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（Resume Packet）、Progress Note、handoff contract、approval boundary |
CH07, CH11, CH12 |
検証・信頼性・運用
| source | 何を補強するか | 関連章 |
|---|---|---|
| 利用中 test framework / CI / coverage tool の official docs | verify 境界、evidence、実行条件の差分 | CH09, CH10, CH11, CH12 |
| Betsy Beyer ほか, Site Reliability Engineering | 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 | Lead / Operator / Reviewer の責務、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 の代わりではなく、判断軸を補うために使う