← 歴史データの追加方法

小さいモデルで開発を続ける手順

固定した計算方法・係数・検算例

# 小さいモデルで続けるための作業手順

## 開始時に読む範囲

このファイルと、`npm run history:next` が返す1枚の作業カードだけを読む。ゲーム全体・過去の会話・全史料を毎回読み込む必要はない。必要になった場合だけ `content/README.md` の該当節を見る。

```bash
npm run history:next
node scripts/history-work.mjs start RQ-DIS-01
```

`next` は未着手カードを表示し、`start` は1枚分のJSON提出物と保護対象の照合情報を作る。開始済みのカードは `show <ID>` で再表示できる。上書きしない。今回の `RQ-DIS-04` は実地試行用に開始済み。

## 探索担当がすること

1. カードに指定された公式URLを開く。1タスクは原則1資料・1レコード。検索は指定予算内にする。
2. `japanese-history/research-packs/<ID>.json` の観測欄だけを埋める。原文の長い転載ではなく、自分の言葉で要約し、表名・節名・段落などの出典箇所を書く。
3. 日付の暦変換や地理範囲が確認できなければ `value: null` と理由を残す。「不明」は正当な調査結果。
4. `research.outcome` を `found` / `not_found` / `conflict` にする。少しでも書ければfoundでよいという意味ではなく、何が分かり何が未確定かをunknownsにも列挙する。
5. レコードは `draft` のまま提出。数値・公式の計算式・史料にない対象範囲を作らない。
6. 次のコマンドが通ればそのタスクを終了する。

```bash
node scripts/history-work.mjs verify RQ-DIS-01
```

機械検証が見るのは、項目・出典ID・出典箇所・件数・採用状態・保護ファイルの変更である。史料の意味が正しいことまでは保証しない。

## 担当の分担

| 仕事 | 担当 | 成果物 |
| --- | --- | --- |
| 指定資料の探索、転記、欠落の記録 | 小さいモデル | draft調査パック |
| JSON整形、既存方式への接続案 | 小さいモデル | 限定差分、検証結果 |
| 数値計算・適用条件・回帰確認 | コード | 一致/失敗と理由 |
| 採用可能性と範囲の確認 | 統合担当 | ready化または保留理由 |
| 新しい式・例外だらけの制度・対立史料の解決 | 設計担当 | 新adapterと固定テスト |

すべてを大きいモデルへ回さない。既知の方式に収まるものは小さいモデルと検証で進め、必要な判断だけを設計担当へ渡す。これはプロジェクト側の役割指定であり、ChatGPTの主モデル設定を自動変更する仕組みではない。

## 変更してよい場所

探索タスクでは自分に割り当てた `research-packs/<ID>.json` だけ。指示が別途ある場合を除き、ゲーム本体・計算式・コンパイラ・既存のreadyデータ・他担当の提出物は変更しない。`protectedSnapshot` を更新して失敗を隠さない。

エラーが出たら該当欄だけ1回修正する。確認できない情報を埋めるために無制限に検索しない。解決しなければ、実行コマンド・エラー・未確定項目を残して終了する。次の担当が同じ探索をやり直さないようにする。

## 計算方式は先に決まっている

正本:`gamestation/calculation-kernel.js`。公開参照:`/gamestation/calculation-rules.json`。

- 現金:前残高+収入−支出。災害の自動支出は払える額まで。
- 健康等:0〜100へ収め、希望変化ではなく実際の差分を記録。
- 資産減損:評価額×率を切り上げ、損失は元評価額まで。現金取引と分離。
- 収入低下:同時のペナルティは最大値を採用。元の収入より減らさない。
- 総資産・純資産:貯蓄+所有物評価額、そこから負債を引く。

これらはゲームの試作モデルであり、史実の損失額・税率・通貨換算を決める資料ではない。新しい税・地代・相続・利息等は、母数・単位・発生頻度・丸め・例外・根拠がそろうまで既存式へ無理に当てはめない。

## 統合担当のチェック

```bash
npm run history:check
node scripts/import-history-content.mjs japanese-history/research-packs/<ID>.json --check
```

探索完了は公開採用とは別。readyへの正規化はsource・time・area・conditions・integrationを埋め、出典の意味と適用範囲を確認してから行う。公開は既存のSites手順。研究結果だけで勝手にサイトを変更するループは設定していない。