Bắt đầu nhanh
First run

Đưa một feature qua vòng verify.

Tạo spec, validate, implement một task packet, rồi test, review, và sync completion khi đã có proof.

Mới biết CafeKit? Trang này dành cho người đã hiểu workflow. Nếu bạn bắt đầu từ con số 0, hãy theo hướng dẫn từng bước — dắt tay từ chưa cài gì đến feature đầu tiên đã verify.

1. Cài CafeKit#

npx @haposoft/cafekit

Nếu idea chưa đủ rõ để viết specs, dùng /hapo:brainstorm trước để làm rõ scope và architecture. Delivery run chính bắt đầu từ specs.

2. Tạo spec#

/hapo:specs Build a meeting transcript extension with AI summaries

CafeKit tạo:

specs/<feature>/
├── spec.json
├── requirements.md
├── research.md
├── design.md
└── tasks/task-R0-01-*.md

3. Validate trước khi code#

/hapo:specs --validate <feature>

Validation kiểm tra requirements, design, task files, task_files, và task_registry có khớp nhau không.

4. Implement một task packet#

/hapo:develop <feature> tasks/task-R0-01-project-scaffold.md

Task-by-task là default an toàn nhất: diff nhỏ hơn và evidence dễ verify hơn.

5. Test và review#

/hapo:test --full
/hapo:code-review --pending

NO_TESTS không phải success. Task chỉ nên thành done khi implementation, evidence, tests, review, và state sync cùng đồng ý.

6. Sync sau khi có proof#

/hapo:sync <feature> task-R0-01-project-scaffold.md done

Command này update spec.json.task_registry và task markdown tương ứng. Nếu state có vẻ lệch, chạy /hapo:sync audit <feature> thay vì đoán.

Đọc Workflow chính để hiểu đầy đủ lý do sau từng gate.

Scope

Task files and scope_lock define what may change.

Evidence

Exact commands and runtime proof must be fresh.

Review

Critical findings block task completion.

Sync

spec.json and markdown state move together.