Mọi chuyện bắt đầu khi mình đi tìm ý tưởng cho một side project trên Reddit. Mình tình cờ đọc được một bài đăng trong r/ProductManagement bàn về release note được AI tự động tạo ra, và thấy hứng thú nên kéo xuống đọc phần bình luận. Ở đó có một bình luận của một người làm Product Manager cho các công cụ release note, giải thích ý tưởng rõ hơn hẳn bài đăng gốc:
Automating release notes does not really mean that you handover full control to the Automation engine and run it on a auto-pilot. Automating release notes also does not really mean that you handover everything to the AI to take care of.
Bình luận đó chia việc làm release note thành ba phần — viết, soạn và phân phối. Automation hợp với việc soạn và phân phối, AI giúp ở phần viết, còn con người là người review và quyết định.
Đọc xong, mình lao vào tìm hiểu rồi bắt tay làm luôn. Kết quả hôm nay là ReleaseFlow — trang dự án đã giới thiệu nó làm gì. Bài này kể phần mà trang dự án không kể: ReleaseFlow thật ra là lần thứ hai mình làm ý tưởng này.
Bản đầu tiên: AI Powered Release Notes Generator
Phiên bản đầu tiên có tên là AI Powered Release Notes Generator. Nó không phải một bản thử nghiệm: nó đã dùng được thật, và mình cũng đã viết vài bài giới thiệu về nó trên một số mạng xã hội.
Nhưng mình thấy nó vẫn khó tiếp cận với mọi người. Theo quyết định ban đầu, dự án còn được chia làm hai phần: một module open-core theo giấy phép AGPL và một module enterprise theo giấy phép riêng, với template, automation và phân phối nằm ở phần enterprise.
Đây là dự án mình rất tâm đắc, và lúc đó mình thấy nó chưa đủ thông tin, chưa đạt tới 100% như mình mong muốn. Nên mình quyết định làm lại, lần này cố gắng làm cho đầy đủ và chuẩn nhất với một dự án mã nguồn mở.
Làm lại thành ReleaseFlow: một module, một giấy phép
Khi bắt đầu làm lại, kế hoạch đặt mục tiêu giữ đủ chức năng của bản cũ, nhưng không nhất thiết giữ cấu trúc của nó. ReleaseFlow chỉ có một Maven module, nhưng mình vẫn để ngỏ câu hỏi có tách open-core và enterprise như bản cũ hay không — nếu cần thương mại hoá thì sẽ tính ở một giai đoạn về sau.
Gần hai tuần sau, ngày 22/9, mình chốt trong ADR-0029: bỏ hẳn việc tách. Mình nhận ra nó thực sự không cần thiết — không có kế hoạch thương mại nào cần tới ranh giới đó, mà duy trì một ranh giới cho một kế hoạch không ai có thì chỉ tốn công. Thứ mình muốn là có một đóng góp nhỏ cho những người thật sự cần công cụ này, chứ không phải thương mại hoá nó. Template, automation và phân phối giờ nằm cùng chỗ với mọi tính năng khác, dưới cùng một giấy phép.
Giấy phép đó là Apache 2.0, chứ không phải AGPL như phần open-core cũ, vì ba lý do:
-
đây là giấy phép của chính hệ sinh thái mà ReleaseFlow dựa vào — Spring Boot, Spring Security, Flyway, Micrometer và Testcontainers đều dùng Apache 2.0;
-
cây dependency không có gì buộc dự án phải theo copyleft, nên đây là một lựa chọn thật sự tự do;
-
Apache 2.0 cấp quyền sáng chế một cách rõ ràng, điều mà MIT không có.
Đi kèm giấy phép là những thứ khác mà một dự án mã nguồn mở cần: NOTICE,
CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md, một CHANGELOG.md theo
Keep a Changelog, và một trang tài liệu song ngữ Anh – Việt.
Khó nhất là lúc chưa viết dòng code nào
Giai đoạn khó nhất với mình là đầu tiên: tìm hiểu cơ chế hoạt động, chức năng và kiến trúc của dự án sao cho không rơi vào over-engineering. Với một công cụ có thể kết nối tới cả chục hệ thống khác nhau, rất dễ thiết kế sẵn cho mọi thứ ngay từ ngày đầu.
Nhìn lại các Architecture Decision Record, mình thấy dự án đã bắt đầu nhỏ hơn nhiều so với bây giờ:
-
Lúc đầu, mỗi Project chỉ nối với đúng một repo GitHub. Phần trừu tượng chung cho các nguồn chỉ được tách ra khi nguồn thứ hai — GitLab — thật sự xuất hiện; Linear và Jira đến ngay sau đó.
-
AI ban đầu chỉ có OpenAI, chỉ chạy khi người dùng bấm, và mọi kết quả AI đều phải được review. Ba ngày sau, quyết định đó bị thay thế: nếu mọi thay đổi có AI chạm vào đều phải review thì AI tự động trở nên vô nghĩa. Thay vào đó, rule và các review trigger giữ quyền quyết định, còn AI chạy tự động và chỉ gợi ý.
-
Không có message broker. Mọi việc nền chạy trên chính PostgreSQL bằng
FOR UPDATE SKIP LOCKED— một database cho cả dữ liệu lẫn hàng đợi.
Hai tuần cho tính năng, gần một tháng để ai cũng dùng được
ADR đầu tiên được ghi ngày 9/9/2026. Đến 22/9, đã có 29 ADR — gần như toàn bộ tính năng của sản phẩm. Nhưng v1.0.0 chỉ ra đời ngày 20/10.
Gần một tháng ở giữa dành cho những thứ không phải tính năng: một bundle quickstart để chạy thử chỉ bằng vài lệnh, một quy trình release tự động publish JAR, image, SBOM và checksum, và trang tài liệu. Đó chính là phần đã thiếu ở bản đầu tiên — phần giúp người khác tiếp cận được dự án.
Mock là chưa đủ: thử thật trên dbvault
Ban đầu mình kiểm thử bằng mock. Nhưng mock chỉ trả lời đúng những gì mình nghĩ tới, nên mình thấy nó chưa sát với thực tế. Mình tìm hiểu và lên một kế hoạch kiểm tra thật, trên chính một project cá nhân của mình.
Project đó là dbvault. Ban đầu nó là bài tập mình tự làm theo đề Database Backup Utility trên roadmap.sh, đã hoàn thành từ lâu. Mình dùng lại nó làm một "lab" thật cho ReleaseFlow: repo trên GitHub và GitLab, project trên Jira, cùng những pull request, merge request và issue thật.
Và lab đó tìm ra vấn đề mà mock không bao giờ tìm ra. Issue Jira DBV-44 mô tả một bug của CLI, còn merge request !9 là thay đổi đã sửa nó. Cả hai đều đi vào ReleaseFlow như hai thay đổi riêng, nhưng chỉ merge request mới nên có trong release note. Nếu từ chối DBV-44 khi review, nó lại được đề xuất cho release tiếp theo, rồi release sau nữa. Cách duy nhất để giữ nó ngoài release là tạo một bản nháp "giữ chỗ" — vừa xấu vừa có thể bị ai đó lỡ tay publish.
Từ đó có tính năng cuối cùng trước v1.0.0: loại một thay đổi khỏi mọi release, kèm lý do, mà không xoá gì cả.
Điều bất ngờ nhất là phần còn lại gần như chạy đúng như mình hình dung. Chưa phải 100%, nhưng với mình, hiện tại nó đã sẵn sàng để mọi người dùng một cách ổn định.
Làm cùng AI coding agent
Mình dùng AI coding agent trong suốt quá trình làm, nhưng luôn trong tầm kiểm
soát của mình: agent làm việc theo một bản hướng dẫn nằm ngay trong repo
(AGENTS.md), và mỗi quyết định lớn được ghi lại thành một ADR.
Việc agent làm rất tốt là viết tài liệu từ những ý tưởng mình trao đổi với nó. Còn chỗ mình phải sửa nhiều nhất là những vấn đề chỉ lộ ra khi thử nghiệm thật với dbvault. Đó cũng là lúc mình bỏ nhiều thời gian giám sát nhất — để thật sự biết các chức năng đã làm đúng việc của chúng chưa, và có lỗi gì xảy ra trong thực tế hay không.
Cũng giống tinh thần của chính ReleaseFlow: AI soạn nháp, còn con người kiểm tra và quyết định.
Tiếp theo
Muốn biết ReleaseFlow làm gì và chạy thử thế nào, bạn xem trang dự án. Trong các bài tới, mình sẽ đi sâu vào từng quyết định kỹ thuật:
Nếu bạn dùng thử và gặp vấn đề, hoặc thấy còn thiếu gì, hãy mở một Discussion trên GitHub — đó là đóng góp có ích nhất với mình lúc này.