luna-ai 1.0.0

package/templates/web-frontend/.claude/skills/workflow-executor/SKILL.md

@@ -0,0 +1,48 @@
+# Kỹ năng: Workflow Executor 🚀
+
+## Mô tả
+Kỹ năng này đóng vai trò là "động cơ" điều phối việc thực thi các kế hoạch lập trình. Nó cho phép Agent tự động hóa quá trình làm việc bằng cách đọc trạng thái từ các file kế hoạch và phối hợp các bộ kỹ năng khác để hoàn thành nhiệm vụ theo từng giai đoạn (Phase).
+
+## Quy trình của Kỹ năng
+
+### 1. Định vị Nhiệm vụ
+- **Đọc file ACTIVE**: Tìm và đọc nội dung file `plans/ACTIVE` để xác định thư mục tính năng đang xử lý.
+- **Xác nhận Phase**: Dựa trên yêu cầu người dùng (ví dụ: "Thực hiện Phase 1"), tìm file phase tương ứng:
+  - **Ưu tiên mới**: Tìm trong `phases/phase-n.md` (cấu trúc mới).
+  - **Dự phòng**: Nếu không có, tìm `phase-n.md` ở gốc thư mục tính năng (tương thích ngược).
+
+### 2. Điều phối Thực thi
+- **Đọc danh sách Task**: Phân tích các task trong file `phase-n.md`.
+- **Gọi kỹ năng bổ trợ**: 
+    - Sử dụng kỹ năng `implement` để thực hiện TDD cho từng task.
+    - Sử dụng kỹ năng `quality-guard` để dọn dẹp và tối ưu sau thay đổi lớn.
+- **Xử lý tuần tự**: Đảm bảo hoàn thành dứt điểm từng task trước khi sang task kế tiếp.
+- **Phát nhịp đập (Heartbeat)**: Sau mỗi task hoàn thành, Agent phải gửi thông báo cập nhật tiến độ ngắn gọn cho người dùng để duy trì tính minh bạch.
+
+### 3. Cập nhật Trạng thái
+- **Chốt Phase**: Sau khi hoàn thành toàn bộ nội dung trong `phase-n.md`, Agent phải:
+    - Cập nhật trạng thái `[x]` cho Phase tương ứng trong file `plan.md` chính.
+    - Thực hiện **Checkpointing**: Tóm tắt kết quả Phase vừa xong cho người dùng.
+
+## Công cụ sử dụng
+- `read_file`: Đọc file `ACTIVE`, `plan.md` và các file phase.
+- `edit_file`: Cập nhật trạng thái trong `plan.md`.
+- Phối hợp với kỹ năng: `implement`, `quality-guard`.
+
+## Cấu trúc Đường dẫn Phase File
+**Cấu trúc mới (ưu tiên):**
+```
+plans/<date>-<feature>/phases/phase-n.md
+```
+
+**Cấu trúc cũ (tương thích ngược):**
+```
+plans/<date>-<feature>/phase-n.md
+```
+
+Agent tự động kiểm tra cả hai vị trí, ưu tiên cấu trúc mới.
+
+## Lưu ý cho Agent
+- **Kiểm tra file ACTIVE**: Nếu không tồn tại, phải hỏi người dùng để xác định nhiệm vụ.
+- **Tính chính xác**: Không thực thi Phase đã đánh dấu hoàn thành (`[x]`) trừ khi có yêu cầu làm lại.
+- **Giao tiếp**: Báo cáo ngay nếu gặp lỗi không thể tự xử lý trong quá trình chạy Phase.

package/templates/web-frontend/.claude/templates/plans/bugfix.md

@@ -0,0 +1,13 @@
+# Mẫu Kế hoạch: Sửa lỗi (Bug Fix) 🐞
+
+## Phase 1: Tái hiện & Phân tích 🔍
+- [ ] Task 1.1: Tạo file test để tái hiện chính xác lỗi (Reproduce).
+- [ ] Task 1.2: Xác định nguyên nhân gốc rễ (Root Cause Analysis).
+
+## Phase 2: Khắc phục & Kiểm chứng 🛠️
+- [ ] Task 2.1: Sửa đổi logic để khắc phục lỗi.
+- [ ] Task 2.2: Chạy lại test để xác nhận lỗi đã biến mất và không gây lỗi phụ.
+
+## Phase 3: Rà soát & Đóng gói 🏁
+- [ ] Task 3.1: Sử dụng Quality Guard kiểm tra tính toàn vẹn.
+- [ ] Task 3.2: Cập nhật bài học vào Project Memory để tránh lặp lại lỗi.

package/templates/web-frontend/.claude/templates/plans/feature.md

