10 vaccine trong CLAUDE.md đã giúp tôi giảm lỗi production

Cập nhật lần cuối: 19/06/2026

Vaccine là quy tắc cố định trong CLAUDE.md — AI đọc trước mỗi session, giảm lỗi lặp lại. Tôi ghi 10 vaccine đã giảm lỗi production từ ~40% xuống <5%.

Cluster: Hệ thống prompt Zola · QA Gatekeeper

10 vaccine tôi dùng

Vaccine 1: Frontmatter Zola bắt buộc

+++
title = "..."
description = "..."
date = 2026-06-19
[taxonomies]
tags = ["..."]
+++

Lỗi trước: AI quên +++ hoặc sai field → build fail.

Vaccine 2: Slug = lowercase, dấu gạch ngang

Quy tắc: bhxh/vssid-khong-hien-bhtn — không underscore, không tiếng Việt có dấu.

Vaccine 3: Internal link ≥ 3 mỗi bài

Mỗi bài phải link pillar + 2 bài cùng cluster + 1 bài cross-cluster.

Vaccine 4: Giọng first-person (Tôi…)

E-E-A-T yêu cầu Experience. Cấm giọng encyclopedia "Bảo hiểm thất nghiệp là…" mở đầu.

Vaccine 5: Không bịa số liệu

Nếu không có nguồn → ghi "theo kinh nghiệm tôi" hoặc "tham khảo VssID".

Vaccine 6: Bảng tóm tắt đầu bài

Mỗi pillar có bảng tóm tắt trong 200 từ đầu — featured snippet.

Vaccine 7: FAQ cuối bài (schema-ready)

≥ 3 câu H3 dạng câu hỏi + câu trả lời ngắn đầu tiên.

Vaccine 8: Code block có ngôn ngữ

```json
{ ... }
```

Không để plain ``` cho JSON-LD.

Vaccine 9: Không xóa code unrelated

Khi sửa file, chỉ diff phần liên quan — không refactor lan.

Vaccine 10: Chạy build trước khi commit

python site/build.py

Nếu fail → không merge.

Kết quả đo lường

Liên kết

• Prompt system Zola
• QA Gatekeeper
• FAQ Schema