01
証拠は四種類、分けて記録
重要な結論には主要な根拠を示します。公式資料は保守者の公開説明、仕様はプロトコル要件、ローカル検証は固定環境の結果、製品動作は観測可能な現象を示し、非公開の内部実装は推測しません。
- 公式資料：公開設定、コマンド、権限、対応範囲。
- 仕様：リクエスト、レスポンス、イベント、エラーの意味。
- ローカル検証：明示したバージョンと入力で再現した結果。
- 製品動作：観測できる結果。非公開設計の推測は含めません。
02
最小検証フロー
クライアント版、エンドポイント、モデル識別子、権限、最小入力を固定し、設定解析、認証、通常応答、ストリーム終了、ツール動作、失敗経路を分けて確認します。書き込みには追加承認と結果確認が必要です。
- 01環境を固定日付、版、OS、設定範囲、秘密を除いたパラメータを記録します。
- 02タスクを最小化読み取り専用または一つのファイルから始め、変数を同時に変えません。
- 03失敗を確認想定エラーが成功として扱われないことを確認します。
- 04境界を保存検証済み、文書上の対応、条件付き、未検証を分けます。
03
互換 ≠ 機能が同一
基本プロトコルが共通でも、モデル検出、ストリームイベント、ツール、推論フィールド、エラー構造、クライアント拡張まで同じとは限りません。互換性の記述には検証した層を示します。
静的ガイドとマトリクスは日付付きのスナップショットです。本番利用前に最小の読み取りリクエストを行い、現在のチャネル、モデル一覧、クライアント help を確認してください。
04
安全性と秘匿化
検証記録に API Key、完全な認証ヘッダー、非公開リポジトリ、利用者データ、許可のないログを含めません。例はプレースホルダーを使い、問題共有では状態、段階、版、秘匿化したリクエスト ID だけを残します。