spec-lite 1.1.9 → 1.1.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-lite",
-  "version": "1.1.9",
+  "version": "1.1.11",
   "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

@@ -31,5 +31,139 @@ git diff $(git merge-base HEAD $BASE)...HEAD
 
 ## Sau khi review
 
-- **Có Critical/Important:** Dừng, không tiếp tục `/build`. Sửa và re-review.
-- **Chỉ Suggestion hoặc không có finding:** Approve, tiếp tục `/build` task tiếp theo.
+### Chỉ Nit/Optional/FYI hoặc không có finding
+
+Approve và thông báo tiếp tục `/build` task tiếp theo.
+
+### Có Critical hoặc Important
+
+**Bước 1 — Tổng hợp findings thành tasks:**
+
+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:**
+
+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:
+
+Phase Review: Fix review findings
+
+  T0XX · Fix {mô tả finding 1}
+  T0XY · Fix {mô tả finding 2}
+  ...
+
+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?"
+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"
+```
+
+**Bước 3 — 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).
+
+Xác định task ID tiếp theo từ plan.md (lấy task ID lớn nhất hiện có, cộng 1).
+
+Append vào `plan.md` (trước section `## Definition of Done`):
+
+```markdown
+### Phase {N}: Review Findings
+
+#### T{XXX} · {task title — bắt đầu bằng động từ}
+
+**Mục tiêu:** {mô tả finding cần fix}
+
+**depends:** {task ID cuối cùng trước phase này}
+
+**Các bước:**
+1. {bước fix cụ thể từ finding}
+
+**Verification:**
+- [ ] {điều kiện verify finding đã được fix}
+
+---
+```
+
+Append vào `todo.md`:
+
+```markdown
+### Phase {N}: Review Findings
+- [ ] T{XXX} — {mô tả task fix}
+```
+
+**Bước 4 — 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}
+```
+
+Sau khi ghi xong, 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ý.
+```
+
+---
+
+## Đánh dấu techdebt đã resolved
+
+Khi `/build` hoàn thành **thành công** một Phase Review, nó phải tìm và mark các techdebt findings tương ứng là resolved.
+
+**Cơ chế liên kết:** Khi append Phase Review vào `plan.md` (Bước 3 ở trên), thêm field `resolves-techdebt` vào task đầu tiên của phase, trỏ đến section date trong techdebt.md:
+
+```markdown
+#### T{XXX} · Fix {mô tả finding 1}
+
+**Mục tiêu:** {mô tả finding cần fix}
+
+**depends:** {task ID cuối cùng trước phase này}
+
+**resolves-techdebt:** {YYYY-MM-DD} — {short-sha}
+
+**Các bước:**
+...
+```
+
+**Khi `/build` hoàn thành Phase Review:**
+
+1. Đọc field `resolves-techdebt` từ task đầu tiên của Phase Review trong `plan.md`
+2. Tìm section tương ứng trong `techdebt.md` (match theo `## {YYYY-MM-DD} — {short-sha}`)
+3. Với mỗi dòng `- [ ]` trong section đó → đổi thành `- [x]` và append ` *(resolved by T{XXX})*`:
+
+```markdown
+## 2026-05-08 — abc1234
+
+- [x] **Critical** — {mô tả finding 1} *(resolved by T005)*
+- [x] **Important** — {mô tả finding 2} *(resolved by T005)*
+```
+
+4. Nếu không tìm được field `resolves-techdebt` hoặc không tìm được section trong techdebt.md → bỏ qua, không báo lỗi.

package/templates/integrations/techdebt-template.md

@@ -0,0 +1,13 @@
+---
+slug: "{slug}"
+created: {YYYY-MM-DD}
+referenced_by:
+  - skills/review/SKILL.md > Bước 4 — Lưu vào techdebt.md
+---
+
+# Tech Debt — {title}
+
+## {YYYY-MM-DD} — {short-sha}
+
+- [ ] **Critical** — {mô tả finding}
+- [ ] **Important** — {mô tả finding}