thanh-kit 2.5.0

package/templates/router/skills-guide.md

@@ -0,0 +1,127 @@
+# Skills Guide
+
+> **Purpose**: Skills provide deep expert knowledge for specific domains/technologies.
+> **Location**: `.claude/skills/<skill-name>/SKILL.md`
+> **When to load**: Only when task requires specialized expertise. Skip for simple tasks.
+
+---
+
+## Loading Rules
+
+1. **Scan keywords** in user request
+2. **Only load when needed**: Simple tasks don't need skills
+3. **Minimum set**: If multiple skills match, choose the smallest set that covers the request
+4. **Ask if ambiguous**: If unsure which skill, ask 1 clarifying question
+
+---
+
+## Available Skills by Domain
+
+### Project Navigation
+| Trigger Keywords | Skill Folder |
+|:---|:---|
+| Project structure, index, tree, folder layout | `.claude/skills/project-index/` |
+
+### Frontend & UI
+| Trigger Keywords | Skill Folder |
+|:---|:---|
+| CSS, Tailwind, styling | `.claude/skills/ui-styling/` |
+| UI/UX advanced | `.claude/skills/ui-ux-pro-max/` |
+| Angular component | `.claude/skills/frontend-angular-component/` |
+| Angular form | `.claude/skills/frontend-angular-form/` |
+| Angular store | `.claude/skills/frontend-angular-store/` |
+| Angular API service | `.claude/skills/frontend-angular-api-service/` |
+| Frontend design | `.claude/skills/frontend-design/`, `.claude/skills/frontend-design-pro/` |
+| Frontend development | `.claude/skills/frontend-development/` |
+| Three.js, 3D | `.claude/skills/threejs/` |
+
+### Backend & Database
+| Trigger Keywords | Skill Folder |
+|:---|:---|
+| Backend, API | `.claude/skills/backend-development/` |
+| Database, SQL, query | `.claude/skills/databases/` |
+| EasyPlatform backend | `.claude/skills/easyplatform-backend/` |
+
+### Testing & Debugging
+| Trigger Keywords | Skill Folder |
+|:---|:---|
+| Test generation | `.claude/skills/test-generation/` |
+| Webapp testing | `.claude/skills/webapp-testing/` |
+| Bug diagnosis | `.claude/skills/bug-diagnosis/` |
+| Debugging | `.claude/skills/debugging/` |
+| Chrome DevTools | `.claude/skills/chrome-devtools/` |
+
+### Architecture & Performance
+| Trigger Keywords | Skill Folder |
+|:---|:---|
+| Cross-service, microservice | `.claude/skills/arch-cross-service-integration/` |
+| Performance optimization | `.claude/skills/arch-performance-optimization/` |
+| Security review | `.claude/skills/arch-security-review/` |
+
+### Documentation & Planning
+| Trigger Keywords | Skill Folder |
+|:---|:---|
+| Documentation | `.claude/skills/documentation/` |
+| Feature docs | `.claude/skills/feature-docs/` |
+| README improvement | `.claude/skills/readme-improvement/` |
+| Planning | `.claude/skills/planning/` |
+| Plan analysis | `.claude/skills/plan-analysis/` |
+| Plans kanban | `.claude/skills/plans-kanban/` |
+
+### AI & Media
+| Trigger Keywords | Skill Folder |
+|:---|:---|
+| AI multimodal, image, vision | `.claude/skills/ai-multimodal/` |
+| AI artist | `.claude/skills/ai-artist/` |
+| Media processing | `.claude/skills/media-processing/` |
+
+### DevOps & Tools
+| Trigger Keywords | Skill Folder |
+|:---|:---|
+| DevOps, CI/CD | `.claude/skills/devops/` |
+| MCP builder | `.claude/skills/mcp-builder/` |
+| MCP management | `.claude/skills/mcp-management/` |
+| Repomix | `.claude/skills/repomix/` |
+| Package upgrade | `.claude/skills/package-upgrade/` |
+
+### Code Quality
+| Trigger Keywords | Skill Folder |
+|:---|:---|
+| Code review | `.claude/skills/code-review/` |
+| Dual pass review | `.claude/skills/dual-pass-review/` |
+| Tasks code review | `.claude/skills/tasks-code-review/` |
+
+### Research & Problem Solving
+| Trigger Keywords | Skill Folder |
+|:---|:---|
+| Research | `.claude/skills/research/` |
+| Problem solving | `.claude/skills/problem-solving/` |
+| Sequential thinking | `.claude/skills/sequential-thinking/` |
+| Feature investigation | `.claude/skills/feature-investigation/` |
+| Feature implementation | `.claude/skills/feature-implementation/` |
+
+### Specialized
+| Trigger Keywords | Skill Folder |
+|:---|:---|
+| Better Auth | `.claude/skills/better-auth/` |
+| Shopify | `.claude/skills/shopify/` |
+| Payment integration | `.claude/skills/payment-integration/` |
+| Mobile development | `.claude/skills/mobile-development/` |
+| Web frameworks | `.claude/skills/web-frameworks/` |
+| Google ADK Python | `.claude/skills/google-adk-python/` |
+| Claude Code | `.claude/skills/claude-code/` |
+| Domain brainstormer | `.claude/skills/domain-name-brainstormer/` |
+| Branch comparison | `.claude/skills/branch-comparison/` |
+| Developer growth | `.claude/skills/developer-growth-analysis/` |
+| Docs seeker | `.claude/skills/docs-seeker/` |
+| Markdown novel viewer | `.claude/skills/markdown-novel-viewer/` |
+| Skill creator | `.claude/skills/skill-creator/` |
+
+---
+
+## Usage Rules
+
+1. **Skills = Expert knowledge**: Load to get deep domain expertise.
+2. **Not always needed**: Simple code/fix tasks often don't need skills.
+3. **Read SKILL.md first**: It contains the main knowledge and may reference other files.
+4. **Combine with Agent + Command**: Skill enhances capability, doesn't replace workflow.

