PHẦN XVII — CLAUDE CODE & VIBE CODE

---

PHẦN XVIIA — CLAUDE CODE: AI HỖ TRỢ CODE & LOGIC

Mục tiêu: Sau khi đọc phần này, NV Vagataba (kể cả không biết code) có thể nhờ Claude viết công thức Excel, phân tích data, tạo logic tự động hoá — mà không cần học lập trình.

---

16.1 Claude Code là gì? (Giải thích cho người không biết code)

Hiểu đơn giản

Một câu giải thích: Claude Code = "phiên dịch" giữa tiếng Việt của bạn và ngôn ngữ máy tính.

💡 Bạn KHÔNG CẦN biết code. Bạn chỉ cần biết bạn muốn gì. Claude sẽ tạo công thức/code cho bạn.

Claude Code có 3 cấp độ (Tier)

Tài liệu này tập trung Tier 1 + 2: Claude giúp bạn xử lý bài toán logic mà không cần bạn biết lập trình.

Khi nào dùng Tier nào?

Bạn cần gì?
├─ Hỏi công thức nhanh / giải thích code → TIER 1 (Chat)
├─ Tạo dashboard / biểu đồ tương tác → TIER 2 (Artifacts)
└─ Xử lý nhiều file / chạy script phức tạp → TIER 3 (CLI) + CAS hỗ trợ

Task liên quan data nhạy cảm / hệ thống? → CHUYỂN CAS/DEV

Khi nào nên dùng / Không nên

---

16.2 Claude hỗ trợ gì liên quan đến "code"?

5 nhóm task "code" mà NV không-biết-code vẫn làm được

Khác biệt: bạn tự làm vs nhờ Claude

---

16.3 Ba nguyên tắc dùng Claude cho logic/kỹ thuật

Nguyên tắc 1: Mô tả BÀI TOÁN, đừng mô tả CODE

❌ Sai: "Viết VLOOKUP cho cột A lookup bảng B range C:D return column 2"

✅ Đúng: "Tôi có 2 bảng: Bảng 1 là danh sách đơn hàng (cột A = mã SP). Bảng 2 là bảng giá (cột A = mã SP, cột B = giá). Tôi muốn tự động điền giá vào Bảng 1 dựa trên mã SP."

💡 Mẹo nhớ: Nói với Claude như nói với đồng nghiệp giỏi Excel — bạn giải thích bài toán, họ viết công thức cho bạn.

Nguyên tắc 2: Test từng bước — Đừng paste cả đống một lúc

Ví dụ test:

Data mẫu:
| Mã SP | Số lượng | Giá | Thành tiền |
| BNK01 | 2        | ?   | ?          |
| BNK02 | 1        | ?   | ?          |

Bảng giá:
| Mã SP | Giá     |
| BNK01 | 799000  |
| BNK02 | 1499000 |

Tôi muốn tự động điền cột Giá (từ bảng giá) và tính Thành tiền = SL × Giá.
Công thức nào cho ô C2 và D2?

Nguyên tắc 3: Không copy mù — Phải hiểu "công thức này làm gì"

Sau khi Claude viết công thức, hỏi thêm:

"Giải thích công thức này bằng tiếng Việt đơn giản, từng phần." "Có gì có thể sai với công thức này không?" "Độ tự tin của bạn với công thức này: bao nhiêu %?"

Ví dụ:

Claude viết: =VLOOKUP(A2,'Bảng giá'!A:B,2,FALSE)

Giải thích:
- VLOOKUP: tìm kiếm giá trị
- A2: tìm mã SP trong ô A2
- 'Bảng giá'!A:B: tìm trong cột A-B của sheet "Bảng giá"
- 2: trả về giá trị ở cột thứ 2 (cột B = giá)
- FALSE: phải khớp chính xác

⚠️ Quy tắc: Nếu bạn không thể giải thích công thức cho đồng nghiệp trong 30 giây → hỏi Claude giải thích lại.

Cảnh báo "Vibe Coding" — KHÔNG copy mù rồi dùng

⚠️ "Vibe coding" là khi bạn nhờ AI viết code/công thức rồi dùng ngay không cần hiểu. Andrej Karpathy (đồng sáng lập OpenAI) cảnh báo: đây là cách dùng nguy hiểm cho công việc thật.

