---
name: onboard-codebase
description: Khảo sát và lập báo cáo kiến trúc codebase cho người mới, chạy trong subagent để không chiếm context chính. Dùng khi onboard dự án mới, nhận bàn giao code khách hàng, hoặc cần hiểu tổng quan repo.
context: fork
agent: Explore
argument-hint: "[chủ đề cần đào sâu, mặc định: toàn bộ kiến trúc]"
---
Khảo sát codebase này (chỉ đọc, không sửa). Trọng tâm: $ARGUMENTS

## Báo cáo cần trả về
1. **Tổng quan:** stack & version, cấu trúc thư mục 3 tầng đầu, entry point.
2. **Luồng chính:** request đi từ đâu tới đâu (route → xử lý → data), vẽ sơ đồ Mermaid.
3. **Phụ thuộc ngoài:** DB, queue, API bên thứ ba, service nội bộ.
4. **Quy ước ngầm:** pattern lặp lại mà tài liệu không ghi.
5. **Bản đồ rủi ro:** 5 khu vực nguy hiểm nhất khi sửa (code phức tạp/không test/god class) + lý do.
6. **Gợi ý CLAUDE.md:** nếu repo chưa có, đề xuất bản nháp.
Trình bày Markdown để lưu thẳng vào docs/onboarding.md.