Sách thiết kế phần mềm nên đọc trước khi bàn giao code AI cho khách
John Ousterhout dùng 196 trang để dạy một việc: giấu độ phức tạp sau giao diện nhỏ, vì khách sẽ phải sống với code đó khi bạn đã đi.

Tóm tắt nhanh
- Ousterhout cho rằng độ phức tạp là giới hạn thật sự của phần mềm, và định nghĩa nó là bất cứ thứ gì khiến code khó hiểu, khó sửa.
- Ông ví công cụ AI viết code với tactical tornado: viết nhanh, sửa nhanh, nhưng đẻ thêm lỗi và nợ kỹ thuật.
- Ba ý nên giữ cho FDE: module sâu, tư duy chiến lược thay cho chiến thuật, và comment ghi điều code không tự nói ra.
Tháng 4/2025, trên podcast The Pragmatic Engineer, John Ousterhout ví công cụ AI viết code với những “tactical tornado”: viết nhanh, sửa lỗi nhanh, và cùng lúc đẻ thêm lỗi mới lẫn nợ kỹ thuật.
Với FDE, nhận xét ấy chạm đúng chỗ đau. Bạn dùng AI để dựng integration trong vài ngày, rồi bàn giao cho đội kỹ thuật của khách, những người phải đọc và sửa code đó khi bạn đã sang dự án khác.
Cũng trong tập podcast ấy, Ousterhout cho rằng sự bùng nổ AI coding có thể khiến thiết kế phần mềm quan trọng hơn trước. Cuốn sách 196 trang của ông, A Philosophy of Software Design, là chỗ gọn nhất để học cách thiết kế đó.
196 trang xoay quanh một kẻ thù
Bản 2nd Ed do Yaknyam Press phát hành tháng 7/2021, ISBN 978-1732102217. Chủ đề chính là cách chia một hệ thống phức tạp thành các module như class và method. Trong cuộc phỏng vấn với Software Engineering Radio, Ousterhout nói thẳng: thứ duy nhất giới hạn những gì ta xây được bằng phần mềm là độ phức tạp.
Định nghĩa của ông rất thực dụng: độ phức tạp là bất cứ thứ gì khiến dự án khó hiểu và khó sửa. FDE dùng được ngay định nghĩa này, vì “khó hiểu, khó sửa” chính là cảm giác của kỹ sư phía khách khi mở repo bạn để lại.
Module sâu là bài học đáng giữ nhất
Ousterhout gọi module nông là thứ có nhiều giao diện mà ít chức năng. Module sâu thì ngược lại, dùng một giao diện đơn giản để che một chức năng phức tạp. Module nông làm hệ thống rối hơn, vì người dùng phải bỏ công học giao diện mà đổi lại được rất ít.
Lấy một ví dụ giả định. Bạn nhờ AI viết connector kéo danh bạ từ CRM của khách, và bản sinh ra có sáu hàm public: lấy token, làm mới token, dựng header, thử lại request, đọc trang kế tiếp, chuẩn hóa bản ghi. Kỹ sư của khách muốn dùng phải hiểu cả sáu hàm và đúng thứ tự gọi chúng.
Bản sâu chỉ để lộ một hàm, kiểu fetch_contacts(since), còn xác thực, retry và phân trang nằm gọn bên trong. Số thứ người tiếp quản phải học giảm từ sáu xuống một. Khi CRM đổi cách phân trang, chỉ một chỗ phải sửa và không ai bên ngoài cần biết.
Vì thế, khi làm ở chỗ khách, trước khi merge code AI sinh ra, hãy đếm số hàm public và hỏi khách thực sự cần gọi hàm nào. Những hàm còn lại thì gom vào bên trong.
Ai đang là tactical tornado trong đội bạn?
Ousterhout tả tactical tornado là người làm mọi cách để tiến độ hôm nay nhích lên, mặc kệ hệ thống hỏng tới đâu. Bản tóm tắt sách trên freshman.tech ghi rằng lập trình chiến thuật là mặc định ở hầu hết công ty, nhắm cho tính năng chạy được càng nhanh càng tốt.
Lập trình chiến lược thì chịu bỏ thời gian tìm thiết kế tốt nhất mà vẫn chạy được.
Công việc FDE đẩy bạn về phía chiến thuật: tuần sau có demo, khách đang chờ, agent viết code trong vài giây. Khi tornado đã là AI, người làm kỹ sư chiến lược chỉ còn bạn. Một thói quen dễ giữ: sau mỗi phiên để AI sinh code, dành một khoảng ngắn chỉ để dọn thiết kế và chưa thêm tính năng mới.
Comment là để cho người tiếp quản đọc
Ý thứ ba ngắn nhưng có giá trị: comment nên ghi những điều không suy ra được từ code. Thứ kỹ sư của khách cần biết là lý do: vì sao connector bỏ qua bản ghi thiếu email, ràng buộc nào từ hệ thống cũ buộc bạn chọn cách này.
Những lý do ấy chỉ nằm trong đầu bạn và trong các buổi họp với khách. Nếu không ghi ra trước ngày bàn giao, bạn rời dự án là chúng mất theo.
Nên đọc theo thứ tự nào?
Nếu ít thời gian, hãy bắt đầu với tập 520 của Software Engineering Radio (12/7/2022).
Ở đó Jeff Doolittle hỏi Ousterhout về độ phức tạp, module hóa, tầng, trừu tượng và che giấu thông tin. Tiếp theo nghe tập podcast The Pragmatic Engineer tháng 4/2025 để biết ông nhìn AI coding ra sao, rồi mới đọc sách, ưu tiên các phần về module sâu và comment.
Nếu bạn từng phải tiếp quản code của người khác, cuốn sách sẽ đặt tên được cho đúng nỗi khổ đó, và đó là lý do nên đọc nó sớm. Còn nếu mới vào nghề, đừng bỏ qua những ý tưởng có vẻ hiển nhiên: chúng là thứ dễ bị quên nhất khi deadline dí sát.
Khi đi xin việc, hãy biến các ý này thành bằng chứng. Trong CV hay buổi phỏng vấn FDE, kể một lần bạn thu gọn giao diện của một module trước khi bàn giao, và sau đó đội của khách tự sửa được mà không cần gọi bạn. Một câu chuyện cụ thể như vậy nói được nhiều hơn hẳn một dòng “viết code sạch” chung chung.
Khi Ousterhout nói về tactical tornado trên SE Radio năm 2022, đó vẫn là một lập trình viên. Giờ nó chạy ngay trong IDE của bạn, và bàn giao sạch hay rối là do người cầm lái quyết định.
Bài này có hữu ích không?
Cảm ơn bạn đã góp ý!
5 nguồn
- A Philosophy of Software Design, 2nd Ed (Yaknyam Press ) · 2021-08-25
- John Ousterhout on A Philosophy of Software Design (Software Engineering Radio episode 520) · 2022-07-12
- Book Summary: A Philosophy of Software Design · 2021-06-15
- The Philosophy of Software Design – with John Ousterhout · 2025-04-09
- SE Radio 520: John Ousterhout on A Philosophy of Software Design · 2022-07-12