01 / DECIDE
Architecture decision
extraction、classification、UI state、次工程が typed data を使う workflow に適する。
Structured Outputs は parsing ambiguity を減らすが、refusal、incomplete result、domain-invalid value は製品側で扱う。 input、output、state、side effect を一つの観測可能な経路にしてから、schema を output contract にする の所有層を決めます。
02 / BUILD
3段階の実装
- 01
contract を定義
caller、data classification、success condition、timeout、cancel、ownership を先に記述します。extraction、classification、UI state、次工程が typed data を使う workflow に適する。
- 02
狭い経路を構築
request correlation、typed state、reversible failure handling を持つ一つの end-to-end path だけを実装します。Structured Outputs は parsing ambiguity を減らすが、refusal、incomplete result、domain-invalid value は製品側で扱う。
- 03
outcome を証明
acceptance を再実行可能な fixture、contract test、browser test にします。valid output、refusal、truncation、悪意入力、全 business-rule failure branch を test する。
03 / BOUND
Production boundary
schema conformance は factual correctness ではない。identifier、permission、total、date、cross-field invariant を検証する。
04 / PROVE
Acceptance evidence
valid output、refusal、truncation、悪意入力、全 business-rule failure branch を test する。
SOURCE / HTTP
再現可能な source probe
curl -fsSI 'https://developers.openai.com/api/docs/guides/structured-outputs' | sed -n '1,5p'