Lối tắt dễ mắc
Thư mục nào cũng nên có hướng dẫn.
Cách làm đúng
Thư mục tĩnh hoặc tự giải thích được thì không nên có file ngữ cảnh mới.
Tóm tắt nhanh / Lệnh
Bộ Marketing
/ak:folder-context
Tạo CLAUDE.md cục bộ gọn và AGENTS.md liên kết chỉ khi thư mục con có quy ước bền vững mà agent sau không tự suy ra được.
Xác nhận thư mục
Đọc bằng chứng cục bộ
Kiểm tra có đáng tạo
Đề xuất dàn ý
Nguyên tắc 01
Ngữ cảnh cục bộ phải gọn, cụ thể và có giá trị lâu dài.
Nguyên tắc 02
Chỉ tạo ngữ cảnh khi agent sau không thể suy ra từ file gần đó.
Nguyên tắc 03
Nguồn hợp lệ chỉ gồm bằng chứng trong thư mục và quyết định người dùng đã xác nhận.
Nguyên tắc 04
Hướng dẫn gốc repo và tài liệu dự án thuộc về skill khác.
Các nhánh chính từ đầu vào đến kết quả, bám theo cách command chạy khi dùng thật.
Khởi động
Đầu vào, phạm vi, route
Xử lý
Agent / skill thực thi
Kiểm chứng
Gate, review, xác thực
Đóng
Báo cáo, bàn giao, artifact
Mỗi mục đối chiếu một lối tắt dễ mắc với cách làm đúng mà skill yêu cầu.
Lối tắt dễ mắc
Thư mục nào cũng nên có hướng dẫn.
Cách làm đúng
Thư mục tĩnh hoặc tự giải thích được thì không nên có file ngữ cảnh mới.
Lối tắt dễ mắc
Chép luật gốc cho chắc.
Cách làm đúng
Chép lại hướng dẫn gốc sẽ gây lệch. Chỉ giữ điểm khác biệt cục bộ và bền vững.
Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.
/ak:folder-context src/components/forms /ak:folder-context src/features/checkout /ak:folder-context src/i18n