Công cụ AI viết code rất giỏi, nhưng chúng không hiểu kiến trúc của bạn

Chúng tôi rất yêu thích Cursor. Chúng tôi rất yêu thích Claude. Chúng tôi cũng rất yêu thích Copilot.

Tuy nhiên, cách đây sáu tháng, chúng tôi nhận thấy một vấn đề đang âm thầm phá vỡ kho mã nguồn (codebase) của mình.

Đó không phải là lỗi (bugs). Đó cũng không phải là code xấu. Đó là sự lệch pha (drift).

Các công cụ AI của chúng tôi liên tục tạo ra những đoạn mã hoàn toàn có chức năng, nhưng dần dần vi phạm các quyết định mà nhóm đã đưa ra trước đó. Đó là mẫu Repository (Repository pattern) mà chúng ta đã thống nhất. Đó là thư viện quản lý trạng thái (state management library) mà chúng ta đã chọn sau hai tuần tranh luận. Đó là phương pháp xác thực (validation) mà kỹ sư cấp cao của chúng ta kiên quyết áp dụng.

Vấn đề là AI không thể đọc được bất kỳ điều nào ở những nơi chứa thông tin đó.

Những quyết định này nằm ở:

• Một luồng trò chuyện trên Slack từ 8 tháng trước
• Một file ARCHITECTURE.md không ai chạm vào trong cả năm qua
• Ba file .cursorrules mâu thuẫn nhau
• Trong trí nhớ của một kỹ sư cấp cao

Vì vậy, AI đã phải đoán mò. Và mỗi lần đoán sai lại thêm một viên gạch vào sự lệch pha của kiến trúc.

Giải pháp chúng tôi xây dựng: Hopsule

Hopsule là một lớp bộ nhớ nằm giữa các quyết định của nhóm và các công cụ AI của bạn.

Bạn chỉ cần ghi lại quyết định một lần. Hopsule sẽ cấu trúc nó, phiên bản hóa (versioning) và tự động đưa nó vào mọi phiên làm việc với AI thông qua MCP (Model Context Protocol).

Ví dụ thực tế

Nhóm của bạn quyết định: "Mọi truy cập cơ sở dữ liệu phải đi qua lớp Repository."

Mọi phiên làm việc với Cursor, Claude hay Copilot sau đó đều sẽ biết quy tắc này, mà bạn không cần phải gõ lại lời nhắc nào nữa.

Mô hình hoạt động

Con người đưa ra quyết định. Hopsule lưu trữ. AI tuân theo.

Tính năng chính

• MCP Server: Tương thích với Cursor, Claude, Copilot.
• Tiện ích mở rộng IDE: Hỗ trợ thực thi trực tiếp (inline enforcement).
• Công cụ CLI: Cài đặt dễ dàng qua npm i -g hopsule.
• Vòng đời quyết định: Quản lý từ bản nháp (Draft) → Được chấp nhận (Accepted) → Lỗi thời (Deprecated).
• Đồng bộ GitHub: Giữ cho tài liệu luôn cập nhật với kho mã.
• Đồ thị quyết định (Decision Graph): Trực quan hóa các mối liên kết kiến trúc.

Chế độ tư vấn: Chúng tôi không bao giờ chặn code của bạn, mà chỉ chỉ ra các xung đột xảy ra tại chỗ.

Câu hỏi dành cho các lập trình viên

Làm thế nào bạn đang giữ cho các công cụ AI của mình đồng bộ với kiến trúc hiện tại? Bạn có dùng .cursorrules? ARCHITECTURE.md? Hay không làm gì cả?

Rất mong muốn nghe những gì đang hiệu quả và những gì không.

🔗 hopsule.com — Phiên bản Beta công khai, miễn phí dùng thử.