Runtime spec-driven cho AI coding trong repo thật.
CafeKit cài skills, agents, hooks, state checks, và quality gates vào repo để assistant đi từ ý tưởng đến implementation đã verify mà không trôi vào kiểu prompt ngẫu hứng.
CafeKit là gì#
CafeKit là runtime bundle đặt trong repo cho AI coding assistants. Package hiện tại là @haposoft/cafekit, cài bằng npx @haposoft/cafekit.
Nó tạo workflow có cấu trúc quanh Claude Code và OpenCode:
The docs should always point back to this contract loop.
Turn intent into scope, evidence, requirements, design, and task packets.
Implement one approved task packet, not the whole chat memory.
Run exact evidence commands and runtime checks.
Review for spec compliance, regressions, security, and drift.
Update task_registry and task markdown only after proof, or audit drift.
Bắt đầu bằng SDD#
CafeKit xoay quanh specification-driven development: ý tưởng chỉ thành code sau khi thành contract có source backing. Bắt đầu bằng trang trực quan: Spec-driven development.
Sau đó đọc sâu theo đường: Workflow chính → Vòng đời spec → Skills.
Cài những gì#
CafeKit cài một runtime thật, không chỉ là vài đoạn hướng dẫn.
29 packaged workflows and domain capabilities
13 specialist agents for planning, code, QA, docs, git, and deploy
Privacy, scope, state, usage, docs sync, and spec-state gates
Runtime configuration, paths, locale, usage, and model hints
Claude Code hook wiring and statusline command
Git, context, usage, task, and agent statusline
Package hiện tại có 30 skills, 13 agents, installer support cho Claude Code và OpenCode, cùng các validator deterministic cho spec và docs bundle.
Nên đọc thế nào#
Nếu mới bắt đầu, đọc theo thứ tự:
Nếu đã quen workflow, đi thẳng tới Skills, Agents, hoặc Tham khảo.
Cam kết cốt lõi#
CafeKit không cố làm assistant nhanh hơn bằng cách bỏ quy trình. Nó làm assistant an toàn hơn bằng source-backed context, task boundary rõ, verify mới, adversarial review, và state sync.
Task files and scope_lock define what may change.
Exact commands and runtime proof must be fresh.
Critical findings block task completion.
spec.json and markdown state move together.