Skip to content

Commit d58d6a1

Browse files
docs: separate CX platform and BenchKit specs [skip-ci]
- reduce BenchKit detail in CX_PLATFORM - remove implementation-specific references from platform-level sections - keep CX_PLATFORM focused on composition and integration requirements
1 parent 18ec4c1 commit d58d6a1

1 file changed

Lines changed: 14 additions & 12 deletions

File tree

docs/cx/CX_PLATFORM.md

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -45,15 +45,17 @@ It integrates software components, external tools, external services, compute sy
4545
## 1.1 文書の位置づけ / Position of This Document
4646

4747
本書は、[`CX_FRAMEWORK.md`](./CX_FRAMEWORK.md) を実装する全体システムとしての CX 基盤を定義する。
48-
本書は、構成要素、責務境界、接続要件を定義し、個別ソフトウェアの詳細仕様は下位仕様へ委ねる。
48+
本書は、構成要素、責務境界、接続要件を定義する。
49+
個別ソフトウェアの詳細仕様は必要に応じて下位仕様で定義する。
4950

50-
特に、BenchKit に関する詳細は [`BENCHKIT_SPEC.md`](./BENCHKIT_SPEC.md) に委ねる
51+
BenchKit に関する詳細は [`BENCHKIT_SPEC.md`](./BENCHKIT_SPEC.md) を参照する
5152
主要用語は [`CX_FRAMEWORK.md`](./CX_FRAMEWORK.md) の用語集に従う。
5253

5354
This document defines the CX Platform as the overall system that implements [`CX_FRAMEWORK.md`](./CX_FRAMEWORK.md).
54-
It defines components, responsibility boundaries, and connection requirements, while delegating software-specific details to lower-level specifications.
55+
It defines components, responsibility boundaries, and connection requirements.
56+
Software-specific details may be defined in lower-level specifications where needed.
5557

56-
In particular, BenchKit-specific details are delegated to [`BENCHKIT_SPEC.md`](./BENCHKIT_SPEC.md).
58+
For BenchKit-specific details, see [`BENCHKIT_SPEC.md`](./BENCHKIT_SPEC.md).
5759
Core terminology follows the glossary in [`CX_FRAMEWORK.md`](./CX_FRAMEWORK.md).
5860

5961
## 2. 適用範囲 / Scope
@@ -82,22 +84,22 @@ The CX Platform includes:
8284

8385
BenchKit は CX基盤を構成する中核ソフトウェアの1つである。
8486
BenchKit は主として、CX 基盤におけるベンチマーク実行、結果正規化、結果表示、および関連ワークフローへの接続点を担う。
85-
BenchKit の詳細な責務、構成、データモデル、接続条件は [`BENCHKIT_SPEC.md`](./BENCHKIT_SPEC.md) に委ねる
87+
詳細は [`BENCHKIT_SPEC.md`](./BENCHKIT_SPEC.md) を参照する
8688

8789
BenchKit is one of the core software components of the CX Platform.
8890
BenchKit is primarily responsible for benchmark execution, result normalization, result presentation, and integration points for related workflows within the CX Platform.
89-
Detailed responsibilities, structure, data models, and integration conditions are delegated to [`BENCHKIT_SPEC.md`](./BENCHKIT_SPEC.md).
91+
For details, see [`BENCHKIT_SPEC.md`](./BENCHKIT_SPEC.md).
9092

9193
## 4. CX基盤の構成要素 / Platform Components
9294

9395
### 4.1 内部中核コンポーネント / Core Internal Components
9496

9597
#### BenchKit
9698

97-
BenchKit は CX 基盤における中核ソフトウェアであり、詳細は [`BENCHKIT_SPEC.md`](./BENCHKIT_SPEC.md) に委ねる
99+
BenchKit は CX 基盤における中核ソフトウェアである
98100
本書では、BenchKit を CX 基盤の主要構成要素として位置づけるにとどめる。
99101

100-
BenchKit is a core software component within the CX Platform, and its details are delegated to [`BENCHKIT_SPEC.md`](./BENCHKIT_SPEC.md).
102+
BenchKit is a core software component within the CX Platform.
101103
This document only positions BenchKit as one of the major components of the CX Platform.
102104

103105
#### 結果ポータル / Result Portal
@@ -109,7 +111,7 @@ This document only positions BenchKit as one of the major components of the CX P
109111
- 使用量レポートの参照
110112
- 将来の申請・承認・AI指示ワークフローへの接続点
111113

112-
現状では主に `result_server` がその役割を担う
114+
現状では CX 基盤の内部ソフトウェアにより提供される
113115

114116
The Result Portal provides user-facing access to:
115117

@@ -118,18 +120,18 @@ The Result Portal provides user-facing access to:
118120
- usage reports
119121
- future integration points for requests, approvals, and AI instructions
120122

121-
It is currently implemented mainly by `result_server`.
123+
It is currently provided by internal software components of the CX Platform.
122124

123125
#### 推定レイヤ / Estimation Layer
124126

125127
実測データから本番規模性能や将来機性能を推定するレイヤである。
126128

127-
現状では BenchKit 内に一部実装されているが
129+
現状では CX 基盤の内部ソフトウェアに一部実装されているが
128130
将来的には外部モデルや外部サービスとも連携しうる。
129131

130132
The Estimation Layer transforms measured data into production-scale and future-system estimates.
131133

132-
It is currently partially implemented inside BenchKit, but may later integrate with external models and services.
134+
It is currently partially implemented within internal platform software, but may later integrate with external models and services.
133135

134136
#### 最適化レイヤ / Optimization Layer
135137

0 commit comments

Comments
 (0)