Phát triển phần mềm hướng đặc tả với AI: 1000 đặc tả, 500.000 dòng mã

Một lập trình viên vừa chia sẻ trên Hacker News về quy trình phát triển phần mềm "spec-first" (đặc tả trước) khi làm việc cùng AI agent. Kể từ đầu năm 2026, phương pháp này đã tạo ra hơn 1000 đặc tả và khoảng 500.000 dòng mã nguồn. Điểm đáng chú ý là thay vì để AI tự do sinh mã, anh kiểm soát chất lượng ngay từ khâu viết đặc tả.

Đặc tả trước, mã nguồn sau

Ý tưởng cốt lõi khá đơn giản: con người viết đặc tả rõ ràng, còn AI agent chịu trách nhiệm biến đặc tả đó thành mã chạy được. Trong đoạn chia sẻ, tác giả giới thiệu công cụ Agent Smith — plugin phát triển agentic đi kèm một mẫu đặc tả có cấu trúc chặt chẽ.

Một đặc tả mẫu trong bài viết gồm các phần:

• Mã định danh và ngữ cảnh: số hiệu đặc tả, phạm vi áp dụng (ví dụ: server), nhánh Git liên quan
• Mục tiêu: ví dụ "các nhà cung cấp ticket để pipeline có thể kéo công việc từ GitHub và Jira"
• Dữ kiện đọc từ mã: trích dẫn chính xác vị trí trong mã nguồn, chẳng hạn Program.cs:40-58 hay AppConfig.cs:12-19
• Quyết định kỹ thuật: ví dụ chọn mẫu adapter thay vì repository vì dữ liệu chủ yếu là đọc
• Điều kiện hoàn thành: các tiêu chí kiểm chứng cụ thể như "stages green" hay kiểm thử đầu-cuối

Cấu trúc này buộc cả người viết lẫn AI phải bám sát ngữ cảnh thực tế của mã nguồn, thay vì suy đoán mơ hồ.

Vì sao cách làm này hiệu quả?

Khi AI tạo mã ngày càng phổ biến, vấn đề lớn nhất không còn là "AI có viết được mã không" mà là "mã đó có đúng ý định của con người không". Đặc tả đóng vai trò như bản hợp đồng giữa ý tưởng và triển khai.

Đặc tả tốt giúp agent có đủ ngữ cảnh để ra quyết định đúng, đồng thời cho con người một điểm kiểm soát trước khi mã được sinh ra.

Một số lợi ích mà tác giả ngầm khẳng định qua con số ấn tượng:

• Giảm vòng lặp sửa lỗi: lỗi được phát hiện ở khâu đặc tả thay vì sau khi mã đã chạy
• Truy vết được: mỗi đặc tả gắn với nhánh và vị trí mã cụ thể, dễ kiểm toán
• Tăng tốc độ: 500.000 dòng mã trong khoảng một năm là con số khó đạt với quy trình thủ công
• Dễ review: đặc tả ngắn gọn, có cấu trúc, phù hợp để đồng nghiệp hoặc AI khác đánh giá

Góc nhìn cho lập trình viên Việt Nam

Với các đội phát triển phần mềm tại Việt Nam, đặc biệt là các startup cần tối ưu nguồn lực, phương pháp spec-first có thể là hướng đi đáng thử. Tuy nhiên cần lưu ý vài điểm:

• Chất lượng đặc tả quyết định chất lượng mã: đặc tả mơ hồ sẽ tạo ra mã mơ hồ, và nợ kỹ thuật tích tụ nhanh hơn
• Không thay thế được tư duy kiến trúc: quyết định thiết kế vẫn cần con người đưa ra, như ví dụ chọn adapter thay vì repository
• Cần quy trình kiểm thử nghiêm túc: điều kiện "done when" chỉ có giá trị nếu thực sự được kiểm chứng tự động

Việc áp dụng công cụ agentic cũng đòi hỏi đội ngũ hiểu rõ công cụ và biết cách kiểm soát đầu ra của AI, tránh biến đặc tả thành hình thức.

Kết luận

Câu chuyện của tác giả trên Hacker News cho thấy một xu hướng đáng chú ý: khi AI viết mã, giá trị của lập trình viên dịch chuyển về phía định nghĩa vấn đề và đặc tả yêu cầu. Với hơn 1000 đặc tả và 500.000 dòng mã, đây là một minh chứng thực tế rằng kỷ luật trong khâu đặc tả có thể nhân sức mạnh của công cụ AI lên đáng kể.