---

16.4 Framework: Problem → Logic → Output

┌──────────────────────────────────────────┐
│         PROBLEM → LOGIC → OUTPUT         │
│                                          │
│   [1] XÁC ĐỊNH BÀI TOÁN                │
│       "Tôi muốn biết/làm gì?"          │
│         ↓                                │
│   [2] VIẾT LOGIC BẰNG TIẾNG VIỆT       │
│       "Nếu A thì B, nếu C thì D"       │
│         ↓                                │
│   [3] CLAUDE CHUYỂN THÀNH CODE/CT       │
│       → Công thức Excel, script,        │
│         template                        │
│         ↓                                │
│   [4] TEST + VERIFY                     │
│       Test với data mẫu, verify output  │
│         ↓                                │
│   [5] DEPLOY                            │
│       Paste vào file thực tế            │
└──────────────────────────────────────────┘

Ví dụ áp dụng:

---

16.5 Ứng dụng thực tế tại Vagataba

Excel / Google Sheets

Task 1: Đối soát COD Viettel Post

Bài toán: Hàng tháng FAS đối soát danh sách COD từ VTP với data nội bộ. Cần biết đơn nào đã thu, chưa thu, lệch.

Prompt mẫu:

Tôi là FAS Vagataba. Đối soát COD tháng 4/2026.

Tôi có 2 bảng:
- Bảng A (data Vagataba): Mã đơn | Khách | SĐT | Tiền COD | Ngày tạo
- Bảng B (data VTP): Mã vận đơn | Tiền thu hộ | Ngày chuyển khoản | Trạng thái

Viết bước đối soát:
1. Match Mã đơn (Bảng A) với Mã vận đơn (Bảng B) — cần công thức gì?
2. Đơn nào có trong A nhưng không có trong B? (chưa giao)
3. Đơn nào tiền COD lệch? (A ≠ B → flag)
4. Tổng tiền VTP đã chuyển khoản vs tổng tiền phải thu?

Output: bảng đối soát + công thức Excel cho từng bước.
Giải thích mỗi công thức bằng tiếng Việt đơn giản.

Task 2: Dashboard KPI Sales hàng tuần

Prompt mẫu:

Tôi là STL Vagataba. Tạo template Google Sheets dashboard KPI Sales tuần.

KPI cần theo dõi:
- Lead mới (từ MKT)
- Lead đã contact (SC)
- Lead chốt đơn (CVR = chốt/contact %)
- Doanh thu (VND)
- Đơn giao thành công
- Đơn RTS + RTS rate
- Response time trung bình (phút)

Yêu cầu:
1. Bảng data input (SC điền hàng ngày)
2. Bảng KPI summary (tự tính từ data input)
3. Traffic light tự động:
   🟢 CVR ≥ 20%, RTS ≤ 15%, Response ≤ 30 phút
   🟡 CVR 10-20%, RTS 15-25%, Response 30-60 phút
   🔴 CVR < 10%, RTS > 25%, Response > 60 phút
4. So sánh tuần này vs tuần trước (% thay đổi)

Output: cấu trúc sheet + công thức cho mỗi ô KPI + conditional formatting rules.

Task 3: Công thức phân loại feedback khách

Prompt mẫu:

Tôi là CSTL. Cần công thức tự động phân loại feedback khách trong Google Sheets.

Cột A = Nội dung feedback (text tiếng Việt)

Logic phân loại:
- Nếu chứa từ: "tốt", "hiệu quả", "hài lòng", "recommend" → "Tích cực"
- Nếu chứa từ: "tạm", "bình thường", "chưa thấy" → "Trung tính"
- Nếu chứa từ: "kém", "không hài lòng", "hoàn tiền", "lừa" → "Tiêu cực"
- Nếu chứa từ: "đau", "bệnh", "thuốc", "bác sĩ", "tác dụng phụ" → "⚠️ Y TẾ - ESCALATE"
- Còn lại: "Chưa phân loại"

Viết công thức cho ô B2 (phân loại dựa trên A2).
Giải thích từng phần.

Phân tích Data

