Dự Án Greenfield

Tạo dự án mới từ đầu với quy trình phát triển AI-powered của ClaudeKit. Biến ý tưởng thành ứng dụng production nhanh chóng với intelligent agents.

Cài Đặt

1. Cài ClaudeKit CLI

npm i -g claudekit-cli@latest

Bắt Đầu Nhanh

Phương Pháp 1: Bootstrap Dự Án Mới

# Tạo dự án mới với ClaudeKit Engineer kit
ck new --kit engineer --dir /đường/dẫn/đến/dự/án

Tùy chọn:

  • --kit engineer: Cài ClaudeKit Engineer configuration
  • --dir: Thư mục đích cho dự án

Phương Pháp 2: Thiết Lập Thủ Công

# Tạo thư mục
mkdir dự-án-tuyệt-vời
cd dự-án-tuyệt-vời

# Khởi tạo git (tùy chọn nhưng nên có)
git init

# Khởi động Claude Code
claude

Bootstrap Ý Tưởng

Lệnh Bootstrap

/bootstrap <mô-tả-ý-tưởng-của-bạn>

Đây là lệnh mạnh nhất cho dự án greenfield. Nó:

  1. Hỏi thêm câu hỏi để hiểu rõ
  2. Cung cấp kế hoạch triển khai chi tiết (xem kỹ!)
  3. Sau khi đồng ý, bắt đầu triển khai
  4. Tự động viết tests
  5. Thực hiện code reviews
  6. Tạo specs và roadmap ban đầu
  7. Cung cấp báo cáo tóm tắt

Không cần chạy /docs:init - specs được tạo tự động trong quá trình bootstrap.

Ví Dụ: Dự Án Đơn Giản

/bootstrap Một CLI tool convert markdown files thành PDF với custom styling

CC sẽ hỏi:

  • Nền tảng mục tiêu? (Node.js, Deno, Bun?)
  • Thư viện PDF ưa thích? (pdfkit, puppeteer, weasyprint?)
  • Phương pháp custom styling? (CSS, theme files?)
  • Phương thức phân phối? (npm, binary, cả hai?)

Ví Dụ: Web Application

/bootstrap Một ứng dụng todo cộng tác real-time với team workspaces và permissions

CC sẽ hỏi:

  • Frontend framework? (React, Vue, Svelte?)
  • Backend? (Node.js, Python, Go?)
  • Database? (PostgreSQL, MongoDB, Supabase?)
  • Giải pháp real-time? (WebSocket, Server-Sent Events?)
  • Authentication? (OAuth, email/password, magic link?)

Ví Dụ: Discord Bot

/bootstrap Bot Discord nghiên cứu, phân tích và gửi báo cáo cổ phiếu DJI lúc 7am hàng ngày

CC sẽ hỏi:

  • Nguồn dữ liệu cổ phiếu? (API nào?)
  • Loại phân tích? (Technical, fundamental, cả hai?)
  • Định dạng báo cáo? (Embed, text, charts?)
  • Time zone cho lịch trình?
  • Lưu trữ dữ liệu lịch sử?

Chế Độ Tự Động (Dùng Cẩn Thận!)

/bootstrap:auto <ý-tưởng-của-bạn>

Chạy chế độ tự động hoàn toàn không cần review plan. CC sẽ:

  • Tự quyết định kỹ thuật
  • Triển khai toàn bộ dự án
  • Chạy tests và sửa lỗi
  • Tạo tài liệu

Khuyến nghị: Chỉ dùng cho:

  • Dự án đơn giản, rõ ràng
  • Prototypes và thử nghiệm
  • Ứng dụng không quan trọng

Luôn review code trước khi dùng production.

Sau Bootstrap

Cấu Trúc Dự Án

ClaudeKit tạo cấu trúc dự án chuẩn:

dự-án-của-tôi/
├── .claude/           # ClaudeKit configuration
├── docs/              # Tài liệu đã tạo
│   ├── project-overview-pdr.md
│   ├── system-architecture.md
│   └── roadmap.md
├── src/               # Source code
├── tests/             # Test files
├── package.json       # Dependencies
└── README.md          # Project readme

Tiếp Tục Phát Triển

Dùng tất cả lệnh ClaudeKit cho phát triển tiếp:

Thêm Tính Năng Mới

/cook Thêm xác thực người dùng với email verification

Sửa Lỗi

/fix:fast Button click handler không hoạt động trên mobile
/fix:hard Lỗi state management phức tạp trong checkout flow

Lên Kế Hoạch Cải Tiến

/plan Thêm xử lý thanh toán với Stripe

Chạy Tests

/test

Các Loại Dự Án Thường Gặp

Web API Server

/bootstrap REST API cho nền tảng e-commerce với products, cart, orders và payments

Câu hỏi thường gặp:

  • Framework: Express, Fastify, Nest.js?
  • Database: PostgreSQL, MySQL, MongoDB?
  • Authentication: JWT, session-based?
  • Payment provider: Stripe, PayPal?
  • Hosting: Vercel, AWS, Railway?

Full-Stack Application

/bootstrap Ứng dụng quản lý task full-stack với kanban boards, time tracking và team collaboration

Câu hỏi thường gặp:

  • Frontend: Next.js, React + Vite, Remix?
  • State management: Redux, Zustand, Context?
  • Database: Supabase, PlanetScale, MongoDB?
  • Real-time: Socket.io, Supabase Realtime?
  • File storage: S3, Cloudflare R2?

