spec-lite 1.4.2 → 1.4.3

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

@@ -7,7 +7,7 @@ description: Discover features từ code, generate frd.md + fdd.md cho từng fe
 
 ## Overview
 
-Tạo `specs/main/feature/{F-XXX}-{feature-name}/frd.md` và `fdd.md` cho các features trong brownfield project.
+Tạo `.specs/main/feature/{F-XXX}-{feature-name}/frd.md` và `fdd.md` cho các features trong brownfield project.
 
 Skill này **tự discover** features từ routes, use cases, và test files, sau đó scan sâu để extract user stories, AC, và inter-component flows. Khi hoàn thành, **điền Feature Index vào prd.md**.
 
@@ -33,9 +33,9 @@ Skill này **tự discover** features từ routes, use cases, và test files, sa
 **Path:** Nếu có ARGUMENT là path → dùng làm root. Nếu không → CWD.
 
 **Load:**
-- `specs/main/prd.md` — kiểm tra Component Index đã được điền
-- `specs/main/domain.md` — đọc Glossary và Shared Entities
-- `specs/main/component/*/crd.md` — đọc Public Interface của từng component (để cross-reference trong fdd.md)
+- `.specs/main/prd.md` — kiểm tra Component Index đã được điền
+- `.specs/main/domain.md` — đọc Glossary và Shared Entities
+- `.specs/main/component/*/crd.md` — đọc Public Interface của từng component (để cross-reference trong fdd.md)
 
 **Kiểm tra preconditions:**
 
@@ -46,7 +46,7 @@ Nếu `prd.md` Component Index còn trống (không có C-XXX entries) → dừn
 > Component Index chưa có entries. Hãy chạy `/spec-brownfield-component` trước.
 > fdd.md cần tham chiếu C-XXX để mô tả inter-component flows.
 
-Nếu `specs/main/component/` không có crd.md nào → cảnh báo tương tự và dừng.
+Nếu `.specs/main/component/` không có crd.md nào → cảnh báo tương tự và dừng.
 
 **Attachments:**
 > Bạn có tài liệu bổ sung nào không? (user stories, test plans, wireframes, existing specs)
@@ -216,10 +216,10 @@ Với mỗi feature, generate 2 files dùng templates tương ứng:
 
 ```
 Sẽ tạo {N} features ({2N} files):
-  ✓ specs/main/feature/F-001-user-registration/frd.md  (4 NEEDS_CLARIFY)
-  ✓ specs/main/feature/F-001-user-registration/fdd.md  (2 NEEDS_CLARIFY)
-  ✓ specs/main/feature/F-002-authentication/frd.md     (1 NEEDS_CLARIFY)
-  ✓ specs/main/feature/F-002-authentication/fdd.md     (0 NEEDS_CLARIFY)
+  ✓ .specs/main/feature/F-001-user-registration/frd.md  (4 NEEDS_CLARIFY)
+  ✓ .specs/main/feature/F-001-user-registration/fdd.md  (2 NEEDS_CLARIFY)
+  ✓ .specs/main/feature/F-002-authentication/frd.md     (1 NEEDS_CLARIFY)
+  ✓ .specs/main/feature/F-002-authentication/fdd.md     (0 NEEDS_CLARIFY)
   ...
 
 Ghi tất cả? [y] hoặc review từng file trước [r]:
@@ -237,7 +237,7 @@ Ghi tất cả? [y] hoặc review từng file trước [r]:
 
 ### Bước 8: Điền Feature Index vào prd.md
 
-Sau khi artifacts đã được ghi, update `specs/main/prd.md` Feature Index:
+Sau khi artifacts đã được ghi, update `.specs/main/prd.md` Feature Index:
 
 ```
 Sẽ điền Feature Index vào prd.md:
