Dev Workflow — ClaudeKit Engineer (bộ mới)

ClaudeKit Engineer mới đã đơn giản hóa CLI: skill tự route theo task thay vì hàng chục subcommand. Thay /fix:test, /fix:ui, /cook:auto:fast bằng /fix và /cook — engine tự chọn strategy.

ClaudeKit Engineer chỉ chạy trên Claude Code CLI. Không hỗ trợ web app, desktop app, hay IDE extension.

Cập nhật bộ mới: Các subcommand cũ như /plan:fast, /plan:hard, /cook:auto, /fix:test, /fix:ui, /design:good, /code:auto, /bootstrap:auto đã bỏ. Xem Mapping cũ → mới bên dưới.

Luồng phát triển tổng thể (bộ mới)

Cây quyết định: Dùng lệnh nào?

Bạn muốn làm gì?
│
├─ Feature mới, có GitHub issue → /vibe --ship #N (autonomous full pipeline)
│
├─ Feature mới, natural language → /vibe --ship "mô tả feature"
│
├─ Feature phức tạp cần review scope → /plan-ceo-review → /plan → /cook
│
├─ Sửa bug (bất kỳ loại) → /investigate → /fix → /verify
│   (skill /fix tự route: test/CI/UI/types/logs)
│
├─ Review code
│   ├─ Local pending changes → /code-review
│   ├─ 1 PR trên GitHub → /review-pr <#> --fix --reply
│   ├─ Pre-landing quick check → /review
│   └─ UI/design QA → /design-review
│
├─ Chạy tests → /test  (không còn /test-gen — dùng /qa-full:tdd)
│
├─ Debug / investigate
│   ├─ Bug khó, cần root cause → /investigate (iron law)
│   ├─ Systematic → /ck-debug
│   └─ Có 2nd opinion → /codex challenge
│
├─ Khám phá codebase
│   ├─ Tìm files, symbol → /scout
│   ├─ Build knowledge graph → /understand
│   ├─ Semantic go-to-def → /gkg
│   └─ Pack repo cho LLM context → /repomix
│
├─ Verify feature work
│   ├─ Chạy app + kiểm chứng → /verify
│   └─ Launch app + screenshot UI → /run
│
├─ Handoff / cuối session
│   ├─ Handoff report → /watzup
│   └─ Save state resume sau → /checkpoint
│
├─ Ship + deploy
│   ├─ Chỉ tạo PR → /ship official (hoặc beta)
│   ├─ Merge + deploy + canary → /land-and-deploy
│   └─ Post-deploy monitor → /canary
│
└─ Tạo dự án mới → /bootstrap

3 Cách implement tính năng

Cách 1: Vibe autonomous (khuyến nghị)
Cách 2: Plan → Cook manual
Cách 3: Cook thẳng

/vibe --ship #123               # Full pipeline: plan → cook → PR → merge → CI watch

Tốt nhất cho feature đã có issue rõ + acceptance criteria. Skill tự chạy 10 bước có gate.

/worktree                       # Isolated worktree
/plan "mô tả feature"           # Plan (skill tự chọn depth)
# Review plan file...
/cook <plan.md>                 # Implement theo plan
/verify                         # Kiểm chứng feature work
/code-review                    # Local review
/ship official                  # Ship PR

Cho feature phức tạp cần review từng bước.

/cook "mô tả ngắn"              # Skill tự plan + implement
/verify

Cho task nhỏ, đã rõ requirements, low-risk.

Các nhóm lệnh chính (bộ mới)

Pipeline

/vibe, /vibe --ship — Full autonomous pipeline

Plan

/plan — Lập kế hoạch (đã bỏ :fast, :hard, :two)

Cook

/cook — Implement plan (đã bỏ :auto, :auto:fast)

Fix

/fix, /investigate — Auto-route + root cause analysis

Code Review

/code-review, /review-pr, /review — 3 levels review

Test

/test, /verify, /run — Test + kiểm chứng feature

Debug

/investigate, /ck-debug, /codex — Root cause + 2nd opinion

Research

/research, /gkg, /repomix — Tìm hiểu solution + codebase

Understand

/understand, /understand-chat, /understand-dashboard — Knowledge graph

Thinking Tools

/sequential-thinking, /brainstorm, /problem-solving, /office-hours

Docs

/docs, /llms, /mintlify — Documentation

MCP

/mcp-builder, /use-mcp — MCP servers & tools

Git & Ship

/worktree, /ship, /land-and-deploy, /ghpm — Git + GitHub

Advanced

ck-debug, ck-predict, ck-scenario, ck-security, ck-plan, ck-loop