Task 4: Phân tích đơn hàng theo vùng

Prompt mẫu:

Tôi là OM Vagataba. Phân tích data đơn hàng tháng 4.

[paste hoặc upload file data]

Cần biết:
1. Tổng đơn + doanh thu theo Tỉnh/TP (top 10)
2. RTS rate theo vùng (vùng nào hoàn nhiều nhất?)
3. CVR theo campaign source (camp nào convert tốt nhất?)
4. Ngày nào trong tuần bán nhiều nhất?
5. Giờ nào SC chốt đơn nhiều nhất?

Output: 5 bảng phân tích + 3 insight chính + 2 action items.
Format: bảng Markdown, traffic light cho chỉ số xấu.

Task 5: Phân tích hoàn hàng

Prompt mẫu:

Tôi là RC Vagataba. Upload data hàng hoàn tháng 4.

[paste data]

Phân tích:
1. Phân loại A (bán lại) / B (giảm giá) / C (huỷ) / D (claim shipper)
2. Giá trị tồn kho hàng hoàn (VND)
3. Claim shipper: bao nhiêu đã gửi? Bao nhiêu đã thu hồi? Pending?
4. Lý do hoàn top 5 (tần suất + % so với tổng)
5. SC nào có tỷ lệ hoàn cao bất thường?

Output: bảng phân loại + bảng claim tracking + 3 action items (owner + deadline).

Automation nhẹ

Task 6: Chuẩn hoá SĐT

Prompt mẫu:

Tôi có cột SĐT trong Google Sheets, format lộn xộn:
- 0901234567
- 84901234567
- +84 901 234 567
- 901.234.567

Viết công thức chuyển TẤT CẢ về format chuẩn: +84901234567
(bỏ dấu cách, dấu chấm, thêm +84 nếu thiếu)

Cho ô A2, viết công thức cho B2.
Test với 5 trường hợp trên.

Task 7: Tạo mã đơn tự động

Prompt mẫu:

Vagataba cần mã đơn format: VG-YYMMDD-XXX
Ví dụ: VG-260508-001, VG-260508-002...

YY = năm 2 số, MM = tháng, DD = ngày
XXX = số thứ tự trong ngày (reset mỗi ngày)

Viết công thức Google Sheets cho cột Mã Đơn:
- Cột A = Ngày tạo đơn (DD/MM/YYYY)
- Cột B = Mã đơn (tự động)

Giải thích từng phần công thức.

Task 8: Hiểu code/công thức cũ (🆕)

Bài toán: NV trước nghỉ việc, để lại file Excel đầy công thức phức tạp. Bạn không hiểu nó tính gì.

Prompt mẫu:

Giải thích công thức Excel này bằng tiếng Việt đơn giản:

=SUMIFS($D:$D,$B:$B,"Thành công",$C:$C,">="&E2,$C:$C,"<="&F2)

1. Công thức này tính gì?
2. Từng phần ($D:$D, $B:$B, v.v.) là gì?
3. E2 và F2 ảnh hưởng kết quả thế nào?
4. Tôi muốn thêm điều kiện "chỉ tính SP = BNK" — sửa thế nào?

Prompt mẫu — Script Python:

NV trước để lại script Python này:

[paste code]

Giải thích cho người không biết code:
1. Script này làm gì?
2. Cần file input gì?
3. Output ra đâu?
4. Làm sao chạy nó?
5. Tôi muốn sửa [yêu cầu cụ thể] — sửa chỗ nào?

💡 Rất thực tế: Mỗi khi NV nghỉ việc để lại file → nhờ Claude giải thích trước khi hỏi CAS.

Task 9: DVO — COD risk scoring formula (🆕)

Prompt mẫu:

Tôi là DVO Vagataba. Tạo công thức tính điểm rủi ro đơn COD.

Data mỗi đơn:
- Cột A: Giá trị đơn (VND)
- Cột B: Khách mới/cũ ("Mới"/"Cũ")
- Cột C: Giờ đặt (HH:MM)
- Cột D: Tỉnh/TP giao
- Cột E: SC (ai chốt đơn)

