Làm việc với AI

Claude Code, Cursor, GitHub Copilot hay Codex tự đọc AGENTS.md, nên biết cấu trúc, lệnh và quy ước của site mà không cần giải thích lại.

AI đọc gì

Mở thư mục của mẫu bằng Claude Code, Cursor, GitHub Copilot hoặc Codex. Các công cụ này tự đọc AGENTS.md (Claude Code đọc qua CLAUDE.md, file chỉ trỏ tới AGENTS.md). File này viết bằng tiếng Anh và nói site có gì, lệnh nào chạy việc gì, section viết ra sao và các quy ước phải giữ.

Ngoài AGENTS.md, AI đọc thêm CONTEXT.md (tình trạng hiện tại, việc còn bỏ ngỏ) và PRODUCT.md (việc kinh doanh của site) khi cần viết nội dung.

Ví dụ yêu cầu

"Thêm trang Ưu đãi giống trang Dịch vụ, cả tiếng Việt và tiếng Anh, rồi thêm vào menu."
"Đổi màu nhấn sang xanh lá và kiểm lại độ tương phản."
"Cập nhật FEATURES.md và CONTEXT.md theo thay đổi vừa làm."

Mẹo

Nói rõ cả hai ngôn ngữ khi nhờ thêm trang hay sửa chữ: mỗi trang có một file trong vi/ và một file cùng tên trong en/.

Kiểm tra sau khi AI sửa

Nhờ AI chạy các lệnh kiểm tra, hoặc tự chạy:

Terminal

pnpm test
pnpm check
pnpm contrast   # khi đổi màu

Sau khi build, pnpm zero-js, pnpm nul-bytes, pnpm preview-parity và pnpm seo-check phải đạt, và không trang nào hiện dòng chữ “object Object” trong ngoặc vuông.

Cảnh báo

Chữ rich text trong content/ phải là chuỗi markdown. AI ghi một object vào đó thì trang in ra dòng chữ “object Object” trong ngoặc vuông.

Giữ tài liệu đúng với code

Mỗi khi thêm hay bỏ một tính năng, nhờ AI cập nhật FEATURES.md và CONTEXT.md trong cùng lần commit, và ghi ảnh hay font mới vào CREDITS.md.