spec-lite 1.4.2 → 1.4.3

package/skills/spec-tech/SKILL.md

@@ -7,7 +7,7 @@ description: Tạo tech.md cho một integration dựa trên spec.md đã đư
 
 ## Overview
 
-Tạo `tech.md` cho một integration trong `specs/integrations/{slug}/`.
+Tạo `tech.md` cho một integration trong `.specs/integrations/{slug}/`.
 
 `tech.md` là technical design — định nghĩa **how to build**: solution approach, data model changes, interfaces. Phải có `spec.md` đã approve trước khi chạy skill này.
 
@@ -30,14 +30,14 @@ Tạo `tech.md` cho một integration trong `specs/integrations/{slug}/`.
 
 **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
+- 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`:
+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:
@@ -58,7 +58,7 @@ 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`.
+Đọc frontmatter của `.specs/integrations/{slug}/spec.md`.
 
 Nếu `status` **không phải** `approved`:
 
@@ -76,12 +76,12 @@ Nếu `status: approved` → tiếp tục sang Bước 2.
 
 Load các file sau:
 
-- `specs/integrations/{slug}/spec.md` — đọc toàn bộ + frontmatter (`features`, `components`)
-- `specs/main/sad.md` — đọc Tech Stack và Architectural Guardrails
-- `specs/main/domain.md` — đọc Glossary và Shared Entities
-- `specs/main/component/{C-XXX}-{slug}/cdd.md` — cho mỗi component trong frontmatter `components` (nếu cdd.md tồn tại)
-- `specs/main/feature/{F-XXX}-{slug}/frd.md` — cho mỗi feature trong frontmatter `features` (đọc `Verification Rules` để sinh `Verification Implementation` trong fdd.md)
-- `specs/main/feature/{F-XXX}-{slug}/fdd.md` — cho mỗi feature trong frontmatter `features` (nếu fdd.md tồn tại)
+- `.specs/integrations/{slug}/spec.md` — đọc toàn bộ + frontmatter (`features`, `components`)
+- `.specs/main/sad.md` — đọc Tech Stack và Architectural Guardrails
+- `.specs/main/domain.md` — đọc Glossary và Shared Entities
+- `.specs/main/component/{C-XXX}-{slug}/cdd.md` — cho mỗi component trong frontmatter `components` (nếu cdd.md tồn tại)
+- `.specs/main/feature/{F-XXX}-{slug}/frd.md` — cho mỗi feature trong frontmatter `features` (đọc `Verification Rules` để sinh `Verification Implementation` trong fdd.md)
+- `.specs/main/feature/{F-XXX}-{slug}/fdd.md` — cho mỗi feature trong frontmatter `features` (nếu fdd.md tồn tại)
 
 Tóm tắt context và surface assumptions:
 
@@ -168,11 +168,11 @@ Liệt kê **tất cả** components bị touched trong frontmatter và đánh g
 
 Với từng component có đề xuất:
 
-**Tạo mới** `specs/main/component/{C-XXX}-{component-slug}/cdd.md`
+**Tạo mới** `.specs/main/component/{C-XXX}-{component-slug}/cdd.md`
 - Dùng khi component này được giới thiệu lần đầu trong integration (cascade từ spec.md đã đề xuất tạo crd, giờ tech.md đề xuất tạo cdd)
 - Nội dung: Module Structure, Internal Data Flow, Storage & Persistence, Internal Interfaces, Technical Decisions
 
-**Cập nhật** `specs/main/component/{C-XXX}-{component-slug}/cdd.md`
+**Cập nhật** `.specs/main/component/{C-XXX}-{component-slug}/cdd.md`
 - Khi cdd.md đã tồn tại và integration thay đổi internal design
 
 ### feature/{F-XXX}-{feature-name}/fdd.md
@@ -184,12 +184,12 @@ Liệt kê **tất cả** features liên quan trong frontmatter và đánh giá:
 | F-001 — Checkout | tồn tại | **Cập nhật** — thêm sequence khi payment fail |
 | F-002 — Refund | chưa có | **Tạo mới** |
 
