docs: refine CX specification boundaries [skip-ci]

yoshifuminakamura · yoshifuminakamura · commit 18ec4c13721d · 2026-04-03T00:28:43.000+09:00
- replace local absolute links with relative links in CX docs
- reduce BenchKit detail in CX_PLATFORM and delegate to BENCHKIT_SPEC
- rename BenchKit structure sections to layer-oriented headings
diff --git a/docs/cx/BENCHKIT_SPEC.md b/docs/cx/BENCHKIT_SPEC.md
@@ -11,7 +11,7 @@ If any discrepancy exists, the Japanese version takes precedence.
 
 ## 読み方のルール / Reading Conventions
 
-本書では、[`CX_FRAMEWORK.md`](C:/Users/yoshi/benchkit/docs/cx/CX_FRAMEWORK.md) の読み方のルールに従う。
+本書では、[`CX_FRAMEWORK.md`](./CX_FRAMEWORK.md) の読み方のルールに従う。
 特に、本書では以下を区別して読むことが重要である。
 
 - 必須要件:
@@ -21,7 +21,7 @@ If any discrepancy exists, the Japanese version takes precedence.
 - 将来拡張:
   申請フォーム、自動 PR、AI 駆動最適化、MCP 連携などの拡張方向。
 
-This document follows the reading conventions defined in [`CX_FRAMEWORK.md`](C:/Users/yoshi/benchkit/docs/cx/CX_FRAMEWORK.md).
+This document follows the reading conventions defined in [`CX_FRAMEWORK.md`](./CX_FRAMEWORK.md).
 In particular, it is important here to distinguish:
 
 - mandatory requirements:
@@ -56,16 +56,16 @@ BenchKit is responsible in particular for:
 
 ## 1.1 文書の位置づけ / Position of This Document
 
-本書は、[`CX_FRAMEWORK.md`](C:/Users/yoshi/benchkit/docs/cx/CX_FRAMEWORK.md) および [`CX_PLATFORM.md`](C:/Users/yoshi/benchkit/docs/cx/CX_PLATFORM.md) を受けて、BenchKit 自体の責務・構成・接続点を定義する下位仕様である。
+本書は、[`CX_FRAMEWORK.md`](./CX_FRAMEWORK.md) および [`CX_PLATFORM.md`](./CX_PLATFORM.md) を受けて、BenchKit 自体の責務・構成・接続点を定義する下位仕様である。
 
 本書は、BenchKit の外にある外部サービス、外部ツール、実システムを前提とするが、
 それらの内部仕様そのものではなく、BenchKit から見た責務境界と接続要件を記述する。
-主要用語は [`CX_FRAMEWORK.md`](C:/Users/yoshi/benchkit/docs/cx/CX_FRAMEWORK.md) の用語集に従う。
+主要用語は [`CX_FRAMEWORK.md`](./CX_FRAMEWORK.md) の用語集に従う。
 
-This document is a lower-level specification derived from [`CX_FRAMEWORK.md`](C:/Users/yoshi/benchkit/docs/cx/CX_FRAMEWORK.md) and [`CX_PLATFORM.md`](C:/Users/yoshi/benchkit/docs/cx/CX_PLATFORM.md), defining BenchKit’s own responsibilities, structure, and integration points.
+This document is a lower-level specification derived from [`CX_FRAMEWORK.md`](./CX_FRAMEWORK.md) and [`CX_PLATFORM.md`](./CX_PLATFORM.md), defining BenchKit’s own responsibilities, structure, and integration points.
 
 It assumes the existence of external services, external tools, and real systems outside BenchKit, but describes not their internal semantics themselves, rather the responsibility boundaries and integration requirements as seen from BenchKit.
-Core terminology follows the glossary in [`CX_FRAMEWORK.md`](C:/Users/yoshi/benchkit/docs/cx/CX_FRAMEWORK.md).
+Core terminology follows the glossary in [`CX_FRAMEWORK.md`](./CX_FRAMEWORK.md).
 
 ## 2. CX基盤における位置づけ / Position Within the CX Platform
 
@@ -168,7 +168,7 @@ BenchKit must explicitly handle their integration conditions, assumptions, and i
 
 BenchKit は概ね以下の論理構成を持つ。
 
-### 6.1 `programs/*`
+### 6.1 アプリ実装層 / Application Implementation Layer
 
 アプリごとの実装層である。
 各アプリは原則として以下を持つ。
@@ -190,7 +190,7 @@ Each application normally contains:
 
 This layer defines application-specific behavior such as source acquisition, build, execution, and FOM extraction.
 
-### 6.2 `scripts/*`
+### 6.2 共通実行基盤層 / Shared Execution Foundation
 
 BenchKit の共通実行基盤である。
 ここでは主に以下を担う。
