spec-lite 1.2.0 → 1.2.1

package/README.md

@@ -86,7 +86,7 @@ Mỗi requirement mới đều đi qua pipeline này.
           │
    /build ◄──────────────┐
           │               │
-   /review                │ (nếu Critical/Important → sửa và build lại)
+   /review-integration    │ (nếu Critical/Important → sửa và build lại)
           │               │
      [approve] ───────────┘ (nếu chỉ Suggestion hoặc không có finding)
 ```
@@ -109,7 +109,7 @@ Tạo `plan.md` và `todo.md` từ `spec.md` + `tech.md`.
 #### `/build`
 Implement từng task trong `plan.md`/`todo.md` theo TDD incremental.
 
-#### `/review`
+#### `/review-integration`
 Review implementation sau `/build` theo năm trục: correctness, readability, architecture, security, performance. Đối chiếu trực tiếp với `spec.md` và `tech.md`.
 
 - Critical/Important → dừng, sửa, re-review
@@ -130,6 +130,6 @@ Review implementation sau `/build` theo năm trục: correctness, readability, a
 | `/spec-tech` | `specs/integrations/{slug}/tech.md` |
 | `/plan` | `specs/integrations/{slug}/plan.md`, `todo.md` |
 | `/build` | *(implements tasks từ `plan.md`/`todo.md`)* |
-| `/review` | *(findings report — không tạo file)* |
+| `/review-integration` | *(findings report — không tạo file)* |
 
 Component và feature artifacts trong greenfield mọc dần qua **cascade proposals** từ integrations — không có skill chuyên biệt để tạo.

package/package.json

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

package/skills/build/SKILL.md

@@ -74,7 +74,7 @@ Nếu `status: approved` → tiếp tục sang Bước 0b.
 
 **Tạo branch (bắt buộc):**
 
-Luôn tạo branch `build/{integration-slug}` trước khi build, bất kể có dùng worktree hay không. Điều này đảm bảo `/review` luôn có base để diff chính xác.
+Luôn tạo branch `build/{integration-slug}` trước khi build, bất kể có dùng worktree hay không. Điều này đảm bảo `/review-integration` luôn có base để diff chính xác.
 
 ```bash
 git checkout -b feat/{slug}
@@ -212,7 +212,7 @@ Invoke `debugging-and-error-recovery`:
 Khi tất cả task trong session này đã done, thông báo:
 
 ```
-Tất cả task đã hoàn thành. Bước tiếp theo: chạy /review để kiểm tra toàn bộ implementation trước khi merge.
+Tất cả task đã hoàn thành. Bước tiếp theo: chạy /review-integration để kiểm tra toàn bộ implementation trước khi merge.
 ```
 
-Không tự động invoke `/review` — để user chủ động gọi.
+Không tự động invoke `/review-integration` — để user chủ động gọi.

package/skills/{review → review-integration}/SKILL.md

@@ -1,9 +1,9 @@
 ---
-name: review
+name: review-integration
 description: Review code sau bước /build theo năm trục — correctness, readability, architecture, security, performance. Dùng sau khi hoàn thành một hoặc nhiều task trong todo.md. Đối chiếu implementation với spec.md và tech.md để xác nhận đúng yêu cầu.
 ---
 
-# Review
+# Review Integration
 
 ## Tổng quan
 
@@ -65,7 +65,7 @@ Append section mới vào cuối file (không ghi đè section cũ). Chỉ ghi c
 - [ ] **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 đó.
+> Details đầy đủ nằm ở Phase Review trong `plan.md` (nếu user chọn thêm phase), hoặc trong output của `/review-integration` lúc đó.
 
 **Bước 3 — Đề xuất thêm phase mới vào plan.md và todo.md:**
 
@@ -142,7 +142,7 @@ Thông báo:
 
 ```
 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ý.
+Chạy /review-integration lại hoặc /build khi sẵn sàng xử lý.
 ```
 
 ---

package/skills/spec-brownfield-component/SKILL.md

@@ -214,20 +214,30 @@ Ghi tất cả? [y] hoặc review từng file trước [r]:
 
 ---
 
-### Bước 10: Điền Component Index vào prd.md
+### Bước 10: Điền Component Index vào prd.md + sad.md Components table
 
-Sau khi artifacts đã được ghi, update `specs/main/prd.md` Component Index với danh sách đã confirm:
+Sau khi artifacts đã được ghi, update song song hai bảng — `prd.md > Components` (vai trò business) và `sad.md > System Overview > Components` (góc nhìn architectural). Danh sách C-XXX phải khớp giữa hai bảng.
 
 ```
-Sẽ điền Component Index vào prd.md:
+Sẽ điền:
+
+prd.md Component Index (business view):
   C-001 | auth         | Xác thực và phân quyền người dùng       | active
   C-002 | user         | Quản lý thông tin người dùng             | active
   C-003 | payment      | Xử lý thanh toán và giao dịch            | active
   C-004 | notification | Gửi thông báo qua email/push             | active
 
+sad.md Components table (architectural view):
+  C-001 | auth         | Stateless service, JWT issuer, in-mem session cache
+  C-002 | user         | Stateful service, owns user DB, exposes REST
+  C-003 | payment      | Stateful service, integrates Stripe, idempotent writes
+  C-004 | notification | Worker, consumes events from message bus
+
 Apply? [y/n]
 ```
 
