pm-kickoff

name	pm-kickoff
description	Bootstrap dự án mới từ đầu (greenfield): chọn tech stack, tạo cấu trúc folder, customize CLAUDE.md, khởi tạo docs structure và sprint 0 checklist. Trigger khi: user nói "bắt đầu dự án mới", "kickoff project", "greenfield project", "setup dự án từ đầu", "project mới cho khách JP", "khởi tạo framework mới", hoặc gõ /pm-kickoff.

Skill: /pm-kickoff

Role: PM / Tech Lead / Bridge Engineer
Mục đích: Bootstrap dự án greenfield — từ ý tưởng đến dự án có cấu trúc, docs, và team sẵn sàng sprint 1.

---

Context

Greenfield project khác brownfield:

• Không có ba-reverse — không có codebase cũ để đọc
• Cần quyết định tech stack ngay từ đầu — ảnh hưởng mọi thứ sau
• Khách JP thường expect 基本設計書 trước khi bắt đầu code
• Sprint 0 = setup môi trường + architecture decisions + initial docs

---

Hướng dẫn thực hiện

Bước 1 — Gate: Thu thập thông tin dự án

Dùng AskUserQuestion tool:

• Loại dự án: Web app / Mobile app / API / Microservice / Library / Other
• Khách hàng: JP outsource / Internal / Other
• Timeline: Deadline đầu tiên (format YYYY-MM-DD JST)
• Team size: Số dev / QA / BE

Chờ confirm.

Bước 2 — Phân tích yêu cầu và đề xuất tech stack

Dựa trên input từ Bước 1 và context của dự án, đề xuất:

## Đề xuất Tech Stack: [Tên dự án]

### Option A: [Tên stack] — [Trade-off chính]
| Layer | Technology | Lý do |
|-------|-----------|-------|
| Frontend | [...] | [...] |
| Backend | [...] | [...] |
| Database | [...] | [...] |
| Cache | [...] | [...] |
| CI/CD | [...] | [...] |
| Hosting | [...] | [...] |

**Phù hợp khi**: [...]
**Trade-off**: [...]

### Option B: [Tên stack] — [Trade-off chính]
[Tương tự]

### Option C: [Tên stack] — [Trade-off chính]
[Tương tự]

Chờ confirm tech stack.

Bước 3 — Gate: Architecture decisions

Sau khi chọn tech stack, xác nhận các quyết định kiến trúc ban đầu:

## Architecture Decisions cần xác nhận

| # | Quyết định | Option A | Option B | Recommend |
|---|-----------|---------|---------|----------|
| 1 | Auth strategy | JWT stateless | Session-based | JWT (scale tốt hơn) |
| 2 | API style | REST | GraphQL | REST (JP clients quen hơn) |
| 3 | DB schema | Monolithic | Multi-tenant | [tùy dự án] |
| 4 | Deployment | Monorepo | Multi-repo | Monorepo (team nhỏ) |
| 5 | Logging | Structured JSON | Plain text | Structured JSON |

Mỗi quyết định sẽ được ghi vào ADR sau.

Chờ confirm.

Bước 4 — Tạo Project Structure

Tạo các files sau (dùng Write tool):

4a. Cập nhật/tạo CLAUDE.md cho dự án cụ thể

Bổ sung section "Project Context" vào CLAUDE.md:

## Project Context

**Tên dự án**: [Tên]
**Khách hàng**: [Tên JP client]
**Bridge Engineer**: [Tên]
**PM**: [Tên]
**Repo**: [URL]
**Staging**: [URL]
**Production**: [URL]

### Tech Stack

| Layer | Technology | Version |
|-------|-----------|---------|
| [...] | [...] | [...] |

### Conventions dự án này

- [Naming convention]
- [Branch naming: feature/TASK-XXX-slug]
- [Commit message format]
- [Code review policy]

### ENV Variables (required)

| Variable | Purpose | Source |
|----------|---------|--------|
| DATABASE_URL | DB connection | 1Password / team lead |
| [...] | [...] | [...] |

4b. Tạo cấu trúc docs

docs/
  tasks/          (gitignored trong framework source, track trong project)
  baseline/
    codebase-overview.md  (empty — điền sau sprint 1-2)
  decisions/
    ADR-001.md    (Tech Stack decision)
    ADR-002.md    (Auth strategy)
    ...
  screens/        (điền khi có design)
  api/            (điền khi có API spec)
  reports/        (release notes, sprint status)
  handover/       (điền khi cần)
  workflows/
    sprint-lifecycle.md  (copy từ framework)
    role-guide.md        (copy từ framework)

4c. Tạo ADRs cho các quyết định ở Bước 3

Với mỗi quyết định đã confirm, gọi /arch-adr hoặc tạo trực tiếp:

# ADR-001: [Tên quyết định]

**Ngày**: [YYYY-MM-DD]
**Status**: Accepted
**Người quyết định**: [Tech Lead + PM]

## Bối cảnh
[Vì sao cần quyết định này]

## Quyết định
[Chọn option nào và tại sao]

## Hệ quả
[Những gì phải làm tiếp theo do quyết định này]

Bước 5 — Sprint 0 Checklist

## Sprint 0 Checklist: [Tên dự án]

### Setup môi trường
- [ ] Repo tạo và team được add
- [ ] Branch protection rules (main, develop)
- [ ] CI/CD pipeline chạy được (lint + test + build)
- [ ] Staging environment up
- [ ] ENV variables documented (không phải giá trị — nguồn lấy)
- [ ] Database schema khởi tạo

### Documentation
- [ ] CLAUDE.md đã customize cho dự án
- [ ] ADRs cho tech stack decisions đã viết
- [ ] Glossary JP-VN-EN đã seed với terms đặc thù dự án
- [ ] 基本設計書 draft đã gửi JP (nếu JP client)

### Process
- [ ] GitHub Issues template đã setup
- [ ] Sprint board tạo
- [ ] Team onboarding doc (README hoặc CLAUDE.md)
- [ ] Contact matrix (khách JP + BE + PM VN + team dev)

### Kỹ thuật
- [ ] Linting rules đã config
- [ ] Test framework đã setup (ít nhất 1 test chạy được)
- [ ] Logging format đã thống nhất
- [ ] Error handling pattern đã thống nhất

Bước 6 — Gate cuối

## Project Kickoff hoàn tất: [Tên dự án]

Đã tạo:
- CLAUDE.md đã customize
- ADR-001 đến ADR-[N] cho decisions đã confirm
- docs/ structure với đúng folders
- Sprint 0 checklist

| # | Câu hỏi | Lựa chọn |
|---|---------|---------|
| 1 | Tech stack có cần điều chỉnh gì không? | A: Không / B: Có — điều chỉnh: ___ / C: Khác: ___ |
| 2 | Cần tạo 基本設計書 gửi JP trước khi bắt đầu code không? | A: Có — chạy /be-bridge tiếp theo / B: Không cần / C: Khác: ___ |
| 3 | Sprint 1 bắt đầu khi nào? | _(Nhập ngày YYYY-MM-DD)_ |

Bước tiếp theo:
- [ ] Team walk-through CLAUDE.md
- [ ] Nếu JP client: /be-bridge để tạo 基本設計書
- [ ] Sprint 1: /pm-breakdown để tạo tasks từ requirements

---

Quy tắc

• Tech stack decision phải có ADR — không quyết định ngầm
• ENV variables: KHÔNG bao giờ commit giá trị thực — chỉ document tên và nguồn lấy
• Nếu JP client: 基本設計書 phải xong và JP confirm trước sprint 1
• CLAUDE.md project section phải được cập nhật khi có thay đổi team/tech