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:
30
AGENTS.md
30
AGENTS.md
@ -108,6 +108,36 @@ ACE/ELO/CAP Learner などの「学習する機能」も、Tiny や Superslab
|
||||
- AGENTS.md では「学習は必ず別箱」「ホットパスを汚さない」「ENV で切り戻せる」というルールだけを守る。
|
||||
|
||||
|
||||
---
|
||||
|
||||
## 研究箱ポリシー: SmallObject v6(Headerless 設計検証)
|
||||
|
||||
SmallObject v6(C6-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」(層を下から固める)
|
||||
|
||||
Reference in New Issue
Block a user