Kry Build Pipeline

Quy trình build app/SaaS hoàn chỉnh cho người nocode, chạy bằng Claude Code skills + sub-agents. Từ "đống ý tưởng vừa họp xong" → spec đầy đủ → build → ship, không rớt luồng, không mất commit.

6 skill nối đuôi — mỗi cái có agent phản biện (giọng tư duy nguyên lý gốc + gu thẩm mỹ khắt khe) để chống bias từ chính lời bạn nhắn và điền những lỗ hổng người nocode không biết để hỏi.

/kry-debrief → /kry-ux → /kry-system → /kry-ui → /kry-plan→cook→qc → [changelog+ver] → /kry-done
   (Brief+git+cron)  (hành vi)  (data+kiến trúc)  (thiết kế)  (build+test)  (log đã-ship)  (commit+push)
        ▲ cron telegram nhắc bước kế ─────────────────────────────────────────────────────┘

Vì sao

Người build solo nocode thua không phải vì code — mà vì mất luồng + mất việc đã làm. Và vì không biết cái mình không biết (input thiếu/bias). Pipeline này giải 2 thứ đó:

Vấn đề	Giải pháp trong pipeline
Mất việc	commit Business Brief vào git ngày 0 + `kry-done` checkpoint mỗi lần dừng
Mất thông tin sau ship	mỗi build bump version + append `CHANGELOG.md` (sổ việc-đã-ship) — bổ trợ `PROGRESS.md` (việc-đang-làm)
Rớt luồng	cron telegram nhắc "project X đang ở bước nào, làm gì tiếp"
Không biết mình thiếu gì	agent phản biện cãi lại bạn + điền lỗ (state/edge · security/race · cliché/breakthrough)
Sửa nền sai = đắt	tách cửa 1 chiều (data/kiến trúc/thiết kế nền, làm kỹ 1 lần) vs cửa 2 chiều (feature/UI, lặp nhanh)

6 Skill

#	Skill	Làm gì	Agent phản biện
1	kry-debrief	dump thô → Business Brief có cấu trúc + tạo repo git + commit Brief + (tuỳ chọn) cron nhắc	`debrief-analyst`
2	kry-ux / kry-ux-website	đặc tả hành vi: flow theo intent · rule→tiêu chí nghiệm thu · màn · trạng thái	`challenger-ux`
3	kry-system	data model + kiến trúc + auth + stack (define tươi cho app này)	`challenger-system`
4	kry-ui	ngôn ngữ thiết kế riêng cho app (mood + nguyên tắc + 1 trục đột phá)	`challenger-ui`
5	kry-plan → cook → qc	chia lát dọc → build → test đối chiếu spec → report	`test-runner`
6	kry-done	dọn + bump version + append CHANGELOG.md + commit + push + cập nhật sổ project-state	—

Act 5 (plan/cook/qc) dùng workflow code của riêng bạn / Claude Code thường + agent test-runner để verify. Repo này tập trung 4 skill đặc tả (debrief/system/ui/done) + 2 skill UX + 5 agent.

5 Agent (`agents/`)

debrief-analyst — bóc đống ý tưởng hỗn → Business Brief (vai · luật · entity · hành trình · tích hợp · 🚩 câu hỏi mở). Cấm bịa, chỉ đánh dấu chỗ thiếu.
challenger-ux / challenger-system / challenger-ui — 3 agent chuyên môn riêng, giọng Nguyên-lý × Gu, cãi lại bạn để bạn tỉnh + chỉ ra cái bạn quên.
test-runner — chạy lại test đối chiếu spec → report PASS/FAIL có dẫn chứng.

Cài đặt

Cần Claude Code (CLI).

git clone https://github.com/dangpm/kry-build-pipeline.git
cd kry-build-pipeline
bash install.sh        # copy skills + agents vào ~/.claude/
# rồi RESTART Claude Code để nạp skill + agent mới

Hoặc copy thủ công: skills/* → ~/.claude/skills/, agents/* → ~/.claude/agents/.

Cấu hình (tuỳ chọn)

Phần kickoff git + cron nhắc cần config riêng của bạn — copy config.example.json → config.json và điền:

{
  "github_user": "your-github-username",
  "repo_private": true,
  "telegram": { "bot_token": "", "chat_id": "" },
  "reminder_host": "",
  "reminder_time": "09:00"
}

github_user — nơi tạo repo project. Để trống → skill chỉ tạo Brief, không tạo repo.
telegram — bot + chat_id để nhận nhắc. Để trống → bỏ qua phần nhắc.
reminder_host — máy chủ chạy cron (ssh). Để trống → không cài cron, dùng pipeline thủ công.

Pipeline vẫn chạy được nếu bỏ trống hết config — chỉ mất phần tự-nhắc, còn lại (Brief → spec → build) hoạt động bình thường.

Cách dùng

team họp xong → /kry-debrief "<dán đống ý tưởng vào đây>"
→ trả lời các 🚩 câu hỏi agent nêu ra
→ /kry-ux        # đặc tả hành vi
→ /kry-system    # data + kiến trúc
→ /kry-ui        # ngôn ngữ thiết kế
→ build từng lát (Claude Code) + /kry-qc với agent test-runner
→ /kry-done      # chốt: commit + push

Mỗi lần dừng việc → /kry-done để không mất.

Lưu ý tương thích

Bước 5 (build/test/ship) trỏ tới /kry-plan /kry-cook /kry-qc — đây là bộ lệnh build riêng của tác giả, repo này KHÔNG ship. Bạn thay bằng workflow code của mình (Claude Code thường, Cursor, hay code tay) + agent test-runner (có sẵn trong repo) để verify đối chiếu spec.

5 skill còn lại (debrief · ux · system · ui · done) + 5 agent tự đứng độc lập, không phụ thuộc lệnh ngoài.

Trực quan

docs/pipeline.html — sơ đồ 6 act / 2 cửa (mở bằng trình duyệt).
docs/spec-template.html — template đặc tả UX 6 Lớp (Mermaid + bảng).

Triết lý

Thấu hiểu = biết intent người dùng tại từng khoảnh khắc, không phải mình muốn nói gì.
Agent = nghi ngờ yêu cầu, kể cả yêu cầu của chính bạn. Bạn nocode = không biết cái mình không biết. Agent cãi để bạn tỉnh ra, không phải để bạn vui.

License

MIT — xài thoải mái. Xem LICENSE.

Tài liệu / pattern agent học từ claudekit-engineer.