HƯỚNG DẪN VIẾT SÁCH EDTECH CHO AI AGENT

Điều kiện tiên quyết

KHÔNG được bắt đầu viết cho đến khi: 1. File MUC-LUC-SACH.md đã tồn tại và đã được user duyệt 2. Thư mục drafts/ chứa đầy đủ các file nghiên cứu từ quá trình tạo mục lục

---

Quy trình viết mỗi chương

Bước 1 — Nhận chỉ định từ user

User sẽ nói viết chương nào. Không tự viết nhiều chương cùng lúc.

Bước 2 — Nghiên cứu chuyên sâu cho chương đó

Đọc lại:

  • Các phần liên quan trong drafts/phase1-book-notes.md và drafts/phase1-conversation-notes.md
  • Các PDF gốc trong books/ — lần này đọc KỸ các chương/phần liên quan, không chỉ skim
  • Các nguồn bổ sung trong drafts/phase2-external-research.md

Tìm kiếm thêm trên web:

  • Papers mới nhất (2024-2026) liên quan đến chủ đề chương
  • Case studies cụ thể
  • Dữ liệu thống kê
  • Quan điểm phản biện

Ghi tất cả ghi chú nghiên cứu vào: drafts/chapter-N-research.md

Bước 3 — Viết nháp

Cấu trúc mỗi chương:

# Chương N: [Tên chương]

## Bối cảnh / Vấn đề
Tại sao chủ đề này quan trọng? Thực trạng là gì?

## Nền tảng lý thuyết
Nghiên cứu nói gì? Có trích dẫn nguồn cụ thể (Tác giả, Năm).

## Thực trạng triển khai
Ví dụ cụ thể: ai đang làm, hoạt động ra sao, kết quả thực tế.
Cái gì hiệu quả? Cái gì thất bại? Tại sao?

## Phân tích phản biện
Lỗ hổng, rủi ro, giới hạn. Research Gaps. Đừng tô hồng.

## Nguyên tắc thiết kế
Dựa trên bằng chứng: nên làm gì, tránh gì, cân nhắc gì.

## Tổng kết chương
3-5 điểm chính. Kết nối sang chương tiếp.

Ghi draft vào: drafts/chapter-N-draft.md

Bước 4 — Tự phản biện

Đọc lại draft và tự hỏi:

  • Có claim nào không có nguồn trích dẫn không?
  • Có đang tô hồng hay quá bi quan không?
  • Có ví dụ thực tế cụ thể không?
  • Giọng văn có khách quan không? Có sến không? Có bán hàng không?
  • Có lặp nội dung từ chương khác không?
  • Mỗi câu có mang thông tin mới không? Có padding không?

Sửa và viết bản chính thức vào: chapters/chuong-N.md

Bước 5 — Trình user review

Báo cho user biết đã viết xong. Chờ feedback trước khi chuyển sang chương khác.

---

Quy tắc viết

Giọng văn

  • Khách quan, thực dụng, có chiều sâu
  • Như sách O'Reilly hoặc Harvard Business Review
  • CẤM: "đỉnh cao", "tối thượng", "cách mạng", "tuyệt vời", "đáng kinh ngạc"
  • Tham khảo thêm: quy-tac-viet-bai/quy-tac-viet-bai.md

Trích dẫn

  • Inline: (Tác giả, Năm) hoặc (Tên sách viết tắt, Chương N)
  • Viết tắt: MIS (Make It Stick), DHPL (Design for How People Learn), ELSI (e-Learning & Science of Instruction), FTD (Failure to Disrupt), AIED (AI in Education)
  • Cuối chương: danh sách tham khảo đầy đủ

Ngôn ngữ

  • Tiếng Việt
  • Thuật ngữ chuyên môn giữ tiếng Anh trong ngoặc lần đầu: "Tải trọng nhận thức (Cognitive Load)"
  • Sau đó dùng tiếng Việt hoặc Anh tuỳ tự nhiên

Độ dài

  • 3,000 - 5,000 từ/chương
  • Không padding. Mỗi câu mang thông tin mới.

---

Cấu trúc thư mục output

edtech-books/
├── drafts/
│   ├── chapter-N-research.md   ← Ghi chú nghiên cứu cho chương N
│   └── chapter-N-draft.md      ← Bản nháp chương N
├── chapters/
│   ├── chuong-1.md             ← Bản chính thức chương 1
│   ├── chuong-2.md
│   └── ...
└── MUC-LUC-SACH.md

---

Nguyên tắc xuyên suốt

1. Không phịa. Mọi claim phải có nguồn. 2. Không tô hồng. EdTech thất bại nhiều hơn thành công. Phản ánh cả hai. 3. Không bán hàng. SYNVIA chỉ là ví dụ nhỏ nếu phù hợp. 4. Không lười. Đọc PDF gốc, tìm web, đừng chỉ dùng tóm tắt. 5. Giữ quá trình. Research notes và drafts đều nằm trong drafts/. 6. Từng chương một. Không viết cả cuốn cùng lúc.