組織内の既存 PC が「自分の文書＋小さな LLM」を持つ専門家になり，中央の管理者や中央の学習なしに 「誰に聞き，誰が答えるか」を決める分散協調（連合 RAG）を調べるための実験基盤である． 研究の目的・仕組み・理論・結果の要約は docs/d0006_research_overview.md， 研究計画の全文は plans/p0001_initialization.md にある．
- データセット：MIRAGE ＋ MedRAG コーパス（4 データ源，約 5,400 万断片，16 シャード），FeB4RAG（13 エンジン）， EnronQA（150 人の受信箱を，専門家 30 台に 5 個ずつ配置）．
- ルーティング方式：RAGRoute の 4 方式（
all・none・random・ragroute）と，中央で学習しない公開情報の方式 （flood_score・card_sim・term_sketch・centroid_sim・multi_centroid），評価用の上限（oracle）． - 回答方式：検索だけ（
retrieval_only），断片返却型（snippet_return），宿る型（local_answer）， 質問者が小型モデルで答える対照（snippet_return_small），GPU の専門家への委託（delegate_gpu）． - 実験：E0（実機の性能実測），E1（RAGRoute の再現），E2（後から加わったデータ源）， EnronQA による RQ-A（見つけてもらう方法）・RQ-B（誰が答えるか）・待ち時間・RQ-C（参加・離脱）． 結果の要約は docs/d0006_research_overview.md §6，条件・判定・数値の全文は .claude/research/journal.md，実行のディレクトリとの対応は results/README.md にある．
gpu2（操作端末）── mise のタスク・イメージの build・外部資材の取得・分析
└─ wafl-ctrl5（制御点．RTX 3060）── registry・データ準備・各ノードの操作．質問者も兼ねる
│ （クエリ埋め込み・ルーティング・統合・回答生成）
├─ 192.168.13.100〜109, 14.100〜109（専門家 20 台．GPU なし）── シャードの検索・宿る型の回答
└─ 192.168.15.100〜109（wafl500〜509．RTX 3060）── 専門家（GPU）．データ準備の埋め込みと採点も分担する
各ノードはインターネットに出ず，イメージとモデルは制御点の registry と rsync で受け取る． 詳しくは docs/d0001_architecture.md を参照．
前提：
- 操作端末に
mise，uv，docker，jqがあること． - 操作端末から
ssh wafl-ctrl5で制御点に入れること． - 制御点から各ノードへ，ユーザー
denjoで SSH できること．
実験条件も環境の構成も全て config.yaml で決める（環境変数は使わない）．
mise run setup # 環境構築．イメージを build して配り，制御点でデータ準備をバックグラウンドで始める
mise run data-status # データ準備の進み具合を見る
mise run deploy # 実験準備．シャード・設定を配り，各ノードのコンテナを起動する
mise run start # 実験実行．結果は results/<YYYYMMDD_HHMMSS>/ に回収される
mise run analyze # 結果の分析．metrics.json と analysis_report.md を作る
mise run stop # 実験の後に，各ノードのコンテナを止めてメモリと VRAM を解放する
mise run check # テスト・lint・型検査- 条件やコードを変えて実験するときは，
config.yamlを編集し，mise run deployから実行し直す． deploy はイメージを毎回 build して配る．start は，各ノードの設定とイメージが今の作業ツリーと同じかを確かめてから始める． deploy から start が終わるまでは，コミットやconfig.yamlの編集をしない． - データ準備の各段は冪等であり，
mise run setupを再び実行しても，終わっている段は飛ばされる． - 2 つの実行の正答率は
uv run atrium compare results/<A> results/<B>（McNemar の正確検定）で比べる． - EnronQA の自由記述の回答は，実験の後に判定モデルで採点する（docs/d0003_experiment_workflow.md §5）．
- 実機を使わない評価（
atrium advert-eval・owner-eval・newcomer-eval・central-eval・exposure-eval・churn-eval・churn-cascade-eval・churn-join-eval・churn-leave-eval・churn-refill-eval・churn-budget-eval・loso）の流し方は docs/d0003_experiment_workflow.md §6，指標は docs/d0004_metrics.md にある．
手順の詳細・所要時間・失敗時の確認先は docs/d0003_experiment_workflow.md にある．
研究サイクルを自動で回すときは，research-cycle skill を使う（docs/d0005_research_cycle.md）．
~/workspace/start_research_cycle.sh atrium| パス | 役割 |
|---|---|
config.yaml |
実験設定（唯一の情報源）．項目は docs/d0002_configuration.md |
src/atrium/ |
Python の実装（専門家ノード・質問者・ルーティング・データ準備・分析．CLI は atrium） |
src/atrium/routing/ |
ルーティング方式．新しい方式はここに Router を追加する |
scripts/tasks/ |
mise のタスクの本体（操作端末で動く） |
scripts/remote/ |
制御点で動くスクリプト（データ準備と各ノードの操作） |
docker/ |
専門家・質問者の compose のひな形（deploy が config.yaml の値で埋める） |
Dockerfile |
node（専門家）と full（質問者・データ準備）の 2 種類のイメージ |
tests/ |
テスト（mise run check） |
plans/ |
研究計画書（p0001）・実装計画（p0002）・E1 の後の計画（p0003）・EnronQA による拡張（p0004）・報告に向けた補強（p0005） |
docs/ |
技術仕様と研究の概要 |
results/ |
実験の結果（実行ごとのディレクトリ）．索引は results/README.md．専門家・質問者のログは Git で追跡しない |
artifacts/ |
操作端末の作業用の生成物（Git で追跡しない）．cache/ は外部から取得したモデルの写しで，setup の再実行で取り直さないために残す |
.claude/research/ |
research-cycle の設定と記録（journal・backlog） |
| 文書 | 内容 |
|---|---|
| docs/d0006_research_overview.md | 研究の目的・実験系の仕組み・理論（検索・ラベル・ルーター・待ち時間・参加と離脱）・評価の方針・主な結果 |
| docs/d0001_architecture.md | 役割の分担・データの流れ・専門家ノードの API・データの配置 |
| docs/d0002_configuration.md | config.yaml の各項目 |
| docs/d0003_experiment_workflow.md | mise タスクの手順・所要時間・失敗時の確認先・EnronQA の採点 |
| docs/d0004_metrics.md | 結果ファイルの書式と指標の定義 |
| docs/d0005_research_cycle.md | research-cycle での研究の進め方 |
| results/README.md | 実行のディレクトリと，journal の節との対応 |
| plans/p0002_implementation.md | 実装の判断と RAGRoute との差分 |
ルーターの MLP・学習手順・プロンプト・回答の抽出規則は RAGRoute
（https://github.com/sacs-epfl/ragroute ，MIT License，Copyright (c) 2025 SaCS-EPFL）から移植した．
評価データは MIRAGE / MedRAG（Xiong et al., Findings of ACL 2024），FeB4RAG（Wang et al., SIGIR 2024），
EnronQA（MichaelR207/enron_qa_0922．CC BY 4.0）を使う．