コンテンツへ移動

ドクトリン

形式化されたテストケースと最小限の解釈フィクスチャ

限界事例と比較事例集を公開するドクトリンは、いずれ同じ問いに行き着く。

コレクションドクトリン
種別ドクトリン
レイヤーtransversal
バージョン1.0
レベルnormatif
公開日2026/3/22
更新日2026/3/23

ガバナンスアーティファクト

このページが対象とするガバナンスファイル

このページは、アイデンティティ、優先順位、限界、コーパスの読解条件を宣言する公開サーフェスに結びついています。以下の順序が、推奨される読解の順序です。

  1. 01Q-Metrics JSON
  2. 02Q-Metrics YAML
  3. 03Q-Ledger JSON
可観測性#01

Q-Metrics JSON

/.well-known/q-metrics.json

ギャップ、スナップショット、比較を観測するための記述的指標のサーフェス。

統御する対象
ギャップ、ドリフト、スナップショット、比較の記述。
画定する範囲
観測されたシグナル、忠実性の証明、実際の舵取りの混同。

保証しないこと: 観測サーフェスは効果を記録するものであり、それ単独では表現を保証しない。

可観測性#02

Q-Metrics YAML

/.well-known/q-metrics.yml

計装と構造化された読解のための、Q-MetricsのYAML投影。

統御する対象
ギャップ、ドリフト、スナップショット、比較の記述。
画定する範囲
観測されたシグナル、忠実性の証明、実際の舵取りの混同。

保証しないこと: 観測サーフェスは効果を記録するものであり、それ単独では表現を保証しない。

可観測性#03

Q-Ledger JSON

/.well-known/q-ledger.json

観測、ベースライン、バージョン管理されたギャップを記録するマシンファーストのジャーナル。

統御する対象
ギャップ、ドリフト、スナップショット、比較の記述。
画定する範囲
観測されたシグナル、忠実性の証明、実際の舵取りの混同。

保証しないこと: 観測サーフェスは効果を記録するものであり、それ単独では表現を保証しない。

補完的なアーティファクト(3)

これらのサーフェスは主要ブロックを補完します。テーマに応じて、文脈、発見、ルーティング、観察を加えます。

可観測性#04

Q-Ledger YAML

/.well-known/q-ledger.yml

手続き的な読解またはツール利用のための、Q-LedgerジャーナルのYAML投影。

可観測性#06

IIPレポートスキーマ

/iip-report.schema.json

ログ、指標、スナップショット、または測定プロトコルを公開する観測サーフェス。

形式化されたテストケースと最小限の解釈フィクスチャ

限界事例と比較事例集を公開するドクトリンは、いずれ同じ問いに行き着く。すなわち、ある種の事例を、その中身を貧しくすることなく、どうすれば再利用可能にできるのかという問いである。

ここで登場するのが、形式化されたテストケースと最小限の解釈フィクスチャである。形式化されたテストケースは、「勝つために設計された」デモンストレーションではない。それは、公開され、限定され、アーカイブ可能で、再実行可能な単位であり、特定のメカニズムをテストすることを可能にする。そのメカニズムとは、例外の存続、階層の維持、翻訳の忠実性、バージョンの優先、画像の結びつき、第三者サーフェスに対する正規ソースの耐性、あるいは非回答の正当な出現である。

このページは、ドクトリン上の判例、比較事例集、公開ベンチマーク、応用的な可観測性を拡張するものである。このページが付け加えるのは、一つの単純な要件である。すなわち、公開可能なテストは、正当性の条件を消し去ることなくメカニズムを切り出さなければならない。


1. 形式化されたテストケースとは実際に何か

形式化されたテストケースは、少なくとも次の五つの要素を組み合わせる。

  • 限定されたコーパス
  • 明示的な問いまたはタスク
  • 固定されたバージョンの状態
  • 期待される出力、または適格な出力の一群
  • 読み取り可能な失敗条件

テストは「正しい答えを出させる」ために存在するのではない。テストは、最低限の条件が満たされたときに、ドクトリン上のメカニズムが存続するかどうかを検証するために存在する。

その意味で、テストケースは単なる評価ツールではない。それは、ドクトリン上の直観を異議申立て可能な対象に変える、公開の一形式である。


2. 最小限の解釈フィクスチャとは何か

最小限の解釈フィクスチャとは、メカニズムを緊張状態に置くことのできる、ソース、バージョン、手がかり、境界の最小の構成である。

