Schemas
このセクションは、PCE 2.0 の schema catalog である。
Specが概念の正規定義を置くのに対して、Schemasは その概念を実務上の object / record / document shape にどう落とすか を扱う。重要なのは、schema が current truth そのものではないということだ。 schema は、何を field として保持し、どこに provenance を持ち、どこで stale invalidation や approval separation を効かせるかを表現するための器である。
このセクションの役割
Section titled “このセクションの役割”schemas セクションの役割は、大きく三つある。
1. 抽象概念を field に落とす
Section titled “1. 抽象概念を field に落とす”たとえば Process Frame を理解していても、
実務では
- どの field を最低限持つか
- 何を required とするか
- どこに actor / gate / recovery / approval を入れるか
を決めなければ実装も docs 化もできない。
schema はその落とし先である。
2. current truth と delta を混同しない
Section titled “2. current truth と delta を混同しない”PCE 2.0 では、出てきたものが即 current truth になるとは限らない。 schema を分けることで、
- frame definition
- compiled context
- emitted delta
の役割を混同しにくくする。
3. docs / runtime / operations の間で形を揃える
Section titled “3. docs / runtime / operations の間で形を揃える”同じ概念でも、
- design doc に書く shape
- runtime record の shape
- handoff package の shape
がズレると later review や audit が弱くなる。
schema を参照点として持つと、 何をどの粒度で残すべきか を揃えやすい。
現在の schema 一覧
Section titled “現在の schema 一覧”PCE 2.0 の work unit を object として表す最重要 schema。
主に表したいもの:
- goal
- scope
- actors
- responsibility bundle
- lifecycle
- approval / evaluation / recovery boundary
向いている用途:
- task / work item definition
- process contract
- orchestrator state
- handoff base object
ある actor / stage / branch に見せる bounded context shape を表す schema。
主に表したいもの:
- local goal slice
- selected evidence
- constraints
- pending gate
- prohibited actions
- freshness / invalidation condition
向いている用途:
- AI input package
- reviewer bundle
- branch-local working set
- handoff continuation package
process から出る change event / candidate / evidence package を表す schema。
主に表したいもの:
- emitted change
- provenance
- status
- confidence / evidence
- promotion candidacy
- invalidation relation
向いている用途:
- review result
- research output
- candidate patch note
- memory candidate
- routing recommendation
3つの schema の違い
Section titled “3つの schema の違い”| Schema | 表すもの | 主語 | current truth になりうるか | 代表的な誤用 |
|---|---|---|---|---|
| Process Frame | 仕事単位の contract | frame | 条件つきで yes | task 名だけを書いて lifecycle / gate を省く |
| Compiled Context | actor-local view | actor / stage | 基本的に no | full project state をそのまま詰め込む |
| Process Delta | emitted change / result | process output | そのままでは no | delta を即 durable state 扱いする |
この区別が見えていると、
- work definition
- local execution context
- emitted result
を混同しにくくなる。
どれを先に読むべきか
Section titled “どれを先に読むべきか”まず全体を掴みたい
Section titled “まず全体を掴みたい”Schema: Process Frame から読む。 PCE 2.0 の work unit が何を保持するかを最初に見るのが一番効く。
AI / handoff / context packaging を見たい
Section titled “AI / handoff / context packaging を見たい”Schema: Compiled Context を読む。 何を actor-local に見せるべきで、何を落とすべきかが分かりやすい。
review / memory / emitted result を見たい
Section titled “review / memory / emitted result を見たい”Schema: Process Delta を読む。 delta と durable state を分ける発想が最もよく見える。
schema を使うときのコツ
Section titled “schema を使うときのコツ”1. schema を storage schema と同一視しない
Section titled “1. schema を storage schema と同一視しない”schema は conceptual shape であって、 必ずしも DB table や JSON payload と 1:1 に一致する必要はない。
2. optional field を雑に増やしすぎない
Section titled “2. optional field を雑に増やしすぎない”なんでも field に入れると、 schema は説明力を失って単なる dump format になる。
3. invalidation を外に追い出さない
Section titled “3. invalidation を外に追い出さない”特に Compiled Context と Process Delta では、
freshness / stale rule を schema 外の暗黙知にしてはいけない。
4. approval separation を潰さない
Section titled “4. approval separation を潰さない”Process Delta に useful-looking result があるからといって、
そのまま durable state へ promote してよいとは限らない。
spec との往復
Section titled “spec との往復”schema を読む前後で、次の spec に戻ると理解が締まりやすい。
Process Frame を読んだあと
Section titled “Process Frame を読んだあと”Compiled Context を読んだあと
Section titled “Compiled Context を読んだあと”Process Delta を読んだあと
Section titled “Process Delta を読んだあと”patterns / cases との関係
Section titled “patterns / cases との関係”schema は単体でも使えるが、実務では pattern や case と往復した方が理解しやすい。
Pattern: SequentialではProcess Frameの stage contract が見えやすいPattern: Parallelでは branch-localCompiled Contextと join-readyProcess Deltaが見えやすいPattern: Evaluator-Optimizerでは candidate lineage と evaluation delta が見えやすい- Feature Delivery では frame と delta の end-to-end relation が見えやすい
- Human-AI Handoff では compiled context と continuity package の関係が見えやすい
暫定的なまとめ
Section titled “暫定的なまとめ”このセクションが言いたいことは、最終的には次の一文に集約できる。
PCE 2.0 の schema は、概念の写経ではない。
何を work unit として束ね、何を actor-local に見せ、何を emitted delta として残し、何をまだ current truth として採用してはいけないかを、運用可能な形に落とすための設計面である。