package/templates/router/workflows-guide.md

@@ -0,0 +1,68 @@
+# Workflows Guide
+
+> **Purpose**: Workflows define orchestration patterns for large, multi-step tasks.
+> **Location**: `.claude/workflows/<workflow-name>.md`
+> **When to load**: Only for complex tasks requiring multiple agents or phases.
+
+---
+
+## Available Workflows
+
+| Trigger | Workflow | Load File | Use Case |
+|:---|:---|:---|:---|
+| New feature, large task | **Primary Workflow** | `.claude/workflows/primary-workflow.md` | Full feature development cycle |
+| Multi-agent coordination | **Orchestration Protocol** | `.claude/workflows/orchestration-protocol.md` | Sequential/parallel agent chains |
+| Dev rules, conventions | **Development Rules** | `.claude/workflows/development-rules.md` | Coding standards reference |
+| Documentation management | **Doc Management** | `.claude/workflows/documentation-management.md` | Docs lifecycle |
+
+---
+
+## When to Use Workflows
+
+### Use Primary Workflow when:
+- Building a new feature from scratch
+- Task has multiple phases (plan → code → test → review)
+- Need to coordinate between planning, implementation, and testing
+
+### Use Orchestration Protocol when:
+- Multiple agents need to work together
+- Tasks can be parallelized
+- Need sequential handoff between agents
+
+### Skip Workflows when:
+- Simple bug fix
+- Single-file change
+- Quick question/answer
+- Small refactor
+
+---
+
+## Workflow Patterns
+
+### Sequential Chaining
+```
+Planner → Developer → Tester → Reviewer
+```
+- Each agent completes before next begins
+- Pass context between agents
+- Use for dependent tasks
+
+### Parallel Execution
+```
+┌─ Developer (Feature A)
+│
+├─ Developer (Feature B)
+│
+└─ Tester (Write tests)
+```
+- Independent tasks run simultaneously
+- No file conflicts allowed
+- Plan merge strategy first
+
+---
+
+## Usage Rules
+
+1. **Workflows = Orchestration**: For coordinating complex multi-step work.
+2. **Not for simple tasks**: Skip if task is straightforward.
+3. **Combine all layers**: Workflow coordinates Agents, who follow Commands, enhanced by Skills.