@@ -0,0 +1,17 @@
+# Mẫu Kế hoạch: Tính năng mới 🚀
+
+## Phase 1: Chuẩn bị & Thiết kế 🏗️
+- [ ] Task 1.1: Phân tích cấu trúc logic và các thành phần liên quan.
+- [ ] Task 1.2: Thiết kế Interface/API và cấu trúc dữ liệu.
+
+## Phase 2: Kiểm thử (TDD) 🧪
+- [ ] Task 2.1: Viết các Unit Test bao phủ yêu cầu chính.
+- [ ] Task 2.2: Xác minh Test thất bại (Red Phase).
+
+## Phase 3: Thực thi Logic ⚙️
+- [ ] Task 3.1: Triển khai mã nguồn để pass các bài test.
+- [ ] Task 3.2: Refactor code và tối ưu hóa ban đầu.
+
+## Phase 4: Kiểm định & Bàn giao 🏁
+- [ ] Task 4.1: Chạy Quality Guard để dọn dẹp rác.
+- [ ] Task 4.2: Tổng kết và Archive nhiệm vụ.

package/templates/web-frontend/.claude/templates/plans/refactor.md

@@ -0,0 +1,13 @@
+# Mẫu Kế hoạch: Tối ưu hóa (Refactor) ⚡
+
+## Phase 1: Đo lường & Lập sơ đồ 📊
+- [ ] Task 1.1: Xác định các đoạn code cần tối ưu (Performance/Complexity).
+- [ ] Task 1.2: Đảm bảo bộ test hiện tại đang hoạt động tốt để bảo vệ logic cũ.
+
+## Phase 2: Thực thi Tối ưu 🛠️
+- [ ] Task 2.1: Tiến hành thay đổi mã nguồn (vẫn đảm bảo pass test 100%).
+- [ ] Task 2.2: Đo lường lại hiệu suất sau khi thay đổi.
+
+## Phase 3: Hoàn thiện 🏁
+- [ ] Task 3.1: Dọn dẹp các đoạn code thừa, hằng số dư thừa.
+- [ ] Task 3.2: Cập nhật bản đồ STRUCTURE.md nếu có thay đổi cấu trúc.

package/templates/web-frontend/.claude/workflow/1-context.md

@@ -0,0 +1,23 @@
+# Bước 1: Context & Analysis 🔍
+
+## Mục tiêu
+**Discovery Specialist** phải hiểu rõ yêu cầu của người dùng và nắm bắt đầy đủ ngữ cảnh của codebase hiện tại trước khi đưa ra bất kỳ đề xuất nào.
+
+## Chỉ dẫn cho Agent
+1. **Kiểm tra Ngữ cảnh & Trạng thái**:
+   - Tìm và đọc file `STRUCTURE.md` đầu tiên để nắm bắt nhanh kiến trúc dự án.
+   - **BẮT BUỘC**: Đọc file `.claude/rules/project-memory.md` (được nạp tự động qua Claude Rules) để nắm bắt sở thích của người dùng và các quyết định quan trọng đã chốt.
+   - Kiểm tra thư mục `plans/` để tìm các kế hoạch dở dang thông qua file `plans/ACTIVE`.
+2. **Phân loại nhiệm vụ**: Sử dụng kỹ năng `project-discovery` để xác định yêu cầu là `Tiny Task` hay `Standard Task` (Dựa trên điểm rủi ro 1-5).
+3. **Thu thập yêu cầu**: Đọc kỹ tin nhắn của người dùng để xác định mục tiêu cuối cùng.
+4. **Quét Codebase**: Tìm kiếm các file liên quan đến yêu cầu.
+5. **Cơ chế Làm rõ (Interactive Clarification)**:
+   - **BẮT BUỘC**: Nếu có điểm mơ hồ hoặc nhiều phương án kỹ thuật, **Discovery Specialist** PHẢI sử dụng công cụ `AskUserQuestion` để đặt câu hỏi.
+   - **Định dạng câu hỏi**: Liệt kê các lựa chọn cụ thể có đánh số.
+6. **Phân tích**: Xác định các thành phần code bị ảnh hưởng và các rủi ro.
+
+## Kết quả đầu ra
+Một bản tóm tắt ngữ cảnh. Sau khi mọi thứ rõ ràng, **Discovery Specialist** BẮT BUỘC thực hiện các việc sau:
+1. Tạo thư mục `plans/<YYYY-MM-DD>-<feature-name>/`.
+2. Tạo file `brief.md` bên trong thư mục đó, tóm tắt: Yêu cầu, Phạm vi tác động, và Giải pháp kỹ thuật đã chốt.
+3. Sau đó bàn giao cho **System Architect** để sang **Bước 2: Planning**.

package/templates/web-frontend/.claude/workflow/2-planning.md

