spec-lite 1.1.7 → 1.1.9

package/package.json

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

package/skills/ado-create/SKILL.md

@@ -26,20 +26,24 @@ description: Tạo Feature và User Story tickets trên ADO từ spec.md của m
 Chưa có .claude/ado.yaml. Hãy chạy /ado-config trước.
 ```
 
-**Xác định current user:** Đọc `git config user.email`. Tìm email này trong toàn bộ `team.PE + team.SE + team.DE` của ado.yaml.
+**Xác định current user:** Gọi `mcp__azure-devops__core_get_identity_ids` với descriptor `me` hoặc `[me]` để lấy identity của user đang authenticated với ADO. Từ kết quả trả về, lấy `providerDisplayName` hoặc `subjectDescriptor` rồi tìm email tương ứng trong toàn bộ `team.PE + team.SE + team.DE` của ado.yaml.
 
-**Nếu tìm thấy** → dùng email đó làm assignee.
+**Nếu tìm thấy** → dùng email đó làm assignee, dùng identity ID từ kết quả MCP (không cần gọi lại).
 
-**Nếu không tìm thấy** → hỏi bằng `AskUserQuestion`:
+**Nếu không resolve được (tool lỗi hoặc không match được email)** → hỏi bằng `AskUserQuestion`:
 
 ```
 question: "Bạn là ai trong team? (dùng để assign ticket)"
 options: [mỗi email trong team.PE + team.SE + team.DE thành 1 option]
 ```
 
-Sau khi xác định email, resolve thành ADO identity ID bằng `mcp__azure-devops__core_get_identity_ids`.
+Sau khi user chọn email, resolve thành ADO identity ID bằng `mcp__azure-devops__core_get_identity_ids`.
 
-Nếu resolve thất bại → tiếp tục nhưng không set assignee; thông báo để user tự assign trên ADO sau.
+Nếu resolve thất bại → **dừng và báo lỗi**. Không tạo ticket nếu không xác định được assignee:
+
+```
+Không resolve được ADO identity ID cho <email>. Kiểm tra lại PAT token hoặc quyền truy cập ADO rồi thử lại.
+```
 
 ---
 
@@ -300,6 +304,7 @@ Tìm section `## ADO Tickets` trong file.
 
 Trước khi tạo ticket:
 - [ ] `.claude/ado.yaml` tồn tại và `epic.id` là số nguyên hợp lệ
+- [ ] Current ADO user đã được xác định và resolve thành identity ID — **nếu không xác định được thì dừng, không tạo ticket không có assignee**
 - [ ] Integration được chọn có `spec.md` chứa ít nhất 1 Feature
 - [ ] `frd.md` tìm được cho mỗi Feature (cảnh báo nếu thiếu, không dừng)
 

package/skills/archive/SKILL.md

