Module Docs Index

更新日: 2026-07-05

src/pca/ の実装をモジュールごとに説明するドキュメント群である。全体像は ../source-design.md を読み、個別の責務や API はこのディレクトリから辿る。

Start Here

• Reading Guide
• 目的別に読む順番と実装入口を示す。
• Flow Diagrams
• self-play、ISMCTS、training、evaluation の処理フロー。
• Implementation Recipes
• よくある変更作業の手順書。
• API Reference Matrix
• import path、引数、戻り値、副作用、関連テストの一覧。
• Artifacts Catalog
• JSONL、CSV、checkpoint、metadata cache、submission bundle の一覧。
• Test Map
• 変更内容ごとに走らせるテスト。

Core

• CABT Boundary
• pca.cabt, pca.cli_config, pca.data
• Features
• pca.features
• Decision
• pca.decision
• Models
• pca.models

Search

• Search
• pca.search.mcts, pca.search.belief, pca.search.determinized
• ISMCTS
• pca.search.ismcts

Training

• Training Data
• pca.training.targets, pca.training.dataset, pca.training.data
• Self-Play
• pca.training.selfplay
• Policy/Value Training
• pca.training.train, pca.training.policy_value
• Belief Training
• pca.training.belief_train, pca.training.belief

Runtime

• Evaluation
• pca.evaluation
• Rule Agents
• pca.rule_agents
• Serving and Submission
• pca.serving, pca.submission
• Tools and Config
• pca.tools, config/YAML helpers

更新ルール

• Python module を追加したら、対応する md の module table に 1 行追加する。
• 公開 API を追加したら、Public API 節に import path と用途を書く。
• CLI の option や JSONL schema を変えたら、関連 md と ../source-design.md の両方を更新する。
• 実装手順が複数ファイルにまたがる場合は recipes.md に追加する。
• 生成物の形式や保存場所を変えたら artifacts.md に追加する。