Safety & Tiện ích

/guard, /freeze, /careful, /watzup, /checkpoint, /journal

Workflow đầy đủ (bộ mới)

Chuẩn bị

/worktree                       # Isolated worktree (tránh xung đột branch)
/ghpm status                    # Xem in-progress work + labels

Lập kế hoạch

/plan "mô tả tính năng"
# HOẶC nếu task cần challenge scope:
/plan-ceo-review "task"         # Rethink scope trước
/plan-eng-review <plan.md>      # Lock architecture

Implement

/cook <plan.md>                 # Implement với plan

Skill Cook tự: viết code, chạy tests, code review, update docs.

Verify feature work

/verify                         # Chạy app kiểm chứng change work thật
/run                            # Launch app + screenshot UI

BẮT BUỘC sau UI/frontend feature — type-check pass ≠ feature work.

QA kiểm tra

/qa-full:check                  # Kiểm tra tests
/qa-full:accept docs/prd/F05.md # Nghiệm thu theo PRD
/qa-full:tdd:verify             # Verify tests PASS sau cook

Ship

/ship official                  # Tạo PR về main
/review-pr <#PR> --fix --reply  # Review PR + auto-fix + reply
/land-and-deploy                # Merge + deploy + canary verify

Danh sách skill chi tiết — ClaudeKit Engineer (bộ mới)

Pipeline & orchestration

/vibe — Autonomous full pipeline

Prefix: /vibe, /vibe --ship, /vibe --beta, /vibe --ship --betaChạy 10 bước:

Parse issue/request + classify (feature/bugfix)
Create isolated worktree
Plan (TDD) + validate + red-team
Create/update GitHub issue với labels
Cook (feature) hoặc Fix (bugfix)
Local code-review
Ship PR
Review-PR + fix + reply comments
Apply “ready to ship stable/beta” label
Merge + watch CI (chỉ khi --ship)

/vibe #123                      # Đến ready-to-ship, không merge
/vibe --ship #123               # Full pipeline → merge → CI watch
/vibe --ship "feature request"  # Natural language, tự tạo issue
/vibe --beta #123               # Ship về beta thay stable

Ví dụ thực tế:

/vibe --ship https://github.com/primeproduction/skils-hub-prime/issues/45
# → worktree feat/45-payment-timeout
# → plan.md validated + red-teamed
# → /cook implements + tests pass
# → PR #46 opened
# → /review-pr --fix --reply resolves comments
# → merge with squash
# → watch main CI until green

/ghpm — GitHub project management

Prefix: /ghpm, /ghpm bootstrap, /ghpm statusBootstrap labels + Projects board + handoff status cho repo mới. Cần thiết cho /vibe (dùng label ready to cook, in progress, ready to ship stable).

/ghpm bootstrap                 # Setup labels + project board 1 lần cho repo
/ghpm status                    # Xem in-progress work + assignments

Plan — Lập kế hoạch

/plan — Skill ck-plan

Prefix: /plan (không còn :fast, :hard, :two, :parallel, :validate cũ)Skill tự chọn depth theo task complexity. Có subcommands cho use case đặc biệt qua /ckm:plan:*:

/plan "mô tả feature"           # Plan chuẩn
/plan --tdd "feature"           # Plan có TDD-first phases
/plan validate <plan.md>        # Validate assumptions
/plan red-team <plan.md>        # Adversarial review

# Subcommands ckm cho marketing (khác skill):
/ckm:plan:fast                  # No research, quick
/ckm:plan:hard                  # Deep research
/ckm:plan:two                   # 2 approaches comparison
/ckm:plan:parallel              # Parallel-executable phases
/ckm:plan:cro <url>             # CRO plan cho content
/ckm:plan:ci                    # Fix GitHub Actions logs
/ckm:plan:validate              # Interactive validation
/ckm:plan:archive               # Archive plans + journal

/plan-ceo-review — CEO/founder mode

Prefix: /plan-ceo-reviewRethink problem, find 10-star product. 4 modes: SCOPE EXPANSION, SELECTIVE EXPANSION, HOLD SCOPE, SCOPE REDUCTION.

/plan-ceo-review <plan.md>      # Review plan file
/plan-ceo-review "idea"         # Review ý tưởng chưa có plan

Khi dùng: Trước khi lock plan, muốn challenge scope, “think bigger”.

/plan-eng-review — Eng Manager mode

Prefix: /plan-eng-reviewLock in architecture, data flow, diagrams, edge cases, test coverage, performance.

/plan-eng-review <plan.md>      # Trước khi bắt đầu code

