Mình là PM trong một công ty startup nhỏ. Đội dev thì luôn kín lịch với sản phẩm chính, mà mình thì có cả đống ý tưởng muốn thử - từ chuyển đổi blog công ty sang kiến trúc mới, đến tạo hệ thống để đồng nghiệp tự viết bài mà không cần biết kỹ thuật.

Nên mình tự build bằng vibe coding.

Nói đơn giản, vibe coding là mình mô tả thứ mình muốn bằng ngôn ngữ tự nhiên > AI viết code > mình xem kết quả rồi điều chỉnh. Công cụ mình dùng là Claude Code - một AI chạy ngay trong terminal, có thể đọc code của dự án, viết file mới, chạy lệnh, và deploy. Mình chỉ cần nói "chuyển blog từ lưu trữ file sang database" và nó tự lên kế hoạch > viết code > chạy thử.

Tuần trước, blog công ty mình đã tích lũy được 118 bài viết thuộc 13 danh mục sau hơn nhiều năm hoạt động. Mình cần chuyển toàn bộ từ cách lưu trữ cũ sang database mới - tương đương việc dọn 118 cuốn sách từ kệ cũ sang tủ mới có đánh index, phân loại, tìm kiếm được. Với Claude Code, mình làm xong trong 4 giờ. Thuê người làm thì ít nhất cả tuần.

Rồi mình setup thêm một headless CMS (Keystatic) để đồng nghiệp không biết kỹ thuật có thể tự viết blog - thay vì bắt họ commit file markdown trực tiếp. Sau vài lượt prompt với AI, mọi thứ có vẻ rất hợp lý..nhưng nó không hoạt động. Cùng một lỗi mà lặp đi lặp lại cả chục lần. Mình sửa theo gợi ý của AI - đổi URL > tạo lại secret > kiểm tra biến môi trường - nhưng vẫn gặp lỗi tương tự.

Mất gần cả nửa ngày sau thì mình mới phát hiện ra: AI đã hướng dẫn mình tạo sai loại ứng dụng ngay từ bước đầu tiên.

Chuyện gì đã xảy ra

Keystatic cần kết nối với GitHub qua OAuth để đồng nghiệp có thể đăng nhập và chỉnh sửa nội dung. Để làm được, mình cần tạo một "ứng dụng" trên GitHub cấp quyền truy cập cho Keystatic.

Nghe có vẻ đơn giản, nhưng vấn đề ở đây là GitHub có hai loại ứng dụng, tên gần giống nhau, nằm cạnh nhau trong cùng trang Developer settings:

• OAuth Apps - chỉ cấp access token (chìa khóa tạm), hết hạn là phải đăng nhập lại
• GitHub Apps - cấp cả access token lẫn refresh token (chìa khóa gia hạn), tự động gia hạn phiên làm việc

Keystatic bắt buộc cần refresh token. AI hướng dẫn mình tạo OAuth Apps - loại không có refresh token.

Mọi cấu hình trông có vẻ đúng - có Client ID, có Client Secret, callback URL chính xác. Nhưng Keystatic luôn báo lỗi xác thực vì không nhận được refresh token.

Mình mất nửa ngày xoay quanh các chi tiết - đổi callback URL > tạo lại Client Secret > kiểm tra biến môi trường trên server - trong khi vấn đề nằm ở bước đầu tiên: sai loại ứng dụng.

Cuối cùng, mình yêu cầu AI hướng dẫn lại từ đầu, kiểm tra từng bước một. Lúc đó nó mới nhận ra - và mình mới biết - rằng mình đang dùng OAuth Apps thay vì GitHub Apps.

Đây không phải lỗi duy nhất

Nhìn lại cả tuần build, mình thấy ít nhất 3 lần AI đưa ra gợi ý sai hoặc thiếu sót:

Lần 1: Mình cần đồng nghiệp không biết kỹ thuật có thể tự viết blog. AI đề xuất dựng thêm Payload CMS - một ứng dụng web riêng biệt chỉ để...

Ngồi brainstorm để tối ưu lại kiến trúc mới cho blog này, có một câu Claude nó nói làm mình bừng tỉnh:

The best architecture is the simplest one that works.

Bữa nay thì có AI cũng tiện ha, và không có nhưng 🙈

Mình nhận ra là khi mình chê một thứ gì đó thì thường mình đang ở một trong hai trường hợp:
1. Mình chưa biết gì về nó
2. Mình đã quá hiểu về nó

Và lẽ dĩ nhiên, trong hầu hết các lần mình chê bai đều rơi vào (1) =))))

Sau khi đã hoàn thiện blog này, mình bắt đầu lên kế hoạch để chia sẻ về tư duy và cách tận dụng AI để người non-tech cũng có thể làm được.

Tự làm thì dễ, nhưng đem đi chia sẻ thì cần phải đóng gói lại làm sao để người vừa non-tech + chưa có trải nghiệm vibe coding trước đó cũng có thể bắt đầu dễ dàng, và sự ố dề thinking của mình bắt đầu trỗi dậy.

Đầu tiên, mình nghĩ ai cũng muốn có một giao diện mang đậm cá tính của riêng mình
—> Cách đơn giản nhất là tạo sẵn vài con theme với các phong cách khác nhau để lựa chọn, sau đó thì có một file config.. user chỉ cần thao tác trên một file duy nhất để thay đổi theme, màu sắc, thông tin,..

Tiếp theo,..

À mà khoan. Đây là lúc mình bừng tỉnh sau 7749 đoạn brainstorm và triển khai với AI nè. Đoạn này là mình đã làm xong luôn phần cấu hình (theme settings, đa ngôn ngữ,..) và vài con theme với các phong cách khác nhau rồi.

Quay lại mục tiêu chính khi mình bắt đầu là gì? “Mình muốn có một giải pháp tốt để người mới dễ bắt đầu.”
—> Giải pháp hiện tại quá phức tạp để người mới hiểu (và để mình giải thích cho người mới hiểu), nó chỉ tiện nếu người khác muốn dùng luôn, đổi theme phát một và không phải tuỳ chỉnh gì thêm ngoài mấy thiết lập được cung cấp sẵn.

Mà phức tạp vậy thì đâu có tốt, nên mình quay xe!

Hiện tại mình đã “clean up” source code, quay về với phiên bản tinh gọn và vừa đủ dùng.
—> Thay vì build sẵn mọi thứ, mình cần tập trung làm tốt nhất phiên bản tinh gọn, sau đó hướng dẫn người mới cách để từ bản tinh gọn này prompt thế nào, workflow ra sao, sử dụng kỹ thuật hoặc từ khoá gì, vào lúc nào,.. để giúp họ tự có khả năng làm được một phiên bản của chính mình. Rõ ràng đây mới là mục tiêu ban đầu mình hướng tới.

Đó, cứ brainstorm một hồi là tự nhiên mình muốn làm nhiều thứ lắm, cảm giác nó rất “đúng”, rất “wow” luôn. Nhưng sự thật là nó bị “over-engineering” và đẩy mình trượt khỏi mục tiêu ban đầu lúc nào không hay..!!

Vẫn phải nói lại, có AI cũng tiện nhưng mà cũng đáng sợ quá hen!

Mình vừa build xong kiến trúc mới cho chiếc blog này.

Tóm tắt:
- Trước đây: Static Site Generation
- Version 2: Server-Side Rendering

Kế hoạch tiếp theo:
- Thử nghiệm một phiên bản với Editor chính là Notion thay vì Obsidian.