@@ -0,0 +1,125 @@
+---
+name: archive
+description: Archive một integration từ specs/integrations sang specs/archive. Dùng khi một integration đã hoàn thành hoặc không còn active và cần được lưu trữ ra khỏi thư mục làm việc chính.
+---
+
+# archive
+
+## Overview
+
+Di chuyển một integration từ `specs/integrations/` sang `specs/archive/` để dọn dẹp thư mục làm việc chính trong khi vẫn giữ nguyên toàn bộ nội dung integration đó.
+
+## When to Use
+
+- Integration đã hoàn thành (Done) và không cần active nữa
+- Integration bị cancel hoặc deferred vô thời hạn
+- Muốn dọn dẹp `specs/integrations/` khỏi các integration cũ
+
+## When NOT to Use
+
+- Integration đang In Progress → chưa nên archive
+- Muốn xóa hoàn toàn → đừng archive, thao tác thủ công sau khi confirm với team
+
+---
+
+## Process
+
+### Bước 1: Kiểm tra thư mục archive
+
+Kiểm tra `specs/archive/` đã tồn tại chưa.
+
+**Nếu chưa tồn tại** → tạo thư mục `specs/archive/`.
+
+**Nếu đã tồn tại** → tiếp tục.
+
+---
+
+### Bước 2: Liệt kê integrations
+
+Quét `specs/integrations/` để tìm tất cả các integration (mỗi integration là một thư mục con).
+
+**Nếu không có integration nào:**
+
+```
+Không có integration nào trong specs/integrations/.
+```
+
+Dừng lại.
+
+**Nếu có integrations**, hiển thị danh sách dạng numbered list, kèm trạng thái nếu đọc được từ `spec.md` (frontmatter `status` hoặc heading):
+
+```
+Integrations trong specs/integrations/:
+
+  [1]  001-user-authentication      (approved)
+  [2]  002-payment-integration      (draft)
+  [3]  003-notification-service     (done)
+  [4]  004-admin-panel              (in-progress)
+
+Chọn số thứ tự integration để archive (hoặc nhập nhiều số cách nhau bởi dấu cách, ví dụ: 1 3):
+```
+
+Với mỗi integration, cố gắng đọc `spec.md` để lấy status. Nếu không đọc được thì bỏ qua phần status.
+
+---
+
+### Bước 3: Xác nhận
+
+Sau khi user chọn, hiển thị xác nhận trước khi di chuyển:
+
+```
+Sẽ archive các integration sau:
+
+  specs/integrations/001-user-authentication/  →  specs/archive/001-user-authentication/
+  specs/integrations/003-notification-service/ →  specs/archive/003-notification-service/
+
+Xác nhận? (yes/no)
+```
+
+Nếu user không confirm → hủy, không làm gì.
+
+---
+
+### Bước 4: Di chuyển
+
+Với mỗi integration đã được confirm:
+
+- Di chuyển toàn bộ thư mục `specs/integrations/{slug}/` sang `specs/archive/{slug}/`
+- Giữ nguyên toàn bộ cấu trúc thư mục và file bên trong
+
+Nếu `specs/archive/{slug}/` đã tồn tại (trùng tên) → cảnh báo:
+
+```
+⚠ specs/archive/001-user-authentication/ đã tồn tại. Bỏ qua integration này để tránh ghi đè.
+```
+
+Và bỏ qua integration đó, tiếp tục với các integration còn lại.
+
+---
+
+### Bước 5: Kết quả
+
+Thông báo kết quả:
+
+```
+✓ Đã archive:
+  specs/archive/001-user-authentication/
+  specs/archive/003-notification-service/
+
+{nếu có lỗi}
+⚠ Bỏ qua (đã tồn tại):
+  specs/archive/005-foo/
+
+specs/integrations/ hiện còn {N} integration(s).
+```
+
+---
+
+## Verification
+
+Trước khi di chuyển:
+
+- [ ] `specs/archive/` đã tồn tại (tạo nếu chưa có)
+- [ ] User đã chọn ít nhất 1 integration
+- [ ] User đã confirm trước khi di chuyển
+- [ ] Không ghi đè nếu slug đã tồn tại trong `specs/archive/`

package/skills/build/SKILL.md

@@ -38,6 +38,38 @@ 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 0a: Gate check — plan.md phải approved
+
+Đọc frontmatter của `specs/integrations/{slug}/plan.md`.
+
+Nếu `plan.md` chưa tồn tại:
+
+> ⛔ Chưa có `plan.md` cho integration **{slug}**.
+>
+> Để tiếp tục:
+> 1. Chạy `/plan` để tạo plan.md và todo.md
+> 2. Review và đổi `status: approved` trong plan.md
+>
+> Sau đó chạy lại `/build`.
+
+**Dừng hoàn toàn.**
+
+Nếu `plan.md` tồn tại nhưng `status` **không phải** `approved`:
+
+> ⛔ `plan.md` của integration **{slug}** chưa được approve (status hiện tại: `{status}`).
+>
+> Để tiếp tục:
+> 1. Review `specs/integrations/{slug}/plan.md`
+> 2. Đổi `status: draft` → `status: approved` trong frontmatter
+>
+> Sau khi approve xong, chạy lại `/build`.
+
+**Dừng hoàn toàn. Không tiếp tục.**
+
+Nếu `status: approved` → tiếp tục sang Bước 0b.
+
+---
+
 ### Bước 0b: Tạo branch và chọn chế độ worktree
 
 **Tạo branch (bắt buộc):**

package/skills/plan/SKILL.md

@@ -53,6 +53,32 @@ Nếu plan.md / todo.md đã tồn tại → hỏi trước khi ghi đè.
 
 ---
 
