a9ddb52ad4
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>
40 lines
2.2 KiB
Markdown
40 lines
2.2 KiB
Markdown
# 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（本ファイル）
|
||
|
||
## 次のステップ（最小）
|
||
1) ルート直下の *.md を上記パターンに沿って一括移動（mv/rename）。古いものは archive へ。
|
||
2) `docs/INDEX.md` に主要ファイルだけリンクする（全部は貼らない）。
|
||
3) `README.md` に「詳細は docs/INDEX.md を参照」と一文を追記。
|
||
4) 移動後にリンクチェック（必要なら sed で修正）。
|
||
|
||
備考: 大量の D 状態のファイルはユーザー作業を尊重し、復元しない。移動は現存ファイルのみ対象。
|