# Docs Index

## 📖 Code Documentation (実装ファイル)
**各実装ファイルのヘッダに詳細コメントあり（機構説明・チューニング方法）**

- **[`../hakmem_pool.c`](../hakmem_pool.c)** — L2 Mid Pool実装（2-32KB）
  - サイズクラステーブル、W_MAX、CAP、TLS構造の説明
  - パフォーマンスチューニング推奨値
- **[`../hakmem_l25_pool.c`](../hakmem_l25_pool.c)** — L2.5 Large Pool実装（64KB-1MB）
  - 32-64KBギャップ問題の解説
  - W_MAX_LARGE緩和の重要性
- **[`../hakmem_policy.c`](../hakmem_policy.c)** — ポリシー初期化
  - CAP初期値の設計思想（保守的 vs パフォーマンス優先）
  - W_MAX設計思想（切り上げ許容倍率のトレードオフ）
- **[`../hakmem_learner.c`](../hakmem_learner.c)** — バックグラウンド学習
  - 4つの学習アルゴリズム（CAP、Budget/Water-filling、W_MAX UCB1、DYN1/DYN2）
  - 環境変数一覧と使用例

## 📋 Specs (仕様書)

- specs/
  - CURRENT_SPEC.md — 現在の実装仕様（SACS‑3、学習、ENV）
  - ENV_VARS.md — 環境変数の一覧と意味

## 📊 Benchmarks (ベンチマーク)

- benchmarks/
  - README.md — 計測の流れ、保存場所、命名規則
  - 2025-10-22_SWEEP_NOTES.md — 本日の要約（抜粋と再現コマンド）

## 🗺️ Roadmap (ロードマップ)

- roadmap/
  - ROADMAP.md — 次の実装方針・優先順位・タスク

## 📌 Status (実装状況)

- status/
  - **PHASE_6.20_RESULTS_2025_10_24.md** — 綺麗綺麗ベンチマーク大作戦結果（Phase 2改善3施策の効果測定）
  - IMPLEMENTATION_STATUS_2025_10_22.md — 実装状況と計画A/Bの照合
  - PHASE_6.18_L25_TUNING_2025_10_23.md — L2.5 リモート＋バッチ吸上げ＋計測強化の要約
  - PHASE_6.17_BUMP_RUN_2025_10_23.md — Mid リンクしないリフィル導入とA/B/Head‑to‑Head要約