CafeKit cup logo
CafeKit
Spec-driven runtime
Runtime Claude Code-first cho quy trình spec-driven

Claude Code-firstCafeKit runtime

Xây dựng từ spec đã được duyệt, triển khai từng task đã verify, và giữ docs luôn đồng bộ. Claude Code dùng được ngay.

Claude Code available now
npx @haposoft/cafekit
Spec gates
validate first
Task state
registry-backed
Docs
checkpoint per task
~ /cafekit-runtime
Install
Create spec
Approve C2
Develop
Test
$
Active Loop
specs → develop → test
Task Packet
R0-02 auth setup

Một runtime xuyên suốt từ prompt đầu tiên tới release

Cài runtime, đi qua specs, develop, test, review, git handoff rồi ship bằng stack deploy hiện có của bạn.

Runtime Workflow

Cài runtime bundle

Khởi tạo CafeKit vào project Claude Code trước khi bắt đầu bất kỳ feature nào.

Active Loop
install → specs → develop → test → review → git → deploy
Điều Gì Xảy Ra

Cài skills, hooks, rules, statusline và workflow context vào `.claude`.

Đưa project sang command surface spec-driven thay vì prompt rời rạc.

Claude Code là runtime chính đang được hỗ trợ ngay lúc này.

Điểm Cần Giữ Chặt
Command

Chạy `npx @haposoft/cafekit` ở root của project.

Kết quả

Repo sẵn sàng chạy `cf:*` workflow ngay.

Điểm khác biệt thật sự

CafeKit thuyết phục nhất khi người dùng nhìn ra sự khác nhau giữa prompt rời rạc và một runtime có state.

Không có CafeKit

Prompt dài và phải giải thích lại mỗi session

Spec lệch khỏi implementation sau lượt code đầu tiên

Task nhìn như xong trong markdown dù build hoặc test vẫn đỏ

Docs bị dồn cuối, cập nhật thiếu hoặc không có

Có CafeKit

Spec trở thành runtime artifact có validate và task boundary

Implementation đi theo từng verified task packet

Quality gate chặn fake progress trước khi sync state

Docs checkpoint chạy tăng dần thay vì dồn cuối

CafeKit cài những gì

Người mới luôn muốn biết CafeKit có sửa app hay chỉ cài workflow infrastructure. Nên nói thật rất rõ.

.claude/skills

Command surface cho specs, develop, test, review, git và sync.

.claude/hooks

State reminders, privacy guardrails và runtime context injection quanh Claude Code.

.claude/agents

Các agent chuyên biệt cho test, review, docs, sync và workflow enforcement trong quá trình delivery.

.claude/rules

Rule giữ spec state, quality gate, docs sync và Git handoff đi cùng nhau.

Code ứng dụng

Không bị đụng tới cho đến khi bạn chủ động chạy workflow spec và task cho một feature thật.

Không khóa framework. Chạy trong repo sẵn có và nói rõ nó đang làm gì.

Sẵn sàng chỉ sau vài giây

Cài CafeKit, tạo và validate spec, triển khai một task, verify nó, rồi commit và deploy bằng release stack hiện tại.

# 1. Cài đặt CafeKit$ npx @haposoft/cafekit # 2. Tạo và validate spec cho feature$ /cf:specs Build a user authentication system$ Accept all  # C2 # 3. Triển khai từng task packet$ /cf:develop user-authentication # 4. Verify và review release candidate$ /cf:test --full$ /cf:code-review --pending # 5. Commit, push và deploy$ /cf:git commit$ /cf:git push$ vercel --prod
Xem hướng dẫn bắt đầu nhanh đầy đủ

Mới biết CafeKit?

Bắt đầu từ con số 0 — từng bước từ chưa cài gì đến feature đầu tiên đã verify.

Bắt đầu hướng dẫn

Hãy nhìn artifact thật, không chỉ nhìn command

Người mới tin CafeKit nhanh hơn khi họ hình dung được file và receipt mà runtime để lại.

Mở tài liệu
specs/meet-transcript-mvp/
plan.md

C1 scope, acceptance criteria, exclusions, decisions và flat task map.

task-NN-*.md

Flat task có một outcome, một Status, ownership, dependencies và proof command.

review + test verdict

Structured signals cho biết code đã thật sự sẵn sàng để merge và ship hay 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.

0/10000