Quy trình làm việc

Quy trình phát triển sản phẩm tại PrimeCommerce theo mô hình GitHub Flow, phối hợp 5 vai trò: PM, Design, Dev, QA, DevOps.

Quy tắc bắt buộc:

Không code UI khi chưa có Design specs — Dev phải đợi Design hoàn thành UI specs/mockups
Không deploy khi chưa qua QA — QA phải sign-off trước khi merge staging → main
Mọi PR cần 1 approval + CI pass — không merge thẳng, không skip review
Không dùng --no-verify / --force-push / git reset --hard trừ khi PM approve

Cập nhật bộ claudekit mới: ClaudeKit đã bỏ các subcommand cũ (/fix:test, /fix:ui, /cook:auto, /design:good…). Xem tools-overview cho mapping cũ → mới.

Tổng quan luồng công việc

Pipeline chuẩn — Vibe (autonomous)

Với feature/bugfix đơn giản đã có GitHub issue, dùng /vibe để chạy full pipeline một lệnh: worktree → plan (TDD) → validate → cook/fix → code-review → ship PR → review-pr → merge (nếu --ship) → watch CI.

# Feature từ issue #123, auto-merge sau khi review PR OK
/vibe --ship https://github.com/primeproduction/skils-hub-prime/issues/123

# Bugfix từ mô tả tự nhiên, dừng ở "ready to ship stable"
/vibe "sửa lỗi checkout không load được tổng tiền"

# Ship beta thay vì stable
/vibe --ship --beta #123

Pipeline vibe gồm 10 bước, mỗi bước gate riêng — xem chi tiết ở dev/overview. Khi nào KHÔNG dùng /vibe:

Task lớn cross-team (cần Design handoff riêng)
Refactor rủi ro cao cần plan review từ Eng Manager
Task chưa rõ scope — dùng /plan-ceo-review trước

Sprint 1 tuần

Sprint Planning — Thứ Hai

Ai: PM Làm gì:

Tạo tickets trên GitHub Projects
Assign issues cho dev
Ưu tiên backlog
Review PRD với Design team để align UI requirements

Công cụ:

/sprint-plan
/prd "mô tả tính năng"
/docs-project:full "feature"     # PRD → UI Specs → QA Plan (1 lệnh)
/estimate                        # Ước lượng effort theo velocity
/gate-check                      # Validate ready advance phase

UI/UX Design — Thứ Hai đến Thứ Ba

Ai: Design Làm gì:

Đọc PRD, tạo UI specs và mockups
Design trong Figma hoặc generate bằng Stitch AI
Review với PM — confirm đúng requirements
Handoff cho Dev — share Figma link + component specs

Công cụ:

/stitch "mô tả screen"           # AI generate UI design (thay /design:good cũ)
/design-shotgun                  # Sinh nhiều variant song song để so sánh
/design-html                     # Finalize design → production HTML/CSS
/design-consultation             # Tạo DESIGN.md (design system source of truth)
/huashu-design:prototype         # HTML hi-fi prototype nhiều screens
/figma:figma-generate-design     # Generate design trong Figma
/docs-project:ui                 # Tạo UI Design Specs từ PRD

Handoff checklist Design → Dev:

Figma link với đầy đủ screens + states (hover, active, error, empty)
Component specs (spacing, colors, typography)
Responsive breakpoints (mobile, tablet, desktop)
Interaction specs (animations, transitions)
DESIGN.md cho project mới (tạo bằng /design-consultation)

Development — Thứ Ba đến Thứ Năm

Ai: Dev Làm gì:

Tạo branch feat/FXX-YY-mo-ta (hoặc dùng /worktree cho parallel work)
Code theo Design specs + PRD
Viết tests (TDD nếu core logic)
Tạo PR vào staging

Công cụ khuyến nghị (theo bộ mới):

# Autonomous (fastest)
/vibe --ship #123                # Full pipeline: plan→code→PR→merge

# Manual step-by-step
/plan "mô tả tính năng"          # Skill ck-plan (không còn /plan:fast, /plan:hard)
/cook                            # Implement (không còn /cook:auto)
/fix                             # Auto-route: bug/test/CI/UI/types
/investigate                     # Debug với "no fix without root cause"
/verify                          # Chạy app xác nhận change thật sự work

# Hỗ trợ
/worktree                        # Isolated git worktree
/checkpoint                      # Save state để resume sau
/watzup                          # Handoff report cuối session

