spec-lite 1.1.10 → 1.1.12

package/package.json

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

package/skills/build/SKILL.md

@@ -100,29 +100,35 @@ Bạn muốn build trong worktree riêng cho integration này không? (y/n)
 
 **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`)
+1. **Thêm `.claude/worktrees/` vào `.gitignore`**
+   - Kiểm tra `.gitignore` ở root repo, nếu chưa có dòng `.claude/worktrees/` thì append:
+     ```bash
+     echo '.claude/worktrees/' >> .gitignore
+     ```
+
+2. **Tạo worktree mới** từ branch vừa tạo
+   - Đường dẫn worktree: `.claude/worktrees/{integration-slug}` (ví dụ: `.claude/worktrees/002-implement-todo`)
    - Lệnh:
      ```bash
-     git worktree add ../{repo}-{slug} feat/{slug}
+     git worktree add .claude/worktrees/{slug} build/{slug}
      ```
 
-2. **Detect package manager**
+3. **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**
+4. **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}/
+     cp .env* .claude/worktrees/{slug}/
      ```
    - Bỏ qua nếu không có file `.env*` nào.
 
-4. **Chuyển working context sang worktree mới**
+5. **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}`
+   - Nhắc user biết đang build tại: `.claude/worktrees/{slug}`
 
 ### Với mỗi task pending
 

package/skills/review/SKILL.md

@@ -41,12 +41,39 @@ Approve và thông báo tiếp tục `/build` task tiếp theo.
 
 Nhóm các findings thành tasks cụ thể có thể implement được. Mỗi finding Critical/Important là ít nhất một task. Đặt tên task bắt đầu bằng động từ, mô tả rõ việc phải sửa.
 
-**Bước 2 — Đề xuất thêm phase mới vào plan.md và todo.md:**
+**Bước 2 — Luôn ghi findings vào techdebt.md:**
+
+Lấy short SHA hiện tại: `git rev-parse --short HEAD`.
+
+Ghi findings vào `specs/integrations/{slug}/techdebt.md`.
+
+Nếu file chưa tồn tại, tạo mới từ `.claude/templates/integrations/techdebt-template.md`, điền `slug`, `title`, `created`.
+
+Append section mới vào cuối file (không ghi đè section cũ). Chỉ ghi các axis có ít nhất một Critical/Important finding:
+
+```markdown
+
+## {YYYY-MM-DD} — {short-sha}
+
+### Correctness
+- [ ] **Critical** — {tên ngắn gọn}
+
+### Security
+- [ ] **Important** — {tên ngắn gọn}
+
+### Performance
+- [ ] **Important** — {tên ngắn gọn}
+```
+
+> Details đầy đủ nằm ở Phase Review trong `plan.md` (nếu user chọn thêm phase), hoặc trong output của `/review` lúc đó.
+
+**Bước 3 — Đề xuất thêm phase mới vào plan.md và todo.md:**
 
 Hiển thị preview phase sẽ được thêm:
 
 ```
-Phát hiện {N} Critical / {M} Important findings. Đề xuất thêm phase mới:
+Phát hiện {N} Critical / {M} Important findings. Đã lưu vào techdebt.md.
+Đề xuất thêm phase mới để fix ngay:
 
 Phase Review: Fix review findings
 
@@ -60,17 +87,17 @@ Thêm phase này vào plan.md và todo.md, rồi chạy /build để fix?
 Hỏi user bằng `AskUserQuestion`:
 
 ```
-question: "Thêm phase Review vào plan.md/todo.md và chạy /build ngay?"
+question: "Thêm phase Review vào plan.md/todo.md?"
 options:
   - label: "Thêm phase và chạy /build"
     description: "Thêm các tasks fix findings vào plan.md và todo.md, rồi gọi /build để thực thi"
   - label: "Thêm phase nhưng không chạy /build"
     description: "Chỉ cập nhật plan.md và todo.md, tự chạy /build sau"
-  - label: "Lưu vào techdebt.md"
-    description: "Ghi findings vào specs/integrations/{slug}/techdebt.md để theo dõi sau, không fix ngay"
+  - label: "Để sau"
+    description: "Findings đã được lưu vào techdebt.md, xử lý sau"
 ```
 
-**Bước 3 — Nếu user chọn "Thêm phase" (cả hai option đầu):**
+**Bước 4 — Nếu user chọn "Thêm phase" (cả hai option đầu):**
 
 Xác định số phase tiếp theo từ plan.md (đếm số `### Phase` hiện có, cộng 1).
 
@@ -87,6 +114,8 @@ Append vào `plan.md` (trước section `## Definition of Done`):
 
 **depends:** {task ID cuối cùng trước phase này}
 
+**resolves-techdebt:** {YYYY-MM-DD} — {short-sha}
+
 **Các bước:**
 1. {bước fix cụ thể từ finding}
 
@@ -103,33 +132,17 @@ Append vào `todo.md`:
 - [ ] T{XXX} — {mô tả task fix}
 ```
 
-**Bước 4 — Nếu user chọn "Thêm phase và chạy /build":**
+**Bước 5 — Nếu user chọn "Thêm phase và chạy /build":**
 
 Sau khi cập nhật xong plan.md và todo.md, invoke ngay `/build` để thực thi phase Review vừa thêm.
 
-**Bước 4 — Nếu user chọn "Lưu vào techdebt.md":**
-
-Lấy short SHA hiện tại: `git rev-parse --short HEAD`.
-
-Ghi findings vào `specs/integrations/{slug}/techdebt.md`.
-
-Nếu file chưa tồn tại, tạo mới từ `.claude/templates/integrations/techdebt-template.md`, điền `slug`, `title`, `created`.
-
-Append section mới vào cuối file (không ghi đè section cũ):
-
-```markdown
-
-## {YYYY-MM-DD} — {short-sha}
-
-- [ ] **Critical** — {mô tả finding 1}
-- [ ] **Important** — {mô tả finding 2}
-```
+**Bước 5 — Nếu user chọn "Để sau":**
 
-Sau khi ghi xong, thông báo:
+Thông báo:
 
 ```
-Đã lưu {N} findings vào specs/integrations/{slug}/techdebt.md.
-Integration được đánh dấu có tech debt chưa xử lý.
+Findings đã được lưu vào specs/integrations/{slug}/techdebt.md.
+Chạy /review lại hoặc /build khi sẵn sàng xử lý.
 ```
 
 ---

package/templates/integrations/techdebt-template.md

@@ -2,12 +2,15 @@
 slug: "{slug}"
 created: {YYYY-MM-DD}
 referenced_by:
-  - skills/review/SKILL.md > Bước 4 — Lưu vào techdebt.md
+  - skills/review/SKILL.md > Bước 2 — Luôn ghi findings vào techdebt.md
 ---
 
 # Tech Debt — {title}
 
 ## {YYYY-MM-DD} — {short-sha}
 
-- [ ] **Critical** — {mô tả finding}
-- [ ] **Important** — {mô tả finding}
+### Correctness
+- [ ] **Critical** — {tên ngắn gọn}
+
+### Security
+- [ ] **Important** — {tên ngắn gọn}