Lưu quy ước thư mục con với ak:folder-context

Dùng ak:folder-context khi một thư mục con có quyết định hoặc quy ước bền vững mà agent trong tương lai không thể suy ra đáng tin cậy. Skill đề xuất một local instruction file ngắn gọn, chờ bạn duyệt, rồi tạo CLAUDE.md cùng AGENTS.md được liên kết trong thư mục đã xác nhận.

Chọn ak:folder-context cho hướng dẫn cục bộ bền vững

Dùng ak:folder-context khi

• Một thư mục con có quy tắc naming, architecture, workflow hoặc safety khác với project root.
• Locked decision hoặc ongoing work phải tồn tại qua nhiều session.
• Agent trong tương lai cần bản đồ ngắn về các local file thiết yếu cùng vai trò.
• Bạn muốn guidance tương thích Claude và AGENTS dùng chung một nguồn.

Chọn workflow khác khi

• Bạn cần project instruction ở root. Hãy dùng ak:docs agent-context; Skill này không bao giờ sửa CLAUDE.md hoặc AGENTS.md ở root.
• Thư mục chỉ chứa tài liệu tham khảo tĩnh hoặc context có thể dễ dàng khám phá khi cần.
• Bạn đang viết project documentation được publish dưới docs/; hãy dùng docs workflow của project.
• Bạn chỉ cần session note tạm thời thay vì agent guidance bền vững.

Chuẩn bị target folder

Trước khi bắt đầu:

• Hoàn thành Làm quen và xác nhận Engineer Kit đã được cài cho đúng runtime cùng scope bạn đang dùng.
• Nêu một thư mục con hiện có làm target.
• Giữ nguyên instruction hiện tại cùng mọi work không liên quan.
• Sẵn sàng xác nhận outline đề xuất trước khi tệp được ghi.
• Loại credential và secret khác khỏi mọi context bạn cung cấp.

Xem Runtime adapter để hiểu khác biệt về delivery cùng từng loại component.

Yêu cầu local context

Skill nhận một target-folder argument. Skill không có mode flag được công bố hay automatic-write mode: duyệt outline là một phần của workflow.

/ak:folder-context packages/payments

/ak:folder-context packages/payments

$ak:folder-context packages/payments

Request hữu ích có thể thêm bằng chứng như “capture provider naming rules, constraint unit test không dùng network và quyết định giữ giá trị tiền tệ dưới dạng integer minor unit.” Target vẫn là positional folder argument; các chi tiết này định hướng việc kiểm tra cùng outline đề xuất.

Hiểu điều gì xảy ra trong một lần chạy

1. Skill xác thực target. Skill xác nhận path là thư mục con, không phải project root, và đọc local instruction hiện có trước.
2. Skill kiểm tra bằng chứng cục bộ. Skill review source, configuration, Markdown cùng context file chính cần để hiểu thư mục.
3. Skill áp dụng sanity gate. Skill bỏ qua thư mục có context tĩnh hoặc dễ khám phá thay vì tạo tệp không cần thiết.
4. Skill đề xuất outline. Skill chỉ nhóm section hữu ích và chờ bạn xác nhận trước khi ghi.
5. Skill ghi nguồn bền vững. Skill tạo local CLAUDE.md ngắn gọn từ bằng chứng trong thư mục cùng quyết định rõ của người dùng, bỏ section rỗng.
6. Skill liên kết companion file. Skill tạo AGENTS.md dưới dạng symlink tới CLAUDE.md; nơi không hỗ trợ symlink, Skill ghi pointer một dòng và báo fallback.
7. Skill tôn trọng chỉnh sửa sau đó. Nếu bạn sửa context, Skill đọc lại tệp và nêu mâu thuẫn mà không revert công việc của bạn.

Nội dung hữu ích gồm purpose của thư mục, essential file với vai trò một dòng, constraint cục bộ, naming convention cùng locked decision có ngày. Skill ưu tiên bullet tập trung thay vì generic prose hoặc file tree được sao chép.

Giữ quyền kiểm soát tệp

• Skill chỉ ghi trong thư mục con đã xác nhận.
• Skill không lặp lại root instruction hoặc tạo constraint không được local evidence hỗ trợ.
• Skill không đưa credential vào context file.
• Local instruction hiện có cùng chỉnh sửa của người dùng vẫn authoritative.
• Symlink thay đổi cách hai path resolve về một nguồn; hãy review effect này trước khi duyệt, đặc biệt trên platform hỗ trợ symlink hạn chế.
• Workflow chỉ nêu local read và write, không nêu network access, external provider, paid service, commit, push, publication hay deployment. Hãy duyệt riêng mọi follow-up như vậy nếu runtime đề xuất.

Xác minh kết quả

Một lần chạy hoàn tất nên cung cấp:

• CLAUDE.md ngắn gọn trong thư mục con được yêu cầu.
• Symlink AGENTS.md resolve tới tệp đó, hoặc pointer một dòng fallback được công bố.
• Nội dung dựa trên tệp đã kiểm tra hoặc quyết định bạn cung cấp rõ ràng.
• Không sửa root instruction hay tệp ngoài target đã xác nhận.
• Báo cáo path đã tạo, hành vi fallback cùng mọi mâu thuẫn còn cần giải quyết.

Kiểm tra cả hai path cùng link hoặc pointer trước khi dựa vào context trong session sau. Skill này không định nghĩa automated test suite riêng; bằng chứng có thể quan sát là nội dung tệp, path boundary cùng hành vi link.

Xử lý sự cố hoặc tiếp tục

Tiếp tục với Project, artifact và checkpoint khi bạn cần model rộng hơn cho công việc bền vững.

Biết các giới hạn hiện tại

• Chất lượng phụ thuộc local evidence hữu ích cùng quyết định rõ; Skill không thể suy ra policy chưa được ghi lại một cách đáng tin cậy.
• Output chủ ý ngắn gọn và không thay thế project docs hoặc root governance.
• Việc tạo symlink phụ thuộc capability của filesystem cùng platform.
• Root context có workflow riêng cần xác nhận trong ak:docs agent-context; Skill này tiếp tục chỉ dành cho thư mục con.