Khi dùng: Refactor lớn, feature architectural risk cao.

/plan-design-review + /plan-devex-review

Prefix: /plan-design-review, /plan-devex-review, /devex-review

/plan-design-review <plan.md>   # Designer's eye review plan
/plan-devex-review <plan.md>    # Developer experience review plan
/devex-review                   # Live DX audit (docs, CLI, error messages)

Cook & Fix — Implement + debug

/cook — Implement plan

Prefix: /cook (không còn :auto, :auto:fast, :auto:parallel)Skill tự chạy 7-step: plan check → scout → code → test → review → docs → PM report.

/cook "mô tả task"              # Tự plan + implement
/cook <plan.md>                 # Implement theo plan file
/cook --tdd <plan.md>           # TDD-first (tests trước)
/cook --auto <plan.md>          # Skip interactive gates (khi tin plan)

/fix — Auto-route bug fixes

Prefix: /fix (không còn :fast, :hard, :test, :ci, :types, :ui, :logs, :parallel)Skill Fix tự route theo evidence trong description:

“test fails” → strategy test-fix
“CI red” → phân tích Actions logs
“UI broken” → visual-fix
“TypeScript error” → types-fix
“logs error X” → logs-fix

/fix "test checkout fails intermittently"
/fix "CI /api job red — timeout"
/fix "button primary màu sai theo Figma"
/fix --auto <plan.md>           # Fix với plan cho bugfix route

Trước /fix bắt buộc chạy /investigate cho bug khó — iron law “no fix without root cause”.

/investigate — Root cause debugging

Prefix: /investigate4 phases: investigate → analyze → hypothesize → implement. Iron Law: no fixes without root cause.

/investigate "500 error /api/users"
/investigate "test X fails 1/10 times"
/investigate "checkout không load tổng tiền trên iOS Safari"

Thay thế cho /debug cũ. Enforce root cause discipline.

/ck-debug — Systematic debug

Prefix: /ck-debugSystematic root cause + fix. Nhẹ hơn /investigate.

/ck-debug "error message"
/ck-debug "performance regression"

/verify + /run — Confirm feature works

Prefix: /verify, /run

/verify                         # Chạy app + kiểm chứng change work thật sự
/run                            # Launch + drive app để screenshot/xem UI

Bắt buộc sau UI/frontend feature. Type-check pass ≠ feature work.

Code review

/code-review — Local pending review

Prefix: /code-review, /code-review --pending, /code-review --commit <sha>

/code-review                    # Review pending changes
/code-review --pending          # Same
/code-review --commit abc1234   # Review 1 commit
/code-review path/to/file       # Review file cụ thể

/review-pr — GitHub PR review

Prefix: /review-pr, /review-pr <#PR> --fix, /review-pr <#PR> --reply

/review-pr #46                  # Review only
/review-pr #46 --fix            # Review + auto-fix issues
/review-pr #46 --reply          # Review + reply comments
/review-pr #46 --fix --reply    # Full (khuyến nghị cho vibe pipeline)

Check: duplicate prior work, project standards, strategic necessity, correctness, security, AI-slop patterns.

/review — Pre-landing quick review

Prefix: /reviewNhanh hơn /code-review. SQL safety, LLM trust boundary, conditional side effects.

/review                         # Trước khi merge

/design-review — Visual QA

Prefix: /design-reviewVisual QA + auto-fix cho UI PR. Screenshot before/after.

/design-review                  # UI polish + fix inconsistency

Test

/test — Chạy test suite

Prefix: /test

/test                           # Chạy full suite
/test path/to/file.test.ts      # Chạy 1 file
/test --coverage                # Với coverage report

/test-flakiness — Detect flaky tests

Prefix: /test-flakinessAggregate pass rates từ CI logs, recommend quarantine.

/test-flakiness                 # Scan test history

Explore & understand

/scout — Fast file discovery

Prefix: /scout, /scout:ext

/scout "component X"            # Tìm files, symbols
/scout:ext                      # External agentic tool (Gemini)

/understand — Knowledge graph

Prefix: /understand, /understand-chat, /understand-diff, /understand-dashboard, /understand-explain, /understand-onboard

/understand                     # Build queryable knowledge graph
/understand-chat "câu hỏi"      # Ask questions về codebase
/understand-diff <PR#>          # Analyze diff impact
/understand-dashboard           # Interactive web dashboard
/understand-explain <file>      # Deep-dive explanation
/understand-onboard <role>      # Onboarding guide cho role mới

/gkg — Semantic code graph

Prefix: /gkgGo-to-definition, find-usages, impact analysis. Support Ruby, Java, Kotlin, Python, TS/JS.

