Biến request thành contract, rồi mới thành code đã verify.
CafeKit đưa phần quan trọng ra khỏi chat. Assistant viết contract trước, implement một task packet đã approve, sau đó prove bằng evidence và sync state.
Người dùng yêu cầu một thay đổi.
Scope C1/C2, plan và flat tasks thành file bền vững.
Assistant implement một task packet đã approve.
Command thật và runtime proof kiểm tra kết quả.
Một pass riêng kiểm tra compliance và risk.
State chỉ được chuyển khi đã có evidence.
Bản đơn giản#
Spec là contract bền vững, không phải chat memory. New work lưu contract trong specs/<feature>/plan.md và flat task-NN-*.md.
Viết rõ điều cần xảy ra trước khi sửa code.
Chỉ implement đúng boundary của task đã approve.
Chạy command và ghi lại evidence chính xác.
Update task Status và inline Receipt sau khi có proof.
Mỗi artifact trả lời gì#
Scope C1/C2 đã duyệt, task index, ownership, dependencies và completion boundary.
Một flat task gồm Outcome, Scope, Acceptance và Verification Plan.
Exact command, exit, Base/Head hiện tại và current output không rỗng.
| Artifact | Câu hỏi |
|---|---|
plan.md | Outcome, scope, exclusions, acceptance, decisions và task map nào đã được duyệt? |
task-NN-*.md | Một outcome nào executable, ai sở hữu và exact proof nào bắt buộc? |
Final inline ## Receipt | Command và current output nào chứng minh task pass? |
Working rule#
- Chỉ brainstorm khi intent hoặc architecture chưa giải quyết.
- Specs mở C1, viết plan/tasks rồi trình C2 findings.
- Planning dừng; chỉ bắt đầu bằng invocation develop mới.
- Develop chạy một unblocked task; test và code review verify.
- Sync chỉ Status/proof đã quan sát; user quyết định completion tại C3.
Dùng full path cho work đáng kể, risk cao, multi-file, runtime, data, auth, package hoặc cần handoff. Clear isolated routine change một-hai file có thể làm trực tiếp.
Đọc Workflow chính và Vòng đời spec.