+### Bước 1b: Gate check — spec.md và tech.md phải approved
+
+Đọc frontmatter của `specs/integrations/{slug}/spec.md` và `specs/integrations/{slug}/tech.md`.
+
+Nếu `tech.md` chưa tồn tại → coi như `status: missing`.
+
+Kiểm tra từng file — nếu **bất kỳ file nào** chưa `approved`:
+
+> ⛔ Không thể tạo plan.md — các artifact sau chưa được approve:
+>
+> - `spec.md` — status: `{status}` ← chỉ liệt kê nếu chưa approved
+> - `tech.md` — status: `{status}` ← chỉ liệt kê nếu chưa approved hoặc chưa tồn tại
+>
+> Để tiếp tục:
+> 1. Review từng file chưa approved (chạy `/spec-tech` trước nếu `tech.md` chưa có)
+> 2. Apply Cascade Proposals (nếu có)
+> 3. Đổi `status` thành `approved` trong frontmatter
+>
+> Sau khi approve xong, chạy lại `/plan`.
+
+**Dừng hoàn toàn. Không tiếp tục.**
+
+Nếu cả hai đều `approved` → tiếp tục sang Bước 2.
+
+---
+
 ### Bước 2: Load và surface context
 
 Load:

package/skills/spec-tech/SKILL.md

@@ -56,6 +56,27 @@ Nếu integration đã có `tech.md` → hỏi trước khi tiếp tục:
 
 ---
 
+### Bước 1b: Gate check — spec.md phải approved
+
+Đọc frontmatter của `specs/integrations/{slug}/spec.md`.
+
+Nếu `status` **không phải** `approved`:
+
+> ⛔ `spec.md` của integration **{slug}** chưa được approve (status hiện tại: `{status}`).
+>
+> Để tiếp tục:
+> 1. Review `specs/integrations/{slug}/spec.md`
+> 2. Apply Cascade Proposals vào main artifacts (nếu có)
+> 3. Đổi `status: draft` → `status: approved` trong frontmatter
+>
+> Sau khi approve xong, chạy lại `/spec-tech`.
+
+**Dừng hoàn toàn. Không tiếp tục.**
+
+Nếu `status: approved` → tiếp tục sang Bước 2.
+
+---
+
 ### Bước 2: Load context
 
 Load các file sau:

package/skills-overview.md

@@ -174,6 +174,7 @@ Sau khi main artifacts đã sẵn sàng (từ greenfield hoặc brownfield), m
 | `/plan` | `spec.md`, `tech.md`, `domain.md` | `plan.md`, `todo.md` |
 | `/build` | `plan.md`, `todo.md` | *(source code)* |
 | `/review` | `spec.md`, `tech.md`, `plan.md`, `todo.md`, *(source code)* | *(findings report)* |
+| `/archive` | `specs/integrations/` | `specs/archive/` |
 
 ### `/spec-new [requirement]`
 
@@ -267,6 +268,22 @@ Review implementation sau `/build` theo năm trục: correctness, readability, a
 
 ---
 
+### `/archive`
+
+Di chuyển integration đã hoàn thành hoặc không còn active từ `specs/integrations/` sang `specs/archive/` để dọn dẹp thư mục làm việc chính.
+
+**Bước 1 — Kiểm tra thư mục:** Tự động tạo `specs/archive/` nếu chưa tồn tại.
+
+**Bước 2 — Liệt kê:** Quét `specs/integrations/`, hiển thị numbered list kèm status (đọc từ `spec.md` nếu có). Nếu không có integration nào → thông báo và dừng.
+
+**Bước 3 — Xác nhận:** Hiển thị preview mapping `integrations/{slug}/ → archive/{slug}/` trước khi di chuyển. Chờ user confirm.
+
+**Bước 4 — Di chuyển:** Move toàn bộ thư mục, giữ nguyên cấu trúc bên trong. Nếu slug đã tồn tại trong `specs/archive/` → bỏ qua và cảnh báo để tránh ghi đè.
+
+**Bước 5 — Kết quả:** Liệt kê integrations đã archive, integrations bị bỏ qua (nếu có), và số integration còn lại trong `specs/integrations/`.
+
+---
+
 ### Thứ tự thực hiện
 
 ```
@@ -284,6 +301,8 @@ Review implementation sau `/build` theo năm trục: correctness, readability, a
         /review               │ (nếu Critical/Important)
                 │              │
            [approve] ──────────┘ (nếu Suggestion only)
+                │
+        /archive  (khi integration Done, dọn dẹp khỏi integrations/)
 ```
 
 ---