-**Tạo mới** `specs/main/feature/{F-XXX}-{feature-slug}/fdd.md`
+**Tạo mới** `.specs/main/feature/{F-XXX}-{feature-slug}/fdd.md`
 - Khi feature gắn với integration nhưng chưa có fdd.md
 - Nội dung: Inter-component data flow, Orchestration, Cross-component invariants, **Verification Implementation** — từ tech.md (chỉ phần inter-component, không lặp internal design của component)
 - **Verification Implementation**: với mỗi rule trong `frd.md > Verification Rules` của feature này, sinh row trong bảng `Rule ID | Rule (short) | Layer | Owning component | Error propagation`. Reference rule bằng `VR-F{NNN}-{seq}` ID (lấy nguyên từ FRD, không tạo ID mới). Rule (short) copy ngắn gọn từ FRD để row tự đọc được. Layer = client/gateway/service (có thể combine). Owning component reference C-XXX. KHÔNG đưa regex/validator code/error message wording vào — đó thuộc `cdd.md` của owning component (cascade riêng) hoặc UI copy artifact. Bỏ qua nếu FRD không có Verification Rules.
 
-**Cập nhật** `specs/main/feature/{F-XXX}-{feature-slug}/fdd.md`
+**Cập nhật** `.specs/main/feature/{F-XXX}-{feature-slug}/fdd.md`
 - Khi fdd.md đã tồn tại, ghi rõ thay đổi flow nào
 - Nếu integration thêm/đổi rule trong FRD → cập nhật bảng Verification Implementation tương ứng
 
@@ -216,7 +216,7 @@ Chỉ ghi file sau khi user confirm. Nếu user yêu cầu chỉnh sửa → c
 
 ### Bước 6: Save + Auto-cascade
 
-**[6.1] Ghi `specs/integrations/{slug}/tech.md`** với status `approved` (không phải `draft` — human đã confirm ở Bước 5 chính là approval). Frontmatter `features` và `components` mirror từ `spec.md`.
+**[6.1] Ghi `.specs/integrations/{slug}/tech.md`** với status `approved` (không phải `draft` — human đã confirm ở Bước 5 chính là approval). Frontmatter `features` và `components` mirror từ `spec.md`.
 
 **[6.2] Auto-apply mỗi Changes block** vào main artifact tương ứng. Thứ tự apply (để tránh forward reference): `sad.md` → `domain.md` → `component/*/cdd.md` → `feature/*/fdd.md`.
 
@@ -265,7 +265,7 @@ Cho mỗi artifact:
 **[6.4] Thông báo kết quả:**
 
 ```
-✓ specs/integrations/{slug}/tech.md đã được tạo (status: approved)
+✓ .specs/integrations/{slug}/tech.md đã được tạo (status: approved)
 
 Auto-cascade applied:
   ✓ sad.md — {summary | no-op}

package/skills/spec-test/SKILL.md

@@ -7,13 +7,13 @@ description: Tạo test.md cho một integration bằng cách mechanical derive
 
 ## Overview
 
-Tạo `test.md` cho một integration trong `specs/integrations/{slug}/`.
+Tạo `test.md` cho một integration trong `.specs/integrations/{slug}/`.
 
 `test.md` là verification design ở integration level — định nghĩa **how to verify** rằng integration đáp ứng `spec.md`. Nội dung gồm Test Strategy (per integration) + Changes blocks cascade lên feature `tsd.md` (Test Spec Document).
 
 **Hai artifact tách bạch:**
-- `specs/integrations/{slug}/test.md` — integration-level, ephemeral, PR record bất biến sau approve (single-word naming như `spec.md` / `tech.md` / `plan.md`).
-- `specs/main/feature/{F-XXX}-{slug}/tsd.md` — feature-level, persistent canonical artifact (3-letter naming như `frd.md` / `fdd.md`). TC content cuối cùng nằm ở đây.
+- `.specs/integrations/{slug}/test.md` — integration-level, ephemeral, PR record bất biến sau approve (single-word naming như `spec.md` / `tech.md` / `plan.md`).
+- `.specs/main/feature/{F-XXX}-{slug}/tsd.md` — feature-level, persistent canonical artifact (3-letter naming như `frd.md` / `fdd.md`). TC content cuối cùng nằm ở đây.
 
 **Role:** QC. Song song với `/spec-tech` (DEV role). Cả hai chỉ phụ thuộc `spec.md` approved — không có thứ tự bắt buộc giữa chúng.
 
@@ -38,14 +38,14 @@ Tạo `test.md` cho một integration trong `specs/integrations/{slug}/`.
 
 **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
+- 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ó `test.md`:
+Quét `.specs/integrations/`. Liệt kê **tất cả** integrations có `spec.md`, đánh dấu những cái đã có `test.md`:
 
 ```
 Integrations:
