Prompt Deep Research — Rà soát Conflict & Đồng bộ docs/

Chế độ: Viết mới
Phạm vi: 58 file .md trong docs/ (trừ plans/W*/)
Triển khai: 4 subagent song song

Prompt hoàn chỉnh — Sẵn copy

## Nhiệm vụ

Rà soát toàn bộ file .md trong thư mục docs/ (trừ plans/W*/) để
tìm và XỬ LÝ các vấn đề:
1. Nội dung conflict v4.0 vs v5.0
2. Cross-reference hỏng (link đến file đã xoá)
3. Thuật ngữ sai so với AGENTS.md
4. Thông tin vai trò/thời gian lỗi thời
5. File không còn cần thiết

---

## Bối cảnh quan trọng — Thay đổi v4.0 → v5.0

Dự án CXK vừa chuyển từ v4.0 (16 tuần) sang v5.0 (21 tuần).
Nhiều file trong docs/ vẫn còn thông tin v4.0. Các conflict chính:

| Khía cạnh | v4.0 (CŨ — SAI) | v5.0 (MỚI — ĐÚNG) |
|---|---|---|
| Số tuần | 16 tuần | 21 tuần |
| Kiến trúc | RAG + ChromaDB + Vector DB | Context Loading (Markdown → Gemini 1M) |
| Sprint mapping | S1=W1-2, S2=W3-4... (8 sprint × 2w) | S1=W1-2, S2=W3-5, S3=W6-8... |
| Mục tiêu KC | ≥80 KC Sprint 2 | 25+25+22 KC qua Sprint 2-4 |
| Frontend | W5-6 | W15-16 |
| Pilot | W13-14 | W17-19 |
| Báo cáo | W15-16 | W20-21 |
| File tham chiếu | 04_KE_HOACH_TRIEN_KHAI_16_TUAN.md | 10_KIEN_TRUC_VA_KE_HOACH_TRIEN_KHAI.md |

---

## Quy trình — Cho MỖI file .md

### Bước 1: Đọc và kiểm tra 5 loại vấn đề

**1A. Conflict v4.0 vs v5.0:**
Tìm các pattern lỗi thời:
- "16 tuần" → phải là "21 tuần"
- "RAG", "ChromaDB", "vector", "embedding" → GĐ1 không dùng
- "Sprint 2 = W3-W4" → sai (Sprint 2 = W3-W5)
- "≥80 KC tuần 4" → sai (≥80 KC tuần 11)
- Reference đến file `04_KE_HOACH_*` → đã xoá
- Reference đến file `MASTER_PLAN_v3*` → đã xoá
- Reference đến file `W*_TASK_BOARD_CHI_TIET.md` → đã xoá

**1B. Cross-reference hỏng:**
Kiểm tra mọi link Markdown `<code>📄 text</code>` xem file đích còn tồn tại.
Chú ý đặc biệt: link đến file đã xoá trong phiên dọn dẹp hôm nay.

**1C. Thuật ngữ sai AGENTS.md:**
| Sai | Đúng |
|---|---|
| knowledge item/card | thẻ tri thức |
| evidence item | thẻ bằng chứng |
| red flag (không giải thích) | cờ đỏ (red flag) |
| safety layer (không giải thích) | bộ lọc an toàn (safety layer) |
| tác giả | NCS / Nghiên cứu sinh |
| pipeline | quy trình (pipeline) |
| benchmark (không giải thích) | bộ kiểm thử chuẩn (benchmark) |

**1D. Vai trò lỗi thời:**
- Tên cũ nhà bảo trợ → "Công ty Vaga"
- "Tác giả" → "Nghiên cứu sinh" / "NCS"
- GVHD sai tên hoặc thiếu

**1E. File không còn cần:**
- File chỉ chứa redirect notice
- File duplicate (cùng nội dung ở 2 nơi)
- File draft đã có phiên bản chính thức

### Bước 2: Phân loại và Hành động

Mỗi finding thuộc 1 trong 3 nhóm:

| Nhóm | Hành động | Ví dụ |
|---|---|---|
| 🔴 **Sửa ngay** | Sửa trực tiếp trong file | "16 tuần" → "21 tuần" |
| 🟡 **Xoá file** | Xoá file rác/lỗi thời | Redirect stub |
| 🟢 **Ghi nhận** | Không sửa, chỉ ghi vào báo cáo | File cần NCS quyết định |

### Bước 3: Thực hiện sửa

- **Sửa thuật ngữ:** Dùng replace trong file
- **Sửa reference:** Cập nhật link sang file mới
- **Sửa số liệu v4.0:** Cập nhật theo v5.0
- **Xoá file rác:** Remove-Item
- GIỮ NGUYÊN nội dung đúng, chỉ sửa phần conflict

### Bước 4: Tạo báo cáo

Gửi message với bảng tổng kết:
```markdown
## Báo cáo Rà soát [Nhóm X]

### Findings
| # | File | Loại | Vấn đề | Hành động | Status |
|---|---|---|---|---|---|
| 1 | file.md | 🔴 Conflict | "16 tuần" | Sửa → "21 tuần" | ✅ Đã sửa |
| 2 | file.md | 🟡 Xoá | Redirect stub | Xoá | ✅ Đã xoá |

### Thống kê
- Tổng file kiểm tra: X
- Findings: X
- Đã sửa: X
- Đã xoá: X
- Chờ NCS: X

Ràng buộc

1. KHÔNG xoá file có nội dung chính thức: project_charter.md,
   intended_use.md, GLOSSARY.md, 10_KIEN_TRUC_*.md, diary entries.
2. KHÔNG sửa nội dung y khoa — chỉ sửa metadata/thuật ngữ.
3. Source of truth: 10_KIEN_TRUC_VA_KE_HOACH_TRIEN_KHAI.md (v5.0).
4. Thuật ngữ: Theo AGENTS.md. Không tạo thuật ngữ mới.
5. Diary entries: Chỉ kiểm tra link, không sửa nội dung ghi nhận.
   ```

Phân nhóm triển khai