package/templates/scripts/README.md

@@ -0,0 +1,254 @@
+# 🔧 Scripts - Công Cụ Hỗ Trợ
+
+## Scripts là gì?
+
+**Scripts** là các "công cụ tiện ích" - các chương trình nhỏ giúp tự động hóa những việc lặp đi lặp lại. Giống như hộp công cụ trong nhà - cần thì lấy ra dùng.
+
+**Ví dụ đơn giản:**
+- **scan_skills.py** - Quét tất cả skills, tạo danh sách tự động
+- **worktree.cjs** - Quản lý git worktrees
+- **resolve_env.py** - Đọc và xử lý biến môi trường
+
+---
+
+## Cài Đặt
+
+```bash
+cd .claude/scripts
+pip install -r requirements.txt
+```
+
+---
+
+## Danh Sách Scripts
+
+### 📋 Scripts Quản Lý
+
+| Script | Chức Năng | Cách Dùng |
+|--------|-----------|-----------|
+| **scan_skills.py** | Quét tất cả skills trong thư mục | Tự động tạo danh sách skills |
+| **scan_commands.py** | Quét tất cả commands | Tự động tạo danh sách commands |
+| **generate_catalogs.py** | Tạo catalogs từ skills/commands | Tổng hợp thành file dễ đọc |
+
+### 🌿 Scripts Git
+
+| Script | Chức Năng | Cách Dùng |
+|--------|-----------|-----------|
+| **worktree.cjs** | Quản lý git worktrees | Tạo/xóa/list worktrees |
+| **set-active-plan.cjs** | Đặt plan đang làm | Track task hiện tại |
+
+### ⚙️ Scripts Tiện Ích
+
+| Script | Chức Năng | Cách Dùng |
+|--------|-----------|-----------|
+| **resolve_env.py** | Xử lý biến môi trường | Load .env files |
+| **ck-help.py** | Hiện trợ giúp commands | Tra cứu cách dùng |
+| **win_compat.py** | Tương thích Windows | Fix path issues |
+
+### 📄 Files Dữ Liệu
+
+| File | Chức Năng | Ghi Chú |
+|------|-----------|---------|
+| **skills_data.yaml** | Dữ liệu skills | Được generate tự động |
+| **commands_data.yaml** | Dữ liệu commands | Được generate tự động |
+| **requirements.txt** | Python dependencies | Cài bằng pip |
+
+---
+
+## Chi Tiết Scripts Quan Trọng
+
+### 1. resolve_env.py - Xử Lý Biến Môi Trường
+
+**Chức năng:** Đọc biến môi trường theo thứ tự ưu tiên
+
+**Thứ tự ưu tiên (cao → thấp):**
+```
+1. process.env (biến runtime)              ← CAO NHẤT
+2. PROJECT/.claude/skills/<skill>/.env     ← Skill cụ thể trong project
+3. PROJECT/.claude/skills/.env             ← Chung cho skills trong project
+4. PROJECT/.claude/.env                    ← Chung cho project
+5. ~/.claude/skills/<skill>/.env           ← Skill cụ thể của user
+6. ~/.claude/skills/.env                   ← Chung cho skills của user
+7. ~/.claude/.env                          ← Chung cho user
+                                           ← THẤP NHẤT
+```
+
+**Cách dùng:**
+```bash
+# Lấy biến cho skill cụ thể
+python resolve_env.py --skill frontend-development --key API_KEY
+
+# Lấy biến chung
+python resolve_env.py --key DATABASE_URL
+```
+
+---
+
+### 2. scan_skills.py - Quét Skills
+
+**Chức năng:** Tự động quét thư mục skills và tạo danh sách
+
+**Cách chạy:**
+```bash
+cd .claude/scripts
+python scan_skills.py
+```
+
+**Output:** File `skills_data.yaml` chứa:
+```yaml
+skills:
+  - name: frontend-development
+    path: skills/frontend-development
+    description: React/TypeScript development
+  - name: debugging
+    path: skills/debugging
+    description: Bug diagnosis framework
+  # ... và tất cả skills khác
+```
+
+**Khi nào dùng:**
+- Sau khi thêm skill mới
+- Cần cập nhật danh sách skills
+
+---
+
+### 3. worktree.cjs - Quản Lý Worktrees
+
+**Chức năng:** Quản lý git worktrees (làm nhiều branches song song)
+
+**Git worktree là gì?**
+```
+Bình thường:
+project/
+└── (chỉ 1 branch tại một thời điểm)
+
+Với worktree:
+project/           ← branch main
+project-feature/   ← branch feature (thư mục riêng)
+project-hotfix/    ← branch hotfix (thư mục riêng)
+
+→ Có thể làm nhiều branches cùng lúc!
+```
+
+**Các lệnh:**
+```bash
+# Tạo worktree mới
+node worktree.cjs create feature/login
+
+# Liệt kê worktrees
+node worktree.cjs list
+
+# Xóa worktree
+node worktree.cjs remove feature/login
+```
+
+---
+
+### 4. ck-help.py - Trợ Giúp Commands
+
+**Chức năng:** Hiển thị hướng dẫn sử dụng commands
+
+**Cách dùng:**
+```bash
+# Xem tất cả commands
+python ck-help.py
+
+# Xem chi tiết 1 command
+python ck-help.py fix
+
+# Xem command variants
+python ck-help.py fix --all
+```
+
+**Output:**
+```
+/fix - Sửa bugs
+  Variants:
+  - /fix/fast  - Sửa nhanh lỗi đơn giản
+  - /fix/hard  - Sửa lỗi phức tạp
+  - /fix/ui    - Sửa lỗi giao diện
+  ...
+```
+
+---
+
+## Cấu Trúc Thư Mục
+
+```
+scripts/
+├── README.md                 ← File này
+│
+├── scan_skills.py           ← Quét skills
+├── scan_commands.py         ← Quét commands
+├── generate_catalogs.py     ← Tạo catalogs
+│
+├── worktree.cjs             ← Quản lý worktrees
+├── worktree.test.cjs        ← Tests cho worktree
+├── set-active-plan.cjs      ← Set plan hiện tại
+│
+├── resolve_env.py           ← Xử lý .env
+├── ck-help.py               ← Trợ giúp
+├── win_compat.py            ← Windows compatibility
+│
+├── skills_data.yaml         ← Data skills (generated)
+├── commands_data.yaml       ← Data commands (generated)
+└── requirements.txt         ← Python dependencies
+```
+
+---
+
+## Ví Dụ Sử Dụng
+
+### Ví dụ 1: Cập nhật danh sách skills
+
+```bash
+# 1. Thêm skill mới vào thư mục skills/
+# 2. Chạy scan
+cd .claude/scripts
+python scan_skills.py
+
+# 3. Kiểm tra kết quả
+cat skills_data.yaml
+```
+
+### Ví dụ 2: Làm việc song song 2 features
+
+```bash
+# 1. Tạo worktree cho feature A
+node worktree.cjs create feature/login
+
+# 2. Tạo worktree cho feature B  
+node worktree.cjs create feature/payment
+
+# 3. Làm việc trên feature A
+cd ../project-feature-login
+# ... code ...
+
+# 4. Xong thì xóa worktrees
+node worktree.cjs remove feature/login
+```
+
+### Ví dụ 3: Tra cứu command
+
+```bash
+python ck-help.py fix --all
+```
+
+---
+
+## Tóm Tắt
+
+| Khái niệm | Giải thích |
+|-----------|------------|
+| **Scripts là gì** | Công cụ tiện ích tự động hóa |
+| **Có bao nhiêu** | ~10 scripts chính |
+| **Viết bằng gì** | Python (.py) và Node.js (.cjs) |
+| **Khi nào dùng** | Khi cần tự động hóa việc lặp lại |
+
+---
+
+## Xem Thêm
+
+- [Hooks (Tự động hóa)](../hooks/README.md)
+- [Skills (Kiến thức)](../skills/README.md)
+- [Commands (Quy trình)](../commands/README.md)