@@ -66,7 +66,7 @@ Nếu integration đã có `test.md` → hỏi trước khi tiếp tục:
 
 ### Bước 1b: Gate check
 
-Đọc frontmatter của `specs/integrations/{slug}/spec.md`.
+Đọc frontmatter của `.specs/integrations/{slug}/spec.md`.
 
 **Check 1 — spec.md phải approved:**
 
@@ -77,7 +77,7 @@ Nếu `status` **không phải** `approved`:
 > `/spec-test` cần spec.md approved vì cascade frd.md (nguồn của TC) chỉ apply sau khi approve.
 >
 > Để tiếp tục:
-> 1. Review `specs/integrations/{slug}/spec.md`
+> 1. Review `.specs/integrations/{slug}/spec.md`
 > 2. Approve (đổi `status: draft` → `status: approved`)
 >
 > Sau đó chạy lại `/spec-test`.
@@ -107,10 +107,10 @@ Nếu cả 2 check pass → tiếp tục Bước 2.
 
 Load các file sau:
 
-- `specs/integrations/{slug}/spec.md` — đọc toàn bộ + frontmatter (`features`)
-- `specs/main/feature/{F-XXX}-{slug}/frd.md` — cho mỗi feature trong frontmatter `features` (source của TC — bắt buộc tồn tại vì cascade từ spec.md đã apply)
-- `specs/main/feature/{F-XXX}-{slug}/tsd.md` — cho mỗi feature trong frontmatter `features` (nếu tồn tại — cần để diff và assign next ID)
-- `specs/integrations/{slug}/tech.md` — đọc nếu tồn tại (optional, dùng để hint environment / data set / NFR perf threshold)
+- `.specs/integrations/{slug}/spec.md` — đọc toàn bộ + frontmatter (`features`)
+- `.specs/main/feature/{F-XXX}-{slug}/frd.md` — cho mỗi feature trong frontmatter `features` (source của TC — bắt buộc tồn tại vì cascade từ spec.md đã apply)
+- `.specs/main/feature/{F-XXX}-{slug}/tsd.md` — cho mỗi feature trong frontmatter `features` (nếu tồn tại — cần để diff và assign next ID)
+- `.specs/integrations/{slug}/tech.md` — đọc nếu tồn tại (optional, dùng để hint environment / data set / NFR perf threshold)
 
 Tóm tắt context:
 
@@ -127,7 +127,7 @@ TÔI HIỂU:
 ```
 
 Nếu frd.md của feature nào không tồn tại → báo lỗi và dừng (lỗi cascade từ spec.md trước đó):
-> ⛔ `specs/main/feature/{F-XXX}-{slug}/frd.md` không tồn tại nhưng feature có trong `features:` của spec.md. Cascade từ spec.md có thể đã fail. Kiểm tra lại.
+> ⛔ `.specs/main/feature/{F-XXX}-{slug}/frd.md` không tồn tại nhưng feature có trong `features:` của spec.md. Cascade từ spec.md có thể đã fail. Kiểm tra lại.
 
 ---
 
@@ -284,14 +284,14 @@ Chỉ tiến hành Bước 6 sau khi QC confirm.
 
 ### Bước 6: Save + Auto-cascade
 
-**[6.1] Ghi `specs/integrations/{slug}/test.md`** với status `approved` (không phải `draft` — human đã confirm ở Bước 5 chính là approval). Frontmatter `features` mirror từ `spec.md`.
+**[6.1] Ghi `.specs/integrations/{slug}/test.md`** với status `approved` (không phải `draft` — human đã confirm ở Bước 5 chính là approval). Frontmatter `features` mirror từ `spec.md`.
 
 **[6.2] Auto-apply mỗi Changes block** vào `feature/{F-XXX}/tsd.md` tương ứng. Thứ tự apply: theo thứ tự xuất hiện trong frontmatter `features` (deterministic, không có forward reference giữa các feature tsd.md). Bỏ qua feature có operation `no-op` trong Cascade Summary.
 
 Cho từng block:
 
 - **Operation=create:**
-  - Tạo file `specs/main/feature/{F-XXX}-{slug}/tsd.md`
+  - Tạo file `.specs/main/feature/{F-XXX}-{slug}/tsd.md`
   - Nội dung = nội dung của Changes block (theo format `templates/main/feature/tsd-template.md`)
   - Frontmatter của tsd.md mới: status `draft` (separate lifecycle với integration test.md)
 
@@ -329,7 +329,7 @@ Format entry:
 **[6.4] Thông báo kết quả:**
 
 ```
