付録D: クイックリファレンス
本付録は、一読後に「どこへ戻れば判断材料を引き直せるか」を素早く確認するための再参照ページです。図版の位置と、典型的な詰まり方ごとの戻り先をまとめます。
1. 図版索引
まず図を見直して全体像を掴みたい場合は、この表を起点に戻ってください。
| 図版 | 場所 | 何を確認するときに使うか |
|---|---|---|
| 概念マップ | トップページ / 概念マップ | 本書全体の論点が、仕様・設計・検証・運用でどうつながるかを見直すとき |
| Context Pack → AI → 検証ループ | 第1章 / 最小ループ | 人間が固定すべき入力契約と、AIへ委任する範囲の境界を確認するとき |
| Pullback / Pushout の比較図 | 第7章 / 統合・移行の設計パターン | 統合・移行で「どの境界を合わせるか」を見失ったとき |
| ストリング図式の配線図 | 第8章 / モノイダル圏とストリング図式 | 並列処理・分業・合流点の責務分担を整理したいとき |
| effect boundary の分割図 | 第9章 / 効果境界の設計 | 副作用・再試行・監査を pure core と分離して考え直したいとき |
| Issue → PR → CI の通しフロー | 第10章 / ケーススタディ | 設計成果物を GitHub 運用へどう接続するかを再確認するとき |
2. 目的別の引き直し方
迷ったら、まず「いま困っているのが仕様・統合・分業・副作用・運用のどれか」を切り分けると、戻る章を選びやすくなります。
- 仕様が曖昧で AI が勝手に補完する: 第1章 → 第2章
- 差分レビューで意味保存を確認したい: 第5章 → 第10章
- 統合・移行で境界が壊れる: 第7章
- 並列化や責務分担で配線が壊れる: 第8章
- 失敗処理・監査・再試行の責務が混ざる: 第9章
3. 症状から引く戻り先
症状ベースで再参照したい場合は、この表を使って最初の戻り先を決めてください。
| 症状 | 最初に戻る場所 | まず見るもの |
|---|---|---|
| AI が仕様を補完して、意図しない実装差分を出す | 第1章 | 失敗パターン表、Context Pack の最小構成、Forbidden changes |
| 用語や境界の意味が章ごとにずれて見える | 用語ガイド | 主要概念(推奨訳語)と Glossary へのリンク |
| 統合や移行で、どの条件を一致させるべきか判断できない | 第7章 | Pullback / Pushout の使い分け、統合時の受入条件 |
| 並列処理や分業で、接続点の責務が曖昧になる | 第8章 | ストリング図式、結合点の責務、配線の検証観点 |
| 副作用・再試行・監査が混ざり、レビュー観点がぶれる | 第9章 | pure core / impure shell、モナド、失敗境界 |
| Issue / PR / CI にどう落とすか分からない | 第10章 | ケーススタディ全体、レビュー手順、CI の検証ポイント |