spec-lite 1.0.1 → 1.0.2

package/package.json

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

package/skills/build/SKILL.md

@@ -13,10 +13,35 @@ Invoke `incremental-implementation` và `test-driven-development` cùng nhau cho
 
 ## Quy trình
 
+### Bước 0: Xác định integration
+
+**Nếu có ARGUMENT:**
+- Parse argument: có thể là số thứ tự (`2`, `002`) hoặc slug (`002-implement-todo`)
+- Quét `specs/integrations/*/todo.md`, tìm integration khớp với argument
+- Nếu không tìm thấy → báo lỗi:
+  > Không tìm thấy integration khớp với "{argument}". Kiểm tra lại tên hoặc số thứ tự.
+- Nếu tìm thấy → dùng `specs/integrations/{slug}/` làm working integration, bắt đầu luôn
+
+**Nếu không có ARGUMENT:**
+- Quét `specs/integrations/*/todo.md`, liệt kê tất cả integrations có todo.md, đánh dấu tiến độ:
+
+```
+Integrations:
+
+  [1] 001-implement-auth    — Implement Auth             (8/8 done) ✓
+  [2] 002-implement-todo    — Implement Todo Management  (0/10 pending)
+
+Chọn số integration:
+```
+
+  Format: `({done}/{total} done)` hoặc `({pending} pending)` — đếm từ todo.md
+  - 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."
+
 ### Với mỗi task pending
 
 **1. Chọn task** (`incremental-implementation` — Increment Cycle)
-Lấy task `[ ]` tiếp theo trong `todo.md`. Đọc acceptance criteria trong `plan.md`.
+Lấy task `[ ]` tiếp theo trong `todo.md` của integration đã chọn. Đọc acceptance criteria trong `plan.md` tương ứng.
 
 **2. Load context** (`incremental-implementation` — Rule 0: Simplicity First)
 Đọc code, types, patterns liên quan. Hỏi: "Cách đơn giản nhất có thể làm việc là gì?"
@@ -50,7 +75,7 @@ Build phải thành công trước khi commit. Nếu fail → invoke `debugging-
 Commit với message mô tả rõ, giới hạn trong phạm vi task này. Một thay đổi logic mỗi commit.
 
 **8. Đánh dấu hoàn thành và tiếp tục**
-Check `[x]` trong `todo.md`. Lặp lại từ bước 1 cho task tiếp theo.
+Check `[x]` trong `todo.md` của integration đang build. Lặp lại từ bước 1 cho task tiếp theo.
 
 ## Dấu hiệu task UI/UX
 

package/skills/plan/SKILL.md

@@ -27,22 +27,28 @@ Mọi quyết định về sizing, slicing đều thuộc về `planning-and-tas
 
 ### Bước 1: Xác định integration
 
+**Nếu có ARGUMENT:**
+- Parse argument: có thể là số thứ tự (`2`, `002`) hoặc slug (`002-implement-todo`)
+- Quét `specs/integrations/*/`, tìm integration khớp với argument
+- Nếu không tìm thấy → báo lỗi:
+  > Không tìm thấy integration khớp với "{argument}". Kiểm tra lại tên hoặc số thứ tự.
+- Nếu tìm thấy → dùng integration đó, bắt đầu luôn
+
+**Nếu không có ARGUMENT:**
+
 Quét `specs/integrations/`. Liệt kê tất cả integrations:
 
 ```
 Integrations:
 
-  [1] f001-authentication       — User Authentication        spec✓ tech✓  plan—
-  [2] f003-app-browsing         — App Browsing & Opt-in      spec✓ tech—
-  [3] f004-credit-system        — Credit System              spec—
+  [1] 001-implement-auth    — Implement Auth             spec✓ tech✓ plan✓
+  [2] 002-implement-todo    — Implement Todo Management  spec✓ tech✓ plan—
 
 Chọn số integration:
 ```
 
 Legend: `✓` = có, `—` = chưa có
 
-Nếu có ARGUMENT → chọn luôn, không hiển thị danh sách.
-
 Nếu plan.md / todo.md đã tồn tại → hỏi trước khi ghi đè.
 
 ---
@@ -84,77 +90,7 @@ Invoke `planning-and-task-breakdown` với context đã load. Skill đó sẽ th
 
 ### plan.md
 