-✓ specs/integrations/{slug}/test.md đã được tạo (status: approved)
+✓ .specs/integrations/{slug}/test.md đã được tạo (status: approved)
 
 Auto-cascade applied:
   ✓ feature/F-XXX-{slug}/tsd.md — {created | updated: +N TS, +M TC, modify K TC, remove L TC}

package/skills/spec-tsd/SKILL.md

@@ -7,7 +7,7 @@ description: Tạo tsd.md (Test Spec Document) trực tiếp tại feature level
 
 ## Overview
 
-Tạo `specs/main/feature/{F-XXX}-{slug}/tsd.md` trực tiếp từ frd.md của feature đó — **không qua integration**, không cascade.
+Tạo `.specs/main/feature/{F-XXX}-{slug}/tsd.md` trực tiếp từ frd.md của feature đó — **không qua integration**, không cascade.
 
 Skill này song hành với `/spec-prd` và `/spec-sad`: skill có acronym suffix (`prd`/`sad`/`tsd`) → tạo main artifact trực tiếp. Phân biệt với `/spec-test` — skill đó tạo `test.md` integration-level và cascade qua Changes blocks.
 
@@ -39,13 +39,13 @@ Quy tắc:
 
 **Nếu có ARGUMENT:**
 - Parse argument: có thể là feature ID (`F-001`, `001`) hoặc slug (`F-001-auth`, `auth`)
-- Quét `specs/main/feature/*/frd.md`, tìm feature khớp
+- Quét `.specs/main/feature/*/frd.md`, tìm feature khớp
 - Nếu không tìm thấy → báo lỗi:
-  > Không tìm thấy feature khớp với "{argument}". Kiểm tra `specs/main/feature/`.
+  > Không tìm thấy feature khớp với "{argument}". Kiểm tra `.specs/main/feature/`.
 
 **Nếu không có ARGUMENT:**
 