Scoring:
- Giá > 1.5tr: +30 điểm
- Khách mới: +20 điểm
- Đặt sau 22h hoặc trước 6h: +25 điểm
- Tỉnh có RTS cao (Đồng Nai, Bình Dương, Long An): +15 điểm
- SC có RTS > 20%: +10 điểm

Phân loại:
- 🟢 Xanh (0-20): Auto approve
- 🟡 Vàng (21-45): Verify kỹ
- 🔴 Đỏ (>45): Gọi 2 lần + lead approve

Công thức cho ô F2 (tổng điểm) và G2 (phân loại).

Task 10: WH — FEFO priority formula (🆕)

Prompt mẫu:

Tôi là WP/WQP Vagataba. Tạo bảng ưu tiên xuất kho theo FEFO.

Data:
- A: Mã SP | B: Tên SP | C: Batch | D: HSD (dd/mm/yyyy) | E: Số lượng | F: Vị trí kho

Tính:
1. Cột G = Số ngày còn lại đến HSD
2. Cột H = Ưu tiên:
   - 🔴 KHẨN: ≤ 7 ngày (xuất ngay hôm nay)
   - 🟠 CAO: 8-30 ngày (ưu tiên tuần này)
   - 🟢 BÌNH THƯỜNG: 31-90 ngày
   - ⬜ THẤP: > 90 ngày
   - ⚫ HẾT HẠN: ≤ 0 ngày (KHÔNG xuất, báo FC)
3. Auto-sort theo Ưu tiên + ngày còn lại (tăng dần)

Công thức cho G2 và H2. Conditional formatting cho từng mức.
In-friendly format cho WP dán tại kệ hàng.

Task 11: RC — Phân loại hàng hoàn A/B/C/D (🆕)

Prompt mẫu:

Tôi là RC Vagataba. Tạo bảng phân loại hàng hoàn tự động.

Data đơn hoàn:
- A: Mã đơn | B: SP | C: Tình trạng bao bì | D: Tình trạng SP | E: Lý do hoàn

Logic phân loại (cột F):
- Loại A (tái nhập bán): bao bì nguyên, SP nguyên, seal chưa mở
- Loại B (giảm giá/xả): bao bì nhẹ móp, SP OK, seal mở nhưng SP chưa dùng
- Loại C (huỷ): bao bì hỏng HOẶC SP bị ẩm/vỡ HOẶC HSD < 3 tháng
- Loại D (claim shipper): lý do = "vỡ khi giao" HOẶC "mất hàng"

Tự động tính:
- Cột G: Giá trị tồn kho (A × giá gốc, B × 50% giá, C = 0, D = claim value)
- Dòng tổng: tổng từng loại + tổng giá trị

Công thức cho F2 và G2. Giải thích logic phân loại.

Task 12: MDM — ROAS dashboard template (🆕)

Prompt mẫu:

Tôi là MDM Vagataba. Tạo template Google Sheets dashboard Facebook Ads.

Data input (MDM điền hàng tuần):
- Campaign name | Spend | Impressions | Clicks | Orders | Revenue

Auto-tính:
1. CPC = Spend / Clicks
2. CTR = Clicks / Impressions × 100
3. CPL = Spend / Orders  
4. ROAS = Revenue / Spend
5. Profit = Revenue - Spend - (Orders × 60k COD fee)

Traffic light:
- 🟢 ROAS ≥ 3 + CPL ≤ 120k → SCALE
- 🟡 ROAS 2-3 HOẶC CPL 120k-180k → GIÁM SÁT
- 🔴 ROAS < 2 HOẶC CPL > 180k → CÂN NHẮC TẮT

So sánh tuần này vs tuần trước (% thay đổi).
Tổng hợp: tổng spend, revenue, ROAS trung bình.

Công thức cho mỗi ô + conditional formatting + chart setup.

Task 13: SDM — SC performance scorecard (🆕)

Prompt mẫu:

Tôi là SDM Vagataba. Tạo bảng so sánh hiệu suất 8 SC.

Data mỗi SC (cột):
- Tên SC | Cuộc gọi/ngày | Connect rate | CVR | AOV | RTS rate | Call duration TB