@@ -214,7 +214,7 @@ It mainly provides:
 
 Common shell functions such as those in `bk_functions.sh` are central to absorbing repeated patterns while preserving the shell-first approach.
 
-### 6.3 `config/*`
+### 6.3 system・queue 定義層 / System and Queue Definition Layer
 
 BenchKit の system / queue 定義層である。
 
@@ -236,7 +236,7 @@ Main roles:
 
 `system.csv` is the source of truth for items such as system name, mode, runner tag, queue, and queue_group.
 
-### 6.4 `result_server/*`
+### 6.4 ポータル層 / Portal Layer
 
 BenchKit のポータル層である。
 
@@ -487,10 +487,10 @@ Users should ideally be able to use BenchKit to:
 
 本仕様は以下と整合する。
 
-- [CX_FRAMEWORK.md](C:/Users/yoshi/benchkit/docs/cx/CX_FRAMEWORK.md)
-- [CX_PLATFORM.md](C:/Users/yoshi/benchkit/docs/cx/CX_PLATFORM.md)
+- [CX_FRAMEWORK.md](./CX_FRAMEWORK.md)
+- [CX_PLATFORM.md](./CX_PLATFORM.md)
 
 This specification is aligned with:
 
-- [CX_FRAMEWORK.md](C:/Users/yoshi/benchkit/docs/cx/CX_FRAMEWORK.md)
-- [CX_PLATFORM.md](C:/Users/yoshi/benchkit/docs/cx/CX_PLATFORM.md)
+- [CX_FRAMEWORK.md](./CX_FRAMEWORK.md)
+- [CX_PLATFORM.md](./CX_PLATFORM.md)
diff --git a/docs/cx/CX_FRAMEWORK.md b/docs/cx/CX_FRAMEWORK.md
@@ -53,16 +53,16 @@ It is a higher-level framework that organizes the roles of platforms, tools, ser
 
 下位には、少なくとも以下の仕様がぶら下がる。
 
-- [`CX_PLATFORM.md`](C:/Users/yoshi/benchkit/docs/cx/CX_PLATFORM.md): CX フレームワークを実装する全体システムの仕様
-- [`BENCHKIT_SPEC.md`](C:/Users/yoshi/benchkit/docs/cx/BENCHKIT_SPEC.md): BenchKit の責務・構成・接続点の仕様
+- [`CX_PLATFORM.md`](./CX_PLATFORM.md): CX フレームワークを実装する全体システムの仕様
+- [`BENCHKIT_SPEC.md`](./BENCHKIT_SPEC.md): BenchKit の責務・構成・接続点の仕様
 
 This document is the top-level conceptual specification for CX as a whole.
 It defines what should run continuously, and does not specify implementation details of individual software components or services.
 
 At least the following lower-level specifications are expected beneath it:
 
-- [`CX_PLATFORM.md`](C:/Users/yoshi/benchkit/docs/cx/CX_PLATFORM.md): the specification of the overall system implementing the CX Framework
-- [`BENCHKIT_SPEC.md`](C:/Users/yoshi/benchkit/docs/cx/BENCHKIT_SPEC.md): the specification of BenchKit responsibilities, structure, and integration points
+- [`CX_PLATFORM.md`](./CX_PLATFORM.md): the specification of the overall system implementing the CX Framework
+- [`BENCHKIT_SPEC.md`](./BENCHKIT_SPEC.md): the specification of BenchKit responsibilities, structure, and integration points
 
 ## 2. 適用範囲 / Scope
 
diff --git a/docs/cx/CX_PLATFORM.md b/docs/cx/CX_PLATFORM.md
@@ -11,7 +11,7 @@ If any discrepancy exists, the Japanese version takes precedence.
 
 ## 読み方のルール / Reading Conventions
 
-本書では、[`CX_FRAMEWORK.md`](C:/Users/yoshi/benchkit/docs/cx/CX_FRAMEWORK.md) の読み方のルールに従う。
+本書では、[`CX_FRAMEWORK.md`](./CX_FRAMEWORK.md) の読み方のルールに従う。
 特に、本書では以下を区別して読むことが重要である。
 
 - 必須要件:
@@ -21,7 +21,7 @@ If any discrepancy exists, the Japanese version takes precedence.
 - 将来拡張:
   申請、承認、自動 PR、AI 連携など、将来の拡張方向。
 
-This document follows the reading conventions defined in [`CX_FRAMEWORK.md`](C:/Users/yoshi/benchkit/docs/cx/CX_FRAMEWORK.md).
+This document follows the reading conventions defined in [`CX_FRAMEWORK.md`](./CX_FRAMEWORK.md).
 In particular, it is important here to distinguish:
 
 - mandatory requirements:
