# AI向け public root router

この clipboard は jp-election-public-ja の public root router です。最初に全公開データを読まず、質問を分類してから必要な public URL だけ読むことを前提にします。

## 利用方針
- 最初に質問を current / years / graph / file lookup / docs のどれかに分類する。
- 重い CSV / JSON / municipality index は必要になった時だけ読む。
- まず index / map / manifest を読み、そこから具体的な public URL を解決する。
- internal path, generated local path, private viewer path は使わない。
- public_key と明示された public URL を優先し、命名規則から path を推測しない。

## 入口ページ
- [公開トップ](https://jp-election-public-ja-2026-hr-smd.pages.dev/index.html)
  - この root 自体。current / graph / data の導線整理。
- [現在の公開ページ](https://jp-election-public-ja-2026-hr-smd.pages.dev/index.html)
  - 現在の公開対象ページ。年・地域・主要リンクの入口。
- [年度別ページ](https://jp-election-public-ja.pages.dev/years)
  - 年度別・選挙 family 別の公開ページ一覧。
- [Municipality / Graph Explorer](https://jp-election-public-ja-2026-hr-smd.pages.dev/graph.html)
  - 自治体・都道府県・全国の系列探索。
- [リンク一覧](https://jp-election-public-ja-2026-hr-smd.pages.dev/links.html)
  - ドキュメント群と選挙別リンクの公開一覧。
- [比例系列](https://jp-election-public-ja-2026-hr-smd.pages.dev/party-proportional.html)
  - 比例系列の分析ページ。
- [選挙区系列](https://jp-election-public-ja-2026-hr-smd.pages.dev/party-constituency.html)
  - 選挙区系列の分析ページ。

## 公開 index / map
- [root-ai-router.md](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/root-ai-router.md)
  - この clipboard 用の最小 router 本文。
- [root-ai-router.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/root-ai-router.json)
  - 質問 routing と公開 index を構造化した JSON。
- [page-profile.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/page-profile.json)
  - root page の概要、件数、導線 metadata。
- [page-links.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/page-links.json)
  - ドキュメント group と選挙別 link row の構造化一覧。
- [file-links.tsv](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/file-links.tsv)
  - 公開 canonical / derived file lookup の最初の入口。
- [page/downloads/catalog.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/downloads/catalog.json)
  - bulk download 用 group catalog。
- [page/downloads/all-files.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/downloads/all-files.json)
  - 公開 download 対象のフル一覧。public_key, href, size, sha256 を含む。
- [site-config.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/site-config.json)
  - public docs / analysis / route の index。
- [page/page-ai-catalog-map.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/page-ai-catalog-map.json)
  - 自治体 graph family 用の重い index map。必要な時だけ読む。
- [analysis/graph-family/latest/graph-page.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/analysis/graph-family/latest/graph-page.json)
  - graph family の page contract と scope status。
- [analysis/party-proportional/latest/graph-page.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/analysis/party-proportional/latest/graph-page.json)
  - 比例系列 analysis page contract。
- [docs/graph-family-spec.html](https://jp-election-public-ja-2026-hr-smd.pages.dev/docs/graph-family-spec.html)
  - graph で何ができるかを読む独立公開仕様書。
- [docs/reports/index.html](https://jp-election-public-ja-2026-hr-smd.pages.dev/docs/reports/index.html)
  - 外部 AI / human 向けの分析レポート置き場。
- [docs/reports/index.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/docs/reports/index.json)
  - 分析レポート一覧の JSON index。

## 質問別の読む順序
### 1. site_navigation
- サイト全体の見方、current / graph / data の違い、どこから読むべきかを聞かれた時。
- まず読む:
  - [root-ai-router.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/root-ai-router.json)
  - [page-profile.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/page-profile.json)
- 必要なら追加で読む:
  - [公開トップ](https://jp-election-public-ja-2026-hr-smd.pages.dev/index.html)
  - [現在の公開ページ](https://jp-election-public-ja-2026-hr-smd.pages.dev/index.html)
  - [年度別ページ](https://jp-election-public-ja.pages.dev/years)
  - [Municipality / Graph Explorer](https://jp-election-public-ja-2026-hr-smd.pages.dev/graph.html)
  - [リンク一覧](https://jp-election-public-ja-2026-hr-smd.pages.dev/links.html)
- まず導線を整理し、必要な entry page だけ追加で読む。

### 2. year_or_release_lookup
- 年度別ページ、公開済みページ、現在の release ページに関する質問。
- まず読む:
  - [年度別ページ](https://jp-election-public-ja.pages.dev/years)
  - [現在の公開ページ](https://jp-election-public-ja-2026-hr-smd.pages.dev/index.html)
  - [page-links.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/page-links.json)
- 必要なら追加で読む:
  - [file-links.tsv](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/file-links.tsv)
  - [page/downloads/catalog.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/downloads/catalog.json)
- HTML の route と structured link row を優先する。

### 3. graph_or_municipality_analysis
- 自治体・都道府県・全国の graph、系列、municipality payload に関する質問。
- まず読む:
  - [Municipality / Graph Explorer](https://jp-election-public-ja-2026-hr-smd.pages.dev/graph.html)
  - [analysis/graph-family/latest/graph-page.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/analysis/graph-family/latest/graph-page.json)
- 必要なら追加で読む:
  - [page/page-ai-catalog-map.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/page-ai-catalog-map.json)
  - [docs/graph-family-spec.html](https://jp-election-public-ja-2026-hr-smd.pages.dev/docs/graph-family-spec.html)
  - [file-links.tsv](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/file-links.tsv)
- 重い自治体 map は必要になった時だけ読む。

### 4. canonical_or_derived_file_lookup
- 公開 canonical / derived file を探したい時、CSV / JSON / docs の public URL を知りたい時。
- まず読む:
  - [file-links.tsv](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/file-links.tsv)
  - [page/downloads/all-files.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/downloads/all-files.json)
- 必要なら追加で読む:
  - [page-links.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/page-links.json)
  - [page/downloads/catalog.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/downloads/catalog.json)
  - [site-config.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/site-config.json)
- path を推測せず、index に出た public_key / href を使う。

### 5. spec_or_methodology
- 公開 docs、仕様書、graph の方法論、公開面 contract に関する質問。
- まず読む:
  - [site-config.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/site-config.json)
- 必要なら追加で読む:
  - [docs/graph-family-spec.html](https://jp-election-public-ja-2026-hr-smd.pages.dev/docs/graph-family-spec.html)
  - [リンク一覧](https://jp-election-public-ja-2026-hr-smd.pages.dev/links.html)
  - [page-links.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/page/page-links.json)
- まず docs index を読み、必要な spec だけ開く。

### 6. analysis_reports
- 公開された分析レポート、 commentary、外部 AI 生成物を読みたい時。
- まず読む:
  - [docs/reports/index.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/docs/reports/index.json)
- 必要なら追加で読む:
  - [docs/reports/index.html](https://jp-election-public-ja-2026-hr-smd.pages.dev/docs/reports/index.html)
  - [site-config.json](https://jp-election-public-ja-2026-hr-smd.pages.dev/site-config.json)
- まず reports index で available report を列挙し、必要な report HTML か raw source だけ読む。

## ルール
- 回答前に、どの公開 URL を実際に読んだかを明示する。
- data volume が大きい時は、必要な public artifact だけ追加で読む。
- 全件ロードが不要な質問では catalog / map だけで止める。
- graph 系 join は label ではなく party_id / seriesId / jis_code / election_set_key を優先する。