# COMBAT ROOM: TRUNG TÂM TÁC CHIẾN & LƯU TRỮ BIÊN BẢN HỌP FREEEXILE

> **Định vị**: Nơi lưu trữ, phân loại và chuyển hóa toàn bộ biên bản các cuộc họp (Hội đồng sáng lập, Toàn thể công ty, Liên phòng ban, Chuyên môn nội bộ, Tác chiến sự cố nóng) thành **Kho Tri Thức Hành Động (Actionable Knowledge Base)** của toàn công ty.  
> **Nguyên tắc vận hành**: Zero-Lip-Service, Machine-Readable Metadata, 100% Action Item Tracking, Phân quyền nghiêm ngặt.

---

## 1. MỤC TIÊU & TRIẾT LÝ VẬN HÀNH

Hầu hết biên bản họp ở các doanh nghiệp trở thành "nghĩa địa tài liệu" vì 4 lý do:
1. **Không có cấu trúc máy đọc được**: Tìm kiếm khó khăn, không trích xuất được quyết định.
2. **Không theo dõi hành động (Lost Action Items)**: Họp xong không ai theo dõi ai làm gì, deadline khi nào, dẫn đến buổi họp sau lại lặp lại vấn đề cũ.
3. **Mất dấu ngữ cảnh quyết định (Lost Architecture Decisions)**: Sau vài tháng không ai nhớ *tại sao* tính năng hay kiến trúc lại được thiết kế như vậy.
4. **Phân quyền hỗn loạn**: Tài liệu mật bị lộ hoặc tài liệu hữu ích cho toàn công ty lại bị giấu kín trong tin nhắn cá nhân.

**Combat Room** tại FreeExile giải quyết triệt để 4 vấn đề trên thông qua:
- **Cấu trúc phân cấp 5 tầng thư mục**: Phản ánh chính xác cơ cấu tổ chức và mức độ bảo mật.
- **Chuẩn hóa Metadata Frontmatter YAML**: Mỗi biên bản đều có thông số chuẩn để máy và con người cùng hiểu.
- **Công cụ tự động hóa `tools/knowledge/combat_room_sync.py`**: Tự động quét biên bản, tổng hợp Sổ Theo Dõi Hành Động (`ACTION_ITEMS_TRACKER.md`), Sổ Cái Quyết Định (`DECISION_REGISTER.md`), và Bản Đồ Từ Khóa (`TOPIC_TAXONOMY.md`).
- **Tích hợp Bộ Nhớ Agent Mem0**: Tự động chuyển giao các quyết định chiến lược vào bộ nhớ dài hạn của trợ lý AI để mọi đề xuất kỹ thuật sau này không bị trôi lệch (Zero-Drift).

---

## 2. CẤU TRÚC PHÂN CẤP THƯ MỤC (DIRECTORY ARCHITECTURE)

```
combat_room/
│
├── README.md                           # Bản chỉ dẫn này (Tổng quan & nguyên tắc)
├── PERMISSIONS.md                      # Ma trận phân quyền chi tiết (5 cấp bảo mật, RACI)
├── .permissions.json                   # Cấu hình phân quyền máy đọc được (Policy Engine)
│
├── 00_executive/                       # Ban Giám Đốc, Hội đồng Sáng lập, Chiến lược tối mật
├── 01_all_hands/                       # Họp toàn thể công ty, Town Hall, Kickoff Milestone
├── 02_cross_dept/                      # Họp liên phòng ban, tích hợp tính năng đa khối
├── 03_incidents_war_room/              # Tác chiến sự cố nóng, Post-mortem, Diễn tập bảo mật
│
├── 04_departments/                     # Không gian chuyên trách từng phòng ban
│   ├── game_design/                    # Khối Thiết Kế Game, Cân Bằng Võ Học & Kinh Tế Hoang Dã
│   ├── engineering_server/             # Khối Máy Chủ, Actor Model, Hạ Tầng & CSDL
│   ├── engineering_client/             # Khối Client iOS Apple Metal 120Hz & WebApp Simulation
│   ├── art_and_audio/                  # Khối Mỹ Thuật Cổ Võ 2.5D, Animation, VFX & m Thanh
│   ├── security_anti_cheat/            # Khối Bảo Mật Độc Lập, Red/Blue Team & Chống Dupe Đồ
│   ├── qa_testing/                     # Khối Đảm Bảo Chất Lượng, Bot Swarm Simulation & TDD
│   └── localization_and_docs/          # Khối Bản Địa Hóa 9 Ngữ, Kiến Trúc Tri Thức & Wiki
│
├── _templates/                         # Bộ mẫu biên bản họp chuẩn mực (Markdown + YAML)
│   ├── TEMPLATE_GENERAL_MEETING.md     # Mẫu họp thảo luận & đồng bộ định kỳ (Sync Meeting)
│   ├── TEMPLATE_DECISION_ADR.md        # Mẫu họp chốt quyết định kiến trúc / chiến lược
│   ├── TEMPLATE_INCIDENT_WAR_ROOM.md   # Mẫu họp mổ xẻ sự cố khẩn cấp (War Room Post-Mortem)
│   └── TEMPLATE_SPRINT_RETROSPECTIVE.md# Mẫu họp cải tiến quy trình & tổng kết Sprint
│
└── _indexes/                           # Hub tri thức tự động (Được sinh tự động từ script)
    ├── README.md                       # Hướng dẫn tra cứu tri thức
    ├── ACTION_ITEMS_TRACKER.md         # Sổ theo dõi toàn bộ đầu việc hành động
    ├── DECISION_REGISTER.md            # Sổ cái toàn bộ quyết định chiến lược đã chốt
    └── TOPIC_TAXONOMY.md               # Bản đồ từ khóa tri thức & tra cứu theo tags
```

