Japanese version: IOrchestrationContract (契約仕様)

IOrchestrationContract (Contract Specification)

1. Responsibility Boundary

IOrchestrationContract defines pure reasoning inputs for the Structure phase and enforces separation between reasoning and expression layers.

• Role:

Provide purpose, constraints, abstract structure, and reasoning pattern as an immutable view.

• Non-role:

Output decoration data (style/examples) must not be supplied here and belongs to IExpressionContract. Validation, SNR calculation, hashing, and transformation belong to service interfaces such as IOrchestrationContractValidator and ISignalToNoiseRatioCalculator.

2. Contract Signature

using AIKernel.Dtos.Context;\n\nnamespace AIKernel.Contracts;\n\n/// <summary>\n/// 推論（Orchestration）契約を定義します。\n/// 目的、制約、抽象構造を含む不変な入力フォーマットです。\n/// \n/// 参照: 2.CONTEXT_ISOLATION_SPEC.jp.md\n/// </summary>\npublic interface IOrchestrationContract\n{\n    /// <summary>\n    /// 推論に必要なコンテキストを取得します。\n    /// 例・文体・RAG は含まれていません。\n    /// </summary>\n    OrchestrationContextDto GetContext();\n\n    /// <summary>\n    /// 推論のための目的を取得します。\n    /// </summary>\n    string GetPurpose();\n\n    /// <summary>\n    /// 推論に課される制約条件を取得します。\n    /// </summary>\n    IReadOnlyList<string> GetConstraints();\n\n    /// <summary>\n    /// 推論の抽象構造を取得します。\n    /// </summary>\n    string GetStructure();\n\n    /// <summary>\n    /// 推論パターンを取得します。\n    /// </summary>\n    string? GetReasoningPattern();\n}

3. Related Use Cases

• UC-02 Structure phase execution:

Core input contract for IThoughtProcess to build RawLogic.

• UC-06 Three-layer buffer boundary:

Contract-level prevention of expression-noise leakage into reasoning context.

4. Governance & Determinism

• Reject attention pollution:

IOrchestrationContractValidator.Validate() should detect expression-layer contamination and enable deny-side handling.

• Deterministic inputs:

For identical context state, methods should return identical values.

• Fail-Closed:

Critical integrity violations should stop execution rather than degrade silently.

5. Metrics & Quality

• ISignalToNoiseRatioCalculator.CalculateSignalToNoiseRatio():

Measures signal density of purpose/constraints/structure in reasoning input.

• Low-SNR handling:

Low SNR should be treated as a risk indicator for ambiguity and reasoning drift.

6. Implementation Notes

• Immutability:

Keep contract content stable through a reasoning cycle.

• Structured representation:

Prefer schema-driven structure formats (YAML/JSON) over free-form prose for replay stability.

Changelog

• v0.0.0 / v0.0.0.0: Initial draft
• v0.0.1 (2026-05-06): Version upgrade aligned with documentation guidelines