Create comprehensive design specifications for Phase v11a (MID v3.5): 1. PHASE_V11A_DESIGN_MID_V3.5.md - Decision rationale: Option A chosen (consolidation vs expansion) - MID v3.5 architecture: unified 257-1KiB box - Role clarification: v7 frozen as research preset - Learner v2 scope: multi-class tracking, C5 ratio primary decision - Segment design decision: shared segment (Design B) vs separate segments - Stats expansion: per-class efficiency metrics - API changes: minimal, backward compatible 2. PHASE_V11A_IMPLEMENTATION_ROADMAP.md - Detailed task breakdown for v11a-1, v11a-2, v11a-3 - File structure: new boxes, implementation files, modified files - Concrete function signatures and integration points - Benchmark commands and expected performance - Dependency graph and implementation order - Build/Makefile changes needed - Testing strategy and regression checks Key Design Decisions: - Multi-class segment uses shared 2MiB segment (not separate) - Per-class free page stacks for efficient refill - Stats published per-page retire (for Learner ingestion) - TLS version-based cache invalidation (atomic policy updates) - Backward compatibility: Policy v2 extends v1 interface Next Step: Phase v11a-2 (Core Implementation) - Implement segment creation/alloc/free - Add C7 support to existing MID_v3 - Stats recording during page retire - Learner aggregation logic 🤖 Generated with Claude Code Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
Docs Overview
このフォルダは hakmem の設計・計測・運用メモを体系化して管理する場所です。
- INDEX.md: 目次(各ドキュメントへのリンク)
- benchmarks/: ベンチマーク手順とスイープ結果の保存先
- specs/: 現在の仕様(SACS‑3/HW/ENV)を集約
- roadmap/: これからの実装計画・優先度・タスク
運用ルール(提案)
- 1つの変更/計測のまとまりにつき1ファイル(or 1フォルダ)
- 再現コマンド・環境変数・ハード構成は必ず記載
- 大きな連続出力はファイルへ保存し、本文からは抜粋/要約を記載