Phase V6-HDR 総括: ドキュメント整備 + v6 凍結宣言

## ドキュメント更新内容

1. CURRENT_TASK.md
   - V6-HDR-0~4 を 1 ブロックに集約(実装完了)
   - 性能推移サマリー(-3.5%~-8.3% → ±0% に回復)
   - 最終ベンチマーク結果(C6-heavy + Mixed)
   - 凍結宣言: v6 は研究箱として OFF がデフォルト

2. AGENTS.md
   - 「研究箱ポリシー: SmallObject v6」セクション追加
   - v6 の現在地・凍結ルール・ハンドリング条件を明示
   - 「基本的な設計目標達成 → 今後リソースは mid/pool へ」の方針を宣言

## 成果総括

### Headerless 設計検証
- RegionIdBox (分類のみ) + TLS-scope cache で ±数% baseline 相当
- 複数フェーズでボトルネック除去(P0: double validation → P1: page_meta cache)
- 実装可能性が実証された

### 設計成果物(参考価値あり)
- RegionIdBox 薄層設計(ptr→(kind, page_meta) のみ)
- Same-page TLS cache(64KiB page level の最適化)
- TLS-scope segment registration(マルチセグメント対応時の基盤)

### 凍結方針
- デフォルト OFF(ENV opt-in)
- バグ修正・基盤伝播以外は触らない
- mid/pool v3 による C6-heavy 改善に注力

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
This commit is contained in:
Moe Charm (CI)
2025-12-12 00:23:54 +09:00
parent ce372cfc7e
commit fbaaf232ae
2 changed files with 93 additions and 59 deletions

View File

@ -108,6 +108,36 @@ ACE/ELO/CAP Learner などの「学習する機能」も、Tiny や Superslab
- AGENTS.md では「学習は必ず別箱」「ホットパスを汚さない」「ENV で切り戻せる」というルールだけを守る。
---
## 研究箱ポリシー: SmallObject v6Headerless 設計検証)
SmallObject v6C6-only headerless allocationは、「header elimination の実現可能性」を実証する**研究箱**です。以下のルールで管理します。
### v6 の現在地
- **状態**: 凍結(デフォルト OFF、ENV opt-in の研究用)
- **性能**: baseline ±数% で相当 = 基本的な設計目標は達成
- **設計成果**:
- RegionIdBox が薄く保たれたptr 分類のみ)
- TLS-scope segment registration + same-page cache で lookup overhead を軽減
- Headerless allocation が実装可能なことを実証
### 凍結後の方針
1. **コード保持**: v6 実装コードは削除しない。参考設計として保持。
2. **デフォルト OFF**: デフォルトプロファイルには一切関与しない。
3. **研究用のみ**: ENV 環境変数 `HAKMEM_SMALL_HEAP_V6_*` で明示的に有効化する場合のみ動作。
4. **今後のリソース**: v6 の P2/P3 最適化は後回しに。mid/pool v3 による C6-heavy 本格改善に注力する。
5. **ドキュメント**: SmallObject v6 の詳細は `docs/analysis/SMALLOBJECT_CORE_V6_DESIGN.md` に集約。CURRENT_TASK.md は概要のみ。
### 凍結をすり抜ける条件
v6 に手を入れるのは以下の場合に限定:
- クリティカルなバグ修正deadlock / segfault
- 基盤TLS 登録、segment allocationに関わる変更の伝播
- 「mid/pool v3 で成功した パターンを v6 にも適用」といった、mid と v6 の共通化
---
## Tiny 向け「積み方 v2」(層を下から固める)