-```markdown
----
-id: "{slug}"
-slug: "{slug}"
-title: "{title} — Implementation Plan"
-features: ["{F-XXX}"]
-status: draft
-created: {YYYY-MM-DD}
----
-
-## Summary
-
-[2-3 sentences on what will be implemented]
-
-## Dependency Graph
-
-[ASCII diagram — bottom = foundations, top = UI. Ví dụ:]
-
-    UI Components
-         │
-    API Routes ──── Middleware
-         │
-      Services
-         │
-    Prisma Schema
-
-## Tasks
-
-### Phase 1: [Phase name]
-
-#### T001 · [task title — starts with a verb]
-
-**Mục tiêu:** [One sentence: what this task delivers]
-
-**depends:** — (hoặc T-IDs)
-
-**Các bước:**
-1. [Concrete implementation step]
-2. [Concrete implementation step]
-
-**Verification:**
-- [ ] [AC-F-001] [specific test case]
-- [ ] [smoke check or observable result]
-
----
-
-### Phase N: Verification
-
-#### T00N · Integration tests — [flow name]
-
-**Mục tiêu:** [End-to-end flow being tested]
-
-**depends:** T001, T002, ...
-
-**Các bước:**
-1. [Test setup / seed data]
-2. [Execute happy path]
-3. [Execute error cases]
-
-**Verification:**
-- [ ] Happy path: [description]
-- [ ] Error case: [description]
-
----
-
-## Definition of Done
-
-- [ ] [AC-F-001 / AC-S-001] [AC description — concise, preserve intent]
-- [ ] All unit tests pass
-- [ ] All integration tests pass
-```
+Dùng `.claude/templates/integrations/plan-template.md` làm skeleton, điền nội dung từ breakdown vào từng section.
 
 **Lưu ý format:**
 - Task ID dùng `·` (middle dot), không dùng `—`
@@ -164,16 +100,7 @@ created: {YYYY-MM-DD}
 
 ### todo.md
 
-```markdown
-# [title] — Todo
-
-### Phase 1: [Phase name]
-- [ ] T001 · [task title]
-- [ ] T002 · [task title]
-
-### Phase N: Verification
-- [ ] T00N · Integration tests — [flow name]
-```
+Dùng `.claude/templates/integrations/todo-template.md` làm skeleton, điền nội dung từ breakdown vào từng section.
 
 ---
 

package/skills/planning-and-task-breakdown/SKILL.md

@@ -41,15 +41,19 @@ Map what depends on what:
 ```
 Database schema
     │
-    ├── API models/types
+    ├── Domain models
     │       │
-    │       ├── API endpoints
-    │       │       │
-    │       │       └── Frontend API client
-    │       │               │
-    │       │               └── UI components
-    │       │
-    │       └── Validation logic
+    │       └── Services
+    │               │
+    │               ├── Validation logic
+    │               │
+    │               └── API endpoints
+    │                       │
+    │                       ├── Middleware
+    │                       │
+    │                       └── Frontend API client
+    │                               │
+    │                               └── UI components
     │
     └── Seed data / migrations
 ```

package/skills/spec-tech/SKILL.md

@@ -28,14 +28,22 @@ Tạo `tech.md` cho một integration trong `specs/integrations/{slug}/`.
 
 ### Bước 1: Xác định integration
 
-Quét thư mục `specs/integrations/`. Liệt kê **tất cả** integrations có `spec.md`, đánh dấu những cái đã có `tech.md`:
+**Nếu có ARGUMENT:**
+- Parse argument: có thể là số thứ tự (`2`, `002`) hoặc slug (`002-implement-todo`)
+- Quét `specs/integrations/*/spec.md`, tìm integration khớp với argument
+- Nếu không tìm thấy → báo lỗi:
+  > Không tìm thấy integration khớp với "{argument}". Kiểm tra lại tên hoặc số thứ tự.
+- Nếu tìm thấy → dùng integration đó, bắt đầu luôn
+
+**Nếu không có ARGUMENT:**
+
+Quét `specs/integrations/`. Liệt kê **tất cả** integrations có `spec.md`, đánh dấu những cái đã có `tech.md`:
 
 ```
 Integrations:
 
-  [1] f001-authentication       — User Authentication
-  [2] f003-app-browsing         — App Browsing & Opt-in         ✓ có tech.md
-  [3] f004-credit-system        — Credit System
+  [1] 001-implement-auth    — Implement Auth             spec✓ tech✓
+  [2] 002-implement-todo    — Implement Todo Management  spec✓ tech—
 
 Chọn số integration:
 ```
@@ -43,8 +51,6 @@ Chọn số integration:
 Nếu không có integration nào → thông báo:
 > Chưa có integration nào. Hãy chạy `/spec-new` trước.
 
-**Nếu có ARGUMENT** → đây là số thứ tự trong danh sách trên (ví dụ `1`, `2`, hoặc `001`). Parse thành số nguyên, bỏ qua leading zeros, map vào integration tương ứng — không cần hiển thị danh sách, chọn luôn.
-
 Nếu integration đã có `tech.md` → hỏi trước khi tiếp tục:
 > `tech.md` đã tồn tại cho integration này. Tiếp tục sẽ ghi đè. Tiếp tục không?
 
@@ -162,7 +168,7 @@ Thông báo kết quả:
 
 Bước tiếp theo:
   - Review và approve tech.md
