10人の予想専門家と5人の資金配分専門家による 2段階の集合知 で毎週の重賞を予想する AI ハーネス。そして、その予想の過程・履歴を「コンテンツ」として見せるサイト/スライド/キャラクター設定の集合体。初回ライブ運用=宝塚記念2026。
「今週の予想を作れ」と言われたAI/人間へ → エントリポイントは
bash scripts/run-weekly.sh <race_id>(冪等な状態機械。各ゲートで停止する)。設計の正本は下記「設計の正本」の4本。個別スクリプトの直叩きは冪等ゲートをバイパスするので、通常は run-weekly.sh を使う。
| 層 | 中身 | 場所 |
|---|---|---|
| エンジン(ハーネス) | 予想10人(jinba)→集約→配分5人(haibun)→集約→採点 の決定的パイプライン。接着スクリプトとエージェント定義 | scripts/ + .claude/agents/(→ AGENTS.md) |
| 履歴(run-artifacts) | レース単位の予想・買い目・採点の記録、人間予想家ベースライン、重み台帳 | runs/<race_id>/(→ runs/README.md), data/scoring/, data/experts/ |
| コンテンツ | 10人をキャラ化した創作世界・公開SPA・採用/登壇スライド・立ち絵 | docs/worldbuilding/, site/, slides/, assets/ |
設計の正本(READMEより先に読むべき4本):
docs/design/expert-subagents.md— 仕様(10人設計・スキーマ・多様性3軸・§3.5 当日依存3カテゴリの実行タイミング)。最上位正本。docs/design/weekly-ops.md— 週次運用の手順(予想作成→結果提出→反省メンテの3フェーズ)。docs/design/weekly-automation.md— 自動化設計(Mac実行・スケジュール+Remote Control。クラウドroutine不使用=バックエンド多様性保持)。docs/visual-design/design-spec.md— 公開サイトのデザイン要件定義書(情報設計・デザイントーン・SPA/OGP制約・成功基準)。
R = runs/<race_id> とする。run-weekly.sh は欠けている成果物を順に埋め、ゲートで停止する冪等な状態機械(race_id でも race-dir パスでも起動可)。
① pack(人手・web収集) → R/pack-v1.json ★手書き正本
② run-experts.sh R/pack-v1.json → R/predictions/v1/<expert>.json ×10 (予想10人 jinba-*)
③ aggregate.mjs R/predictions/v1 R/pack-v1.json → R/predictions/aggregated-v1.json (Borda+正規化Log Pooling)
④ build-betting-input.mjs R → R/betting-input-v1.json (★リーク遮断の実体)
⑤ run-bettors.sh betting-input → R/bets/v1/<bettor>.json ×5 (配分5人 haibun-*)
⑥ aggregate-bets.mjs R/bets/v1 → R/bets/aggregated-v1.json (券種別 stake 平均)
⑦ 人手ゲート:予算圧縮(betting-v2.md)・レビュー(review-v1.md)・提出(prediction-v1.md)・レース後 result.json 記録
⑧ score-race.mjs R → data/scoring/<race_id>.json + data/scoring/weights.json
主なゲート(停止して Sho に委ねる):
- pack 不在 — ①が無ければ着手不能(手動 web 収集のブロッカー)。
- クォーラム未達 — 有効予想 <
QUORUM(既定8、--quorumで可変)。 - 配分不足 — 有効ポートフォリオ <
MIN_BETTORS(既定3、--min-bettorsで可変)。 - リーク tripwire —
build-betting-input.mjsが禁止キー/ペルソナ名を検出すると書込拒否(exit 1)。 - 人手判断 — 予算圧縮・レビュー・提出・
result.json記録・馬券購入は人手。
進捗確認は bash scripts/run-weekly.sh <race_id> --plan。次の一手案内は --what-now --race-time HH:MM。
当日再実行(オッズ/馬場の品質アップグレード L1→L2→L3)の設計は docs/design/expert-subagents.md §3.5 と .claude/plans/done/flexible-execution-timing.md、その残ギャップ改善は .claude/plans/flexible-timing-hardening.md。
scripts/ エンジンの接着(run-weekly=司令塔, run-experts, aggregate, build-betting-input,
run-bettors, aggregate-bets, score-race)
.claude/agents/ エージェント定義の正本(jinba×10 + haibun×5 + schema×2 + backend .sh×6)→ AGENTS.md
runs/<race_id>/ レース単位の全成果物(pack/予想/集約/配分/提出物/result)→ runs/README.md
data/scoring/ 採点カード <race_id>.json + weights.json(重み台帳)+ README.md
data/experts/ 人間予想家ベースライン(評価専用・予想/packに混入禁止)
docs/design/ 設計の正本3本(仕様 expert-subagents / 運用 weekly-ops / 自動化 weekly-automation)
docs/visual-design/ ビジュアルデザイン刷新のドキュメント・参考資料(design-spec.md が正本)
docs/research/ 背景リサーチ4本(集合知理論・予想流派・CLI仕様・宝塚記念)
docs/worldbuilding/ 10人をキャラ化した創作世界(yosouya-10。jinba 10人のみ・haibun は対象外)
docs/memo/ 走り書きスクラッチ(設計の正本ではない)
site/ 公開SPA(静的。app.js に CHARACTERS/HORSES/RACES を inline 保持。実行時に data を読まない)
slides/ 採用/登壇スライド(現用=keiba-strategy.html)+ slides/assets/(勉強会・採用画像4枚)
assets/characters/ 現用キャラ立ち絵 <expert_id>/{mini,mid,real}.png + 集合 real.png(site/slides 共通リソース)
assets/characters-bench/ 没・旧・派生・実験画像の退避先(live 参照なし)
.claude/plans/ 設計プラン(現役は直下、完了は done/)
.claude/memories/ 運用メモリ(現状 target-race-selection.md の1本)
.claude/skills/ cli-smoke-test(CLIバックエンドの疎通テスト)
| # | 落とし穴 | 正しい理解 |
|---|---|---|
| 1 | aggregated-v1.json が2箇所 |
predictions/aggregated-v1.json(予想集約)と bets/aggregated-v1.json(買い目集約)は同名・別物。必ずフルパスで呼ぶ |
| 2 | v1 の三義 |
(a) フォルダ predictions/v1・bets/v1(実行ラウンド) (b) ファイル世代 pack-v1.json/aggregated-v1.json (c) md改訂 betting-v1.md→betting-v2.md(betting は v2 が最終) |
| 3 | 「専門家」が2集団 | 予想 expert(10人 jinba-*) ≠ 配分 bettor(5人 haibun-*)。expert_id と bettor_id を取り違えない |
| 4 | AI専門家10 ≠ 人間予想家9 | data/experts/takarazuka-2026.json は人間予想家9人(評価専用ベースライン)。AI専門家(jinba)とは別物で、pack・予想に混ぜるのは設計上の禁止事項(リーク) |
| 5 | レース名の二系統 | runs/・data/scoring/ は netkeiba race_id(202609030411)、data/experts/ はスラッグ(takarazuka-2026)。同一レースだが命名規約が違う(→ runs/README.md に対応表) |
| 6 | 創作の数値を実装と誤認 | docs/worldbuilding/.../円卓制度.md の降格点・閾値・監査役・降格戦・外部挑戦者は 物語用の架空制度で score-race.mjs の実装ではない |
| 7 | budget=10000 は実質固定 | build-betting-input.mjs + aggregate-bets.mjs + bettor-output.schema.json の3箇所に独立ハードコード。--budget で渡しても下流が追従しない(end-to-end 変更不可) |
| 8 | 採点は v1 固定読み | score-race.mjs は pack-v1.json・predictions/v1・aggregated-v1.json を v1 固定で読む。当日再実行の v2-odds/v2-baba は集約には入るが採点では読まれない |
| 9 | 画像の頭身バリアント | mini.png=チビ/SD(site/slides 現用), mid.png=中頭身(退役中・未参照), real.png=実頭身。makoto だけ site が real.png を使う例外 |
| 10 | real.png が2種 |
assets/characters/real.png=10人集合ビジュアル(hero用)≠ assets/characters/<id>/real.png=個別立ち絵 |
| 11 | CLI配管エージェント | hina/yuko/makoto/teppei/ittetsu/ritsu の .md は model: haiku の薄い配管で、実バックエンドは .sh 内の gemini-2.5-flash / gpt-5.5(→ AGENTS.md) |
- 編集対象:
scripts/,.claude/agents/,docs/design/,docs/visual-design/,docs/worldbuilding/.../characters/,site/,slides/keiba-strategy.html - 凍結(上書き禁止):
runs/202609030411/(宝塚記念2026の記録),data/scoring/202609030411.json。新レースはruns/<新race_id>/を作る - 現役WIP(触らない):
runs/202609030611/(しらさぎS・今週の対象。pack 未作成・着手前) - 再生成可: 各 run の
predictions/,bets/,*aggregated*,betting-input,data/scoring/<id>.json(LLM非決定的なので再実行で同一にはならない) - 死蔵(誤認注意):
slides/assets.zip(17.9MB・陳腐化アーカイブ),slides/keiba-strategy v2 (bundle).html(壊れ),assets/characters/cutout.png(孤児),assets/characters-bench/(退避先),mid.png(退役中)
- 馬券は実購入しない — システムは提出物(買い目案)まで。購入判断は Sho。
- 外部アクセスは GET 読み取りのみ(一次データの取得に限る)。
- 見送りも投資判断 — 全額見送り(tickets 空)も有効なポートフォリオ。
- バックエンド多様性が設計の核心 — claude + codex(gpt-5.5) + gemini-2.5-flash。CLI 不在で全員 Claude に fallback すると実効独立性が静かに崩れる(本番前に
.claude/skills/cli-smoke-testで疎通確認)。
- roster 重複 — 専門家名簿が複数箇所にハードコード(
run-experts.sh3箇所+当日依存カテゴリsakura,yuko,hina/goro,misaki,kentaがaggregate.mjs・run-weekly.sh等に散在)。PERSONA_NAMES(リーク tripwire・日本語名)とALL_EXPERTS(ローマ字名)の同期が切れると tripwire が静かに無効化。 - budget=10000 のパラメータ化未対応(上記 落とし穴#7)。
- race_id / レース名のハードコード —
aggregate.mjs:269の race_id フォールバック"202609030411"、aggregate.mjs:311のバナー「宝塚記念 2026」、score-race.mjs:156の人間予想家ファイル選択takarazuka文字列マッチ(他レースで誤って宝塚データを拾うリスク)。 - 採点の v1 固定読み(落とし穴#8)と 重みづけ未配線(
weights.jsonは races=1 < min 20 のため全員等重み・weighting_active=false)。
- AGENTS.md — 予想10人(jinba)・配分5人(haibun)・schema 2種・backend/effort の対応表
- runs/README.md — run-artifact カタログ、
v1三義、レースID⇔スラッグ対応表 - data/scoring/README.md — 採点指標・ベースライン・重み学習ルール
docs/design/(設計正本3本)/docs/visual-design/(ビジュアルデザイン刷新・design-spec.md)/docs/research/(背景)/docs/worldbuilding/yosouya-10/README.md(創作世界)