Đã BỎ trong bộ mới: /fix:test, /fix:ui, /fix:ci, /fix:types, /fix:hard, /fix:fast, /cook:auto, /cook:auto:parallel, /plan:fast, /plan:hard, /plan:two, /code:auto. Giờ chỉ dùng /fix, /cook, /plan — skill tự chọn strategy.

Code Review — Trong 4 giờ sau PR

Ai: Dev (reviewer) + Design (visual review nếu có UI) Làm gì:

Dev: Review correctness, security, performance
Design: Review UI match với mockups (cho PR có UI changes)
Approve hoặc request changes

Công cụ:

/code-review                     # Local review pending changes
/review-pr <#PR>                 # Review PR trên GitHub
/review-pr <#PR> --fix --reply   # Review + auto-fix + reply comments
/design-review                   # Visual QA + auto-fix cho UI PR
/plan-eng-review                 # Lock architecture (PR risky)

QA Testing — Sau merge vào staging

Ai: QA Làm gì:

Verify từng issue trên staging
Kiểm tra UI match design (responsive, interactions, edge states)
Gán label qa:passed hoặc qa:failed
Báo cáo bug nếu có

Công cụ:

/qa-full:verify-issue #66
/qa-full:check
/qa-full:accept docs/prd/F05.md
/qa-full:regression src/checkout.ts
/qa-full:tdd "feature"           # Viết failing tests trước
/qa-full:tdd:verify              # Xác nhận tests đã PASS sau /cook
/qa-full a11y https://staging... # Accessibility check
/qa-full security                # Security scan

Sprint Demo — Thứ Sáu

Ai: PM + Dev + Design Làm gì:

Demo trên staging cho stakeholders
Design confirm UI quality
Thu thập feedback

Công cụ:

/sprint-status                   # Snapshot burndown + risk
/retro                           # Sprint retrospective từ git activity

Release — Sau QA sign-off

Ai: DevOps Làm gì:

Merge staging vào main
Deploy production
Monitor sau deploy

Công cụ (bộ mới):

/land-and-deploy                 # Merge PR → chờ CI → deploy → canary verify
/deploy                          # Auto-detect platform (Vercel/Netlify/Fly...)
/canary                          # Post-deploy monitoring (screenshot + perf diff)
/health                          # Code quality dashboard 0-10 score

# PrimeCommerce custom pages (không phải command)
/deploy-checklist                # Xem devops/deploy-checklist
/health-check                    # Xem devops/health-check

Quy trình QA theo sprint

# Đầu sprint:
/qa-full:audit                    # Xem tình trạng dự án

# Trong sprint (mỗi ngày):
/qa-full:verify-issue #N          # Verify issues được assign

# TDD flow cho feature quan trọng (auth, payment, core logic):
/qa-full:tdd "feature"            # Viết failing tests TRƯỚC
/cook                             # Dev implement
/qa-full:tdd:verify               # Xác nhận tests PASS, không cheat

# Cuối sprint:
/qa-full:check                    # Bổ sung tests thiếu
/qa-full:full --skip-gen          # Chạy full QA
/qa-full:accept docs/prd/F*.md    # Nghiệm thu theo PRD
/qa-full:regression src/file.ts   # Kiểm tra hồi quy sau fix

# Trước release:
/qa-full:full                     # Full QA
/qa-full e2e https://staging...   # E2E
/qa-full security                 # Bảo mật

Daily Standup

Hàng ngày qua Lark, trả lời 3 câu hỏi:

Hôm qua làm gì?
Hôm nay sẽ làm gì?
Có blocker nào?

Công cụ hỗ trợ:

/watzup                           # Auto-generate handoff report từ git + worktrees
/sprint-status                    # Fast sprint status check

Git Flow

Feature (vibe)
Feature (manual)
Bug Fix
Hotfix

# Vibe tự tạo worktree + branch + PR + merge
/vibe --ship https://github.com/primeproduction/skils-hub-prime/issues/123

/worktree                     # Tạo isolated worktree
# ... code với /cook, /fix ...
/code-review                  # Local review
/ship official                # Ship PR về main
/review-pr <#PR> --fix --reply

/worktree                     # Isolated worktree
/investigate                  # Root cause analysis (no fix without root cause)
/fix                          # Apply fix
/verify                       # Xác nhận fix work
/ship official