-  - Implement theo tech.md
+  - /plan → tạo plan.md và todo.md cho integration này
   - Sau khi done: đổi status F-XXX trong prd.md thành DONE
   - Nếu Cascade Proposals có thay đổi → chạy /spec-domain hoặc /spec-sad
 ```

package/templates/integrations/plan-template.md

@@ -14,25 +14,74 @@ referenced_by:
 
 <!-- Mô tả ngắn những gì sẽ được implement trong integration này -->
 
+## Dependency Graph
+
+```
+<!-- ASCII diagram — bottom = foundations, top = UI. Ví dụ:
+
+Database schema
+    │
+    ├── Domain models
+    │       │
+    │       └── Services
+    │               │
+    │               └── API endpoints
+    │                       │
+    │                       └── UI components
+-->
+```
+
 ## Tasks
 
 ### Phase 1: {tên phase}
 
-- [ ] T001 — {mô tả task}
-- [ ] T002 — {mô tả task}
-- [ ] T003 — {mô tả task} (depends: T001)
+#### T001 · {task title — bắt đầu bằng động từ}
 
-### Phase 2: {tên phase}
+**Mục tiêu:** {One sentence: what this task delivers}
 
-- [ ] T004 — {mô tả task} (depends: T001, T002)
-- [ ] T005 — {mô tả task}
+**depends:** —
 
-<!-- Convention:
-  - ID tăng dần trong phạm vi integration: T001, T002...
-  - Dependency ghi rõ: (depends: T001, T003)
-  - Tasks trong cùng phase không có dependency → có thể xử lý song song
-  - Tasks across phases có dependency tuần tự
--->
+**Các bước:**
+1. {Concrete implementation step}
+2. {Concrete implementation step}
+
+**Verification:**
+- [ ] {specific test case hoặc observable result}
+
+---
+
+#### T002 · {task title}
+
+**Mục tiêu:** {One sentence}
+
+**depends:** T001
+
+**Các bước:**
+1. {Concrete implementation step}
+
+**Verification:**
+- [ ] {specific test case hoặc observable result}
+
+---
+
+### Phase N: Verification
+
+#### T00N · Integration tests — {flow name}
+
+**Mục tiêu:** {End-to-end flow being tested}
+
+**depends:** T001, T002, ...
+
+**Các bước:**
+1. {Test setup / seed data}
+2. {Execute happy path}
+3. {Execute error cases}
+
+**Verification:**
+- [ ] Happy path: {description}
+- [ ] Error case: {description}
+
+---
 
 ## Definition of Done
 

package/templates/integrations/spec-template.md

@@ -24,21 +24,27 @@ referenced_by:
 
 ### Feature: {feature-name}
 
-**Feature-level AC:**
+**Feature-level Acceptance Criteria:**
 
-- [ ] AC-F-001: GIVEN {precondition}
-               WHEN {action}
-               THEN {expected outcome}
+- [ ] AC-F-001
+  - **Given** {precondition}
+  - **When** {action}
+  - **Then** {expected outcome}
 
 <!-- Lặp lại block Story bên dưới cho mỗi user story thuộc feature này -->
 
-**Story: {story-title}**
+#### US-001: {Story title}
 
-> {mô tả user story — As a {role}, I want to {action} so that {benefit}}
+**{Persona}** muốn **{hành động}** để **{mục tiêu}**.
 
-- [ ] AC-S-001: GIVEN {precondition}
-               WHEN {action}
-               THEN {expected outcome}
+**Priority:** Must / Should / Could
+
+**Acceptance Criteria:**
+
+- [ ] AC-S-001
+  - **Given** {precondition}
+  - **When** {action}
+  - **Then** {expected outcome}
 
 ## Out of Scope
 

package/templates/main/feature/frd-template.md

@@ -19,40 +19,44 @@ referenced_by:
 
 Criteria áp dụng cho toàn bộ feature — không gắn với story cụ thể (ví dụ: performance, security, accessibility).
 
-- [ ] GIVEN {precondition}
-      WHEN {action}
-      THEN {expected outcome}
+- [ ]
+  - **Given** {precondition}
+  - **When** {action}
+  - **Then** {expected outcome}
 
 ## User Stories
 
 ### US-001: {Story title}
 
-As a {persona}, I want to {action} so that {value}.
+**{Persona}** muốn **{hành động}** để **{mục tiêu}**.
 
 **Priority:** Must / Should / Could
 
 **Acceptance Criteria:**
 
-- [ ] GIVEN {precondition}
-      WHEN {action}
-      THEN {expected outcome}
-- [ ] GIVEN {precondition}
-      WHEN {action}
-      THEN {expected outcome}
+- [ ]
+  - **Given** {precondition}
+  - **When** {action}
+  - **Then** {expected outcome}
+- [ ]
+  - **Given** {precondition}
+  - **When** {action}
+  - **Then** {expected outcome}
 
 ---
 
 ### US-002: {Story title}
 
-As a {persona}, I want to {action} so that {value}.
+**{Persona}** muốn **{hành động}** để **{mục tiêu}**.
 
 **Priority:** Must / Should / Could
 
 **Acceptance Criteria:**
 
-- [ ] GIVEN {precondition}
-      WHEN {action}
-      THEN {expected outcome}
+- [ ]
+  - **Given** {precondition}
+  - **When** {action}
+  - **Then** {expected outcome}
 
 ---