27 quy ước, được tinh chỉnh thủ công

Triết lý

Chúng tôi xuất phát từ những cách mà code do AI sinh ra thực sự hỏng: kiểu any âm thầm, lỗi bị nuốt, các trạng thái bất hợp lệ chạm tới được qua trường tùy chọn, sự cố runtime do dữ liệu chưa được kiểm tra. Mỗi quy tắc được viết để đẩy mô hình rời xa một trong những kiểu hỏng đó — và chỉ giữ lại trong thư viện nếu nó cải thiện rõ rệt code mà agent tạo ra.

Mỗi quy tắc đều ngắn gọn, có chính kiến và độc lập. Agent của bạn chỉ đọc một quy tắc khi sắp thực hiện thay đổi liên quan — không phải đọc tất cả ở đầu phiên làm việc. Điều đó đồng nghĩa với prompt nhỏ hơn, hóa đơn nhẹ hơn, và các quy tắc mà mô hình thực sự có thể giữ trong bộ nhớ làm việc trong lúc viết code.

Có gì trong thư viện

Thư viện hiện tại gồm 27 quy ước, bao phủ các mảng mà TypeScript do AI sinh ra hay sai nhất: độ chặt chẽ về kiểu, xử lý lỗi, kiểm tra runtime tại các ranh giới tin cậy, đặt tên và cấu trúc module, luồng điều khiển, và các pattern đặc thù theo framework (ví dụ: hình dạng prop của React component, quy ước Prisma model).

Các quy tắc cụ thể chỉ dành cho người đăng ký thông qua MCP server — chúng tôi không công bố toàn bộ danh sách ở đây. Hãy đăng ký để truy cập toàn bộ kho quy ước.

Cập nhật

Chúng tôi bổ sung và tinh chỉnh quy ước theo sự thay đổi của công cụ và hành vi mô hình bên dưới. Cập nhật được áp dụng tức thì: bạn không cần triển khai lại bất cứ thứ gì. Các thay đổi lớn sẽ được thông báo cho người đăng ký qua email.