-Quét `specs/main/feature/`. Liệt kê **tất cả** features có `frd.md`, đánh dấu trạng thái tsd:
+Quét `.specs/main/feature/`. Liệt kê **tất cả** features có `frd.md`, đánh dấu trạng thái tsd:
 
 ```
 Features có frd.md:
@@ -66,12 +66,12 @@ Nếu không có feature nào có frd → thông báo:
 
 **Check 1 — frd.md tồn tại:**
 
-Nếu `specs/main/feature/{F-XXX}-{slug}/frd.md` không tồn tại → dừng:
+Nếu `.specs/main/feature/{F-XXX}-{slug}/frd.md` không tồn tại → dừng:
 > ⛔ `feature/{F-XXX}-{slug}/frd.md` không tồn tại. `/spec-tsd` cần frd làm input.
 
 **Check 2 — tsd.md đã tồn tại:**
 
-Nếu `specs/main/feature/{F-XXX}-{slug}/tsd.md` đã tồn tại:
+Nếu `.specs/main/feature/{F-XXX}-{slug}/tsd.md` đã tồn tại:
 
 > ⚠ `tsd.md` đã tồn tại cho feature **{F-XXX} — {slug}**.
 >
@@ -90,8 +90,8 @@ Nếu user chọn yes → backup tsd.md cũ thành `tsd.md.bak.{timestamp}` rồ
 
 Load các file sau:
 
-- `specs/main/feature/{F-XXX}-{slug}/frd.md` — **bắt buộc**, source của TC
-- `specs/main/feature/{F-XXX}-{slug}/fdd.md` — optional, đọc nếu tồn tại để hint Components Used (cho Dependencies section của tsd)
+- `.specs/main/feature/{F-XXX}-{slug}/frd.md` — **bắt buộc**, source của TC
+- `.specs/main/feature/{F-XXX}-{slug}/fdd.md` — optional, đọc nếu tồn tại để hint Components Used (cho Dependencies section của tsd)
 
 Tóm tắt context:
 
@@ -183,7 +183,7 @@ Hiển thị draft đầy đủ — chưa ghi file.
 
 ### Bước 6: Save
 
-Ghi `specs/main/feature/{F-XXX}-{slug}/tsd.md` với status `draft` (feature-level artifact có lifecycle riêng, không phải `approved` — QC còn fill placeholders nên status `draft` cho đến khi đầy đủ).
+Ghi `.specs/main/feature/{F-XXX}-{slug}/tsd.md` với status `draft` (feature-level artifact có lifecycle riêng, không phải `approved` — QC còn fill placeholders nên status `draft` cho đến khi đầy đủ).
 
 Nếu overwrite — file backup `tsd.md.bak.{timestamp}` đã tạo ở Bước 2.
 
@@ -200,7 +200,7 @@ Nếu overwrite tsd.md cũ → entry vẫn dùng operation `create` (vì IDs reg
 Thông báo kết quả:
 
 ```
-✓ specs/main/feature/{F-XXX}-{slug}/tsd.md đã được tạo (status: draft)
+✓ .specs/main/feature/{F-XXX}-{slug}/tsd.md đã được tạo (status: draft)
   Coverage: N Flows → N TS, M US/AC → M Functional TC, P VR → ~2P Validation TC, Q FAC → Q Feature AC TC
   {nếu overwrite: backup tại tsd.md.bak.{timestamp}}
 

package/skills-overview.md