Cần:
1. Ranking từng KPI (1=tốt nhất, 8=kém nhất)
2. Tổng điểm ranking (SC nào overall tốt/yếu nhất)
3. Traffic light: 
   - 🟢 CVR ≥ 20% + RTS ≤ 15%
   - 🟡 CVR 10-20% HOẶC RTS 15-25%
   - 🔴 CVR < 10% HOẶC RTS > 25%
4. Gap analysis: SC yếu nhất thiếu gì so với SC tốt nhất?
5. Coaching recommendation tự động cho mỗi SC đỏ/vàng

Công thức cho từng ô. Format in được cho meeting weekly SDM-STL.

---

16.6 Giới hạn của Claude Code — Cần biết

5 giới hạn quan trọng

4 cấp độ kiểm tra — Từ đơn giản → nghiêm ngặt

💡 Quy tắc: Công thức đơn giản (VLOOKUP) → Cấp 1. Dashboard KPI team dùng hàng ngày → Cấp 2-3. Script tài chính → Cấp 4.

Prompt validation mẫu — Cấp 1 (dùng cho mọi output code/formula):

Giải thích code/công thức này bằng tiếng Việt đơn giản:

[paste code hoặc công thức]

Trả lời:
1. Nó làm gì?
2. Cần input gì?
3. Có gì có thể sai?
4. Có lệnh nguy hiểm nào không?
5. Tôi nên lo lắng điều gì?

Checklist 8 câu TRƯỚC KHI chạy code/formula từ AI:

• Tôi hiểu code này làm gì? (nếu không → dùng prompt validation ở trên)
• Đã test trên data mẫu (3-5 dòng)?
• Có lệnh nào xoá/sửa file mà tôi không mong muốn?
• Đã hỏi Claude "Có gì có thể sai?"
• Có backup file gốc trước khi paste công thức mới?
• Nếu sai, tôi có thể undo được không?
• Code này dùng cho cá nhân hay business-critical? (→ quyết định cấp kiểm tra)
• Nếu hỏng, tôi có thể tự sửa hoặc nhờ ai sửa được?

💡 In checklist này dán cạnh bàn. Chỉ mất 2 phút nhưng tránh được rủi ro mất data hoặc sai số.

Lệnh nguy hiểm — THẤY LÀ DỮNG, hỏi CAS

⚠️ Nếu thấy lệnh nào trên trong output Claude → KHÔNG chạy → hỏi CAS ngay.

Khi nào DỪNG LẠI, chuyển CAS/Dev?

Progressive Trust Model — Tin tưởng dần, không tin mù

⚠️ KHÔNG BAO GIỜ skip review cho: Code xử lý tiền, data khách, gửi email/tin nhắn, API bên ngoài, code bạn không hiểu.

---

16.7 Claude Code (công cụ) — Dành cho CAS [CẦN XÁC MINH]

⚠️ Phần này dành cho CAS (R03) và team kỹ thuật. NV khác có thể bỏ qua.

Claude Code (terminal tool) là gì?

Claude Code là phần mềm chạy trên terminal máy tính. Khi bạn gõ claude trong terminal, nó:

1. Đọc toàn bộ file/folder trên máy bạn
2. Lên kế hoạch nhiều bước
3. Tự thực thi lệnh
4. Tự sửa lỗi cho đến khi xong

Cho CAS Vagataba, có thể dùng để:

• Viết script Python cho Odoo Server Action
• Debug automation rules (phân tích log)
• Tạo tài liệu kỹ thuật từ code base
• Batch process file data (CSV → report)
• Tạo test plan cho automation mới

CLAUDE.md — File hướng dẫn AI

Tạo file CLAUDE.md trong folder làm việc để AI tự đọc context:

# Vagataba Odoo Configuration

## Tech Stack
- Odoo 17 Community
- Pancake (Facebook integration)
- VTP API (Viettel Post)
- Misa Accounting

## Rules
- KHÔNG thay đổi production data
- Mọi script phải test trên staging trước
- Log mọi thay đổi
- Output bằng tiếng Việt

Yêu cầu cài đặt

---

16.8 Checklist dùng Claude Code an toàn

Cho MỌI NV (viết công thức/phân tích data)