+Cột architectural notes trong sad.md nên ngắn gọn — tập trung vào boundary/deployment/key tech concern, không lặp lại business role từ prd.md.
+
 ---
 
 ### Bước 11: Summary
@@ -239,6 +249,7 @@ Apply? [y/n]
   ...
 
 ✓ prd.md Component Index: {N} entries đã được điền
+✓ sad.md Components table: {N} entries đã được điền (architectural view)
 
 {nếu có} ✓ domain.md Shared Entities: {N} entities đã được cascade
 
@@ -262,5 +273,6 @@ Bước tiếp theo:
 - [ ] Dependencies chỉ reference C-XXX IDs, không reference file paths
 - [ ] Business rules detect được đánh dấu `(detected from code)`
 - [ ] prd.md Component Index đã được update
+- [ ] sad.md Components table đã được update — danh sách C-XXX khớp với prd.md
 - [ ] Shared Entities đã được cascade vào domain.md (nếu có)
 - [ ] NEEDS_CLARIFY items được list đầy đủ trong summary

package/skills/spec-sad/SKILL.md

@@ -111,6 +111,12 @@ Hỏi tuần tự từng phần:
 
 Nếu user muốn đề xuất → đề xuất 2-3 option với trade-offs rõ ràng, để user chọn. Không quyết định thay.
 
+**Phần 1.5 — System Overview (diagram + Components table):**
+> Vẽ sơ đồ tổng thể (Mermaid): các component và quan hệ chính.
+> Components table (projection từ `prd.md > Components`): với mỗi `C-XXX`, ghi 1 dòng architectural note — boundary/deployment unit/key tech concern. **Không lặp lại role/responsibility từ `crd.md`** — chỉ góc nhìn architectural.
+
+Nếu `prd.md > Components` còn rỗng (brownfield init chưa scan code, hoặc greenfield chưa biết component) → để placeholder và note rằng bảng này sẽ được điền khi Component Index có nội dung (qua `/spec-brownfield-component` hoặc cascade từ integration).
+
 **Phần 2 — Tech Stack:**
 > Tech stack cho từng layer: Frontend, Backend, Database, Infrastructure?
 > Với mỗi lựa chọn: lý do chọn là gì? (performance, team familiarity, ecosystem...)
@@ -196,6 +202,7 @@ Trước khi kết thúc, kiểm tra:
 
 - [ ] Frontmatter đầy đủ và đúng schema
 - [ ] Architectural Style có lý do gắn với NFRs hoặc constraints
+- [ ] System Overview có diagram + Components table; danh sách C-XXX khớp với `prd.md > Components` (hoặc cả hai cùng rỗng nếu Component Index chưa được điền)
 - [ ] Mỗi tech stack item có lý do chọn rõ ràng
 - [ ] Tất cả 4 cross-cutting concerns đã được điền (auth, error, logging, caching)
 - [ ] Guardrails có ít nhất 3 item, mỗi item cụ thể và actionable

package/skills-overview.md

@@ -173,7 +173,7 @@ Sau khi main artifacts đã sẵn sàng (từ greenfield hoặc brownfield), m
 | `/spec-tech [number]` | `sad.md`, `domain.md`, cdd(s), fdd(s), `spec.md` | `specs/integrations/{slug}/tech.md` |
 | `/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)* |
+| `/review-integration` | `spec.md`, `tech.md`, `plan.md`, `todo.md`, *(source code)* | *(findings report)* |
 | `/archive` | `specs/integrations/` | `specs/archive/` |
 
 ### `/spec-new [requirement]`
@@ -250,7 +250,7 @@ Với mỗi task `[ ]` trong `todo.md`, lặp lại:
 
 ---
 
-### `/review`
+### `/review-integration`
 
 Review implementation sau `/build` theo năm trục: correctness, readability, architecture, security, performance. Đối chiếu trực tiếp với `spec.md` và `tech.md`. Delegates to `code-review-and-quality`.
 
@@ -298,7 +298,7 @@ Di chuyển integration đã hoàn thành hoặc không còn active từ `specs/
                 │
         /build ←──────────────┐
                 │              │
-        /review               │ (nếu Critical/Important)
+        /review-integration   │ (nếu Critical/Important)
                 │              │
            [approve] ──────────┘ (nếu Suggestion only)
                 │

package/templates/integrations/techdebt-template.md

@@ -2,7 +2,7 @@
 slug: "{slug}"
 created: {YYYY-MM-DD}
 referenced_by:
-  - skills/review/SKILL.md > Bước 2 — Luôn ghi findings vào techdebt.md
+  - skills/review-integration/SKILL.md > Bước 2 — Luôn ghi findings vào techdebt.md
 ---
 
 # Tech Debt — {title}

package/templates/main/sad-template.md

@@ -24,6 +24,14 @@ graph TD
     ...
 ```
 
+### Components
+
+Liệt kê các component của hệ thống — projection từ `prd.md > Components` với góc nhìn **architectural** (boundary, deployment unit, key tech concern). Vai trò business/role chi tiết xem `crd.md`, internal design xem `cdd.md`.
+
+| ID | Component | Boundary / Architectural notes |
+| --- | --- | --- |
+| C-XXX | {name} | {deployment unit, layer, key tech-level concern} |
+
 ## Tech Stack
 
 | Layer | Technology | Lý do chọn |