アーキテクチャ

更新日: 2026-07-24

architecture/ には、現在の実装と設計を記載します。手法の背景、コードの配置、モジュールAPI、生成物、テストの観点は、このページからたどれます。

読む順番

1. current-method.md
2. 現在採用している手法の全体像。Policy・Value、Belief、ISMCTS、self-play、学習、評価の設計。
3. source-design.md
4. src/pca/のパッケージ構成、主要なdataclassとAPI、CLI、JSONLスキーマ、拡張手順。
5. modules/index.md
6. モジュールごとの詳細説明と、複数モジュールにまたがる資料への索引。
7. modules/reading-guide.md
8. 初めて読む場合や、self-play、ISMCTS、学習、評価を変更する場合の読み方。

現在の仕様

文書	内容
current-method.md	現在の手法と評価方針。
evaluation-gumbel-vs-visit.md	Gumbel対Visit 560試合の直接対戦結果と採用判断。
source-design.md	実装設計とAPIのガイド。
directory-layout.md	ディレクトリ構造と責務境界。
unified-token-policy-value.md	V14でも採用している統合型Policy・Value・Beliefモデルの詳細。
modules/api-reference.md	主要 API の import path、引数、戻り値、副作用、関連テスト。
modules/artifacts.md	JSONL、CSV、checkpoint、metadata cache、submission bundle の形式。
modules/test-map.md	変更内容ごとのテスト対応表。
modules/flows.md	self-play、ISMCTS、training、evaluation の処理フロー。
modules/recipes.md	よくある変更作業の手順。

過去の設計メモ

文書	位置付け
belief-guided-neural-ismcts.md	初期設計メモ。詳細は current-method.md を優先する。

更新時の注意

• 公開APIを増やしたらmodules/api-reference.mdと該当するモジュールの文書を更新する。
• JSONL、CSV、チェックポイント、キャッシュの形式を変えたらmodules/artifacts.mdを更新する。
• 複数のモジュールにまたがる変更手順が増えたらmodules/recipes.mdに追加する。
• テストの分担が変わったら modules/test-map.md を更新する。