@@ -8,13 +8,13 @@ Dùng khi bắt đầu dự án mới chưa có code. Mục tiêu: bootstrap `pr
 
 | Command | Reads | Writes |
 | --- | --- | --- |
-| `/spec-prd` | — *(tùy chọn: nguồn baseline path/@file/paste)* | `specs/main/prd.md`, `specs/main/domain.md` *(skeleton)* |
-| `/spec-sad` | `prd.md`, `domain.md` | `specs/main/sad.md` |
-| `/spec-frd [F-XXX]` *(tùy chọn)* | `prd.md`, `domain.md`, `sad.md`, `crd(s)` *(+ nguồn baseline)* | `specs/main/feature/{F-XXX}-*/frd.md` *(+ register feature row vào `prd.md` nếu feature mới)* |
+| `/spec-prd` | — *(tùy chọn: nguồn baseline path/@file/paste)* | `.specs/main/prd.md`, `.specs/main/domain.md` *(skeleton)* |
+| `/spec-sad` | `prd.md`, `domain.md` | `.specs/main/sad.md` |
+| `/spec-frd [F-XXX]` *(tùy chọn)* | `prd.md`, `domain.md`, `sad.md`, `crd(s)` *(+ nguồn baseline)* | `.specs/main/feature/{F-XXX}-*/frd.md` *(+ register feature row vào `prd.md` nếu feature mới)* |
 
 ### `/spec-prd`
 
-Tạo hoặc cập nhật `specs/main/prd.md` thông qua interview có cấu trúc. Ngoài ra **scaffold luôn `specs/main/domain.md` skeleton** (Glossary placeholder + Shared Entities rỗng) — domain mọc dần qua cascade từ integrations.
+Tạo hoặc cập nhật `.specs/main/prd.md` thông qua interview có cấu trúc. Ngoài ra **scaffold luôn `.specs/main/domain.md` skeleton** (Glossary placeholder + Shared Entities rỗng) — domain mọc dần qua cascade từ integrations.
 
 **Sections template** (7): Problem Statement · Target Users · Scope · Features · Components · Non-Functional Requirements · Business Constraints
 
@@ -33,7 +33,7 @@ Chọn `A` → interview tuần tự 7 sections template (sections thừa không
 
 ### `/spec-sad`
 
-Tạo hoặc cập nhật `specs/main/sad.md`. Yêu cầu `prd.md` và `domain.md` đã tồn tại (cả hai do `/spec-prd` scaffold).
+Tạo hoặc cập nhật `.specs/main/sad.md`. Yêu cầu `prd.md` và `domain.md` đã tồn tại (cả hai do `/spec-prd` scaffold).
 
 Trước khi interview, đọc `prd.md` (NFRs, constraints) và `domain.md` (glossary, shared entities) để surface assumptions và đề xuất options phù hợp khi user chưa quyết định.
 
@@ -51,7 +51,7 @@ Nếu `prd.md` chưa có → dừng, yêu cầu chạy `/spec-prd` trước.
 
 ### `/spec-frd [F-XXX]` *(tùy chọn)*
 
-BA author `specs/main/feature/{F-XXX}-*/frd.md` trực tiếp qua interview — **spec-first ở feature level**, chạy *trước* khi DEV bắt đầu integration. Cặp greenfield đối xứng với `/spec-brownfield-feature` (vốn reverse-engineer frd từ code).
+BA author `.specs/main/feature/{F-XXX}-*/frd.md` trực tiếp qua interview — **spec-first ở feature level**, chạy *trước* khi DEV bắt đầu integration. Cặp greenfield đối xứng với `/spec-brownfield-feature` (vốn reverse-engineer frd từ code).
 
 Nhận F-XXX từ argument (hoặc chọn từ prd Feature Index) + tùy chọn nguồn baseline (path/@file/paste như `/spec-prd`). Yêu cầu `prd.md` tồn tại.
 
@@ -253,17 +253,17 @@ Sau khi main artifacts đã sẵn sàng (từ greenfield hoặc brownfield), m
 
 | Command | Reads | Writes |
 | --- | --- | --- |
-| `/spec-new [requirement]` | `prd.md`, `domain.md`, frd(s), crd(s) | `specs/integrations/{slug}/spec.md` |
-| `/spec-tech [number]` | `sad.md`, `domain.md`, cdd(s), fdd(s), `spec.md` | `specs/integrations/{slug}/tech.md` |
-| `/spec-test [number]` | `spec.md`, frd(s), tsd(s), `tech.md` *(optional)* | `specs/integrations/{slug}/test.md`, `feature/{F-XXX}/tsd.md` |
+| `/spec-new [requirement]` | `prd.md`, `domain.md`, frd(s), crd(s) | `.specs/integrations/{slug}/spec.md` |
+| `/spec-tech [number]` | `sad.md`, `domain.md`, cdd(s), fdd(s), `spec.md` | `.specs/integrations/{slug}/tech.md` |
+| `/spec-test [number]` | `spec.md`, frd(s), tsd(s), `tech.md` *(optional)* | `.specs/integrations/{slug}/test.md`, `feature/{F-XXX}/tsd.md` |
 | `/plan` | `spec.md`, `tech.md`, `domain.md` | `plan.md`, `todo.md` |
 | `/build` | `plan.md`, `todo.md` | *(source code)* |
 | `/review-integration` | `spec.md`, `tech.md`, `plan.md`, `todo.md`, *(source code)* | *(findings report)* |
-| `/archive` | `specs/integrations/` | `specs/archive/` |
+| `/archive` | `.specs/integrations/` | `.specs/archive/` |
 
 ### `/spec-new [requirement]`
 
-Tạo `specs/integrations/{slug}/spec.md` cho một integration mới. Chạy bởi BA.
+Tạo `.specs/integrations/{slug}/spec.md` cho một integration mới. Chạy bởi BA.
 
 **Nếu không có argument** → đọc `prd.md`, hiển thị danh sách features có `Status = TODO`, user chọn số.
 
@@ -283,9 +283,9 @@ Sau khi confirm → ghi `spec.md`, cập nhật `prd.md`: Status `TODO → In Pr
 
 ### `/spec-tech [number]`
 