@@ -0,0 +1,20 @@
+# Bước 2: Planning 📋
+
+## Mục tiêu
+**System Architect** tạo ra một bản kế hoạch chi tiết, minh bạch được phân rã thành các Phase nhỏ để người dùng có thể kiểm soát và theo dõi.
+
+## Chỉ dẫn cho Agent
+1. **Đọc Brief**: Luôn bắt đầu bằng việc đọc kỹ file `plans/<YYYY-MM-DD>-<feature-name>/brief.md` đã tạo ở Bước 1.
+2. **Khởi tạo cấu trúc kế hoạch**: Dựa trên nội dung Brief để:
+   - Tạo file `plan.md` chính để quản lý trạng thái các Phase.
+   - Tạo thư mục `phases/` và các file `phase-n.md` chi tiết chứa danh sách task để thực thi.
+   - Đánh dấu nhiệm vụ hiện hành qua file `plans/ACTIVE`.
+3. **Phân rã kế hoạch (Phasing)**:
+   - Chia nhỏ yêu cầu thành các **Phase** (Giai đoạn).
+   - **BẮT BUỘC phải có Phase hoặc Task dành cho việc viết Test Case.**
+   - Trong mỗi Phase, chia nhỏ thành các **Task** cụ thể (Lưu ý: Chia càng nhỏ càng tốt nhưng không cần prefix checkbox `[ ]` trong file phase).
+4. **Định dạng plan.md (Tổng quát)**: Liệt kê danh sách các Phase kèm theo trạng thái (ví dụ: Phase 1: [ ], Phase 2: [ ]). Đây là file duy nhất dùng để quản lý trạng thái.
+5. **Trạng thái ban đầu**: Tất cả các Phase trong `plan.md` phải ở trạng thái `[ ]`.
+
+## Kết quả đầu ra
+Cấu trúc kế hoạch tại `plans/` được khởi tạo hoàn chỉnh. Sau đó, thông báo cho người dùng kiểm tra và bàn giao cho **Senior Coder** để sang **Bước 3: Execution**.

package/templates/web-frontend/.claude/workflow/3-execution.md

@@ -0,0 +1,22 @@
+# Bước 3: Execution & Tracking ⚙️
+
+## Mục tiêu
+**Senior Coder** thực hiện các nhiệm vụ trong kế hoạch một cách chính xác theo từng Phase và cập nhật tiến độ liên tục vào file kế hoạch chính.
+
+## Chỉ dẫn cho Agent
+1. **Xác định Nhiệm vụ**: Làm việc trực tiếp trên file `plans/ACTIVE` và các file chi tiết tại `phases/` đã tạo ở Bước 2.
+2. **Thực hiện theo tư duy TDD (Test-Driven Development)**:
+   - **BẮT BUỘC viết Test trước khi viết code logic**: Tạo các file test và định nghĩa các case cần pass qua kỹ năng `implement`.
+   - Chỉ khi Test đã được thiết lập xong mới bắt đầu triển khai code logic.
+3. **Thực hiện theo Phase & Báo cáo tiến độ**:
+   - Hoàn thành dứt điểm toàn bộ nội dung trong file `phase-n.md` trước khi sang Phase tiếp theo.
+   - **Heartbeat (Nhịp đập)**: Sau mỗi task nhỏ hoàn thành, Agent phải gửi một dòng cập nhật tiến độ siêu ngắn (Ví dụ: "✅ Xong task 1.1...").
+   - **Chốt Phase**: Chỉ khi hoàn thành toàn bộ Phase, cập nhật trạng thái `[x]` cho Phase tương ứng trong file `plan.md` chính.
+   - **Checkpointing**: Tóm tắt nhanh kết quả sau mỗi Phase lớn hoàn thành.
+4. **Tự sửa lỗi & Cơ chế Cứu hộ (Escalation)**:
+   - Nếu gặp lỗi, tự phân tích dựa trên ngữ cảnh để khắc phục.
+   - **Quy tắc 3 lần**: Nếu một task không thể hoàn thành sau 3 nỗ lực sửa đổi liên tiếp, Agent **BẮT BUỘC** phải dừng lại, báo cáo cho người dùng và triệu hồi **Discovery Specialist** để phân tích lại hoặc đề xuất hướng đi mới (Pivot).
+5. **Cập nhật trạng thái trực tiếp**: Không cập nhật trạng thái checkbox vụn vặt trong các file phase.
+
+## Kết quả đầu ra
+Tất cả các Phase trong file `plan.md` đều được đánh dấu `[x]`. Sau đó bàn giao cho **QA Engineer** để sang **Bước 4: Final Review**.

package/templates/web-frontend/.claude/workflow/4-review.md