@@ -267,8 +267,8 @@ Khi apply → đồng thời append entry vào `## Change History` của prd.md
 
 ```
 ✓ Generated {N} features:
-  specs/main/feature/F-001-user-registration/  (frd.md + fdd.md)
-  specs/main/feature/F-002-authentication/     (frd.md + fdd.md)
+  .specs/main/feature/F-001-user-registration/  (frd.md + fdd.md)
+  .specs/main/feature/F-002-authentication/     (frd.md + fdd.md)
   ...
 
 ✓ prd.md Feature Index: {N} entries đã được điền
@@ -279,7 +279,7 @@ NEEDS_CLARIFY summary — {total} items:
   ...
 
 Brownfield init hoàn tất! Main artifacts:
-  specs/main/
+  .specs/main/
   ├── prd.md           (Component Index: {N} | Feature Index: {N})
   ├── domain.md        (Glossary: {N} terms | Shared Entities: {N})
   ├── sad.md

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

@@ -7,7 +7,7 @@ description: Khởi tạo main artifacts (prd.md, domain.md, sad.md) cho brownfi
 
 ## Overview
 
-Tạo `specs/main/prd.md`, `specs/main/domain.md`, và `specs/main/sad.md` cho một project đã tồn tại.
+Tạo `.specs/main/prd.md`, `.specs/main/domain.md`, và `.specs/main/sad.md` cho một project đã tồn tại.
 
 Skill này chỉ tập trung vào **product và architecture level** — những gì có thể extract từ README, docs, config, và kiến trúc tổng thể. Component Index và Feature Index trong prd.md sẽ **để trống** — chúng sẽ được điền bởi `/spec-brownfield-component` và `/spec-brownfield-feature` sau khi scan code chuyên sâu.
 
@@ -17,9 +17,9 @@ Mỗi file output được sinh ra từ template tương ứng — đọc templa
 
 | Output file | Template |
 | --- | --- |
-| `specs/main/prd.md` | `templates/main/prd-template.md` |
-| `specs/main/domain.md` | `templates/main/domain-template.md` |
-| `specs/main/sad.md` | `templates/main/sad-template.md` |
+| `.specs/main/prd.md` | `templates/main/prd-template.md` |
+| `.specs/main/domain.md` | `templates/main/domain-template.md` |
+| `.specs/main/sad.md` | `templates/main/sad-template.md` |
 
 Giữ nguyên cấu trúc section và frontmatter từ template. Điền nội dung thu thập được từ scan và interview vào đúng vị trí.
 
@@ -32,7 +32,7 @@ Thông tin không thể detect từ code được đánh dấu nhất quán:
 ## When to Use
 
 - Onboarding một brownfield project vào SDD workflow
-- `specs/main/prd.md` chưa có hoặc còn trống
+- `.specs/main/prd.md` chưa có hoặc còn trống
 
 ## When NOT to Use
 
@@ -63,14 +63,14 @@ Load tất cả attachments trước khi scan. Dùng làm context bổ sung tron
 
 ### Bước 2: Kiểm tra existing specs
 
-Kiểm tra `specs/main/prd.md`, `specs/main/domain.md`, `specs/main/sad.md`:
+Kiểm tra `.specs/main/prd.md`, `.specs/main/domain.md`, `.specs/main/sad.md`:
 
 Nếu một trong ba đã có nội dung thực → cảnh báo:
 
 ```
 ⚠ File đã có nội dung:
-  - specs/main/prd.md
-  - specs/main/sad.md
+  - .specs/main/prd.md
+  - .specs/main/sad.md
 
 Skill này sẽ overwrite các file trên. Tiếp tục? [y/n]
 ```
@@ -253,7 +253,7 @@ Hiển thị draft từng file lần lượt. Với mỗi file:
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-DRAFT: specs/main/{file}
+DRAFT: .specs/main/{file}
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 {nội dung draft}
 
@@ -270,7 +270,7 @@ Confirm? [y] Bỏ qua [n] Chỉnh sửa [e]:
 
 ### Bước 9: Save
 
-Tạo `specs/main/` nếu chưa có. Ghi các files đã được confirm.
+Tạo `.specs/main/` nếu chưa có. Ghi các files đã được confirm.
 
 **Change History:** Append entry vào section `## Change History` cuối mỗi file vừa ghi (`prd.md`, `domain.md`, `sad.md`) theo `conventions.md` §5.5:
 
@@ -281,9 +281,9 @@ Tạo `specs/main/` nếu chưa có. Ghi các files đã được confirm.
 ```
 
 ```
-✓ specs/main/prd.md        (Component Index và Feature Index: placeholder — chưa có)
-✓ specs/main/domain.md     (Glossary: {n} terms | Shared Entities: trống — sẽ mọc qua cascade)
-✓ specs/main/sad.md
+✓ .specs/main/prd.md        (Component Index và Feature Index: placeholder — chưa có)
+✓ .specs/main/domain.md     (Glossary: {n} terms | Shared Entities: trống — sẽ mọc qua cascade)
+✓ .specs/main/sad.md
 
 NEEDS_CLARIFY summary — {total} items cần làm rõ:
   prd.md:    {n} — [Problem Statement, Business Constraints, ...]

package/skills/spec-frd/SKILL.md

@@ -7,7 +7,7 @@ description: Author MỚI frd.md (Feature Requirements Document) trực tiếp
 
 ## Overview
 
-Author `specs/main/feature/{F-XXX}-{feature-slug}/frd.md` trực tiếp qua interview — **spec-first ở feature level**, do **BA** chạy trước khi bất kỳ integration nào bắt đầu.
+Author `.specs/main/feature/{F-XXX}-{feature-slug}/frd.md` trực tiếp qua interview — **spec-first ở feature level**, do **BA** chạy trước khi bất kỳ integration nào bắt đầu.
 
 `frd.md` là **what to build** của một feature: Overview, User Flows, Feature AC, User Stories, Verification Rules, Scope, Dependencies. Đây là baseline ổn định, **author một lần** — mọi thay đổi sau đó đi qua `/spec-new` (delta cascade).
 
