Architecture Docs

更新日: 2026-07-05

architecture/ は現行実装を説明する正本である。手法の背景、コード配置、モジュール API、生成物、テスト観点はここから辿る。

Reading Order

1. current-method.md
2. 現在採用している手法の全体像。Policy/Value、Belief、ISMCTS、self-play、training、evaluation の設計。
3. source-design.md
4. src/pca/ の package 構造、主要 dataclass/API、CLI、JSONL schema、拡張手順。
5. modules/index.md
6. module ごとの詳細説明と横断資料への索引。
7. modules/reading-guide.md
8. 初見、self-play、ISMCTS、training、evaluation など目的別の読み方。

Current Reference

Document	Role
current-method.md	手法と評価方針の正本。
source-design.md	実装設計と API ガイドの正本。
directory-layout.md	ディレクトリ構造と責務境界。
unified-token-policy-value.md	v13 unified model の詳細。
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	よくある変更作業の手順。

Historical Design Notes

Document	Status
belief-guided-neural-ismcts.md	初期設計メモ。詳細は current-method.md を優先する。

Maintenance

• Public API を増やしたら modules/api-reference.md と該当 module doc を更新する。
• JSONL / CSV / checkpoint / cache の形式を変えたら modules/artifacts.md を更新する。
• 複数 module にまたがる変更手順が増えたら modules/recipes.md に追加する。
• テストの分担が変わったら modules/test-map.md を更新する。