Phase 1 完了:環境変数整理 + fprintf デバッグガード ENV変数削除(BG/HotMag系): - core/hakmem_tiny_init.inc: HotMag ENV 削除 (~131 lines) - core/hakmem_tiny_bg_spill.c: BG spill ENV 削除 - core/tiny_refill.h: BG remote 固定値化 - core/hakmem_tiny_slow.inc: BG refs 削除 fprintf Debug Guards (#if !HAKMEM_BUILD_RELEASE): - core/hakmem_shared_pool.c: Lock stats (~18 fprintf) - core/page_arena.c: Init/Shutdown/Stats (~27 fprintf) - core/hakmem.c: SIGSEGV init message ドキュメント整理: - 328 markdown files 削除(旧レポート・重複docs) 性能確認: - Larson: 52.35M ops/s (前回52.8M、安定動作✅) - ENV整理による機能影響なし - Debug出力は一部残存(次phase で対応) 🤖 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
2.2 KiB
2.2 KiB
Docs Reorganization Plan (P2.x)
目的: ルート直下に散在する Markdown を docs/ 配下に集約し、カテゴリ別に検索しやすくする。実ファイルの削除・復元はせず、移動方針とマッピングを明示する。
方針
- ルートには README/AGENTS/ビルド・ラン入口のみを残し、それ以外は
docs/に移す。 - 既存の削除/改変は触らない(ユーザー作業を壊さない)。
- 最新・有用な文書だけを
analysis/design/status/benchmarks/specs/roadmapに残し、古いものはdocs/archive/へ。 - インデックスは
docs/INDEX.mdをエントリーポイントにする。
カテゴリ
- analysis/ — 調査・RCA・ベンチ結果
- design/ — 仕様・設計・アーキテクチャ
- benchmarks/ — ベンチ手順・結果
- status/ — 進捗・フェーズまとめ
- roadmap/ — 今後の方針/優先順位
- specs/ — ENV・BUILD 等のリファレンス
- archive/ — 旧版/履歴/退避
移動ガイド(パターン)
*_REPORT.md,*_ANALYSIS.md,ROOT_CAUSE*.md→docs/analysis/またはdocs/archive/analysis/*_PLAN.md,*_DESIGN.md,SPEC*.md→docs/design/またはdocs/specs/*_STATUS.md,*_SUMMARY.md,PHASE*_*.md→docs/status/- ベンチ結果・手順 (
BENCH*,PERF*,LARSON*,RANDOM_MIXED*) →docs/benchmarks/ - 古い/不要なもの →
docs/archive/(サブフォルダは任意: analysis, design, status など)
ルートに残すもの
- README.md(概要)
- AGENTS.md(箱理論・協働ルール)
- build/run 系の入口(build.sh, run_* scripts など)
- DOCS_REORG_PLAN.md(本ファイル)
次のステップ(最小)
- ルート直下の *.md を上記パターンに沿って一括移動(mv/rename)。古いものは archive へ。
docs/INDEX.mdに主要ファイルだけリンクする(全部は貼らない)。README.mdに「詳細は docs/INDEX.md を参照」と一文を追記。- 移動後にリンクチェック(必要なら sed で修正)。
備考: 大量の D 状態のファイルはユーザー作業を尊重し、復元しない。移動は現存ファイルのみ対象。