@@ -59,7 +59,7 @@ Có nguồn → trích baseline cho từng section frd (overview, flows, stories
 
 ### Bước 1: Xác định feature
 
-**Precondition:** đọc `specs/main/prd.md`. Nếu không tồn tại / template rỗng → dừng:
+**Precondition:** đọc `.specs/main/prd.md`. Nếu không tồn tại / template rỗng → dừng:
 > `prd.md` chưa có nội dung. Hãy chạy `/spec-prd` trước.
 
 `/spec-frd` là skill **CREATE-only, đúng một feature mỗi lần chạy**. Xác định feature mục tiêu qua ba gate — phải pass cả ba mới vào interview.
@@ -103,7 +103,7 @@ Chọn feature để author frd:
 
 #### 1c. Create-only gate — frd.md CHƯA tồn tại
 
-Kiểm tra `specs/main/feature/{F-XXX}-*/frd.md`.
+Kiểm tra `.specs/main/feature/{F-XXX}-*/frd.md`.
 
 - **Chưa tồn tại** → tiếp Bước 2 (author mới).
 - **Đã tồn tại** → **DỪNG**, redirect `/spec-new`:
@@ -117,10 +117,10 @@ Kiểm tra `specs/main/feature/{F-XXX}-*/frd.md`.
 ### Bước 2: Load context
 
 Load:
-- `specs/main/prd.md` — Problem Statement, Target Users (personas), Scope, **row của feature này** trong Feature Index (tên, mô tả, priority), Component Index, **cột ADO** (nếu feature có ticket → lưu lại để spec.md sau này không tạo duplicate).
-- `specs/main/domain.md` — Glossary + Shared Entities liên quan.
-- `specs/main/sad.md` — bảng Components (góc nhìn kiến trúc, để biết C-XXX nào đã có boundary).
-- `specs/main/component/{C-XXX}-*/crd.md` — Public Interface của các component khả năng feature sẽ dùng (nếu đã tồn tại).
+- `.specs/main/prd.md` — Problem Statement, Target Users (personas), Scope, **row của feature này** trong Feature Index (tên, mô tả, priority), Component Index, **cột ADO** (nếu feature có ticket → lưu lại để spec.md sau này không tạo duplicate).
+- `.specs/main/domain.md` — Glossary + Shared Entities liên quan.
+- `.specs/main/sad.md` — bảng Components (góc nhìn kiến trúc, để biết C-XXX nào đã có boundary).
+- `.specs/main/component/{C-XXX}-*/crd.md` — Public Interface của các component khả năng feature sẽ dùng (nếu đã tồn tại).
 
 Tóm tắt context + surface assumptions:
 
@@ -222,7 +222,7 @@ Chỉ ghi file sau khi user confirm. Yêu cầu chỉnh → cập nhật draft
 
 ### Bước 7: Save
 
-**7a. Ghi `specs/main/feature/{F-XXX}-{slug}/frd.md`** — tạo thư mục nếu chưa có. Status `draft` (lifecycle riêng của artifact).
+**7a. Ghi `.specs/main/feature/{F-XXX}-{slug}/frd.md`** — tạo thư mục nếu chưa có. Status `draft` (lifecycle riêng của artifact).
 
 Slug feature lấy từ tên trong prd Feature Index, kebab-case (ví dụ F-001 "Authentication" → `F-001-authentication`).
 
@@ -258,7 +258,7 @@ Và append Change History entry vào prd.md (theo `conventions.md` §5.5):
 **7d. Thông báo kết quả:**
 
 ```
-✓ specs/main/feature/{F-XXX}-{slug}/frd.md đã được tạo (status: draft)
+✓ .specs/main/feature/{F-XXX}-{slug}/frd.md đã được tạo (status: draft)
 
 {nếu có} Component candidate cần carve (chuyển cho architect / integration):
   - {tên đề xuất} — {vai trò}

package/skills/spec-frd-update/SKILL.md

@@ -7,7 +7,7 @@ description: Migrate frd.md hiện có lên cấu trúc template mới nhất
 
 ## Overview
 
-Migrate các file `specs/main/feature/{F-XXX}-{slug}/frd.md` hiện có sang **format mới nhất** của [templates/main/feature/frd-template.md](../../templates/main/feature/frd-template.md).
+Migrate các file `.specs/main/feature/{F-XXX}-{slug}/frd.md` hiện có sang **format mới nhất** của [templates/main/feature/frd-template.md](../../templates/main/feature/frd-template.md).
 
 Skill này **chỉ làm migration mechanical + propose** — không phải BA interview. Mọi quyết định nội dung mới (Verification Rules content) đều cần user approve trước khi ghi.
 
@@ -67,7 +67,7 @@ Chạy `git status --porcelain`. Nếu output không rỗng (có file modified /
 Hãy commit hoặc stash thay đổi hiện tại trước khi chạy `/spec-frd-update`, rồi chạy lại.
 
 Files dirty:
-  M specs/main/feature/F-001-auth/frd.md
+  M .specs/main/feature/F-001-auth/frd.md
   ?? notes.md
 ```
 
@@ -80,7 +80,7 @@ Nếu repo không phải git repo → cảnh báo và yêu cầu confirm:
 
 ### Bước 1: Discover & classify
 
-Quét `specs/main/feature/*/frd.md`. Với mỗi file:
+Quét `.specs/main/feature/*/frd.md`. Với mỗi file:
 
 1. Parse headings và frontmatter.
 2. Run detection cho V1–V8.
@@ -123,11 +123,11 @@ Với mỗi FRD đã chọn, load các file sau (chỉ những gì cần thiết
 
 | File | Bắt buộc | Mục đích |
 |---|---|---|
-| `specs/main/feature/{F-XXX}-{slug}/frd.md` | ✓ | File cần migrate |
+| `.specs/main/feature/{F-XXX}-{slug}/frd.md` | ✓ | File cần migrate |
 | [templates/main/feature/frd-template.md](../../templates/main/feature/frd-template.md) | ✓ | Target structure — copy text cho V2/V3/V5 |
-| `specs/main/feature/{F-XXX}-{slug}/fdd.md` | nếu tồn tại | Cascade target cho V4 (AC→FAC rename) |
-| `specs/main/feature/{F-XXX}-{slug}/tsd.md` | nếu tồn tại | Cascade target cho V4 |
-| `specs/main/domain.md` (Shared Entities block) | optional | Cho V6 — match field name với entity glossary để pick semantic type consistent |
+| `.specs/main/feature/{F-XXX}-{slug}/fdd.md` | nếu tồn tại | Cascade target cho V4 (AC→FAC rename) |
+| `.specs/main/feature/{F-XXX}-{slug}/tsd.md` | nếu tồn tại | Cascade target cho V4 |
+| `.specs/main/domain.md` (Shared Entities block) | optional | Cho V6 — match field name với entity glossary để pick semantic type consistent |
 
 **KHÔNG load:**
 - `conventions.md` — template đã self-contained, load là thừa
@@ -183,7 +183,7 @@ Với mỗi FRD đã chọn, load các file sau (chỉ những gì cần thiết
   ```
 
 #### 4.3 Scan cascade references
-- Grep toàn `specs/` cho từng ID cũ.
+- Grep toàn `.specs/` cho từng ID cũ.
 - **CRITICAL**: chỉ remap những match THUỘC Feature AC (Bước 4.1 list). KHÔNG đụng Story AC trùng namespace `AC-F{NNN}-{seq}` — đây là string overlap nhưng khác counter.
 - Tạo bảng impact:
   ```
@@ -358,7 +358,7 @@ Cho mỗi FRD đã migrate:
 
 Nếu artifact chưa có section `## Change History` (vì template cũ) → tạo section mới ở cuối file rồi append entry. Đây cũng là một migration vector ngầm — đảm bảo mọi main artifact sau migration đều có Change History section.
 
-Rollback (nếu user phát hiện sai sau khi skill xong): `git checkout -- specs/main/feature/{F-XXX}-{slug}/` để revert toàn bộ feature dir, hoặc `git restore -p` để revert per-hunk.
+Rollback (nếu user phát hiện sai sau khi skill xong): `git checkout -- .specs/main/feature/{F-XXX}-{slug}/` để revert toàn bộ feature dir, hoặc `git restore -p` để revert per-hunk.
 
 Append vào [changelogs.md](../../changelogs.md) `## [Unreleased]`:
 

package/skills/spec-new/SKILL.md

@@ -7,7 +7,7 @@ description: Tạo spec.md cho một integration mới thông qua interview có
 
 ## Overview
 
-Tạo `spec.md` cho một integration mới trong `specs/integrations/{NNN}-{slug}/`.
+Tạo `spec.md` cho một integration mới trong `.specs/integrations/{NNN}-{slug}/`.
 
 `spec.md` là functional spec — định nghĩa **what to build**: vấn đề, requirements, acceptance criteria, out of scope. Không chứa technical design.
 
@@ -33,7 +33,7 @@ Tạo `spec.md` cho một integration mới trong `specs/integrations/{NNN}-{slu
 
 **Nếu không có ARGUMENT:**
 
-Đọc `specs/main/prd.md`. Nếu file không tồn tại hoặc là template rỗng → dừng:
+Đọc `.specs/main/prd.md`. Nếu file không tồn tại hoặc là template rỗng → dừng:
 > `prd.md` chưa có nội dung. Hãy chạy `/spec-prd` trước.
 
 Đọc toàn bộ bảng Features. Hiển thị **tất cả** features kèm trạng thái — không lọc — để thấy rõ feature nào có FRD cần update:
@@ -50,7 +50,7 @@ Features trong PRD:
 Chọn số feature để bắt đầu spec:
 ```
 
-Ghi chú `→ frd.md tồn tại` nếu file `specs/main/feature/{F-XXX}-*/frd.md` đã có.
+Ghi chú `→ frd.md tồn tại` nếu file `.specs/main/feature/{F-XXX}-*/frd.md` đã có.
 
 Nếu tất cả features đều Done → thông báo:
 > Tất cả features trong prd.md đã được implement. Nếu có yêu cầu mới, hãy truyền nó trực tiếp: `/spec-new <yêu cầu>`.
@@ -88,10 +88,10 @@ Lưu lại lựa chọn section.
 
 Từ raw requirement, agent xác định features và components liên quan, rồi load các file sau:
 
-- `specs/main/prd.md` — đọc Problem Statement, Target Users, Scope, Feature Index, Component Index; **đặc biệt ghi nhận cột `ADO` trong bảng Features** — nếu feature đã có ticket ID thì lưu lại `{feature_id → ado_ticket_id, ado_ticket_title, ado_ticket_url}`
-- `specs/main/domain.md` — đọc Glossary và Shared Entities
-- `specs/main/feature/{F-XXX}-{slug}/frd.md` — cho mỗi feature liên quan (nếu file đã tồn tại)
-- `specs/main/component/{C-XXX}-{slug}/crd.md` — cho mỗi component bị touched (nếu file đã tồn tại)
+- `.specs/main/prd.md` — đọc Problem Statement, Target Users, Scope, Feature Index, Component Index; **đặc biệt ghi nhận cột `ADO` trong bảng Features** — nếu feature đã có ticket ID thì lưu lại `{feature_id → ado_ticket_id, ado_ticket_title, ado_ticket_url}`
+- `.specs/main/domain.md` — đọc Glossary và Shared Entities
+- `.specs/main/feature/{F-XXX}-{slug}/frd.md` — cho mỗi feature liên quan (nếu file đã tồn tại)
+- `.specs/main/component/{C-XXX}-{slug}/crd.md` — cho mỗi component bị touched (nếu file đã tồn tại)
 
 Tóm tắt context và surface assumptions:
 
@@ -150,11 +150,11 @@ Từ title của integration, sinh slug:
 - Nếu từ prd.md: dùng `{feature-id}-{feature-slug}`, ví dụ: `f001-authentication`
 
 Xác định số thứ tự (`NNN`):
-- Liệt kê các thư mục hiện có trong `specs/integrations/` theo pattern `{NNN}-*`
+- Liệt kê các thư mục hiện có trong `.specs/integrations/` theo pattern `{NNN}-*`
 - Lấy số lớn nhất hiện có và cộng thêm 1, format 3 chữ số (ví dụ: `001`, `002`, `012`)
 - Nếu chưa có thư mục nào → bắt đầu từ `001`
 
-Output path: `specs/integrations/{NNN}-{slug}/spec.md`
+Output path: `.specs/integrations/{NNN}-{slug}/spec.md`
 
 ---
 
@@ -339,7 +339,7 @@ Chỉ tiến hành Bước 7 sau khi user confirm. Nếu user yêu cầu chỉnh
 
 ### Bước 7: Save + Auto-cascade
 
-Tạo thư mục `specs/integrations/{NNN}-{slug}/` nếu chưa có.
+Tạo thư mục `.specs/integrations/{NNN}-{slug}/` nếu chưa có.
 
 **[7.1] Ghi spec.md** với status `approved` (không phải `draft` — human đã confirm ở Bước 6 chính là approval). Frontmatter `features` và `components` phải được điền theo những gì đã nhận diện ở Bước 2.
 
@@ -391,7 +391,7 @@ Cho mỗi artifact:
 **[7.4] Thông báo kết quả:**
 
 ```
-✓ specs/integrations/{NNN}-{slug}/spec.md đã được tạo (status: approved)
+✓ .specs/integrations/{NNN}-{slug}/spec.md đã được tạo (status: approved)
 
 Auto-cascade applied:
   ✓ prd.md — {summary}

package/skills/spec-prd/SKILL.md

@@ -7,15 +7,15 @@ description: Điền hoặc cập nhật prd.md — Product Requirements Documen
 
 ## Overview
 
-Tạo nội dung cho `specs/main/prd.md` thông qua interview có cấu trúc. PRD là nguồn sự thật ở product level — nó định nghĩa vấn đề, users, scope, features, components, và NFRs trước khi bất kỳ technical decision nào được đưa ra.
+Tạo nội dung cho `.specs/main/prd.md` thông qua interview có cấu trúc. PRD là nguồn sự thật ở product level — nó định nghĩa vấn đề, users, scope, features, components, và NFRs trước khi bất kỳ technical decision nào được đưa ra.
 
-Skill này cũng scaffold `specs/main/domain.md` skeleton nếu chưa tồn tại — domain.md sẽ được mọc dần qua cascade từ integrations (glossary terms, shared entities).
+Skill này cũng scaffold `.specs/main/domain.md` skeleton nếu chưa tồn tại — domain.md sẽ được mọc dần qua cascade từ integrations (glossary terms, shared entities).
 
 PRD không chứa: tech stack, implementation details, entity schema, glossary, business rules — những thứ đó thuộc về `sad.md` hoặc `domain.md`.
 
 ## When to Use
 
-- `specs/main/prd.md` chưa có nội dung hoặc vẫn còn là template
+- `.specs/main/prd.md` chưa có nội dung hoặc vẫn còn là template
 - Cần bổ sung hoặc cập nhật một phần của PRD hiện tại
 - Requirements thay đổi và PRD cần được đồng bộ lại
 
@@ -118,9 +118,9 @@ Nếu không có nguồn → bỏ qua, interview từ đầu như bình thườn
 
 ### Bước 1: Kiểm tra preconditions
 
-Đọc `specs/main/prd.md`:
+Đọc `.specs/main/prd.md`:
 
-- **File không tồn tại** → tạo thư mục `specs/main/` (nếu chưa có) rồi tiến hành Bước 2 (full interview).
+- **File không tồn tại** → tạo thư mục `.specs/main/` (nếu chưa có) rồi tiến hành Bước 2 (full interview).
 
 - **File là template rỗng** → tiến hành Bước 2 (full interview).
 
@@ -240,11 +240,11 @@ Chỉ ghi file sau khi user confirm. Nếu user yêu cầu chỉnh sửa → c
 
 ### Bước 5: Save
 
-**5a. Ghi `specs/main/prd.md`** — nội dung đã được confirm, thay thế toàn bộ nội dung cũ.
+**5a. Ghi `.specs/main/prd.md`** — nội dung đã được confirm, thay thế toàn bộ nội dung cũ.
 
-**5b. Scaffold `specs/main/domain.md`** *(chỉ khi file này chưa tồn tại)*:
+**5b. Scaffold `.specs/main/domain.md`** *(chỉ khi file này chưa tồn tại)*:
 
-- Copy `.claude/templates/main/domain-template.md` thành `specs/main/domain.md`.
+- Copy `.claude/templates/main/domain-template.md` thành `.specs/main/domain.md`.
 - Section **Glossary** giữ format bảng rỗng — terms sẽ được thêm dần qua cascade từ integrations.
 - Section **Shared Entities** giữ block placeholder — entities sẽ mọc dần qua cascade khi integration giới thiệu shared entity.
 
@@ -264,8 +264,8 @@ Nếu `domain.md` đã tồn tại với nội dung thực → không đụng t
 
 Thông báo kết quả:
 ```
-✓ specs/main/prd.md đã được cập nhật (status: draft)
-{nếu vừa scaffold} ✓ specs/main/domain.md đã được scaffold (skeleton — sẽ mọc dần qua cascade)
+✓ .specs/main/prd.md đã được cập nhật (status: draft)
+{nếu vừa scaffold} ✓ .specs/main/domain.md đã được scaffold (skeleton — sẽ mọc dần qua cascade)
 
 Bước tiếp theo:
   - /spec-sad → thiết kế kiến trúc kỹ thuật

package/skills/spec-remove/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: spec-remove
-description: Remove một feature toàn diện — tạo removal integration với Code Inventory, Reverse Dependency Audit, reverse-TDD test strategy, và Finalize Plan (move feature artifacts sang specs/removed/ + đóng ADO tickets) như task cuối trong todo.md. Nhận F-XXX làm argument.
+description: Remove một feature toàn diện — tạo removal integration với Code Inventory, Reverse Dependency Audit, reverse-TDD test strategy, và Finalize Plan (move feature artifacts sang .specs/removed/ + đóng ADO tickets) như task cuối trong todo.md. Nhận F-XXX làm argument.
 ---
 
 # spec-remove
@@ -12,7 +12,7 @@ Tạo removal integration cho 1 feature đã tồn tại. Output là `spec.md` v
 - **Code Inventory** — code, route, DB, feature flag, config liên quan
 - **Reverse Dependency Audit** — ai còn reference, an toàn xoá hay không
 - **Test Strategy** — reverse-TDD (regression test "thing is gone")
-- **Finalize Plan** — move feature artifacts sang `specs/removed/` + đóng ADO tickets, được DEV chạy như task cuối trong `todo.md`
+- **Finalize Plan** — move feature artifacts sang `.specs/removed/` + đóng ADO tickets, được DEV chạy như task cuối trong `todo.md`
 - **Changes blocks** — `[REMOVE]` markers cho mọi artifact bị touched
 
 Skill **không** sinh `tech.md` / `plan.md` / `todo.md`. Sau khi `spec.md` được approve, chạy `/spec-tech` → `/plan` → `/build` như flow thường. `spec.md` đủ giàu để 3 skill đó hoạt động không cần modification.
@@ -33,8 +33,8 @@ Skill **không** sinh `tech.md` / `plan.md` / `todo.md`. Sau khi `spec.md` đư
 
 ## Prerequisites
 
-- `specs/main/feature/{F-XXX}-*/frd.md` tồn tại
-- `specs/main/prd.md` có row của feature trong Feature Index
+- `.specs/main/feature/{F-XXX}-*/frd.md` tồn tại
+- `.specs/main/prd.md` có row của feature trong Feature Index
 - (Optional) `.claude/ado.yaml` cấu hình nếu muốn đóng ADO tickets ở finalize step
 
 ---
@@ -49,7 +49,7 @@ Argument BẮT BUỘC là Feature ID dạng `F-XXX` (3 chữ số). Nếu argume
 spec-remove cần Feature ID. Ví dụ: /spec-remove F-001
 ```
 
-Tìm thư mục `specs/main/feature/F-XXX-*/`:
+Tìm thư mục `.specs/main/feature/F-XXX-*/`:
 - 0 matches → báo lỗi feature không tồn tại, dừng.
 - ≥ 2 matches → báo lỗi data inconsistency (nhiều thư mục cùng prefix), dừng.
 - 1 match → tiếp.
@@ -71,20 +71,20 @@ F-XXX đã có status `removed`. Bạn muốn:
 Đọc các file sau:
 
 **Bắt buộc:**
-- `specs/main/feature/{F-XXX}-*/frd.md` — full content
-- `specs/main/feature/{F-XXX}-*/fdd.md` — nếu tồn tại
-- `specs/main/prd.md` — Feature Index (capture ADO ticket ID cho F-XXX), Component Index, NFR
-- `specs/main/domain.md` — Glossary + Shared Entities (xác định entity nào owned bởi component thuộc F-XXX)
+- `.specs/main/feature/{F-XXX}-*/frd.md` — full content
+- `.specs/main/feature/{F-XXX}-*/fdd.md` — nếu tồn tại
+- `.specs/main/prd.md` — Feature Index (capture ADO ticket ID cho F-XXX), Component Index, NFR
+- `.specs/main/domain.md` — Glossary + Shared Entities (xác định entity nào owned bởi component thuộc F-XXX)
 
 **Components used by F-XXX:**
 
 Trích từ `frd.md` section `Components Used` + `fdd.md` section `Components Touched`. Với mỗi C-YYY:
-- `specs/main/component/{C-YYY}-*/crd.md`
-- `specs/main/component/{C-YYY}-*/cdd.md` — nếu tồn tại
+- `.specs/main/component/{C-YYY}-*/crd.md`
+- `.specs/main/component/{C-YYY}-*/cdd.md` — nếu tồn tại
 
 **Reverse dependency scan:**
 
-Với mỗi C-YYY mà F-XXX sử dụng, grep `specs/main/feature/F-*/frd.md` (trừ F-XXX) tìm references tới C-YYY. Mọi feature khác có reference → load `frd.md` của feature đó để hiểu nó dùng C-YYY làm gì.
+Với mỗi C-YYY mà F-XXX sử dụng, grep `.specs/main/feature/F-*/frd.md` (trừ F-XXX) tìm references tới C-YYY. Mọi feature khác có reference → load `frd.md` của feature đó để hiểu nó dùng C-YYY làm gì.
 
 Output context summary cho user:
 
@@ -243,9 +243,9 @@ Sau khi migration deploy xong, chạy lại /spec-remove F-XXX.
 
 Xác định slug và NNN giống `/spec-new`:
 - Slug: `remove-{f-xxx-slug}` (ví dụ `remove-f001-authentication`)
-- NNN: max của thư mục hiện có trong `specs/integrations/` + 1, format 3 chữ số.
+- NNN: max của thư mục hiện có trong `.specs/integrations/` + 1, format 3 chữ số.
 
-Output path: `specs/integrations/{NNN}-remove-{f-xxx-slug}/spec.md`
+Output path: `.specs/integrations/{NNN}-remove-{f-xxx-slug}/spec.md`
 
 Cấu trúc spec.md:
 
@@ -319,20 +319,20 @@ Regression tests **được giữ lại** trong codebase như guardrail — futu
 
 1. **Move feature artifacts:**
    ```bash
-   mkdir -p specs/removed
-   mv specs/main/feature/{F-XXX}-{slug}/ specs/removed/{F-XXX}-{slug}/
+   mkdir -p .specs/removed
+   mv .specs/main/feature/{F-XXX}-{slug}/ .specs/removed/{F-XXX}-{slug}/
    ```
 
-2. **Append Change History** vào `specs/removed/{F-XXX}-{slug}/frd.md` (nếu file còn tồn tại sau move):
+2. **Append Change History** vào `.specs/removed/{F-XXX}-{slug}/frd.md` (nếu file còn tồn tại sau move):
    ```markdown
    ### {YYYY-MM-DD} — [{NNN}-remove-{slug}](../../integrations/{NNN}-remove-{slug}/spec.md) — removed
-   - **Feature decommissioned**: moved from specs/main/feature/ to specs/removed/
+   - **Feature decommissioned**: moved from .specs/main/feature/ to .specs/removed/
    - Reason: {lý do từ Problem Statement}
    ```
 
 3. **Update prd.md Feature Index:**
    - Row F-XXX: status → `Removed`
-   - Add note column hoặc inline: `(see specs/removed/{F-XXX}-{slug}/)`
+   - Add note column hoặc inline: `(see .specs/removed/{F-XXX}-{slug}/)`
 
 4. **Close ADO tickets** (nếu prd.md có ADO ticket ID cho F-XXX):
    - Feature ticket → state `Removed`
@@ -342,8 +342,8 @@ Regression tests **được giữ lại** trong codebase như guardrail — futu
    - Nếu ADO state name khác (vd "Closed") → xem `.claude/ado.yaml` hoặc fetch từ `wit_get_work_item_type`
 
 5. **Verify finalize:**
-   - `ls specs/main/feature/ | grep {F-XXX}` → không còn match
-   - `ls specs/removed/{F-XXX}-{slug}/` → tồn tại
+   - `ls .specs/main/feature/ | grep {F-XXX}` → không còn match
+   - `ls .specs/removed/{F-XXX}-{slug}/` → tồn tại
    - prd.md grep `F-XXX` → status `Removed`
    - ADO ticket fetch → state khớp
 
@@ -356,7 +356,7 @@ Regression tests **được giữ lại** trong codebase như guardrail — futu
 
 #### Features (Feature Index)
 - Row [MODIFY status]: `F-XXX` {current status} → `Removed`
-- {nếu có note column} Row [MODIFY note]: `F-XXX` add note "see specs/removed/"
+- {nếu có note column} Row [MODIFY note]: `F-XXX` add note "see .specs/removed/"
 
 #### Components (Component Index) — chỉ component exclusive với F-XXX
 - Row [MODIFY status]: `C-YYY` {current status} → `Removed`
@@ -367,7 +367,7 @@ Regression tests **được giữ lại** trong codebase như guardrail — futu
 **Format reference:** [frd-template.md](../../templates/main/feature/frd-template.md)
 
 <!--
-Đánh dấu mọi item bằng [REMOVE]. File sẽ bị move sang specs/removed/ ở Finalize step
+Đánh dấu mọi item bằng [REMOVE]. File sẽ bị move sang .specs/removed/ ở Finalize step
 nhưng cascade content vẫn ghi vào file gốc trước (để Change History entry được apply).
 -->
 
@@ -462,7 +462,7 @@ Draft trên đã đúng chưa?
 
 Sau khi confirm, agent sẽ auto-apply Changes blocks lên main artifacts.
 File feature artifacts (frd/fdd) KHÔNG bị move ngay — chỉ apply [REMOVE] markers
-+ Change History entry. Move sang specs/removed/ là task cuối trong todo.md,
++ Change History entry. Move sang .specs/removed/ là task cuối trong todo.md,
 do /build chạy sau khi mọi deletion task khác xong.
 ```
 
@@ -500,7 +500,7 @@ Giống `/spec-new` Bước 7, nhưng với removal-specific extensions.
 **[8.5] Thông báo kết quả:**
 
 ```
-✓ specs/integrations/{NNN}-remove-{f-xxx-slug}/spec.md đã được tạo (status: approved, removal: true)
+✓ .specs/integrations/{NNN}-remove-{f-xxx-slug}/spec.md đã được tạo (status: approved, removal: true)
 
 Auto-cascade applied:
   ✓ prd.md — F-XXX status → Removed; {N} components status → Removed
@@ -509,7 +509,7 @@ Auto-cascade applied:
   ✓ feature/F-XXX-*/frd.md — all items [REMOVE], status → removed
   ✓ feature/F-XXX-*/fdd.md — all items [REMOVE], status → removed
 
-⚠ File feature/F-XXX-*/ vẫn ở specs/main/feature/. Sẽ được move sang specs/removed/ ở task cuối todo.md.
+⚠ File feature/F-XXX-*/ vẫn ở .specs/main/feature/. Sẽ được move sang .specs/removed/ ở task cuối todo.md.
 ⚠ ADO tickets giữ nguyên state. Sẽ được close ở task cuối todo.md (cần .claude/ado.yaml).
 
 Bước tiếp theo:
@@ -583,6 +583,6 @@ Sau khi user confirm (Bước 8):
 - [ ] Auto-cascade chạy đúng thứ tự prd → domain → sad → crd → cdd → frd → fdd
 - [ ] Mọi artifact bị touched có Change History entry
 - [ ] prd.md row F-XXX status = Removed (đổi ngay sau approve)
-- [ ] File feature/F-XXX-*/ VẪN ở specs/main/feature/ (chưa move — chỉ move ở Finalize task)
+- [ ] File feature/F-XXX-*/ VẪN ở .specs/main/feature/ (chưa move — chỉ move ở Finalize task)
 - [ ] ADO tickets KHÔNG bị transition (chưa close — chỉ close ở Finalize task)
 - [ ] Notification cuối ghi rõ 2 ⚠ về việc folder + ADO chưa được động vào

package/skills/spec-sad/SKILL.md

@@ -7,7 +7,7 @@ description: Điền hoặc cập nhật sad.md — System Architecture Document
 
 ## Overview
 
-Tạo nội dung cho `specs/main/sad.md` thông qua interview có cấu trúc. SAD là bản đồ kỹ thuật của hệ thống — nó định nghĩa các quyết định kiến trúc, tech stack, và đặc biệt là **Architectural Guardrails**: các nguyên tắc bất biến mà mọi agent phải tuân theo khi sinh `tech.md`.
+Tạo nội dung cho `.specs/main/sad.md` thông qua interview có cấu trúc. SAD là bản đồ kỹ thuật của hệ thống — nó định nghĩa các quyết định kiến trúc, tech stack, và đặc biệt là **Architectural Guardrails**: các nguyên tắc bất biến mà mọi agent phải tuân theo khi sinh `tech.md`.
 
 SAD không chứa: feature-level design, business rules, entity details — những thứ đó thuộc về `domain.md` và `fdd.md`.
 
@@ -30,21 +30,21 @@ SAD không chứa: feature-level design, business rules, entity details — nh
 
 ### Bước 1: Kiểm tra preconditions
 
-**Đọc `specs/main/prd.md`:**
+**Đọc `.specs/main/prd.md`:**
 
 - **Chưa tồn tại hoặc là template** → dừng ngay:
   > `prd.md` chưa có nội dung. Hãy chạy `/spec-prd` trước.
 
 - **Đã có nội dung** → đọc để lấy: NFRs (performance, security, availability targets), business constraints, scope.
 
-**Đọc `specs/main/domain.md`:**
+**Đọc `.specs/main/domain.md`:**
 
 - **Chưa tồn tại** → dừng ngay:
   > `domain.md` chưa được scaffold. Hãy chạy `/spec-prd` trước (skill này scaffold cả `prd.md` và `domain.md` skeleton).
 
 - **Đã tồn tại** → đọc để hiểu: glossary và shared entities (nếu có). Lưu ý `domain.md` có thể chỉ mới là skeleton vì nội dung chi tiết mọc dần qua cascade từ integrations — không cần dừng nếu file mỏng.
 
-**Đọc `specs/main/sad.md`:**
+**Đọc `.specs/main/sad.md`:**
 
 - **Chưa tồn tại** → tiến hành Bước 2 (full interview).
 
@@ -167,7 +167,7 @@ Chỉ ghi file sau khi user confirm. Nếu user yêu cầu chỉnh sửa → c
 
 ### Bước 5: Save
 
-Ghi nội dung đã được confirm vào `specs/main/sad.md`.
+Ghi nội dung đã được confirm vào `.specs/main/sad.md`.
 
 **Change History:** Append entry vào section `## Change History` cuối `sad.md` (theo `conventions.md` §5.5):
 
@@ -181,7 +181,7 @@ Nếu chạy lần thứ N (sad.md đã có) → operation = `update`, body li
 
 Thông báo kết quả:
 ```
-✓ specs/main/sad.md đã được cập nhật (status: draft)
+✓ .specs/main/sad.md đã được cập nhật (status: draft)
 
 Bước tiếp theo:
   - /spec-new {feature-name} → định nghĩa requirements của từng feature