-Tạo `specs/integrations/{slug}/tech.md` cho một integration. Chạy bởi DEV sau khi `spec.md` đã được approve.
+Tạo `.specs/integrations/{slug}/tech.md` cho một integration. Chạy bởi DEV sau khi `spec.md` đã được approve.
 
-**Luôn hiển thị danh sách tất cả integrations** trong `specs/integrations/`, đánh dấu `✓` những cái đã có `tech.md`. Nếu có argument → argument là số thứ tự (`1`, `001`...), chọn luôn không cần hiển thị.
+**Luôn hiển thị danh sách tất cả integrations** trong `.specs/integrations/`, đánh dấu `✓` những cái đã có `tech.md`. Nếu có argument → argument là số thứ tự (`1`, `001`...), chọn luôn không cần hiển thị.
 
 Nếu integration đã có `tech.md` → hỏi confirm trước khi ghi đè.
 
@@ -299,9 +299,9 @@ Context load: `spec.md` + `sad.md` + `domain.md` + `cdd.md` (cho mỗi component
 
 ### `/spec-test [number]`
 
-Tạo `specs/integrations/{slug}/test.md` cho một integration. Chạy bởi **QC** sau khi `spec.md` đã được approve. **Song song / độc lập** với `/spec-tech` — cả hai chỉ phụ thuộc `spec.md`. Không có thứ tự bắt buộc giữa chúng.
+Tạo `.specs/integrations/{slug}/test.md` cho một integration. Chạy bởi **QC** sau khi `spec.md` đã được approve. **Song song / độc lập** với `/spec-tech` — cả hai chỉ phụ thuộc `spec.md`. Không có thứ tự bắt buộc giữa chúng.
 
-**Luôn hiển thị danh sách tất cả integrations** trong `specs/integrations/`, đánh dấu `✓` những cái đã có `test.md`. Nếu có argument → chọn luôn không cần hiển thị.
+**Luôn hiển thị danh sách tất cả integrations** trong `.specs/integrations/`, đánh dấu `✓` những cái đã có `test.md`. Nếu có argument → chọn luôn không cần hiển thị.
 
 **Gate check:** spec.md phải `approved` + `features:` non-empty. Integration có `features: []` (thuần component) → dừng vì component-level `tsd` không tồn tại trong kit này.
 
@@ -326,7 +326,7 @@ QC review: override priority defaults, fill placeholders (env / data / OOS / str
 Tạo `plan.md` và `todo.md` từ `spec.md` + `tech.md`. Là SDD wrapper quanh `planning-and-task-breakdown`.
 
 **Bước 1: Xác định integration**
-Quét `specs/integrations/`, hiển thị danh sách với trạng thái `spec✓/—`, `tech✓/—`, `plan✓/—`. Nếu có argument → chọn luôn. Nếu `plan.md`/`todo.md` đã tồn tại → hỏi trước khi ghi đè.
+Quét `.specs/integrations/`, hiển thị danh sách với trạng thái `spec✓/—`, `tech✓/—`, `plan✓/—`. Nếu có argument → chọn luôn. Nếu `plan.md`/`todo.md` đã tồn tại → hỏi trước khi ghi đè.
 
 **Bước 2: Load và surface context**
 Đọc `spec.md`, `tech.md`, `domain.md`. Surface tóm tắt (features, components, AC IDs, thay đổi kỹ thuật, shared entities) và assumptions để user confirm. Plan mode từ đây — chỉ đọc, không viết code.
@@ -379,17 +379,17 @@ 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.
+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 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 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 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/`.
+**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/`.
 
 ---
 
@@ -432,7 +432,7 @@ Khác với `/review-integration` (chạy sau `/build` cho một integration c
 
 | Command | Reads | Writes |
 | --- | --- | --- |
-| `/review-everything` | `prd.md`, `domain.md`, `sad.md`, *(source code)* | `specs/integrations/{NNN}-{slug}/review-findings.md` *(qua /spec-new)* |
+| `/review-everything` | `prd.md`, `domain.md`, `sad.md`, *(source code)* | `.specs/integrations/{NNN}-{slug}/review-findings.md` *(qua /spec-new)* |
 
 ### `/review-everything`
 
@@ -450,7 +450,7 @@ Review codebase ở project level theo năm trục của `code-review-and-qualit
 
 Nếu user chọn fix → gom selected findings thành raw requirement, invoke `/spec-new` với ARGUMENT đó. Integration được tạo và xử lý như integration thường (`/spec-tech` → `/plan` → `/build`).
 
-`review-findings.md` (full snapshot, gồm cả deferred) được ghi vào `specs/integrations/{NNN}-{slug}/` để traceability.
+`review-findings.md` (full snapshot, gồm cả deferred) được ghi vào `.specs/integrations/{NNN}-{slug}/` để traceability.
 
 **Khi dùng:**
 
@@ -571,7 +571,7 @@ Tạo hoặc cập nhật `.claude/ado.yaml` — file config ADO dùng chung cho
 
 **Bước 1 — Current user:** Đọc `git config user.email`, tìm trong `team.*` của `ado.yaml`. Nếu không khớp → hỏi user chọn. Resolve email → ADO identity ID để dùng làm assignee.
 
-**Bước 2 — Chọn integration:** List tất cả `specs/integrations/` kèm title và status từ frontmatter `spec.md`.
+**Bước 2 — Chọn integration:** List tất cả `.specs/integrations/` kèm title và status từ frontmatter `spec.md`.
 
 **Bước 3 — Parse spec.md:** Extract Features (`### Feature: <name> (<ID>)`) và User Stories (`#### US-FXXX-YYY — <title>`). Detect ticket đã tồn tại qua dòng `**ADO:**` ngay sau heading — đánh dấu `already_created`, bỏ qua khi tạo.
 
@@ -599,7 +599,7 @@ Cập nhật state đồng loạt cho User Story (và tuỳ chọn Feature) tick
 
 **Bước 1 — Load config:** Đọc `ado.yaml`. Dừng nếu thiếu file hoặc `environments` rỗng.
 
-**Bước 2 — Chọn integration:** List `specs/integrations/` kèm title và status.
+**Bước 2 — Chọn integration:** List `.specs/integrations/` kèm title và status.
 
 **Bước 3 — Parse & validate:** Extract tất cả Feature và User Story tickets từ dòng `**ADO:**` trong `spec.md`. Nếu bất kỳ ticket nào chưa có → dừng, báo danh sách thiếu, yêu cầu chạy `/ado-create` trước.
 

package/templates/main/domain-template.md

@@ -14,7 +14,7 @@ referenced_by:
 
 > File này mỏng — chỉ chứa **shared vocabulary** và **shared entities** (entities được dùng bởi 2+ component).
 >
-> Business rules, domain events, internal entities thuộc về component sở hữu — xem `specs/main/component/{C-XXX}-{component-name}/crd.md`.
+> Business rules, domain events, internal entities thuộc về component sở hữu — xem `.specs/main/component/{C-XXX}-{component-name}/crd.md`.
 
 ## Glossary
 

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

@@ -149,7 +149,7 @@ Sub-rule phức tạp (vd: password complexity với nhiều điều kiện) →
 
 ### Components Used
 
-Tham chiếu đến `specs/main/component/{C-XXX}-...`.
+Tham chiếu đến `.specs/main/component/{C-XXX}-...`.
 
 | Component | Vai trò trong feature |
 | --- | --- |

package/templates/main/prd-template.md

@@ -56,7 +56,7 @@ Section này **chỉ liệt kê component có boundary _Given_** — tức bound
 - `/spec-sad` — architect lock component boundaries dựa trên full feature index + NFRs
 - `/spec-new F-XXX` cascade — khi analyze 1 feature, discover component mới nếu cần và register vào đây qua Change History
 
-Chi tiết về vai trò và thiết kế nằm trong `specs/main/component/{C-XXX}-{component-name}/`.
+Chi tiết về vai trò và thiết kế nằm trong `.specs/main/component/{C-XXX}-{component-name}/`.
 
 | ID | Component | Mô tả ngắn | Status |
 | --- | --- | --- | --- |