spec-lite 1.1.2 → 1.1.4

package/bin/cli.js

@@ -20,6 +20,10 @@ if (command === 'install') {
   // Copy templates → .claude/templates/
   cpSync(join(pkgRoot, 'templates'), join(claudeDir, 'templates'), { recursive: true })
   console.log('✓ templates  →  .claude/templates/')
+
+  // Copy references → .claude/references/
+  cpSync(join(pkgRoot, 'references'), join(claudeDir, 'references'), { recursive: true })
+  console.log('✓ references  →  .claude/references/')
 } else {
   console.log('Usage: npx spec-lite install')
   process.exit(1)

package/package.json

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

package/skills/build/SKILL.md

@@ -38,6 +38,60 @@ Chọn số integration:
   - Nếu chỉ có 1 integration có task pending → chọn luôn, không hỏi
   - Nếu tất cả đều done → thông báo: "Tất cả integration đã hoàn thành."
 
+### Bước 0b: Tạo branch và chọn chế độ worktree
+
+**Tạo branch (bắt buộc):**
+
+Luôn tạo branch `build/{integration-slug}` trước khi build, bất kể có dùng worktree hay không. Điều này đảm bảo `/review` luôn có base để diff chính xác.
+
+```bash
+git checkout -b feat/{slug}
+```
+
+Nếu branch đã tồn tại → checkout branch cũ:
+
+```bash
+git checkout feat/{slug}
+```
+
+---
+
+**Chọn worktree (tùy chọn):**
+
+Hỏi user:
+
+```
+Bạn muốn build trong worktree riêng cho integration này không? (y/n)
+```
+
+**Nếu chọn "n":** Tiếp tục build trong working directory hiện tại trên branch vừa tạo.
+
+**Nếu chọn "y":**
+
+1. **Tạo worktree mới** từ branch vừa tạo
+   - Đường dẫn worktree: `../{repo-name}-{integration-slug}` (ví dụ: `../myapp-002-implement-todo`)
+   - Lệnh:
+     ```bash
+     git worktree add ../{repo}-{slug} feat/{slug}
+     ```
+
+2. **Detect package manager**
+   - Kiểm tra theo thứ tự: `pnpm-lock.yaml` → `yarn.lock` → `package-lock.json` → `package.json`
+   - Dùng package manager tương ứng: `pnpm install` / `yarn install` / `npm install`
+   - Nếu không có `package.json` → bỏ qua bước install.
+
+3. **Copy env files**
+   - Tìm tất cả file `.env*` ở root của working directory gốc (`.env`, `.env.local`, `.env.development`, v.v.)
+   - Copy từng file vào worktree mới:
+     ```bash
+     cp .env* ../{repo}-{slug}/
+     ```
+   - Bỏ qua nếu không có file `.env*` nào.
+
+4. **Chuyển working context sang worktree mới**
+   - Tất cả các bước build tiếp theo đều chạy trong đường dẫn worktree mới.
+   - Nhắc user biết đang build tại: `../{repo}-{slug}`
+
 ### Với mỗi task pending
 
 **1. Chọn task** (`incremental-implementation` — Increment Cycle)
@@ -114,3 +168,13 @@ Invoke `debugging-and-error-recovery`:
 - [ ] Mỗi task có atomic commit riêng
 - [ ] Tất cả task đánh dấu `[x]` trong `todo.md`
 - [ ] Không còn uncommitted changes
+
+## Sau khi hoàn thành
+
+Khi tất cả task trong session này đã done, thông báo:
+
+```
+Tất cả task đã hoàn thành. Bước tiếp theo: chạy /review để kiểm tra toàn bộ implementation trước khi merge.
+```
+
+Không tự động invoke `/review` — để user chủ động gọi.

package/skills/review/SKILL.md

@@ -16,7 +16,12 @@ Trước khi bắt đầu review, load context từ working integration:
 3. `specs/integrations/{slug}/plan.md` — task breakdown và acceptance criteria chi tiết
 4. `specs/integrations/{slug}/todo.md` — task nào đã được implement (`[x]`)
 
-Chạy `git diff main...HEAD` để lấy thay đổi cần review.
+Chạy lệnh sau để lấy thay đổi cần review — diff từ điểm branch tách ra, không phải từ tip của base branch:
+
+```bash
+BASE=$(git rev-parse --abbrev-ref @{upstream} 2>/dev/null | sed 's|origin/||' || echo main)
+git diff $(git merge-base HEAD $BASE)...HEAD
+```
 
 ## Xác định integration
 

package/skills/spec-sad/SKILL.md

@@ -22,7 +22,7 @@ SAD không chứa: feature-level design, business rules, entity details — nh
 ## When NOT to Use
 
 - `prd.md` chưa có nội dung → chạy `/spec-prd` trước
-- Đang muốn thiết kế một feature cụ thể → dùng `/spec-fdd`
+- Đang muốn thiết kế một feature cụ thể → dùng `/spec-tech`
 
 ---
 
@@ -168,7 +168,7 @@ Thông báo kết quả:
 ✓ specs/main/sad.md đã được cập nhật (status: draft)
 
 Bước tiếp theo:
-  - /spec-frd {feature-name} → định nghĩa requirements của từng feature
+  - /spec-new {feature-name} → định nghĩa requirements của từng feature
 ```
 
 ---