それは、たとえば次のようなものでありうる。

  • 互いに矛盾する正規ページと二次的なページ
  • 一般的なルールと局所的な例外
  • わずかに食い違うフランス語版と英語版
  • PDF内の表とそのテキストによる説明
  • 一次ソースよりも可視性の高い第三者の掲載情報
  • 唯一の正当な出力が保留または非回答であるような問い

このフィクスチャが最小限と呼ばれるのは、単純だからではなく、冗長でなく、かつ十分だからである。それは、文書上のノイズを減らしながら、メカニズムを見える状態に保つ。


3. 公開可能な良いテストの特性

a) 最小性

テストは、問題を損なうことなく、できるだけ少ない変数を切り出さなければならない。

b) バージョンの固定

良いテストは、それが動員するソースの状態を正確に示す。バージョンの固定がなければ、テストは時間の経過とともに解釈しにくくなる。

c) 正当な出力の複数性

メカニズムによっては、単一の「正しい」出力ではなく、適格な回答の一群が求められる。たとえば、条件付きの回答、リダイレクト、例外への言及、あるいは結論を出すことの拒否である。

d) 明示的なネガティブ

良いテストは、何が失敗とみなされるかも示す。不当な一般化、例外の消去、不十分な引用、階層の逆転、あるいは保留が求められていた場面での断定である。

e) 再構成可能なアーカイブ

テストは再実行できなければならない。少なくとも、その範囲が理解可能なままであるのに十分な文脈とともに読み直せなければならない。


4. これらのテストが有効に検証できること

よく形式化されたテストケースは、現実を網羅するふりをすることなく、きわめて異なるメカニズムを検証することができる。

テストケースは次のことをテストしうる。

したがって、その価値は単一のスコアを生み出すことにはない。その価値は、明示的な条件のもとでメカニズムを議論可能にすることにある。


5. テストがドクトリンに取って代わらない理由

よくある危険は、テストがそれだけで何が良いかの規範を生み出すかのように扱うことである。この横滑りは誤解を招く。

テストは、あるシステムが局所的なフィクスチャで成功することを示しうる。しかし、それだけでは、そのレジームが他の場所でもガバナンス下にあることも、局所的な成功が一般化できることも示さない。テストがドクトリン上の判例と比較事例集に結びついたままでなければならないのは、このためである。その結びつきがなければ、テストはすぐに孤立した小さな証明になってしまう。

ドクトリンは何が重要かを述べる。テストは特定のメカニズムが存続するかどうかを述べる。この二つを混同すると、テストを過大評価するか、ドクトリンの規定を不十分にするかのいずれかに至る。


6. 単発の観察から公開可能なベンチマークへ

形式化されたテストケースは、単一の事例とベンチマークの間に位置する。

それは単発の観察よりも精密であり、完全なベンチマークよりも軽く、単なる例よりも再利用しやすい。したがって、公開ベンチマーク、応用的な可観測性の付録、あるいはモデル横断検証プロトコル(英語)のようなプロトコルの構成要素として役立ちうる。

健全な進行は、しばしば次のようになる。

  1. 限界事例が問題を明らかにする。
  2. 比較事例集がそれを再構成する。
  3. 最小限のフィクスチャがそれを切り出す。
  4. テストケースがそれを再利用可能にする。
  5. ベンチマークがそれをより広いシリーズに統合する。

この進行は、ドクトリンを計測手段だけの中に溶け込ませるのではなく、ドクトリンを視野に保つ。

ただし、この進行には追加の規律が前提となる。採用された事例は、シリーズが実際にカバーしている以上の範囲をカバーしているように見えないよう、十分に明確にサンプリングされなければならない。テストのコーパスが拡大するやいなや、サンプリングと代表性は、単なる方法論上の背景ではなく、公開されたドクトリンの一部となる。


7. 範囲と限界

このページは、普遍的なテストスイートも、全体的な指標も、決定的な検証の約束も提案しない。このページが定めるのは、より控えめな要件である。すなわち、メカニズムをテストするために事例が公開される場合、その事例は、再利用可能であるのに十分なほど限定され、かつ局所的な成功をドクトリン上の正当性と混同しないのに十分なほど豊かでなければならない。

良い形式化されたテストケースは、完璧な回答の縮小版ではない。それは、システムが何を保持すべきだったのか、何を正当に拒否できたのか、そして表現が説得力をもって聞こえたとしても何がなお失敗とみなされるのかを可視化する対象である。


正規リンク