Wheat: Khung quyết định kỹ thuật chạy trên AI giúp loại bỏ các mâu thuẫn trong lập trình

Wheat là một framework ra quyết định kỹ thuật mới lạ, hoạt động dưới dạng dòng lệnh (CLI) ngay bên trong Claude Code. Vào lúc các đội ngũ phát triển phần mềm thường phải đưa ra những quyết định mang tính sống còn dựa trên các cuộc tranh luận vô bổ trên Slack, Wheat xuất hiện như một giải pháp để chuẩn hóa quy trình này thông qua nghiên cứu, thử nghiệm (prototyping) và xác thực logic.

Công cụ này buộc người dùng phải chứng minh mọi khẳng định trước khi có thể đưa ra một đề xuất cuối cùng.

Vấn đề của việc ra quyết định kỹ thuật

Đa số các đội ngũ kỹ thuật thường "làm theo cảm tính" khi đối mặt với các câu hỏi khó như "Có nên di chuyển từ REST sang GraphQL không?" hay "Liệu có nên viết lại dự án bằng Rust?". Các quyết định này thường bị chi phối bởi ý kiến của người nói to nhất hoặc xu hướng công nghệ nhất thời thay vì dựa trên dữ liệu thực tế.

Wheat giải quyết vấn đề này bằng cách biến quá trình ra quyết định thành một quy trình có cấu trúc, bắt buộc phải có bằng chứng (evidence-grade) cho từng phát hiện.

Quy trình làm việc: Từ câu hỏi đến kết luận

Wheat hoạt động dựa trên khái niệm "sprint" – một cuộc điều tra kỹ thuật đơn lẻ. Quy trình diễn ra qua các bước:

1. Question (Đặt câu hỏi): Bạn bắt đầu bằng một câu hỏi kỹ thuật cụ thể.
2. Research (Nghiên cứu): Sử dụng các lệnh dạng slash (ví dụ: /research) để thu thập thông tin. Mỗi phát hiện được gọi là một "claim" (tuyên bố) và được gắn một loại (factual, risk, estimate) cùng mức độ tin cậy (từ "stated" - chưa kiểm chứng đến "tested" - đã kiểm thử).
3. Prototype (Tạo mẫu): Wheat có thể tự động tạo proof-of-concept và benchmarking để nâng cấp mức độ tin cậy của bằng chứng lên "tested".
4. Challenge (Phản biện): Đây là bước quan trọng nhất. Bạn có thể dùng lệnh /challenge để yêu cầu AI "tấn công" vào các phát hiện của chính mình, tìm ra các lỗ hổng logic hoặc giả định sai lầm.
5. Brief (Tổng hợp): Khi mọi thứ đã sẵn sàng, lệnh /brief sẽ biên dịch các dữ liệu thành một tài liệu HTML để chia sẻ với các bên liên quan.

Trình biên dịch logic (Compiler)

Điểm độc đáo nhất của Wheat là "trình biên dịch" của nó. Trước khi cho phép xuất bản bản tóm tắt quyết định (decision brief), trình biên dịch sẽ chạy qua 7 vòng kiểm tra:

• Bắt các mâu thuẫn giữa các tuyên bố.
• Gắn cờ cho các bằng chứng yếu.
• Chặn đầu ra cho đến khi tất cả các xung đột được giải quyết.

Bạn không thể xuất một bản khuyến nghị nếu nó được xây dựng trên các giả định mâu thuẫn nhau.

Ví dụ thực tế

Hãy xem xét việc quyết định có nên di chuyển từ REST sang GraphQL hay không.

1. Khởi tạo: Người dùng đặt câu hỏi. Wheat yêu cầu xác định khán giả và các ràng buộc.
2. Nghiên cứu: Wheat tìm thấy r001: GraphQL giảm tải dữ liệu 40-60%. Nhưng nó cũng tìm thấy r003: Cơ chế caching của REST không chuyển sang GraphQL.
3. Thử nghiệm: Wheat chạy một bản demo và đo lường (p002).
4. Phản biện: Lệnh /challenge r001 phát hiện rằng giả định giảm 40-60% tải quá lạc quan vì endpoint REST hiện tại đã được lọc trường dữ liệu. Tỷ lệ thực tế chỉ còn 15-25%.
5. Kết quả: Trình biên dịch hòa giải các xung đột. Kết quả cuối cùng không phải là "Có/Không" tuyệt đối, mà là "Chỉ dùng GraphQL cho các endpoint mới, giữ lại REST cho phần cũ vì lợi ích về caching".

Tính năng và Hệ sinh thái

Wheat không chỉ là một script đơn giản; nó là một hệ sinh thái hoàn chỉnh cho các kỹ sư:

• Lịch sử Git: Mỗi phát hiện được tự động commit vào tệp claims.json. Bạn có thể chạy git log claims.json để xem chính xác cách đội ngũ đã đi đến quyết định đó.
• Chia sẻ dễ dàng: Các bản brief là các tệp HTML độc lập (inline CSS/JS), có thể gửi qua email mà không cần host.
• Hệ sinh thái mở: Kết hợp với các công cụ khác như farmer (quản lý quyền hạn), mill (xuất bản), và silo (kho kiến thức).

Wheat yêu cầu Node.js phiên bản 20 trở lên và hoạt động tốt nhất bên trong Claude Code, Cursor hoặc Copilot. Nó miễn phí và mã nguồn mở, cung cấp một cách tiếp cận kỹ thuật hơn cho việc quản lý kiến thức và ra quyết định trong phát triển phần mềm.