spec-lite 1.5.1 → 1.5.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-lite",
-  "version": "1.5.1",
+  "version": "1.5.2",
   "description": "Spec-driven development kit for Claude Code",
   "type": "module",
   "bin": {

package/skills/spec-frd/SKILL.md

@@ -43,6 +43,31 @@ Skill này là cặp greenfield đối xứng với `/spec-brownfield-feature` (
 
 ## Process
 
+### Pre-flight: chuẩn bị nhánh Git (chạy TRƯỚC Bước 0)
+
+Mục tiêu: không bao giờ author frd ngay trên nhánh hiện tại của user (có thể là một nhánh đang làm dở) — luôn bắt đầu từ **nhánh chính mới nhất** rồi tách một **nhánh làm việc riêng**.
+
+**Trước tiên, thông báo cho user toàn bộ việc Git skill sẽ làm** (để user biết trước, đúng tinh thần "agent làm các việc này"):
+
+> Trước khi author frd, mình sẽ:
+> 1. Pull code mới nhất từ nhánh chính (`{main}`).
+> 2. Tạo & checkout một nhánh mới tách từ `{main}` để làm việc.
+>
+> (Bạn đang ở nhánh `{current}`.)
+
+**1. Xác định nhánh chính (`{main}`).**
+- Không phải git repo → bỏ qua toàn bộ pre-flight, note cho user rồi tiếp Bước 0.
+- Có nhánh `develop` → mặc định `{main}` = `develop`. Không có `develop` nhưng có `main`/`master` → dùng nó.
+- Mơ hồ (tồn tại cả `develop` lẫn `main`, hoặc remote default khác) → **hỏi user** nhánh nào là nhánh chính. KHÔNG đoán.
+
+**2. Kiểm tra working tree sạch.** `git status` còn thay đổi chưa commit → **DỪNG**, báo user commit/stash trước. KHÔNG tự ý stash/discard.
+
+**3. Checkout + pull nhánh chính:** `git checkout {main}` rồi `git pull`. Pull fail (conflict, không có upstream…) → **DỪNG**, surface lỗi cụ thể, để user xử lý.
+
+**4. Tạo nhánh làm việc mới off `{main}`.** Cần slug để đặt tên → thực hiện **ngay sau khi xác định feature mục tiêu ở Bước 1c** (xem nhắc ở đó): đề xuất `git checkout -b spec/{F-XXX}-{slug}`, cho user sửa tên rồi tạo. Mọi việc author/cascade từ Bước 2 trở đi diễn ra trên nhánh này.
+
+---
+
 ### Bước 0: Nạp nguồn yêu cầu (tùy chọn)
 
 Giống `/spec-prd` Bước 0. Xác định có nguồn baseline cho feature không (proposal, mô tả feature, ghi chú họp, wireframe note):
@@ -106,7 +131,7 @@ Chọn feature để author frd:
 
 Kiểm tra `.specs/main/feature/{F-XXX}-*/frd.md`.
 
-- **Chưa tồn tại** → tiếp Bước 2 (author mới).
+- **Chưa tồn tại** → **tạo nhánh làm việc** (Pre-flight bước 4): `git checkout -b spec/{F-XXX}-{slug}` off `{main}` (đề xuất tên, cho user sửa), rồi tiếp Bước 2 (author mới).
 - **Đã tồn tại** → **DỪNG**, redirect `/spec-new`:
   > frd.md cho {F-XXX} đã tồn tại. Mọi thay đổi feature đã được spec phải đi qua `/spec-new` — skill đó phân tích delta, cascade lên frd/crd/prd/domain, và kéo theo việc kỹ thuật/test (`/spec-tech`, `/spec-test`).
   > Chạy: `/spec-new {F-XXX}` (hoặc `/spec-new <mô tả thay đổi>`).
@@ -355,6 +380,7 @@ Bước tiếp theo:
 
 ## Verification
 
+- [ ] **Pre-flight Git**: đã thông báo plan cho user; xác định đúng nhánh chính (hỏi nếu mơ hồ); working tree sạch; đã `checkout {main}` + `pull`; tạo nhánh làm việc mới off `{main}` trước khi author
 - [ ] `prd.md` tồn tại
 - [ ] **Single-feature gate**: nguồn liên quan đúng 1 feature; nếu >1 đã DỪNG và mô tả rõ lý do tách + redirect `/spec-prd`
 - [ ] **Create-only gate**: frd.md của feature mục tiêu CHƯA tồn tại; nếu đã có đã redirect `/spec-new`

package/skills/spec-new/SKILL.md

@@ -27,6 +27,31 @@ Tạo `spec.md` cho một integration mới trong `.specs/integrations/{NNN}-{sl
 
 ## Process
 
+### Bước 0 · Pre-flight: chuẩn bị nhánh Git (chạy TRƯỚC Bước 1)
+
+Mục tiêu: không bao giờ tạo spec/cascade ngay trên nhánh hiện tại của user (có thể là một nhánh đang làm dở) — luôn bắt đầu từ **nhánh chính mới nhất** rồi tách một **nhánh làm việc riêng** cho integration.
+
+**Trước tiên, thông báo cho user toàn bộ việc Git skill sẽ làm** (để user biết trước, đúng tinh thần "agent làm các việc này"):
+
+> Trước khi tạo spec, mình sẽ:
+> 1. Pull code mới nhất từ nhánh chính (`{main}`).
+> 2. Tạo & checkout một nhánh mới tách từ `{main}` để làm integration này.
+>
+> (Bạn đang ở nhánh `{current}`.)
+
+**1. Xác định nhánh chính (`{main}`).**
+- Không phải git repo → bỏ qua toàn bộ pre-flight, note cho user rồi tiếp Bước 1.
+- Có nhánh `develop` → mặc định `{main}` = `develop`. Không có `develop` nhưng có `main`/`master` → dùng nó.
+- Mơ hồ (tồn tại cả `develop` lẫn `main`, hoặc remote default khác) → **hỏi user** nhánh nào là nhánh chính. KHÔNG đoán.
+
+**2. Kiểm tra working tree sạch.** `git status` còn thay đổi chưa commit → **DỪNG**, báo user commit/stash trước. KHÔNG tự ý stash/discard.
+
+**3. Checkout + pull nhánh chính:** `git checkout {main}` rồi `git pull`. Pull fail (conflict, không có upstream…) → **DỪNG**, surface lỗi cụ thể, để user xử lý.
+
+**4. Tạo nhánh làm việc mới off `{main}`.** Cần `{NNN}-{slug}` để đặt tên → thực hiện **ngay sau khi xác định slug + số thứ tự ở Bước 4** (xem nhắc ở đó): đề xuất `git checkout -b feat/{NNN}-{slug}`, cho user sửa tên rồi tạo. Mọi việc ghi spec + auto-cascade từ Bước 5/7 diễn ra trên nhánh này.
+
+---
+
 ### Bước 1: Xác định input
 
 **Nếu có ARGUMENT** → đây là raw requirement, chuyển sang Bước 2.
@@ -156,6 +181,8 @@ Xác định số thứ tự (`NNN`):
 
 Output path: `.specs/integrations/{NNN}-{slug}/spec.md`
 
+**Tạo nhánh làm việc** (Pre-flight bước 4) — giờ đã có `{NNN}-{slug}`: `git checkout -b feat/{NNN}-{slug}` off `{main}` (đề xuất tên, cho user sửa). Bỏ qua nếu không phải git repo (pre-flight đã note).
+
 ---
 
 ### Bước 5: Write — sinh draft
@@ -429,6 +456,7 @@ Bước tiếp theo:
 
 Trước khi user confirm (Bước 6), kiểm tra:
 
+- [ ] **Pre-flight Git**: đã thông báo plan cho user; xác định đúng nhánh chính (hỏi nếu mơ hồ); working tree sạch; đã `checkout {main}` + `pull`; tạo nhánh làm việc mới off `{main}` trước khi cascade
 - [ ] Problem Statement từ góc nhìn user/business, không mention tech
 - [ ] Mỗi Acceptance Criterion dùng cú pháp GIVEN / WHEN / THEN, có thể test được
 - [ ] Out of Scope có ít nhất 1 item