後付け
後付け
図表一覧方針
このファイルは、ebook / print の後付けとして図一覧と表一覧を作るときの正本である。図そのものの source は `manuscript/figures/`、表そのものの source は各章の markdown table にある。
このファイルは、ebook / print の後付けとして図一覧と表一覧を作るときの正本である。図そのものの source は manuscript/figures/、表そのものの source は各章の markdown table にある。
役割
- 読者が通読後に図と表だけを探し直せるようにする
- production で図番号、表番号、page を付ける前の seed を残す
- figure plan、章本文、組版物の対応を崩さない
図一覧の方針
- 図 ID、対象章、caption、first mention は
manuscript/figures/figure-plan.mdを正本にする - 図一覧では「図から何を理解してほしいか」が 1 行で分かる caption を維持する
- 1 図 = 1 主メッセージを守り、組版後に図番号だけを差し替える
現時点の図 seed
| 図 ID | 対象章 | first mention | source |
|---|---|---|---|
fig-01 |
CH01 | Prompt / Context / Harness の対応表 | manuscript/figures/fig-01-maturity-model.mmd |
fig-02 |
CH05 | 永続・タスク・セッション・ツールコンテキスト | manuscript/figures/fig-02-context-classes.mmd |
fig-03 |
CH07 | セッション再開時の最低入力 | manuscript/figures/fig-03-resume-packet.mmd |
fig-04 |
CH09 | single-agent harness の全体像 | manuscript/figures/fig-04-single-agent-harness.mmd |
fig-05 |
CH10 | lint / typecheck / unit / e2e の順序 | manuscript/figures/fig-05-verification-pipeline.mmd |
fig-06 |
CH11 | planner / coder / reviewer の分離 | manuscript/figures/fig-06-long-running-multi-agent.mmd |
fig-07 |
CH12 | 人間が残す責務 | manuscript/figures/fig-07-operating-model.mmd |
表一覧の方針
- 表一覧は reader-facing な表だけを載せる。箇条書きの代用品や一時比較表は載せない
- 表タイトルは、直前の小見出しと表の主メッセージを組にして production で確定する
- 現段階では page 番号を持てないため、「主に戻る章」と「近接見出し」を seed として残す
現時点の表 seed
| 主に戻る章 | 近接見出し | 表の役割 |
|---|---|---|
| CH01 | 単発で当たることと、仕事が完了することは違う | plausible output と完了した仕事の差を示す |
| CH02 | prompt は命令文ではなく入出力契約 | Prompt Contract の要素と欠落時の failure を示す |
| CH04 | 良い prompt は評価できる | prompt / context / harness evaluation の境界を示す |
| CH07 | Resume Packet 最小形 | 再開時に最低限必要な要素を示す |
| CH09 | Single-Agent Harness フロー | init から report までの工程を縮約する |
| CH10 | Verification Pipeline | failing test から approval までの順序を示す |
| CH11 | Long-running / Multi-agent 判定カード | single-agent と multi-agent の分岐条件を示す |
| CH12 | metrics とふりかえり | throughput / quality / hygiene の計測群を示す |