Chúng tôi đang xây Salty Poker như thế nào: spec-driven development

Hầu hết các nền tảng poker được xây dựng theo đúng kiểu mà hầu hết các ván poker được chơi — nhanh, theo cảm giác, vừa đi vừa tính. Chúng tôi thì không làm như vậy.

Ngay từ ngày đầu, chúng tôi đã chủ động lựa chọn xây dựng nền tảng này theo spec-driven development. Đây là một phương pháp đang thực sự tăng tốc trong giới engineering có hỗ trợ AI, và là nền móng cho toàn bộ những gì chúng tôi đang xây.

Spec-driven development có nghĩa là gì

Trước khi một dòng code production duy nhất được viết, một bản spec đã được viết trước. Hơn 100 trang. Hai mươi ba module bao quát mọi lĩnh vực của hệ thống — hạ tầng, schema cơ sở dữ liệu, API contract, service boundary, các control về compliance, pipeline CI/CD, runbook vận hành.

Phương pháp này chia làm ba cấp độ. Spec-first: một bản spec đầy đủ được viết trước bất kỳ dòng code nào, rồi dùng để dẫn dắt quá trình phát triển. Spec-anchored: bản spec vẫn sống và tiến hóa song song với codebase khi dự án trưởng thành. Spec-as-source: con người chỉ chạm vào bản spec — code được sinh ra hoàn toàn từ nó.

Có một anti-pattern đáng được gọi tên: spec-once — khi spec mở màn dự án rồi bị âm thầm bỏ rơi khi quá trình build đi sâu hơn. Bản thiết kế trở thành một di tích.

Chúng tôi thiết kế một cách rõ ràng để chống lại điều đó. Spec của chúng tôi là một tài liệu sống. Nó được cập nhật khi các quyết định được đưa ra, khi edge case xuất hiện, khi kiến trúc tiến hóa. Khi một phiên kết thúc, spec phản ánh đúng những gì đã được xây. Khi phiên tiếp theo bắt đầu, nó tiếp tục chính xác từ nơi phiên trước dừng lại.

Vì sao điều này quan trọng với một nền tảng poker

Các nền tảng poker hỏng theo những cách có thể đoán trước — và gần như tất cả đều quay lại cùng một nguyên nhân gốc: những con đường tắt đi sớm sẽ dồn lại thành những vấn đề nghiêm trọng về sau.

Một hệ thống wallet được xây dựng mà không có một ledger theo nguyên tắc ghi sổ kép cho ra hồn. Một game engine chưa bao giờ bị stress-test cho các edge case. Một lớp compliance được vít vào sau, thay vì được nướng sẵn từ ngày đầu. Một nền tảng chạy ổn với 50 người chơi và sụp đổ với 500.

Spec-driven development chính là cái kỷ luật ngăn chặn điều đó. Mỗi service boundary được định nghĩa trước khi được xây. Mỗi luồng dữ liệu được tài liệu hóa trước khi được triển khai. Mỗi yêu cầu compliance đã nằm trong spec trước khi một migration nào đó chạy. Không có kiểu quyết định "cái đó tính sau" — bởi vì "sau" là lúc người chơi đã ngồi xuống bàn.

Agentic AI như một cỗ máy thực thi

Chúng tôi đang dùng agentic AI để xây nền tảng này — và có một sự khác biệt quan trọng giữa nó và các công cụ AI mà phần lớn mọi người đã quen.

Agentic AI không chỉ trả lời câu hỏi hay autocomplete code. Nó tự thực hiện các workflow nhiều bước một cách tự chủ trong ranh giới đã được định nghĩa — viết code, chạy test, bắt lỗi, sửa lỗi, commit — mà không cần con người giám sát từng hành động. Nó xử lý một task từ đầu đến cuối và trả lại quyền điều khiển khi gặp một quyết định được dành riêng cho con người.

Chính spec là cái khiến điều đó an toàn và dự đoán được. Agent vận hành dựa trên một spec đã được định nghĩa, review và version-control. Mỗi phiên tải một tập con module được tập trung — hai đến bốn module một lần — đưa cho agent đúng ngữ cảnh nó cần, không thừa không thiếu. Mỗi phiên có scope rõ ràng. Một checkpoint chặn cửa sang giai đoạn tiếp theo. Không có gì bước tiếp khi checklist chưa sạch.

Agent không quyết định cái gì cần xây. Spec quyết định. Agent thực thi.

Kết quả

Một nền tảng được xây với sự nghiêm túc mà nó xứng đáng. Mọi quyết định kiến trúc đều có tài liệu. Mọi service boundary đều là có chủ đích. Mọi yêu cầu compliance đều đã được xử lý trước khi nó kịp trở thành vấn đề.

Đó là cái chúng tôi đang xây. Và bạn sẽ cảm nhận được sự khác biệt khi chơi trên nó.

Tôi viết về spec-driven development như một phương pháp — những quyết định, tooling, cấu trúc của các phiên, và ý nghĩa của nó vượt ra ngoài poker — trên The Salty Korean. Nếu khía cạnh engineering này hợp với bạn, thì những bài sâu hơn đều ở đó.

Để biết thêm về phương pháp này: Using Spec-Driven Development with Claude Code của Heeki Park.

Stay salty.