/f5-classify

description: Classify input files by type using content-first analysis, detect gaps, and generate coverage declaration
argument-hint: <path> [--dry-run] [--lang=vi|en|all] [review|approve]

/f5-classify - Input Classification Command V3.0

Phân loại input files (Excel, documents) theo type, detect gaps, và tạo Coverage Declaration.

> **Version:** 3.0 (Content-First Classification) > **Nguyên tắc:** AI support - Human decide > **Thay đổi chính:** Phân loại dựa trên NỘI DUNG file thay vì tên file

---

🎯 VAI TRÒ CỦA F5-CLASSIFY

┌─────────────────────────────────────────────────────────────────────────────────┐
│  f5-classify KHÔNG PHẢI là bước tạo spec                                        │
│  f5-classify KHÔNG quyết định đúng/sai nội dung                                 │
├─────────────────────────────────────────────────────────────────────────────────┤
│  VAI TRÒ ĐÚNG:                                                                  │
│  ✅ Phân loại tài liệu theo type (dựa trên CONTENT)                             │
│  ✅ Trích xuất thông tin có cấu trúc                                            │
│  ✅ Khai báo độ bao phủ (Coverage Declaration)                                  │
│  ✅ Khai báo chất lượng (Classification Quality Level)                          │
│  ✅ Khai báo giới hạn kỹ thuật (Technical Limitations)                          │
│  ✅ Gắn cờ rủi ro (Missing Sections, Low Confidence)                            │
│  ✅ Chuẩn hoá input cho các phase phía sau                                      │
├─────────────────────────────────────────────────────────────────────────────────┤
│  QUYẾT ĐỊNH CUỐI CÙNG: BA / DEV / Tech Lead                                     │
└─────────────────────────────────────────────────────────────────────────────────┘

---

🆕 WHAT'S NEW IN V3.0

| Feature | V2.1 | V3.0 | |---------|------|------| | Classification method | Name-based (tên file) | **Content-first** (nội dung) | | Accuracy | Phụ thuộc naming convention | Dựa trên nội dung thực tế | | Confidence | Based on name pattern match | Based on content analysis depth | | Fallback | None | Name-based khi không đọc được content |

---

🧠 CLASSIFICATION LOGIC V3.0 - CONTENT-FIRST

╔═══════════════════════════════════════════════════════════════════════════╗
║  CLASSIFICATION PRIORITY                                                  ║
╠═══════════════════════════════════════════════════════════════════════════╣
║                                                                           ║
║  PRIORITY 1: Content-based (ƯU TIÊN)                                      ║
║  ─────────────────────────────────────                                    ║
║  Đọc nội dung file → Phân tích → Xác định loại                           ║
║  Confidence: HIGH                                                         ║
║                                                                           ║
║  PRIORITY 2: Name-based (FALLBACK)                                        ║
║  ─────────────────────────────────                                        ║
║  Chỉ dùng khi KHÔNG đọc được content                                      ║
║  Confidence: LOW (cần human verification)                                 ║
║                                                                           ║
╚═══════════════════════════════════════════════════════════════════════════╝

CLASSIFICATION FLOW

┌─────────────────────────────────────────────────────────────────────────────────┐
│                         CLASSIFICATION FLOW V3.0                                 │
├─────────────────────────────────────────────────────────────────────────────────┤
│                                                                                  │
│  INPUT FILE                                                                      │
│      │                                                                           │
│      ▼                                                                           │
│  ┌─────────────────────────────┐                                                │
│  │ Có thể đọc content không?   │                                                │
│  │ (MCP Excel / CSV / PDF)     │                                                │
│  └─────────────────────────────┘                                                │
│      │                                                                           │
│  ┌───┴───┐                                                                       │
│  │       │                                                                       │
│ YES      NO                                                                      │
│  │       │                                                                       │
│  ▼       ▼                                                                       │
│ ┌─────────────────┐  ┌─────────────────┐                                        │
│ │ CONTENT-BASED   │  │ NAME-BASED      │                                        │
│ │ ANALYSIS        │  │ FALLBACK        │                                        │
│ │                 │  │                 │                                        │
│ │ 1. Read content │  │ 1. Parse name   │                                        │
│ │ 2. Analyze      │  │ 2. Match rules  │                                        │
│ │ 3. Determine    │  │ 3. Determine    │                                        │
│ │                 │  │                 │                                        │
│ │ Confidence:     │  │ Confidence:     │                                        │
│ │ HIGH/MEDIUM     │  │ LOW             │                                        │
│ └─────────────────┘  └─────────────────┘                                        │
│      │                    │                                                      │
│      └────────┬───────────┘                                                      │
│               ▼