Kế hoạch Tái cấu trúc docs/ — Dry Run

Ngày: 26/09/2026 | Trạng thái: DRY-RUN (chưa thực hiện)
Ảnh hưởng: ~30 file .md cần đổi tên/di chuyển, ~15 file cần sửa cross-references


1. Nguyên tắc đổi tên

Quy tắc Ví dụ
Xóa prefix số cũ (01_, 02_...) 02_BAO_CAO... → BAO_CAO...
snake_case VIẾT HOA không dấu Phụ lục 8_ Hướng dẫn... → PHU_LUC_8_HUONG_DAN_AI_TAO_SINH.md
Tên phản ánh nội dung, không phải thứ tự 09_PROMPT_DEEP_RESEARCH_KIEN_TRUC_PROJECT.md → giữ nguyên (đã rõ nghĩa)
File mới tạo (10_ANALYSIS, 10_ROADMAP) → giữ nguyên Vừa tạo, tên đã chuẩn

2. Bảng Ánh xạ Đổi tên & Di chuyển

2.1 docs/research/requirements/

File hiện tại Tên mới Hành động
01_YEU_CAU_GOC_VA_LICH_SU_NGHIEN_CUU.md YEU_CAU_GOC.md Đổi tên
Phu luc 6_ Báo cáo kết quả...docx.md PHU_LUC_6_MAU_BAO_CAO_KET_QUA.md Đổi tên
Phụ lục 3_Hướng dẫn ghi nhật ký.docx.md PHU_LUC_3_HUONG_DAN_GHI_NHAT_KY.md Đổi tên
Phụ lục 8_ Hướng dẫn sử dụng AI tạo sinh.docx.md PHU_LUC_8_HUONG_DAN_AI_TAO_SINH.md Đổi tên

2.2 docs/research/reports/

File hiện tại Tên mới Hành động
02_BAO_CAO_NGHIEN_CUU_TONG_THE.md BAO_CAO_NGHIEN_CUU_TONG_THE.md Đổi tên
03_TOM_TAT_DE_CUONG_NGHIEN_CUU.md DE_CUONG_NGHIEN_CUU.md Đổi tên
08_TOAN_BO_NOI_DUNG_NGHIEN_CUU.md TONG_HOP_NGHIEN_CUU_ARCHIVE.md Đổi tên (rõ là archive)
11_OBSIDIAN_VS_RAG_DEEP_RESEARCH.md DEEP_RESEARCH_OBSIDIAN_VS_RAG.md Đổi tên
12_DEEP_RESEARCH_CAMERA_QUAN_SAT_CU_DONG.md DEEP_RESEARCH_CAMERA.md Đổi tên
14_CHIEN_LUOC_BAO_VE_AI_PL8.md CHIEN_LUOC_BAO_VE_PL8.md Đổi tên

2.3 docs/research/plans/

File hiện tại Tên mới Hành động
10_KIEN_TRUC_VA_KE_HOACH_TRIEN_KHAI.md KIEN_TRUC_DU_AN.md Đổi tên
10_ROADMAP.md ROADMAP.md Đổi tên
10_ANALYSIS.md PHAN_TICH_DU_AN.md Đổi tên
CAMERA_MODULE_TASK_BOARD.md Giữ nguyên —
_DANH_GIA_TONG_THE_KE_HOACH.md Giữ nguyên Đã có _ prefix = internal
_DANH_GIA_TONG_THE_KE_HOACH_V2.md Giữ nguyên Đã có _ prefix
_PHUONG_AN_NANG_CAP_V6_CAMERA.md Giữ nguyên Đã có _ prefix
task_list.txt Giữ nguyên —
W1–W21 folders Giữ nguyên —

2.4 docs/research/references/

File hiện tại Tên mới Hành động
07_NGUON_THAM_KHAO_VA_GHI_CHU_XUAT.md NGUON_THAM_KHAO.md Đổi tên

2.5 docs/research/prompts/ — 14 files

File hiện tại Tên mới Hành động
Tất cả 14 file 09_PROMPT_... → 20_PROMPT_... Xóa prefix số, giữ PROMPT_ Đổi tên hàng loạt

Ví dụ: 09_PROMPT_DEEP_RESEARCH_KIEN_TRUC_PROJECT.md → PROMPT_DEEP_RESEARCH_KIEN_TRUC_PROJECT.md

Prompts là file tham khảo, ít ai link đến. Rủi ro thấp.

2.6 Di chuyển file giữa thư mục

File Vị trí hiện tại Vị trí mới Lý do
OUTLINE_BAO_CAO_15_TRANG.md docs/reports/final/ docs/research/reports/ Đây là outline nghiên cứu, không phải report cuối
W1_D06_VoiceUX_Notes.md docs/design/ docs/research/plans/W1/ Thuộc deliverable W1

2.7 Thư mục gộp/xóa

Thư mục Trạng thái Hành động
docs/architecture/ Trống Xóa (nội dung kiến trúc đã ở research/plans/)
docs/gates/ Trống Xóa (gate tracking đã ở research/plans/)
docs/reports/final/ 1 file → di chuyển Xóa sau khi di chuyển OUTLINE
docs/reports/weekly/ Kiểm tra Giữ nếu có nội dung

3. Cross-references cần cập nhật

File chứa link Số links cần sửa Ghi chú
docs/INDEX.md ~15 File bản đồ dự án — nhiều link nhất
docs/research/00_MUC_LUC.md ~13 Mục lục nghiên cứu
AGENTS.md ~5 Link đến file 10, glossary
README.md ~5 Link đến reports, plans
docs/research/plans/KIEN_TRUC_DU_AN.md ~12 File kiến trúc — nhiều internal links
docs/research/plans/ROADMAP.md ~8 Roadmap links
docs/research/plans/PHAN_TICH_DU_AN.md ~5 Analysis links
docs/research/reports/TONG_HOP_NGHIEN_CUU_ARCHIVE.md ~10 Archive — section markers
docs/diary/2026-09-23.md → 2026-09-25.md ~4 mỗi file Diary entries
docs/project/project_charter.md ~1 Link đến camera report
docs/guides/HUONG_DAN_ANTIGRAVITY_CXK.md ~4 Link đến plans
docs/research/plans/CAMERA_MODULE_TASK_BOARD.md ~1 Link đến camera report

4. Thứ tự thực hiện (nếu duyệt)

  1. Bước 1: Đổi tên tất cả file (dùng git mv hoặc Move-Item)
  2. Bước 2: Di chuyển OUTLINE và VoiceUX
  3. Bước 3: Xóa thư mục trống
  4. Bước 4: Cập nhật cross-references (script Python quét + replace)
  5. Bước 5: Chạy check_structure.py + check_glossary.py
  6. Bước 6: Cập nhật 00_MUC_LUC.md, INDEX.md, README.md
  7. Bước 7: Ghi diary

5. Rủi ro

Rủi ro Mức Giảm thiểu
Gãy cross-reference Cao Script Python quét toàn bộ .md files
Mất file trên shared drive Trung bình Dùng copy → verify → delete (không dùng move)
AGENTS.md link sai Cao Kiểm tra thủ công sau
Obsidian graph bị vỡ Thấp Obsidian tự rebuild graph

Ước lượng: ~15–20 phút thực thi + 5 phút kiểm tra.
Bấm Proceed để thực hiện.