VHK - Harness lập trình AI full-cycle không bị sụp đổ ngay cả khi đổi model hay agent

Khi làm vibe coding, tôi thường đổi công cụ khá nhiều. Đang dùng Claude Code rồi sang Cursor, rồi lại Codex... Mỗi lần như vậy, file quy tắc và ngữ cảnh lại bị phân tán, còn agent thì bảo là "xong rồi" nhưng thực tế nhiều khi test còn chưa chạy. Vì không muốn lần nào cũng phải tự tay
dọn dẹp, tôi đã làm ra CLI harness này.

VHK không phải là coding agent. Dù bạn dùng agent nào, nó sẽ nằm bên trên để cố định quy tắc, đặc tả, bằng chứng và bộ nhớ ngay trong repo. Kể cả khi đổi hẳn model, các file này vẫn còn nguyên.

Tính năng chính

• Đồng bộ quy tắc: chỉ cần quản lý một RULES.md, VHK sẽ tự động căn chỉnh 8 file quy tắc của công cụ như .cursorrules, CLAUDE.md, copilot-instructions v.v.
• Cổng bằng chứng: verify / review / receipt / preflight. Đặc biệt, receipt dùng bằng chứng máy như mã thoát của tsc·test·build để bắt các trường hợp "hoàn thành giả" (không dùng LLM để phán định).
• Tự tiến hóa: các bài học tích lũy theo từng phiên được gom vào memory/pattern và được đề xuất thành ứng viên quy tắc. Dùng càng nhiều, nó càng được tinh chỉnh theo đúng dự án này.
• Full-cycle: từ kiểm chứng ý tưởng đến phát triển·xác minh, rồi sau triển khai còn nối tiếp tới nội dung·vận hành·bản thảo bán hàng bằng các lệnh (đăng bài·thanh toán thì con người làm).
• Ngôn ngữ tự nhiên tiếng Hàn: cũng có thể định tuyến bằng tiếng Hàn như "vhk luu-giup-toi", "vhk xuat-kho-kiem-tra".

Mục tiêu không phải là thay thế agent, mà là đảm nhận phần lặp lại, ghi nhớ và gate mà agent thường làm chưa tốt.

Nói thật thì đây là dự án một người nên ưu tiên tiếng Hàn trước, còn tài liệu tiếng Anh vẫn đang theo sau. Nếu có chỗ nào còn thô, cứ thoải mái góp ý nhé.

Cài đặt: npm i -g @byh3071/vhk
GitHub: https://github.com/byh3071-cpu/vhk (MIT · MCP 35 tools · Node 22+)

Tự làm một mình mà cũng đã đi tới v2.9.0 rồi. Nếu bạn cũng thấy dự án bị chao đảo mỗi lần đổi model, rất mong nhận được phản hồi.