spec-lite 1.1.7 → 1.1.8

package/package.json

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

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-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/)
 ```
 
 ---