Playbook Blueprint
Chuẩn bắt buộc cho mọi trang trong site này. Một Playbook không phải bài blog dài, cũng không phải bài knowledge. Knowledge trả lời "biết gì"; Playbook trả lời "làm gì, theo thứ tự nào".
Một Playbook giải một job-to-be-done
Không đặt tên theo chủ đề ("IELTS Writing là gì"), đặt tên theo việc người đọc cần làm ("Muốn viết tốt IELTS Writing thì học và luyện như thế nào"). Nếu không nói được người đọc đang kẹt ở tình huống nào thì đó chưa phải Playbook.
11 phần
Mọi playbook có đúng 11 phần, đúng thứ tự này:
| # | Phần | Trả lời câu hỏi |
|---|---|---|
| 1 | Tình huống | Khi nào bạn cần cẩm nang này? |
| 2 | Mục tiêu | Bạn muốn đạt được gì? |
| 3 | Nguyên tắc | Những nguyên tắc quan trọng |
| 4 | Chẩn đoán | Làm sao biết mình đang ở đâu? |
| 5 | Chiến lược | Nên đi theo hướng nào? |
| 6 | Các bước | Làm từng bước như thế nào? |
| 7 | Công cụ | Dùng công cụ gì? |
| 8 | Ví dụ | Ví dụ thực tế |
| 9 | Lỗi thường gặp | Những cái bẫy hay mắc |
| 10 | Checklist | Tôi đã làm đủ chưa? |
| 11 | Playbook tiếp theo | Tiếp theo nên đọc hoặc làm gì? |
Không gọi mọi thứ là "Playbook"
Playbook là cấp lớn. Bên trong nó là các thể loại nhỏ hơn, và mỗi thể loại có hình dạng riêng:
- Playbook — hệ thống hành động cho một tình huống lớn.
- Guide — hướng dẫn một kỹ năng hẹp bên trong playbook.
- Checklist — danh sách kiểm, không giải thích.
- Template — khung điền sẵn.
- Tool — thứ chạy được, cho ra kết quả.
- Decision Tree — cây câu hỏi dẫn tới một lựa chọn.
Nhờ tách vậy mà sau mười năm đây vẫn là một Action Knowledge Graph, không phải một đống PDF.
Hai chiều metadata, không phải hai cây thư mục
Thư mục chỉ theo chủ đề (Family · Learner · Learning · Exams · Competitions · Life). Hai chiều còn lại nằm trong frontmatter để lọc, không đẻ thêm thư mục:
audience:marlin(bố mẹ) ·nemo(learner) ·mentor·school. Một vấn đề có thể có nhiều bản hành động khác nhau cho từng đối tượng.stage: vị trí trong hành trình —discover → diagnose → plan → learn → practice → assess → fix → mock → final → exam → reflect.
Playbook là tầng điều hướng của hệ Nemo12
Một playbook không kết thúc bằng lời khuyên chung. Nó đẩy người đọc sang bước tiếp theo trong hệ: đọc xong "Giúp con ôn thi chuyên" thì việc tiếp theo là làm Diagnostic, từ đó ra Learner Model, Coral chỉ ra chỗ còn thiếu, Learning Engine dựng Learning Plan, learner học, assessment cập nhật bằng chứng — rồi playbook lại trả lời câu hỏi kế tiếp của bố mẹ: "bây giờ nên làm gì?".
Nội dung sinh ở đâu
Khung trang (frontmatter và 11 heading) sinh từ apps/playbooks/catalog/playbooks.json bằng npm run gen:playbooks. Phần thân là việc của xưởng nội dung, không gõ tay vào repo — cùng luật với nội dung học (CLAUDE.md, SRC-635). Thêm hoặc bỏ một playbook thì sửa catalog, không tạo file .md tay.