---

## 3. QUY ƯỚC ĐẶT TÊN TỆP BIÊN BẢN (NAMING CONVENTIONS)

Tên tệp biên bản bắt buộc tuân theo quy tắc:
```text
YYYYMMDD_[PHÒNG_BAN/LOẠI_HÌNH]_[chủ_đề_ngắn_gọn_không_dấu].md
```

### Ví dụ chuẩn:
- `00_executive/20261015_EXEC_ngan_sach_phat_hanh_ios.md`
- `01_all_hands/20261001_ALL_HANDS_q4_kickoff_and_milestones.md`
- `02_cross_dept/20261002_CROSS_DEPT_feral_totem_delegation_sync.md`
- `03_incidents_war_room/20261002_INCIDENT_postmortem_2pc_redis_network_partition.md`
- `04_departments/engineering_server/20261003_SRV_actor_model_spatial_partitioning.md`
- `04_departments/game_design/20261004_DSG_15_tier_affix_balance.md`

---

## 4. QUY TRÌNH BIẾN BIÊN BẢN THÀNH TRI THỨC HỮU DỤNG

```mermaid
flowchart TD
    M1["1. Chuẩn Bị & Họp"] -->|"Chọn template trong _templates/"| M2["2. Lập Biên Bản"]
    M2 -->|"Điền YAML Frontmatter + Action Items"| M3["3. Lưu Vào Thư Mục Tương Ứng"]
    M3 -->|"Commit Git hoặc Chạy Sync Tool"| M4["4. Engine Tự Động Hóa Tri Thức<br/>(tools/knowledge/combat_room_sync.py)"]
    M4 -->|"Trích xuất Task"| I1["_indexes/ACTION_ITEMS_TRACKER.md"]
    M4 -->|"Trích xuất Quyết định"| I2["_indexes/DECISION_REGISTER.md"]
    M4 -->|"Trích xuất Tags"| I3["_indexes/TOPIC_TAXONOMY.md"]
    M4 -->|"Đồng bộ Vector"| I4["Mem0 / AI Memory (Nhận thức dài hạn)"]
```

### 3 Bước Vàng Sau Mỗi Cuộc Họp:
1. **Thư ký/Chủ trì** nhân bản một mẫu từ `_templates/` vào thư mục phù hợp, cập nhật Frontmatter và nội dung.
2. **Gán mã rõ ràng**:
   - Quyết định: `DEC-[MÃ_HỌP]-[STT]` (ví dụ: `DEC-MTG-20261002-SRV-01`).
   - Đầu việc: `ACT-[MÃ_HỌP]-[STT]` (ví dụ: `ACT-MTG-20261002-SRV-01`).
3. **Chạy đồng bộ tri thức**:
   ```bash
   python tools/knowledge/combat_room_sync.py
   ```
   Toàn bộ bảng theo dõi, chỉ mục và bộ nhớ Agent sẽ lập tức được cập nhật mà không cần ai phải sao chép thủ công.