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.
8 skill nối đuôi (6 build + 2 bảo trì), 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ế ─────────────────────────────────────────────────────┘
│ ship lần đầu
/kry-done ◄── /kry-update <feature|fix> ◄── /kry-docs ◄─────┘
↺ (commit) (act 8: thêm/sửa) (act 7: bản đồ docs)
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) |
| Ship xong, mỗi lần sửa lại đọc cả repo | kry-docs sinh bản đồ docs 5 file (FEATURES ↔ file, ARCHITECTURE, DECISIONS, RUNBOOK) ngay sau ship; kry-update đọc bản đồ đó để thêm tính năng / fix đúng chỗ |
| Fix bug rồi bug lặp | kry-update mode fix: root cause trước, rồi cài learning vào guardrail → checklist → gotcha (RUNBOOK), không chỉ ghi nhớ |
| # | 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 + chỉ cửa kế (docs / update) | (không cần) |
| 7 | kry-docs | sau ship lần đầu: đọc code thật + spec → README + docs/{FEATURES,ARCHITECTURE,DECISIONS,RUNBOOK}, verify path/lệnh/env, cấm bịa |
(không cần, verify bằng lệnh) |
| 8 | kry-update | vòng bảo trì <feature|fix>: đọc docs thay vì cả repo → phân cửa → plan duyệt → build → regression → docs delta → /kry-done |
challenger-system (đụng schema/auth) · challenger-ux (flow mới) · test-runner |
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 + 2 skill bảo trì (docs/update) + 5 agent.
/kry-done (ship v1.0.0) → /kry-docs → /kry-update feature "thêm X" → /kry-done (v1.1.0)
↺ /kry-update fix "lỗi Y" → /kry-done (v1.1.1)
kry-docschạy 1 lần sau ship đầu (và--refreshkhi docs lệch code). Sinh bản đồ để AI phiên sau đọc 10 phút thay vì đọc cả repo. File quan trọng nhất:docs/FEATURES.md(tính năng ↔ AC ↔ file/route/bảng ↔ version).kry-updatelà cửa duy nhất để sửa app đã ship. Gate: phải códocs/. Feature đụng schema/auth →challenger-systemgác như act 3. Fix → root cause trước, vá sau, rồi ghi gotcha vàoRUNBOOK.md. Xong luôn cập nhật docs delta rồi hand off/kry-done(feature = minor, fix = patch).
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ầ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ớiHoặc copy thủ công: skills/* → ~/.claude/skills/, agents/* → ~/.claude/agents/.
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.
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
→ /kry-docs # (sau ship lần đầu) bản đồ docs 5 file
# từ đây, mọi thay đổi:
/kry-update feature "cho khách tự huỷ lịch trước 24h"
/kry-update fix "email xác nhận không gửi khi thanh toán qua ví"
→ /kry-done # feature = minor · fix = patch
Mỗi lần dừng việc → /kry-done để không mất. Sau ship, không mở lại từ act 1: dùng /kry-update.
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.
7 skill còn lại (debrief · ux · system · ui · done · docs · update) + 5 agent tự đứng độc lập, không phụ thuộc lệnh ngoài. kry-update có bước build: dùng workflow code của bạn, phần plan/test/docs/version do skill lo.
docs/pipeline.html: sơ đồ 8 act / 2 cửa + vòng bảo trì (mở bằng trình duyệt).docs/spec-template.html— template đặc tả UX 6 Lớp (Mermaid + bảng).
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.
MIT — xài thoải mái. Xem LICENSE.
Tài liệu / pattern agent học từ claudekit-engineer.