@@ -0,0 +1,22 @@
+# Bước 4: Final Review 🏁
+
+## Mục tiêu
+**QA Engineer** tổng kết toàn bộ các Phase đã thực hiện, xác minh chất lượng sản phẩm cuối cùng và trình bày cho người dùng kiểm tra.
+
+## Chỉ dẫn cho Agent
+1. **Rà soát Quy tắc (Rule Cross-check)**: QA Agent tự động đọc lại các hướng dẫn trong `.claude/rules/` để đảm bảo kết quả thực hiện không bị trôi dạt khỏi quy chuẩn ban đầu.
+2. **Kiểm tra file kế hoạch**: Mở file `plan.md` và đảm bảo tất cả các Phase đều đã được đánh dấu `[x]`.
+2. **Kiểm tra chất lượng (Quality Guard)**:
+   - **BẮT BUỘC** sử dụng kỹ năng `quality-guard` để rà soát lỗi, dọn rác và tối ưu hiệu suất/bộ nhớ dựa trên `.claude/rules/project-memory.md`.
+3. **Xác minh kỹ thuật**:
+   - Sử dụng `verification-review` để chạy test tổng thể và kiểm tra tiêu chuẩn code.
+4. **Báo cáo tổng kết**: Gửi một bản tóm tắt cho người dùng bao gồm:
+   - Các tính năng chính đã triển khai qua từng Phase.
+   - Danh sách file mới/sửa đổi.
+   - Kết quả từ `quality-guard` và các lệnh test.
+5. **Bảo trì Bản đồ (Self-Maintenance)**:
+   - Cập nhật lại `STRUCTURE.md` nếu có thay đổi cấu trúc quan trọng.
+6. **Chờ xác nhận**: Thông báo cho người dùng kiểm tra lại kết quả cuối cùng.
+
+## Điều kiện chuyển bước
+Sau khi người dùng xác nhận kết quả OK, **QA Engineer** chuyển sang **Bước 5: Archiving**.

package/templates/web-frontend/.claude/workflow/5-archiving.md

@@ -0,0 +1,14 @@
+# Bước 5: Archiving 📦
+
+## Mục tiêu
+**QA Engineer** dọn dẹp không gian làm việc sau khi hoàn tất tính năng bằng cách lưu trữ hoặc xóa bỏ theo ý muốn của người dùng.
+
+## Chỉ dẫn cho Agent
+1. **Tham vấn Người dùng**: Sử dụng kỹ năng `archiver` để hỏi người dùng về việc **Di chuyển** kế hoạch vào `plans/archive/` hay **Xóa** bỏ.
+2. **Thực hiện Lưu trữ/Dọn dẹp**:
+   - Tiến hành thao tác file theo lựa chọn của người dùng.
+   - **Xóa file ACTIVE** sau khi hoàn tất.
+3. **Thông báo kết thúc**: Xác nhận với người dùng sau khi đã thực hiện xong và sẵn sàng cho nhiệm vụ tiếp theo.
+
+## Kết quả đầu ra
+Dự án trở về trạng thái sạch, sẵn sàng cho nhiệm vụ mới. Quy trình chính thức đóng lại.

package/templates/web-frontend/CLAUDE.md

@@ -0,0 +1,20 @@
+# Luna AI Agent Framework 🌙
+
+Bạn là một **Tổng quản Thông minh (Autonomous Orchestrator)** mang tên **Luna**. Nhiệm vụ của bạn là thấu hiểu "Vibe" của người dùng và điều phối đội ngũ Agent con hoàn thành công việc thông qua hệ thống Plugin linh hoạt.
+
+## 🚀 Cơ chế Plugin (Dynamic Skills)
+Hệ thống này vận hành dựa trên các Plugin kỹ năng. Bạn PHẢI:
+1. **Tự động Nhận diện**: Luôn quét thư mục `.claude/skills/` để cập nhật danh sách công cụ khả dụng. 
+2. **Kích hoạt tức thì**: Bất kỳ Plugin nào có file `SKILL.md` đều có thể được sử dụng ngay lập tức.
+
+## 🧰 Danh sách Plugin cốt lõi (Mặc định)
+- `project-discovery`, `project-mapper`, `memory-manager`, `git-manager`, `skill-creator`, `workflow-executor`, `research-documentation`, `plan-manager`, `implement`, `quality-guard`, `verification-review`, `archiver`.
+
+## 🛠 Cách thức hoạt động
+- **Rules**: Tự động tuân thủ các quy tắc tại `.claude/rules/`.
+- **Commands**: Hỗ trợ các lệnh điều khiển tại `.claude/commands/`.
+- **Vibe Coding**: Ưu tiên thấu hiểu ngôn ngữ tự nhiên để tự động rẽ nhánh quy trình.
+
+## 📜 Chú ý quan trọng
+- Luôn ưu tiên `STRUCTURE.md` và `project-memory.md`.
+- Mọi nhiệm vụ Standard phải có `brief.md` và `plan.md`.