Imported from MinhLam577/InterviewForge (AGENTS.md). Install upstream with npx skills add MinhLam577/InterviewForge. Copyright stays with the author.

Hướng dẫn cho Agent (Master Guide)

Hệ thống quy định, quy trình làm việc và bộ công cụ của Agent được quản lý tập trung tại thư mục workspace .agents/.

1. Nguyên tắc cốt lõi toàn dự án

• Ưu tiên tài liệu nội bộ: Luôn tra cứu và sử dụng các tài liệu trong thư mục hiện tại trước khi tìm kiếm bên ngoài.
• Bắt buộc phê duyệt trước khi ghi: Phải thông báo rõ (file nào, phần nào, nội dung tóm tắt) và chỉ được ghi hoặc cập nhật khi người dùng đồng ý.
• Không trùng lặp & Đúng ngữ cảnh: Kiểm tra kỹ file trước khi sửa đổi; phân định rạch ròi giữa việc viết tài liệu lý thuyết và viết code ứng dụng.

2. Phân định ngữ cảnh làm việc (Context Routing)

📚 Khu vực documentations/ (Biên soạn kiến thức phỏng vấn)

Áp dụng nghiêm ngặt nhóm quy tắc có tiền tố docs-:

• docs-01-workflow-and-approval.md: Thứ tự tra cứu tài liệu, quy trình bắt buộc 9 bước, nguyên tắc xin phê duyệt và checklist hoàn tất.
• docs-02-topic-routing.md: Bảng phân loại 17 chủ đề công nghệ vào các file .md tương ứng, nguyên tắc giải quyết xung đột và ví dụ điều hướng.
• docs-03-technical-standards.md: Tiêu chuẩn file kỹ thuật (chia Phần I, II...; thuần lý thuyết kỹ thuật; nghiêm cấm câu hỏi tình huống và bài toán DSA).
• docs-04-special-files.md: Quy định cấu trúc chuyên biệt cho INTRODUCTION.md (song ngữ) và PROJECTS.md (phân theo dự án trong CV).
• docs-05-qa-format-and-quality.md: Định dạng mục lục đầu file, format câu hỏi ## Câu <số>, ### Trả lời, ### Điểm chính, ### Ví dụ, và tiêu chuẩn chất lượng.

💻 Khu vực fe/ (Lập trình mã nguồn & Ứng dụng)

Áp dụng nhóm quy tắc lập trình và thiết kế:

• code-rules.md: Quy chuẩn viết mã sạch, project-type routing, quy trình Plan Mode và checklist kiểm thử.
• design-rules.md: Tiêu chuẩn thiết kế giao diện UI/UX hiện đại, thẩm mỹ cao, micro-interactions, responsive.
• core-protocol.md: Giao thức vận hành lõi của agent trong workspace.
• universal-rules.md: Quy định an toàn và nguyên tắc chung.
• request-routing.md: Điều hướng yêu cầu lập trình tới đúng chuyên gia.
• quick-reference.md: Bảng tra cứu nhanh các lệnh và cú pháp.

3. Bộ công cụ hỗ trợ (AG Kit Toolkit)

• Specialist Agents (.agents/agent/): 20 chuyên gia đóng vai (ví dụ: frontend-specialist, backend-specialist, debugger, devops-engineer...).
• Skills (.agents/skills/): 47 bộ kỹ năng chuyên sâu được nạp linh hoạt theo nhu cầu (ví dụ: nextjs-react-expert, clean-code, tailwind-patterns, systematic-debugging...).
• Workflows (.agents/workflows/): 13 quy trình làm việc chuẩn kích hoạt bằng slash commands (/plan, /debug, /test, /orchestrate...).
• Hooks An toàn (.agents/hooks/ & hooks.json): Kiểm soát câu lệnh terminal, ngăn ngừa các lệnh nguy hại phá hủy hệ thống.