• ✅ Mô tả bài toán bằng tiếng Việt rõ ràng?
• ✅ Cho data mẫu 3-5 dòng?
• ✅ Test công thức trên data mẫu trước khi áp dụng toàn bộ?
• ✅ Hiểu công thức làm gì? (nếu không → hỏi Claude giải thích)
• ✅ Không paste PII/data nhạy cảm?
• ✅ Backup file gốc trước khi paste công thức mới?
• ✅ Kết quả đã verify với 1 đồng nghiệp?

Cho CAS (dùng Claude Code terminal)

• ✅ Chỉ chạy trên staging/test, KHÔNG production?
• ✅ Đã có CLAUDE.md với context + rules?
• ✅ Dùng chế độ Plan trước khi Execute?
• ✅ Mọi script đã được review bởi OM?
• ✅ Log mọi thay đổi?
• ✅ Backup trước khi chạy?

---

16.9 Bảng tóm tắt: Ai dùng gì?

---

16.10 Top 13 công thức hay nhất cho Vagataba

Copy-paste ngay hoặc nhờ Claude customize.

---

Nội dung PHẦN XVII — CLAUDE CODE. Cập nhật 05/2026. Tham chiếu: 03_Nghe_Thuat_Viet_Prompt.md (§3) | 09_Finance_Admin.md (§5.8) | 07_Claude_Projects_Kien_Truc.md (§7)

---

PHẦN XVII — VIBE CODE: AI-ASSISTED CODING CHO DEVELOPER

Mục tiêu: Sau khi đọc phần này, Developer phòng Công Nghệ Vagataba nắm vững khái niệm Vibe Coding, phân biệt rõ khi nào nên/không nên áp dụng, thành thạo AI-assisted coding workflow với Claude Code, và tuân thủ các guardrails an toàn cho production code.

---

17.1 Vibe Coding là gì?

Nguồn gốc & Định nghĩa

Andrej Karpathy (đồng sáng lập OpenAI) đặt ra thuật ngữ "Vibe Coding" vào tháng 2/2025:

"Vibe coding là khi bạn hoàn toàn buông theo cảm giác, quên rằng code tồn tại. Bạn mô tả dự án bằng ngôn ngữ tự nhiên, AI tự sinh code, và bạn chấp nhận output mà không review kỹ."

Tiến hoá: Vibe Coding → Agentic Engineering (2026)

⚠️ Karpathy (2026): Vibe coding giờ đã "passé", thay bằng "Agentic Engineering" cho phát triển chuyên nghiệp.

Cho Developer Vagataba: Phân biệt rõ

---

17.2 Bộ công cụ AI-Assisted Coding cho Developer

So sánh 3 công cụ chính (2026)

Khuyến nghị cho Vagataba Dev Team

Workflow khuyến nghị (Hybrid Approach):
├─ Copilot    → Autocomplete hàng ngày, boilerplate nhanh
├─ Cursor     → Refactoring multi-file, debug phức tạp  
└─ Claude Code → Kiến trúc lớn, phân tích legacy code, batch tasks

💡 Nguyên tắc: Không chọn 1 tool "winner" — dùng kết hợp theo task cụ thể.

Claude Code CLI — Setup cho Dev Vagataba

Cài đặt:

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

Yêu cầu:

Hai chế độ hoạt động:

---

17.3 CLAUDE.md — File hướng dẫn AI cho dự án

Tại sao cần CLAUDE.md?

CLAUDE.md là file context tự động được Claude Code đọc khi bắt đầu session. Nó đóng vai trò như "onboarding doc cho AI junior dev".

Template CLAUDE.md cho Vagataba

# Vagataba Development Context

## Tech Stack
- Odoo 17 Community Edition
- Python 3.10+ (Odoo modules)
- PostgreSQL 14
- Pancake (Facebook integration)
- VTP API (Viettel Post shipping)
- Misa Accounting API

## Coding Standards
- PEP 8 cho Python
- Odoo ORM conventions (recordset, browse, search)
- Docstring bắt buộc cho mọi method public
- Type hints cho parameters và return values

## Rules — KHÔNG ĐƯỢC VI PHẠM
- KHÔNG thay đổi production database trực tiếp
- KHÔNG commit secrets, API keys, passwords
- Mọi script PHẢI test trên staging trước
- Log mọi thay đổi vào changelog
- Output/comment bằng tiếng Việt khi cần

