Hệ thống tư vấn đa chuyên gia theo mô hình Vertical Multi-Agent. Một Triage Agent điều phối xuống 4 Expert Agents chuyên biệt theo lĩnh vực. Toàn bộ framework dạng file-based markdown — không phụ thuộc platform, import được vào bất kỳ project nào.
User Request
│
▼
┌─────────────────────────────┐
│ Triage Agent │ ← Phân tích & routing
└─────────────────────────────┘
│ │
▼ ▼
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
│Software │ │ AI │ │Business │ │ Market │
│ Expert │ │ Expert │ │ Expert │ │ Expert │
└─────────┘ └─────────┘ └─────────┘ └─────────┘
│ │ │ │
▼ ▼ ▼ ▼
docs/software/ docs/ai-ml/ docs/business/ docs/market/
<project-root>/
│
├── agent.md ← Generic entry point (đổi tên tuỳ tool, xem bên dưới)
├── CLAUDE.md ← Entry point cho Claude Code
├── .cursorrules ← Entry point cho Cursor / Windsurf
├── README.md ← File này
│
├── .agents/ ← Toàn bộ framework (không cần chỉnh sửa)
│ ├── agents/
│ │ ├── triage.md ← Orchestrator — đọc đầu tiên
│ │ ├── software-expert.md ← SE Agent
│ │ ├── ai-expert.md ← AI/ML Agent
│ │ ├── business-expert.md ← Business Mentor Agent
│ │ └── market-expert.md ← Market Research Agent
│ ├── skills/
│ │ ├── clarify.md ← Kỹ năng làm rõ yêu cầu
│ │ ├── research.md ← Kỹ năng web search & tổng hợp
│ │ ├── analysis.md ← Kỹ năng phân tích đa chiều
│ │ └── synthesis.md ← Kỹ năng tổng hợp multi-agent
│ ├── rules/
│ │ ├── global.md ← Rules áp dụng cho tất cả agents
│ │ ├── software-engineering.md
│ │ ├── ai-ml.md
│ │ ├── business-mentor.md
│ │ └── market-research.md
│ ├── templates/
│ │ ├── triage-output.md
│ │ ├── software-expert-output.md
│ │ ├── ai-expert-output.md
│ │ ├── business-playbook-output.md
│ │ ├── market-expert-output.md
│ │ └── synthesis-report.md
│ └── references/
│ ├── software-engineering.md ← Knowledge base kỹ thuật
│ ├── ai-ml.md ← Knowledge base AI/ML
│ ├── business-mentor.md ← Knowledge base pháp lý & kinh doanh VN
│ └── market-research.md ← Knowledge base nghiên cứu thị trường
│
└── docs/ ← Output tài liệu từ các Expert Agents
├── software/ ← Phân tích từ Software Expert
├── ai-ml/ ← Phân tích từ AI Expert
├── business/ ← Phân tích từ Business Expert
└── market/ ← Phân tích từ Market Expert
unzip advisor-expert-agents-workspace.zip -d /path/to/your-project/| AI Tool | File cần dùng | Hành động |
|---|---|---|
| Claude Code | CLAUDE.md |
Giữ nguyên, Claude Code tự đọc |
| Cursor | .cursorrules |
Giữ nguyên, Cursor tự đọc |
| Windsurf | .windsurfrules |
Đổi tên .cursorrules → .windsurfrules |
| Antigravity | agent.md |
Reference trong workspace config |
| GitHub Copilot | .github/copilot-instructions.md |
Copy nội dung agent.md vào đây |
| JetBrains AI | .jb-ai-instructions.md |
Copy nội dung agent.md vào đây |
| Claude Projects | System prompt | Paste nội dung CLAUDE.md vào system prompt |
Không cần cấu hình thêm. Chỉ cần đặt câu hỏi — framework tự xử lý routing.
# Ví dụ — AI Expert tự động được kích hoạt
"Nên dùng RAG hay fine-tuning cho chatbot hỗ trợ khách hàng?"
# Ví dụ — Business Expert tự động được kích hoạt
"Đối tác đề xuất chia 50/50 cổ phần, có nên chấp nhận không?"
# Ví dụ — Software Expert tự động được kích hoạt
"Hệ thống đang xử lý 10k RPS, nên migrate sang microservices không?"
# Triage tự nhận diện cần 2 agents
"Startup AI của tôi muốn hợp tác với đối tác phân phối, nên đàm phán thế nào?"
→ Business Expert (chính) + AI Expert (bổ trợ)
"business-mentor: [mô tả tình huống]"
"ai-expert: [câu hỏi về AI]"
Mỗi phân tích hoàn thành, Expert Agent tự ghi file vào docs/:
docs/
├── ai-ml/
│ ├── 2025-01-15_rag-vs-finetuning.md
│ └── 2025-01-20_llm-cost-optimization.md
├── business/
│ ├── 2025-01-16_hop-tac-doi-tac-abc.md
│ └── 2025-01-18_co-dong-mau-thuan-xu-ly.md
├── software/
│ └── 2025-01-17_kafka-vs-rabbitmq.md
└── market/
└── 2025-01-19_fintech-vn-landscape.md
Các file này có thể commit thẳng vào git cùng codebase — tích lũy thành knowledge base của project theo thời gian.
Tư vấn kiến trúc, tech stack, system design, DevOps, engineering process. Phân tích trade-offs, đưa ra khuyến nghị rõ ràng kèm điều kiện.
Tư vấn lựa chọn model, LLM application, AI strategy, MLOps. Luôn search verify thông tin mới nhất. Bắt buộc kèm eval plan.
Tư vấn hợp tác, hợp đồng, tranh chấp, nội bộ, pháp lý doanh nghiệp VN. Phân tích đa góc độ, thiết kế "nước cờ" cụ thể, căn cứ luật VN.
Nghiên cứu thị trường, phân tích cạnh tranh, xu hướng, go-to-market. Luôn search data mới nhất. Bottom-up sizing. Kèm signals theo dõi.
- Separation of concerns: Agent định nghĩa vai trò & wiring, không chứa kiến thức chuyên môn
- Single responsibility: Mỗi file có 1 trách nhiệm duy nhất
- Composable: Skills và rules tái sử dụng giữa nhiều agents
- File-first / Platform-agnostic: Hoạt động với bất kỳ AI tool nào đọc được markdown
- Vietnamese-first: Output tiếng Việt mặc định, giữ nguyên English technical terms
- Tạo
.agents/agents/<tên>-expert.mdtheo cấu trúc của các agent hiện có - Thêm entry vào Routing Table trong
.agents/agents/triage.md - Tạo
.agents/rules/<tên>.mdvới rules chuyên biệt - Tạo
.agents/templates/<tên>-output.mdvới output format - Tạo thư mục
docs/<tên>/để chứa output
Tạo .agents/skills/<tên>.md và reference trong Wiring section của agent cần dùng.
- AI tool có khả năng đọc file trong workspace (Claude Code, Cursor, Windsurf, Antigravity...)
- Không cần cài đặt thêm bất kỳ dependency nào
- Không cần code, không cần API key riêng