hakorune/docs/development/current/main/01-JoinIR-Selfhost-INDEX.md

JoinIR / Selfhost INDEX（読み始めガイド）

Status: Active
Scope: JoinIR と Selfhost（Stage‑B/Stage‑1/Stage‑3）に関する「最初に読むべき現役ドキュメント」だけを集約した入口。

このファイルは、JoinIR と Selfhost ラインの主戦場をすばやく把握するためのインデックスだよ。
歴史メモや詳細な Phase 文書に飛ぶ前に、まずここに載っている現役ドキュメントから辿っていくことを想定しているよ。

---

1. まず全体像だけ掴みたいとき

• JoinIR 全体像（SSOT）
  • docs/development/current/main/joinir-architecture-overview.md
• Selfhost / Stage‑B〜3 の代表フロー
  • docs/development/current/main/selfhost_stage3_expected_flow.md
• 「いまどこまで進んでいるか」の現状サマリ
  • docs/development/current/main/10-Now.md
    • 「JoinIR / Loop / If ライン」
    • 「JsonParser / Selfhost depth‑2 ライン」

---

2. JoinIR をこれから触る人向け

JoinIR の箱構造と責務、ループ/if の lowering パターンを把握したいときの読み順だよ。

1. JoinIR の基本設計（SSOT）
   • docs/development/current/main/joinir-architecture-overview.md
2. ループパターン空間とパターン番号の意味
   • docs/development/current/main/loop_pattern_space.md
3. Boundary / ExitLine / Carrier の具体パターン
   • docs/development/current/main/joinir-boundary-builder-pattern.md
4. 代表的な Phase 文書（現役ラインとの接点だけ絞ったもの）
   • docs/development/current/main/phase33-16-INDEX.md
   • docs/development/current/main/phase33-17-joinir-modularization-analysis.md
   • docs/development/current/main/phase183-selfhost-depth2-joinir-status.md

Phase 文書は歴史や検証ログも含むので、「JoinIR の現役設計を確認した上で、必要なときだけ掘る」という前提で読んでね。

---

3. Selfhost（Stage‑B / Stage‑1 / Stage‑3）を触る人向け

自己ホストコンパイラのフローや実行手順、Ny Executor ラインの計画を押さえたいときの読み順だよ。

1. Selfhost 全体フロー（Stage‑B / Stage‑1 / Stage‑3 と JSON v0）
   • docs/development/current/main/selfhost_stage3_expected_flow.md
2. 実行手順・クイックスタート
   • docs/development/selfhosting/quickstart.md
   • docs/development/testing/selfhost_exe_stageb_quick_guide.md
3. Ny Executor（Ny で MIR(JSON v0) を実行）のロードマップ
   • docs/development/roadmap/selfhosting-ny-executor.md
4. Stage‑3 / depth‑2 関連で「現役」として参照する Phase 文書
   • docs/development/current/main/phase150_selfhost_stage3_depth1_baseline.md
   • docs/development/current/main/phase150_selfhost_stage3_depth1_results.md
   • docs/development/current/main/phase183-selfhost-depth2-joinir-status.md
   • docs/development/current/main/phase120_selfhost_stable_paths.md

---

4. 迷ったときの読み分けガイド

• JoinIR の箱や契約で迷っているとき
  • → 2章の 1〜3 をこの順番で読む。
• Selfhost のビルド / 実行フローで迷っているとき
  • → 3章の 1〜3 をこの順番で読む。
• 「この Phase 文書は現役か？」で迷ったとき
  • → まず docs/development/current/main/10-Now.md と
    docs/development/current/main/30-Backlog.md を確認し、そこで名前が挙がっている Phase 文書を優先して読んでね。