Chrome Extension

/bootstrap Chrome extension tóm tắt bài viết web và lưu highlights vào Notion

Câu hỏi thường gặp:

  • Manifest version: V2 hay V3?
  • AI service: OpenAI, Anthropic, local?
  • Notion integration: Official API?
  • Storage: Chrome storage, cloud sync?

Mobile App Backend

/bootstrap Backend API cho ứng dụng fitness mobile với workout tracking, social features và achievements

Câu hỏi thường gặp:

  • Framework: Express, FastAPI, Rails?
  • Database: PostgreSQL, MongoDB?
  • File uploads: S3, Cloudflare R2?
  • Push notifications: FCM, OneSignal?
  • Analytics: Mixpanel, PostHog?

Workflows Nâng Cao

Phát Triển Lặp

# 1. Bắt đầu với MVP
/bootstrap Sản phẩm tối thiểu cho ứng dụng theo dõi thói quen

# 2. Sau khi hoàn thành MVP, thêm tính năng
/cook Thêm tính năng chia sẻ social
/cook Thêm streak tracking và notifications
/cook Thêm analytics dashboard

# 3. Tối ưu và tinh chỉnh
/fix:hard Vấn đề hiệu suất với datasets lớn 1000+ items
/plan Thêm tính năng premium với subscription

Kiến Trúc Multi-Service

# 1. Bootstrap main API
/bootstrap API service chính cho nền tảng social media

# 2. Lên kế hoạch microservices
/plan Thêm service auth riêng
/plan Thêm service xử lý media
/plan Thêm service notification

# 3. Triển khai services riêng biệt
/code auth-service-plan.md
/code media-service-plan.md
/code notification-service-plan.md

Documentation-Driven Development

# 1. Tạo kế hoạch chi tiết trước
/plan Nền tảng SaaS hoàn chỉnh với multi-tenancy, billing và admin dashboard

# 2. Xem và tinh chỉnh kế hoạch
# Chỉnh sửa file markdown plan đã tạo

# 3. Triển khai theo từng giai đoạn
/code plan.md --phase 1
/test
/code plan.md --phase 2
/test

Cấu Hình Dự Án

Thiết Lập Environment

Sau bootstrap, cấu hình environments:

# Development
/config Tạo cấu hình môi trường development

# Production
/config Tạo cấu hình môi trường production

# Testing
/config Tạo cấu hình môi trường testing

Deployment

# Lên kế hoạch deployment
/plan Deploy lên Vercel với CI/CD

# Triển khai deployment
/code deployment-plan.md

# Hoặc dùng integration cụ thể
/integrate vercel
/integrate railway
/integrate fly.io

Best Practices

1. Mô Tả Rõ Ràng

Tốt:

/bootstrap Ứng dụng chat real-time với rooms, direct messages, file sharing và presence indicators. Target 1000 concurrent users.

Không tốt:

/bootstrap App chat

2. Trả Lời Câu Hỏi Đầy Đủ

Cung cấp câu trả lời chi tiết cho câu hỏi của CC. Context tốt hơn = triển khai tốt hơn.

3. Xem Kỹ Kế Hoạch

QUAN TRỌNG: Luôn xem kỹ kế hoạch triển khai trước khi đồng ý. Kiểm tra:

  • Quyết định kiến trúc
  • Lựa chọn công nghệ
  • Cân nhắc bảo mật
  • Cách tiếp cận khả năng mở rộng
  • Chiến lược testing

4. Bắt Đầu Nhỏ, Lặp Dần

Bắt đầu với chức năng cốt lõi, sau đó mở rộng:

# Giai đoạn 1: Core MVP
/bootstrap Nền tảng blog cơ bản với posts và comments

# Giai đoạn 2: Cải tiến
/cook Thêm rich text editor
/cook Thêm upload hình ảnh
/cook Thêm user profiles

# Giai đoạn 3: Tính năng nâng cao
/cook Thêm chức năng tìm kiếm
/cook Thêm social sharing

5. Dùng Version Control

# Sau bootstrap
git add .
git commit -m "Khởi tạo dự án qua ClaudeKit bootstrap"

# Sau mỗi tính năng
/git:cp

Xử Lý Sự Cố

Bootstrap Bị Treo hoặc Thất Bại

# Dừng và khởi động lại với mô tả cụ thể hơn
/bootstrap [mô tả chi tiết hơn với tech stack preferences]

Code Được Tạo Có Vấn Đề

# Sửa các vấn đề cụ thể
/fix:hard [mô tả vấn đề]

# Hoặc chạy full test suite và tự động sửa
/fix:test

Cần Đổi Cách Tiếp Cận

# Tạo kế hoạch mới
/plan Refactor sang kiến trúc khác

# Triển khai thay đổi
/code new-approach-plan.md

Bước Tiếp Theo

Sau khi bootstrap dự án:

  1. Phát Triển Liên Tục: Dùng /cook cho tính năng mới
  2. Testing: Chạy /test thường xuyên
  3. Tài Liệu: Giữ /docs:update cập nhật
  4. Deployment: Thiết lập CI/CD với /plan:ci
  5. Cộng Tác Nhóm: Chia sẻ cấu hình .claude/

Tài Nguyên

Sẵn sàng xây dựng? Bắt đầu với /bootstrap và để AI agents xử lý phần nặng nhọc. Nhớ xem kỹ kế hoạch trước khi đồng ý!

Cần giúp? Truy cập GitHub Discussions