## Project Structure
- /addons/  → Custom Odoo modules
- /scripts/ → Automation scripts
- /tests/   → Unit tests (pytest)
- /docs/    → Technical documentation

## Testing Requirements
- Unit test coverage ≥ 80%
- Integration test cho mọi API endpoint
- Test với data tiếng Việt (Unicode)

## Git Workflow
- Branch naming: feature/xxx, fix/xxx, hotfix/xxx
- Commit message: conventional commits (feat:, fix:, docs:)
- PR require ≥ 1 reviewer

AGENTS.md — Guardrails cho AI Agent

Ngoài CLAUDE.md, tạo thêm AGENTS.md để định nghĩa rõ ràng các quy tắc:

# AI Agent Guidelines

## Forbidden Patterns
- KHÔNG sử dụng eval() hoặc exec()
- KHÔNG hardcode credentials
- KHÔNG xoá file không qua confirmation
- KHÔNG modify migration files đã chạy

## Allowed Operations
- Đọc file trong project scope
- Tạo file mới trong /addons/ và /scripts/
- Chạy pytest
- Chạy linting (flake8, pylint)

## Escalation Triggers
- Khi cần thay đổi database schema → Hỏi Lead Dev
- Khi cần access production → Hỏi OM
- Khi không chắc chắn → Dừng lại, hỏi

---

17.4 Agentic Engineering Workflow

📌 Nội dung Agentic Engineering đã được tách thành module riêng — xem chi tiết tại §18 (file 18_Agentic_Engineering.md). File 18 bao gồm: 4 Design Patterns (Andrew Ng), MCP Protocol, Google Antigravity, Cursor, Windsurf, Multi-Agent Orchestration, Safety & Governance, và 8+ khóa đào tạo hàng đầu.

Best Practices từ các khóa đào tạo hàng đầu

(Tổng hợp từ Anthropic Academy, DeepLearning.AI, DataCamp, và cộng đồng developer)

Ví dụ thực tế — Tạo Odoo Server Action

Bước 1: Plan (spec.md)

## Feature: Auto-flag đơn COD rủi ro cao

### Mục tiêu
Tự động flag đơn COD có risk score ≥ 70 điểm

### Logic
- Khách mới + đơn > 1.5tr VND = +40 điểm
- Đặt sau 22h = +15 điểm
- Vùng có RTS cao = +15 điểm
- Nhiều đơn cùng SĐT trong 24h = +20 điểm

### Input
- Model: sale.order
- Trigger: on_create

### Output  
- Field: x_risk_score (Integer)
- Field: x_risk_level (Selection: low/medium/high)
- Notification: Gửi cho DVO nếu high risk

Bước 2: Prompt Claude Code

Đọc spec.md trong folder hiện tại.
Implement Server Action cho Odoo 17 theo spec.
- Tạo module mới trong /addons/cod_risk_scoring/
- Viết unit test coverage ≥ 80%
- Tuân thủ CLAUDE.md rules
- Giải thích mỗi hàm bằng docstring tiếng Việt

Bước 3: Review checklist

• Logic scoring đúng theo spec?
• Unit test cover edge cases?
• Không hardcode giá trị (dùng config parameter)?
• Performance OK với 1000+ đơn/ngày?
• Rollback plan nếu cần disable?

---

17.5 Rủi ro thực tế & Bài học cảnh báo

5 rủi ro lớn nhất của AI-generated code

Lệnh nguy hiểm — THẤY LÀ DỪNG

⚠️ Quy tắc Vagataba: Nếu AI output chứa lệnh trên → KHÔNG chạy → review kỹ → hỏi Lead Dev.

Bài học từ Shopify (2026)

"AI-written code increased production bugs because human reviewers were less thorough."

Nguyên nhân: Dev tin AI → review qua loa → bug lọt vào production.

Giải pháp Vagataba:

• Code AI viết = code của Junior Dev → review nghiêm ngặt như nhau
• PR từ AI cần ít nhất 1 human reviewer
• Automated test phải pass trước khi review

---

