Reference
Referenceは、PCE 2.0 の定義を増やす場所ではない。 ここが担うのは、 すでにある定義を速く引き、使い分け、実装や読解に再利用しやすくすること である。したがって、正規定義は常に
Specを優先する。Referenceは authority ではなく、lookup / indexing / schema / pattern reuse の層である。
このセクションの役割
Section titled “このセクションの役割”reference セクションの役割は、大きく四つある。
1. 語を短く引く
Section titled “1. 語を短く引く”意味をすぐ確認したいとき、 まずどこを開けばよいかを与える。
2. 用語を逆引きする
Section titled “2. 用語を逆引きする”canonical term を忘れていても、 別名、外部語彙、日本語検索語から入口を見つけられるようにする。
3. 概念を object shape に落とす
Section titled “3. 概念を object shape に落とす”schema を通じて、 abstract concept を docs / runtime / handoff object に落とせるようにする。
4. topology を再利用する
Section titled “4. topology を再利用する”pattern を通じて、 よく使う process topology を短く再利用できるようにする。
最短で意味を確認するページ。 「この語はざっくり何か」を知りたいときに開く。
向いている用途:
- 初見の語の早引き
- 近接概念の区別
- spec を読む前のウォームアップ
逆引き用のページ。 canonical term、別名、日本語検索語、外部語彙から、 どのページを開けばよいかを引く。
向いている用途:
- 語は知っているが canonical page が分からない
- workflow / agent / state など既存語彙から入りたい
- Glossary より検索寄りに使いたい
主要 object をどう field に落とすかを整理するページ群。 concept を docs / implementation / operations に変換するときに使う。
向いている用途:
- frame / delta / compiled context の shape を確認したい
- handoff package や runtime object を設計したい
- object boundary を明確にしたい
典型的な process topology を再利用するためのページ群。 sequential、parallel、evaluator-optimizer など、 work topology を短く引きたいときに使う。
向いている用途:
- 今の仕事が one path か multi-path か loop かを整理したい
- cases を pattern として抽出したい
- topology の失敗モードを見たい
どう使い分けるか
Section titled “どう使い分けるか”まず意味だけ知りたい
Section titled “まず意味だけ知りたい”→ Glossary
どのページへ行くべきか知りたい
Section titled “どのページへ行くべきか知りたい”object shape を確認したい
Section titled “object shape を確認したい”→ Schemas
work topology を確認したい
Section titled “work topology を確認したい”→ Patterns
短く言えば、
Glossaryは短い説明Term Indexは逆引きSchemasは field shapePatternsは topology
である。
よくある往復
Section titled “よくある往復”初見の語に出会ったとき
Section titled “初見の語に出会ったとき”- Glossary を引く
- 正規定義が必要なら
Specへ行く - related concept を
Term Indexで辿る
既存語彙から入りたいとき
Section titled “既存語彙から入りたいとき”- Term Index を引く
- canonical term を見つける
- 該当する spec / case / mapping へ行く
実装 object を設計したいとき
Section titled “実装 object を設計したいとき”仕事の shape を説明したいとき
Section titled “仕事の shape を説明したいとき”- Patterns を見る
- 関連 case を読む
- そこに出てくる語を
Glossary/Term Indexで補う
Reference と他セクションの関係
Section titled “Reference と他セクションの関係”Spec との関係
Section titled “Spec との関係”Reference は Spec を置き換えない。
定義の衝突が起きた場合は、常に Spec を優先する。
Guide との関係
Section titled “Guide との関係”まだ全体像が弱いなら、
Reference より Reading Paths や Guide を先に見た方がよい。
Mappings との関係
Section titled “Mappings との関係”既存語彙から入る場合は Mappings が先、
そこから canonical term を引き直すときに Reference が効く。
Cases との関係
Section titled “Cases との関係”case を読んで語が増えたら Reference に戻る。
Reference だけ読んでも PCE 2.0 の動きは見えないので、
必要に応じて Cases へ戻るとよい。
- 定義の変更はまず
Specに反映する Referenceでは一覧性、検索性、再利用性を優先する- useful でも canonical ではない shortcut を定義扱いしない
- schema や pattern は正規定義ではなく参照面として扱う
暫定的なまとめ
Section titled “暫定的なまとめ”このセクションが言いたいことは、最終的には次の一文に集約できる。
PCE 2.0 の reference は、定義のコピー置き場ではない。
既にある正規定義を壊さずに、語を短く引き、逆引きし、object shape に落とし、topology として再利用できるようにするための辞書層である。