CafeKit runtimecho AI coding có kiểm chứng
Biến prompt rời rạc thành luồng delivery có spec, task boundary, verification gate và state sync. Ưu tiên Claude Code, có hỗ trợ OpenCode.
npx @haposoft/cafekitTừ prompt đầu tiên đến release có kiểm chứng
CafeKit cài một lớp vận hành vào repo: tạo spec, chia task packet, triển khai từng task, chạy test/review, đồng bộ state và bàn giao release bằng stack sẵn có.
Cài runtime vào repo
Bootstrap CafeKit vào project Claude Code hoặc OpenCode mà không chạm vào code ứng dụng.
Cài skills, agents, hooks, rules, statusline và workflow context vào `.claude` hoặc `.opencode`.
Ghi metadata phiên bản và ownership manifest để lần cài sau preserve user edits.
Đưa repo sang command surface spec-driven thay vì phụ thuộc vào prompt dài.
Chạy `npx @haposoft/cafekit` ở root của project.
Repo sẵn sàng chạy các workflow `hapo:*` với runtime project-local.
Điểm khác biệt
CafeKit không cố làm agent thông minh hơn bằng prompt dài. Nó đặt agent vào một runtime có state, artifacts và gates để tiến độ không bị giả xanh.
Không có CafeKit
Mỗi session phải giải thích lại context, scope và cách làm
Spec dễ lệch khỏi implementation sau lượt code đầu tiên
Task có thể bị mark done dù build, test hoặc runtime proof vẫn thiếu
Docs thường bị dồn cuối, cập nhật thiếu hoặc bỏ qua
Có CafeKit
Spec trở thành artifact có validation, task registry và readiness gate
Implementation đi theo từng task packet đã có completion criteria và Evidence
Quality gate chặn fake progress trước khi sync state sang done
Docs checkpoint chạy theo task đã verify thay vì dồn vào cuối release
CafeKit cài gì vào repo
Installer chỉ cài workflow/runtime infrastructure vào `.claude` hoặc `.opencode`. Code ứng dụng không bị chạm cho đến khi bạn chạy workflow cho một feature thật.
.claude/skills
Bộ skill tạo command surface cho question, brainstorm, specs, develop, test, review, docs, sync và git.
.claude/hooks
Hook nhắc state/spec drift, chặn đọc dữ liệu nhạy cảm, inject context phiên làm việc và cập nhật usage.
.claude/agents
Subagent chuyên trách inspect, spec, develop, test, review, docs, git và deployment handoff.
.claude/rules
Rule vận hành giữ scope, spec state, quality gate, docs sync và Git handoff đi cùng nhau.
Code ứng dụng
Được giữ nguyên trong lúc cài đặt. CafeKit chỉ sửa app khi bạn giao một task implementation rõ ràng.
Cài runtime, chạy flow đầu tiên
Cài CafeKit, tạo spec đã validate, triển khai một task có Evidence, rồi test/review trước khi Git handoff.
# 1. Cài đặt CafeKit$ npx @haposoft/cafekit# 2. Tạo và validate spec$ /hapo:specs Build a user authentication system$ /hapo:specs --validate user-authentication# 3. Triển khai từng task packet$ /hapo:develop user-authentication task-R0-02-auth-setup-dual-mode.md# 4. Test và review candidate$ /hapo:test --full$ /hapo:code-review --pending# 5. Commit, push và bàn giao release$ /hapo:git commit$ /hapo:git push$ vercel --prod
Mới biết CafeKit?
Đi từ repo chưa cài gì đến feature đầu tiên có spec, task và verification receipt.
Artifacts thật sau mỗi bước
CafeKit để lại file, registry và receipt để reviewer biết task nào đã sẵn sàng, task nào còn thiếu evidence.
Mở tài liệuMachine state cho phase, validation status, task registry và readiness gate.
Task packet có objective, scope boundary, completion criteria và Evidence commands.
Structured verdict cho biết code đã đủ điều kiện merge, Git handoff hoặc release chưa.
Liên hệ với chúng tôi
Kể về dự án của bạn hoặc đặt câu hỏi. Chúng tôi thường trả lời trong một ngày làm việc.