training-conductor

name	training:conductor
description	Conductor: quản lý pipeline xây dựng training từ init đến review. Entry point chính.

Training: Pipeline Conductor

Nhiệm vụ

Entry point chính cho Training Engine. Tìm dự án training hiện có, hiển thị trạng thái, gợi ý bước tiếp theo, hoặc khởi tạo dự án mới.

Quy trình

1. Tìm dự án

Tìm thư mục training-projects/ trong CWD.

• Không tồn tại → bước 2a
• Tồn tại nhưng rỗng → bước 2a
• Có 1 project → bước 2b
• Có nhiều project → bước 2c

2a. Chưa có dự án (Onboarding)

Khi user lần đầu dùng Training Engine (không có training-projects/), giải thích ngắn gọn trước khi dẫn vào init:

Training Engine giúp bạn xây dựng bộ tài liệu đào tạo hoàn chỉnh qua 6 bước:

1. Init: Xác định mục tiêu, đối tượng, metric thành công
2. Research: Trích xuất nội dung từ tài liệu nguồn (sách, video, URL, notes)
3. Analyze: Tách thành modules độc lập, xếp thứ tự học
4. Plan: Thiết kế từng module (tỉ lệ lý thuyết/thực hành, deliverable)
5. Build: Sinh toàn bộ nội dung (bài đọc, bài tập, case study, đánh giá)
6. Review: Kiểm tra chất lượng, phát hiện lỗ hổng

Output: thư mục markdown có cấu trúc, sẵn sàng upload Google Docs hoặc dùng trực tiếp.

Bạn chọn phương pháp sư phạm (mặc định: Văn-Tư-Tu, tỉ lệ 10% lý thuyết, 20% suy tư, 70% thực hành). Có thể thêm phương pháp khác sau.

Bắt đầu?

Nếu user đồng ý → thực hiện inline (đọc skills/training-init/SKILL.md và follow quy trình).

Nếu user hỏi thêm về Training Engine, trả lời dựa trên context sau:

Khi nào dùng Training Engine?

• Cần đào tạo có hệ thống (không phải chỉ chia sẻ 1 bài viết)
• Có ≥ 3 chủ đề cần dạy
• Cần đo lường kết quả sau đào tạo
• Cần nhiều người cùng dạy (facilitator hub)

Khi nào KHÔNG cần?

• Chỉ cần viết 1 bài hướng dẫn ngắn → dùng skill khác
• Chia sẻ kiến thức không cần đo lường → viết blog/doc thường

Method là gì?

• Phương pháp sư phạm quyết định cách chia nội dung trong mỗi module
• Văn-Tư-Tu (mặc định): 10% đọc, 20% suy tư, 70% thực hành
• Xem tất cả methods: /training:method-creator
• Tạo method riêng: /training:method-creator hoặc copy skills/training-method-creator/training-methods/_template/

Output trông thế nào?

training-projects/feedback-cho-leader/
  00-brief.md                    Mục tiêu + metric
  01-content-inventory.md        Nội dung đã trích xuất
  02-module-map.md               Sơ đồ modules
  03-module-designs/             Blueprint từng module
  04-modules/                    Nội dung hoàn chỉnh
    module-01-sbi-framework/
      README.md
      01-van/                    Lý thuyết
      02-tu-suy-tu/              Câu hỏi phản chiếu, case study
      03-tu-thuc-hanh/           Bài thực hành, dự án
      04-danh-gia/               Rubric, đánh giá
    _facilitator-hub/            Hướng dẫn cho người dạy
    _danh-gia-khoa/              Survey + follow-up 30/60/90 ngày
  05-review-report.md            Báo cáo chất lượng

2b. Có 1 dự án

Đọc project.json. Hiển thị dashboard (bước 3).

2c. Có nhiều dự án

Liệt kê:

#	Dự án	Method	Phase hiện tại
1	feedback-cho-leader	van-tu-tu	research
2	onboarding-dev	van-tu-tu	init

Hỏi user chọn → đọc project.json → bước 3.

3. Dashboard

Đọc project.json, hiển thị:

Training: <name>
Method: <method>

  ✅ Init        → 00-brief.md
  ✅ Research    → 01-content-inventory.md
  ▶️  Analyze     (gợi ý chạy tiếp)
  ⬜ Plan
  ⬜ Build
  ⬜ Review

Ký hiệu:

• ✅ = done
• ▶️ = gợi ý (phase tiếp theo chưa done)
• ⬜ = pending

4. Gợi ý hành động

Dựa trên current_phase, gợi ý:

current_phase	Gợi ý
init	Chạy /training:research để nghiên cứu nội dung
research	Chạy /training:analyze để phân tích và tách module
analyze	Chạy /training:plan để thiết kế từng module
plan	Chạy /training:build để sinh nội dung
build	Chạy /training:review để review chất lượng
review	Khoá hoàn thành! Output tại training-projects/<slug>/04-modules/

5. Nhảy phase

User có thể yêu cầu chạy bất kỳ phase nào. Conductor kiểm tra prerequisite:

• Phase yêu cầu phase trước đã done → cho phép
• Phase trước chưa done → thông báo cần chạy phase trước

6. Troubleshooting (khi user bị kẹt)

Nếu user báo không biết làm gì tiếp, hoặc output phase trước không đúng:

Vấn đề	Hướng dẫn
Brief quá mơ hồ, research không ra gì	Quay lại /training:init, bổ sung câu trả lời cụ thể hơn
Modules tách không hợp lý	Chạy lại /training:analyze. Phase này idempotent, ghi đè output cũ
Nội dung build ra không khớp brief	Kiểm tra 05-review-report.md. Nếu chưa có, chạy /training:review
Muốn thay đổi method giữa chừng	Sửa project.json field "method". Chạy lại từ phase plan trở đi
Review fail nhiều module	Sửa issues trong 04-modules/, chạy /training:review lại
Muốn thêm module mới sau khi build	Quay lại /training:analyze thêm module, rồi /training:plan + /training:build cho module mới

Quy tắc chung: mỗi phase ghi đè output cũ khi chạy lại. Quay lại phase nào cũng được, miễn phase trước nó đã done.

7. Hành động khác

User có thể yêu cầu:

• "Xem brief" → đọc 00-brief.md
• "Xem module map" → đọc 02-module-map.md
• "Xem review report" → đọc 05-review-report.md
• "Đổi method" → cảnh báo ảnh hưởng đến output đã tạo
• "Xoá dự án" → xác nhận, xoá thư mục