/gkg "find usages of function X"
/gkg "impact if I change interface Y"

/repomix — Pack repo cho LLM

Prefix: /repomixPack repo → XML/Markdown/plain text. Cho LLM context.

/repomix                        # Pack current repo
/repomix path/to/subdir         # Pack subdir

/xia — Extract/port feature

Prefix: /xiaExtract, compare, port feature từ GitHub repo hoặc local repo path.

/xia "port auth from https://github.com/X/Y"
/xia "compare our checkout with Shopify's"

Ship & deploy

/ship — Ship PR

Prefix: /ship official, /ship betaShip pipeline: merge target, test, review, journal, commit, push, PR.

/ship official                  # Ship về main
/ship beta                      # Ship về beta/dev

/land-and-deploy — Merge + deploy + canary

Prefix: /land-and-deployMerge PR → chờ CI → deploy → canary verify.

/setup-deploy                   # 1 lần: cấu hình platform (Vercel/Netlify/Fly/Render)
/land-and-deploy                # Sau khi PR ready

/canary — Post-deploy monitoring

Prefix: /canaryScreenshot + performance diff so với baseline.

/canary                         # Sau deploy production

/worktree — Isolated git worktree

Prefix: /worktree

/worktree                       # Tạo worktree mới
/worktree list                  # List worktrees
/worktree cleanup               # Remove stale worktrees

Safety

/guard — Full safety mode (careful + freeze)

Prefix: /guardKết hợp /careful + /freeze. Bảo vệ tối đa khi debug prod.

/guard <dir>                    # Restrict edit + warn destructive

/freeze + /unfreeze — Restrict edit scope

Prefix: /freeze <dir>, /unfreeze

/freeze src/checkout            # Chỉ cho phép edit trong folder này
/unfreeze                       # Clear boundary

/careful — Warn destructive commands

Prefix: /carefulCảnh báo trước rm -rf, DROP TABLE, git reset --hard, force-push, kubectl delete.

/careful                        # Enable safety warnings

Handoff & session

/watzup — Handoff report

Prefix: /watzupAuto-generate handoff report từ git + worktrees + plans + unfinished work.

/watzup                         # Cuối session / chuyển ca

/checkpoint — Save & resume state

Prefix: /checkpoint, /checkpoint resume

/checkpoint                     # Save git state + decisions + remaining work
/checkpoint resume              # Resume từ checkpoint

/journal — Technical journal entries

Prefix: /journalWrite technical journal entries analyzing changes.

/journal                        # Session reflection
/journal decisions              # Log architectural decisions

Thinking tools

/sequential-thinking + /brainstorm + /problem-solving

/sequential-thinking            # Step-by-step reasoning với revision
/brainstorm "topic"             # Trade-off analysis, brutal honesty
/problem-solving                # Systematic techniques khi stuck

/office-hours — YC-style challenge

Prefix: /office-hours6 forcing questions: demand reality, status quo, desperate specificity, narrowest wedge, observation, future-fit.

/office-hours "idea"            # Challenge premise, save design doc

/codex — OpenAI Codex 2nd opinion

Prefix: /codex review, /codex challenge, /codex ask

/codex review                   # Independent diff review
/codex challenge                # Adversarial mode
/codex ask "question"           # Consult với session continuity

Mapping cũ → mới

Bộ cũ	Bộ mới	Ghi chú
`/plan:fast`	`/plan`	Skill tự chọn depth
`/plan:hard`	`/plan` hoặc `/ckm:plan:hard`	ckm:plan:hard cho deep research
`/plan:two`	`/ckm:plan:two`	Vẫn còn dưới ckm prefix
`/plan:parallel`	`/ckm:plan:parallel`	Vẫn còn dưới ckm prefix
`/plan:validate`	`/plan validate <file>`	Là action của skill, không phải subcommand
`/cook:auto`	`/cook --auto`	Là flag, không phải subcommand
`/cook:auto:fast`	`/cook "task"`	Skill tự chọn strategy
`/cook:auto:parallel`	`/cook --auto <plan.md>`	Với plan có parallel phases
`/fix:test`	`/fix "test X fails"`	Skill auto-route theo description
`/fix:ci`	`/fix "CI red"`	Auto-route
`/fix:ui`	`/fix "UI broken"`	Auto-route
`/fix:types`	`/fix "TS error"`	Auto-route
`/fix:hard`	`/investigate` + `/fix`	Root cause trước
`/code`, `/code:auto`	`/cook`	Cook thay thế
`/debug`	`/investigate` hoặc `/ck-debug`	Investigate có iron law
`/test-gen`	`/qa-full:tdd "feature"`	TDD trong QA
`/bootstrap:auto`, `:auto:fast`, `:auto:parallel`	`/bootstrap`	Skill tự chọn
`/design:good`, `:screenshot`, `:3d`, `:describe`	`/stitch`, `/design-shotgun`, `/design-html`	Xem Design tab
`/skill:add`, `:create`, `:update`, `:optimize`	`/ckm:skill:add`, `:create`, `:update`, `:optimize`	Có `ckm` prefix
`/docs:init`, `:update`, `:summarize`	`/ckm:docs:init`, `:update`, `:summarize`	Có `ckm` prefix