# Nhánh từ main (không phải staging)
git checkout main
/worktree hotfix/F13-payment-timeout
/investigate                  # Prove root cause trước khi sửa
/fix
/verify
/ship official                # PR về main
/land-and-deploy              # Merge + deploy + canary
# Sau đó merge ngược lại staging

Handoff giữa các team

5 điểm handoff quan trọng — mỗi điểm cần output rõ ràng, không assume.

#	Handoff	Từ → Đến	Output bắt buộc
1	PRD → Design	PM → Design	PRD với Acceptance Criteria + wireframes (nếu có)
2	Design → Dev	Design → Dev	Figma link + component specs + responsive breakpoints + DESIGN.md
3	Code → QA	Dev → QA	Push staging + comment “ready for QA” + list files changed + `/watzup` report
4	Bug → Dev	QA → Dev	Bug report: steps to reproduce + expected vs actual + screenshots + `/investigate` output nếu có
5	Release → Ops	Dev → DevOps	PR staging→main + QA sign-off + deploy checklist + `/land-and-deploy` sẵn sàng

Best Practices phối hợp cross-team

Sprint planning tips:

PM: Không assign quá 80% capacity → dành 20% cho bugs + tech debt
Design: Làm specs sớm (T2-T3) để Dev có specs code từ T3
Dev: Estimate thêm 30% buffer cho review + QA feedback
QC: Plan verify time song song với dev timeline, không đợi cuối sprint

Communication rules:

Dùng GitHub issues/PRs làm nguồn chính, Lark chỉ để chat nhanh
Design feedback qua Figma comments, không qua chat
Blocker phải escalate trong 2 giờ, không đợi standup ngày hôm sau

Safety rules cho autonomous pipeline:

/vibe --ship yêu cầu plan validated + red-teamed trước khi merge
/guard khi debug prod — chặn edit ngoài scope, cảnh báo lệnh destructive
/freeze <dir> khi chỉ muốn sửa 1 module

→ Xem thêm: Best Practices tổng hợp

Ma trận trách nhiệm (RACI)

Hoạt động	PM	Design	Dev	QA	DevOps
PRD	R	C	C	C	I
UI/UX Design	C	R	C	I	I
Sprint Planning	R	C	C	C	I
Code	I	I	R	I	I
Code Review	I	C	R	I	I
Visual Review	I	R	C	C	I
QA Testing	I	C	C	R	I
Deploy	I	I	I	C	R
Monitoring	I	I	C	I	R
Rollback / Incident	I	I	C	I	R

R = Responsible, C = Consulted, I = Informed

Bắt đầu

Quan trọng

AgentKit (AK) — Migration mới

Tham khảo

Dev — Bắt đầu

Dev — Lệnh chính

Dev — Phân tích & Nghiên cứu

Dev — Công cụ hỗ trợ

Dev — Skills nổi bật

QA — Bắt đầu

QA — Use Cases

PM — Bắt đầu

PM — Lập kế hoạch

PM — Vận hành

PM — Kỹ thuật

PM — Skills nổi bật

DevOps — Bắt đầu

DevOps — Triển khai

DevOps — Bảo mật & Chất lượng

DevOps — Giám sát

DevOps — Skills nổi bật

Design — Bắt đầu

Design — Công cụ

Design — Quy trình

Design — Skills nổi bật

Marketing — Bắt đầu

Marketing — Nội dung

Marketing — Phân phối

Marketing — Quản lý

Quy trình làm việc

Quy trình làm việc

Tổng quan luồng công việc

Pipeline chuẩn — Vibe (autonomous)

Sprint 1 tuần

Quy trình QA theo sprint

Daily Standup

Git Flow

Handoff giữa các team

Best Practices phối hợp cross-team

Ma trận trách nhiệm (RACI)

​Quy trình làm việc

​Tổng quan luồng công việc

​Pipeline chuẩn — Vibe (autonomous)

​Sprint 1 tuần

​Quy trình QA theo sprint

​Daily Standup

​Git Flow

​Handoff giữa các team

​Best Practices phối hợp cross-team

​Ma trận trách nhiệm (RACI)

Quy trình làm việc

Tổng quan luồng công việc

Pipeline chuẩn — Vibe (autonomous)

Sprint 1 tuần

Quy trình QA theo sprint

Daily Standup

Git Flow

Handoff giữa các team

Best Practices phối hợp cross-team

Ma trận trách nhiệm (RACI)