@@ -44,17 +44,17 @@ It integrates software components, external tools, external services, compute sy
 
 ## 1.1 文書の位置づけ / Position of This Document
 
-本書は、[`CX_FRAMEWORK.md`](C:/Users/yoshi/benchkit/docs/cx/CX_FRAMEWORK.md) を実装する全体システムとしての CX 基盤を定義する。
+本書は、[`CX_FRAMEWORK.md`](./CX_FRAMEWORK.md) を実装する全体システムとしての CX 基盤を定義する。
 本書は、構成要素、責務境界、接続要件を定義し、個別ソフトウェアの詳細仕様は下位仕様へ委ねる。
 
-特に、BenchKit に関する詳細は [`BENCHKIT_SPEC.md`](C:/Users/yoshi/benchkit/docs/cx/BENCHKIT_SPEC.md) に委ねる。
-主要用語は [`CX_FRAMEWORK.md`](C:/Users/yoshi/benchkit/docs/cx/CX_FRAMEWORK.md) の用語集に従う。
+特に、BenchKit に関する詳細は [`BENCHKIT_SPEC.md`](./BENCHKIT_SPEC.md) に委ねる。
+主要用語は [`CX_FRAMEWORK.md`](./CX_FRAMEWORK.md) の用語集に従う。
 
-This document defines the CX Platform as the overall system that implements [`CX_FRAMEWORK.md`](C:/Users/yoshi/benchkit/docs/cx/CX_FRAMEWORK.md).
+This document defines the CX Platform as the overall system that implements [`CX_FRAMEWORK.md`](./CX_FRAMEWORK.md).
 It defines components, responsibility boundaries, and connection requirements, while delegating software-specific details to lower-level specifications.
 
-In particular, BenchKit-specific details are delegated to [`BENCHKIT_SPEC.md`](C:/Users/yoshi/benchkit/docs/cx/BENCHKIT_SPEC.md).
-Core terminology follows the glossary in [`CX_FRAMEWORK.md`](C:/Users/yoshi/benchkit/docs/cx/CX_FRAMEWORK.md).
+In particular, BenchKit-specific details are delegated to [`BENCHKIT_SPEC.md`](./BENCHKIT_SPEC.md).
+Core terminology follows the glossary in [`CX_FRAMEWORK.md`](./CX_FRAMEWORK.md).
 
 ## 2. 適用範囲 / Scope
 
@@ -81,46 +81,24 @@ The CX Platform includes:
 ## 3. BenchKit の位置づけ / Position of BenchKit
 
 BenchKit は CX基盤を構成する中核ソフトウェアの1つである。
-
-BenchKit は主に以下を担う。
-
-- ベンチマーク定義と実行オーケストレーション
-- CI/CD を用いたジョブ生成
-- 結果の標準化
-- 結果および推定結果の表示
-- 推定・最適化・申請ワークフローへの接続点
+BenchKit は主として、CX 基盤におけるベンチマーク実行、結果正規化、結果表示、および関連ワークフローへの接続点を担う。
+BenchKit の詳細な責務、構成、データモデル、接続条件は [`BENCHKIT_SPEC.md`](./BENCHKIT_SPEC.md) に委ねる。
 
 BenchKit is one of the core software components of the CX Platform.
-
-BenchKit is primarily responsible for:
-
-- benchmark definition and execution orchestration
-- CI/CD-driven job generation
-- result normalization
-- presentation of benchmark and estimation results
-- integration points for estimation, optimization, and request workflows
+BenchKit is primarily responsible for benchmark execution, result normalization, result presentation, and integration points for related workflows within the CX Platform.
+Detailed responsibilities, structure, data models, and integration conditions are delegated to [`BENCHKIT_SPEC.md`](./BENCHKIT_SPEC.md).
 
 ## 4. CX基盤の構成要素 / Platform Components
 
 ### 4.1 内部中核コンポーネント / Core Internal Components
 
 #### BenchKit
 
-BenchKit はベンチマーク実行と結果管理の中核基盤である。
-
-主な構成:
-- `programs/*`
-- `scripts/*`
-- `config/*`
-- `result_server/*`
-
-BenchKit is the core platform for benchmark execution and result management.
+BenchKit は CX 基盤における中核ソフトウェアであり、詳細は [`BENCHKIT_SPEC.md`](./BENCHKIT_SPEC.md) に委ねる。
+本書では、BenchKit を CX 基盤の主要構成要素として位置づけるにとどめる。
 
-Main parts:
-- `programs/*`
-- `scripts/*`
-- `config/*`
-- `result_server/*`
+BenchKit is a core software component within the CX Platform, and its details are delegated to [`BENCHKIT_SPEC.md`](./BENCHKIT_SPEC.md).
+This document only positions BenchKit as one of the major components of the CX Platform.
 
 #### 結果ポータル / Result Portal
 