17.6 Progressive Trust Model — Tin tưởng dần

KHÔNG BAO GIỜ skip review cho:

• Code xử lý tiền (COD, payment, accounting)
• Code access database production
• Code gửi email/SMS/notification
• Code gọi external API (VTP, Pancake, Misa)
• Code bạn không hiểu 100%

---

17.7 Khóa đào tạo được đánh giá cao (2026)

📌 Danh sách đầy đủ 8+ khóa đào tạo Agentic Engineering hàng đầu thế giới + lộ trình học cho Dev Vagataba — xem §18.7 (file 18_Agentic_Engineering.md). Bao gồm: Andrew Ng (DeepLearning.AI), Anthropic Academy, Google AI Studio (Antigravity), Udacity Nanodegree, Vanderbilt/Coursera, Udemy (Ed Donner), Scrimba, LangChain Academy.

---

17.8 Khi nào cần Developer (vs. AI tự làm)?

Escalation Matrix

Mô hình cộng tác AI + Developer

NV non-tech (Tier 1-2)          Developer (Tier 3)
     │                                │
     │ Prototype / Tool cá nhân       │
     │ (Claude.ai Chat/Artifacts)     │
     │                                │
     ├─── Nếu hữu ích ──────────────►│
     │                                │ Review code
     │                                │ Security check
     │                                │ Performance test
     │                                │ Production deploy
     │◄── Feedback + hướng dẫn ───────┤
     │                                │
     │ Tiếp tục cải tiến              │ Monitor + maintain

💡 Quote (Cat Wu, Anthropic): "It's still very much up to the individual who merges it to be responsible for well-maintained, well-documented code with reasonable abstractions."

---

17.9 Git Workflow với AI — Safety Net

Git là "bảo hiểm" cho AI coding

Boris Cherny (Lead Engineer, Anthropic): "Is writing a file ever unsafe if you have version control?"

Workflow chuẩn:

# 1. Trước khi AI thay đổi
git add . && git commit -m "pre-AI: working state"

# 2. Cho AI làm việc (Claude Code)
claude "implement feature X theo spec.md"

# 3. Review diff
git diff

# 4a. Nếu OK → commit
git add . && git commit -m "feat: AI-implemented feature X"

# 4b. Nếu KHÔNG OK → rollback
git reset --hard HEAD

# 5. Push + PR
git push origin feature/xxx
# Tạo PR → Review → Merge

Branch Strategy cho AI-assisted development

---

17.10 Checklist dùng Vibe Code an toàn

Cho Developer — Trước khi dùng AI viết code

• ✅ Đã tạo spec.md/PRD cho feature?
• ✅ Đã có CLAUDE.md + AGENTS.md trong project?
• ✅ Đã commit working state trước khi AI thay đổi?
• ✅ Task đã chia nhỏ đủ cụ thể?
• ✅ Không yêu cầu AI access production?

Cho Developer — Sau khi nhận code từ AI

• ✅ Đã đọc và HIỂU mọi dòng code?
• ✅ Không có lệnh nguy hiểm (rm, DROP, eval)?
• ✅ Không hardcode secrets/credentials?
• ✅ Unit test coverage ≥ 80%?
• ✅ Security scan pass (SAST/SCA)?
• ✅ Test với data tiếng Việt (Unicode)?
• ✅ Performance OK với volume dự kiến?
• ✅ Đã review diff trước khi commit?

Cho Developer — Trước khi deploy

• ✅ Test trên staging thành công?
• ✅ PR đã được ≥ 1 người review?
• ✅ Có rollback plan?
• ✅ Monitoring/alerting đã setup?
• ✅ Documentation đã cập nhật?

---

17.11 Bảng tóm tắt: Developer dùng gì, khi nào?

---

Nội dung Phần XII — Vibe Code: AI-Assisted Coding cho Developer. Cập nhật 05/2026. Tham chiếu: 17_Claude_Code_Vibe.md (§9) | 11_Claude_Cowork.md (§8) | 04_Quy_Trinh_An_Toan_Kaizen.md (§5) Nguồn: Anthropic Academy, DeepLearning.AI, Andrej Karpathy, Simon Willison, BCG AI Survey, KPMG/HBS Study