Tóm tắt nhanh:
ak-folder-contextviết một fileCLAUDE.mdngắn trong thư mục con bạn chỉ định, kèmAGENTS.mdtrỏ về cùng nội dung, chỉ ghi quy ước và quyết định agent không tự đoán ra từ code. Nó không có skill tiếp theo: bạn duyệt và sửa bản nháp. Nó không đụngCLAUDE.mdhayAGENTS.mdở gốc project, việc đó thuộcak-docs agent-context.
Công khai: mình là maintainer của AgentKit và có quan hệ affiliate: link AgentKit trong bài là link affiliate, mua qua link này bạn được giảm 30%.
Tóm tắt
Dùng khi một thư mục có luật riêng mà agent hay làm sai vì không biết, khi muốn bổ sung vào file ngữ cảnh bạn đã viết, hoặc khi vừa sửa file đó và muốn soát chỗ mâu thuẫn. Không cần khi thư mục chỉ chứa file tĩnh như icon hay dữ liệu mẫu, khi bạn muốn sửa file ở gốc project, hay khi viết tài liệu trong docs/.
flowchart LR
A["Thư mục con có quy ước riêng"] --> B["ak-folder-context"]
B --> C["CLAUDE.md + AGENTS.md trong thư mục đó"]
B --> D["Dừng: thư mục không cần file"]
E["Thư mục gốc project"] --> F["ak-docs agent-context"]Nó giữ 4 nguyên tắc:
| Nguyên tắc | Câu hỏi | Ví dụ |
|---|---|---|
| Cổng kiểm tra | Thư mục này có thật sự cần file ngữ cảnh không? | src/payments/ có luật "không gọi thẳng API ngân hàng, luôn qua lớp gateway" thì cần. fixtures/ chỉ chứa dữ liệu mẫu tĩnh thì không, agent tự mở ra đọc khi cần. |
| Chỉ ghi điều có bằng chứng | Nội dung trong file lấy từ đâu? | Từ code, cấu hình, file Markdown trong thư mục, hoặc quyết định bạn nói rõ trong prompt. Nó không tự nghĩ ra ràng buộc, không ghi secret, và bỏ hẳn mục nào không có gì để ghi. |
| Kế thừa từ gốc, không chép lại | File của thư mục khác gì file ở gốc? | Luật chung của project đã nằm ở gốc thì file thư mục không nhắc lại. Đường vận hành như cách deploy hay chỗ xem log cũng không viết vào đây, chỉ để link tới hướng dẫn vận hành đang giữ nó. |
| Một nội dung, hai tên file | Vì sao có cả CLAUDE.md và AGENTS.md? | AGENTS.md là symlink tới CLAUDE.md, nên bạn chỉ sửa một chỗ. Máy không tạo được symlink thì nó tạo AGENTS.md một dòng ghi tên CLAUDE.md, và báo bạn biết. |
Nó viết bản nháp vào thư mục ngay rồi đưa bạn duyệt, chỉ dừng lại hỏi khi xung đột với nội dung bạn đã viết hoặc việc ghi đè cần bạn quyết định. Bạn sửa file sau đó thì nó chỉ ra chỗ mâu thuẫn, không tự hoàn tác phần bạn sửa.
Prompt mẫu cho module có luật riêng:
/ak-folder-context src/payments
Ghi lại: mọi lệnh gọi ngân hàng phải qua src/payments/gateway, không gọi thẳng SDK.
Số tiền luôn lưu bằng số nguyên đơn vị nhỏ nhất, không dùng số thực.
Quyết định ngày <ngày>: webhook chỉ xử lý idempotent theo mã giao dịch.Skill này không có cờ.
Phần dưới đây là bản chi tiết: luồng chạy, 5 tình huống kèm prompt, cách truyền tuỳ chọn khi skill không có cờ, lịch sử thay đổi theo bản ak và các lỗi hay vấp. Bản chi tiết và trang trực quan dành cho subscriber. Agent của bạn cũng tìm được trong đó qua MCP của portal.
Mở khi tài khoản có quyền subscriber
Bài này dành cho subscriber
Khi tài khoản có quyền, toàn bộ bài, bản visual tương tác và lệnh gọi từ agent đều mở.
- Đăng nhập hoặc tạo tài khoản modernEngineerQuyền đọc gắn với email tài khoản.
- Chọn gói trên trang Bảng giáGói 1, 3 hoặc 12 tháng, trả bằng chuyển khoản VietQR. Quyền đọc mở khoảng một phút sau khi tiền về.
- Hoặc nhập mã Facebook subscriberNgười ủng hộ trang qua Facebook nhận mã kích hoạt qua tin nhắn mỗi tháng.
Đã là subscriber? Đăng nhập để đọc.
Dùng bài này trong agent của bạn
Lấy API keyChép đoạn dưới, dán vào Claude Code, Codex hay agent bạn đang dùng. Agent đọc bài rồi đối chiếu với repo đang mở.
Đọc bài "ak-folder-context: ghi ngữ cảnh riêng cho một thư mục con" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "ak-folder-context". Nếu chưa nối MCP server modernengineer, dừng lại và hướng dẫn tôi nối theo https://modernengineer.dev/vi/mcp.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.Nối MCP cho Claude Code (một lần)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Đọc trọn bài qua MCP cần API key của tài khoản subscriber hoặc đã mua guide này. Không có quyền, agent sẽ chỉ đọc được phần mở đầu.
- Phiên bản
- v1.0.0
- Cập nhật
- 22/10/2026
- Giấy phép
- Bảo lưu mọi quyền
- Slug
- ak-folder-context