17 Agents tự động phối hợp

planner → researcher (parallel) → coder → tester
→ code-reviewer → docs-manager → project-manager

Khi bạn chạy /cook hoặc /vibe, các agent tự động phối hợp — không cần gọi thủ công.

Danh sách 17 agents

Agent	Vai trò
`planner`	Lập kế hoạch implementation
`researcher`	Tìm hiểu codebase, patterns, dependencies
`architect`	Thiết kế architecture, database schema
`coder`	Viết code production
`fullstack-developer`	Full-stack implementation
`tester`	Viết unit/integration/e2e tests
`qa-engineer`	QA chuyên biệt, edge cases
`code-reviewer`	Review code quality
`security-auditor`	Kiểm tra bảo mật
`performance-optimizer`	Tối ưu hiệu suất
`docs-manager`	Cập nhật documentation
`project-manager`	Tổng hợp, báo cáo tiến độ
`debugger`	Debug errors chuyên sâu
`devops-engineer`	CI/CD, deployment, infra
`database-admin`	Schema design, migrations, queries
`ui-developer`	Frontend UI/UX implementation
`api-developer`	API design & implementation

So sánh: /vibe vs manual pipeline

Tiêu chí	`/vibe --ship`	Manual step-by-step
Setup	Auto: worktree + branch từ issue name	Bạn tự `git checkout -b`
Plan	Auto: `/plan --tdd` + validate + red-team	Bạn tự `/plan` + `/plan validate`
Issue update	Auto: labels `ready to cook` → `in progress` → `ready to ship`	Bạn tự update
Implement	Auto: `/cook --tdd --auto <plan>` hoặc `/fix --auto`	Bạn tự `/cook`, `/fix`
Review local	Auto: `/code-review --pending`	Bạn tự chạy
Ship PR	Auto: `/ship official` (hoặc `/ship beta`)	Bạn tự
Review PR	Auto: `/review-pr <#> --fix --reply`	Bạn tự
Merge	Auto: `gh pr merge --auto` khi checks xanh	Bạn tự merge
CI watch	Auto: theo dõi main branch CI, fix nếu fail	Bạn tự theo dõi
Blast radius	Có gate ở mỗi bước, dừng khi cần user decision	Full control

​Dev Workflow — ClaudeKit Engineer (bộ mới)

​Luồng phát triển tổng thể (bộ mới)

​Cây quyết định: Dùng lệnh nào?

​3 Cách implement tính năng

​Các nhóm lệnh chính (bộ mới)

Pipeline

Plan

Cook

Fix

Code Review

Test

Debug

Research

Understand

Thinking Tools

Docs

MCP

Git & Ship

Advanced

Safety & Tiện ích

​Workflow đầy đủ (bộ mới)

​Danh sách skill chi tiết — ClaudeKit Engineer (bộ mới)

​Pipeline & orchestration

​Plan — Lập kế hoạch

​Cook & Fix — Implement + debug

​Code review

​Test

​Explore & understand

​Ship & deploy

​Safety

​Handoff & session

​Thinking tools

​Mapping cũ → mới

​17 Agents tự động phối hợp

​Danh sách 17 agents

​So sánh: /vibe vs manual pipeline

Dev Workflow — ClaudeKit Engineer (bộ mới)

Luồng phát triển tổng thể (bộ mới)

Cây quyết định: Dùng lệnh nào?

3 Cách implement tính năng

Các nhóm lệnh chính (bộ mới)

Workflow đầy đủ (bộ mới)

Danh sách skill chi tiết — ClaudeKit Engineer (bộ mới)

Pipeline & orchestration

Plan — Lập kế hoạch

Cook & Fix — Implement + debug

Code review

Test

Explore & understand

Ship & deploy

Safety

Handoff & session

Thinking tools

Mapping cũ → mới

17 Agents tự động phối hợp

Danh sách 17 agents

So sánh: /vibe vs manual pipeline