thanh-kit 2.5.1 → 2.5.2

package/templates/commands/worktree.md

@@ -1,126 +0,0 @@
----
-description: Create isolated git worktree for parallel development
-argument-hint: [feature-description] OR [project] [feature] (monorepo)
----
-
-Create an isolated git worktree for parallel feature development.
-
-## Workflow
-
-### Step 1: Get Repository Info
-
-```bash
-node .claude/scripts/worktree.cjs info --json
-```
-
-**Response fields:**
-- `repoType`: "monorepo" or "standalone"
-- `baseBranch`: detected base branch
-- `projects`: array of {name, path} for monorepo
-- `envFiles`: array of .env* files found
-- `dirtyState`: boolean
-
-### Step 2: Gather Info via AskUserQuestion
-
-**Detect branch prefix from user's description:**
-- Keywords "fix", "bug", "error", "issue" → prefix = `fix`
-- Keywords "refactor", "restructure", "rewrite" → prefix = `refactor`
-- Keywords "docs", "documentation", "readme" → prefix = `docs`
-- Keywords "test", "spec", "coverage" → prefix = `test`
-- Keywords "chore", "cleanup", "deps" → prefix = `chore`
-- Keywords "perf", "performance", "optimize" → prefix = `perf`
-- Everything else → prefix = `feat`
-
-**For MONOREPO:** Use AskUserQuestion if project not specified:
-```javascript
-// If user said "/worktree add auth" but multiple projects exist
-AskUserQuestion({
-  questions: [{
-    header: "Project",
-    question: "Which project should the worktree be created for?",
-    options: projects.map(p => ({ label: p.name, description: p.path })),
-    multiSelect: false
-  }]
-})
-```
-
-**For env files:** Always ask which to copy:
-```javascript
-AskUserQuestion({
-  questions: [{
-    header: "Env files",
-    question: "Which environment files should be copied to the worktree?",
-    options: envFiles.map(f => ({ label: f, description: "Copy to worktree" })),
-    multiSelect: true
-  }]
-})
-```
-
-### Step 3: Convert Description to Slug
-
-- "add authentication system" → `add-auth`
-- "fix login bug" → `login-bug`
-- Remove filler words, kebab-case, max 50 chars
-
-### Step 4: Execute Command
-
-**Monorepo:**
-```bash
-node .claude/scripts/worktree.cjs create "<PROJECT>" "<SLUG>" --prefix <TYPE> --env "<FILES>"
-```
-
-**Standalone:**
-```bash
-node .claude/scripts/worktree.cjs create "<SLUG>" --prefix <TYPE> --env "<FILES>"
-```
-
-**Options:**
-- `--prefix` - Branch type: feat|fix|refactor|docs|test|chore|perf
-- `--env` - Comma-separated .env files to copy
-- `--json` - Output JSON for parsing
-- `--dry-run` - Preview without executing
-
-## Commands
-
-| Command | Usage | Description |
-|---------|-------|-------------|
-| `create` | `create [project] <feature>` | Create new worktree |
-| `remove` | `remove <name-or-path>` | Remove worktree and branch |
-| `info` | `info` | Get repo info |
-| `list` | `list` | List existing worktrees |
-
-## Error Codes
-
-| Code | Meaning | Action |
-|------|---------|--------|
-| `MISSING_ARGS` | Missing project/feature for monorepo | Ask for both |
-| `MISSING_FEATURE` | No feature name (standalone) | Ask for feature |
-| `PROJECT_NOT_FOUND` | Project not in .gitmodules | Show available projects |
-| `MULTIPLE_PROJECTS_MATCH` | Ambiguous project name | Use AskUserQuestion |
-| `MULTIPLE_WORKTREES_MATCH` | Ambiguous worktree for remove | Use AskUserQuestion |
-| `BRANCH_CHECKED_OUT` | Branch in use elsewhere | Suggest different name |
-| `WORKTREE_EXISTS` | Path already exists | Suggest use or remove |
-| `WORKTREE_CREATE_FAILED` | Git command failed | Show git error |
-| `WORKTREE_REMOVE_FAILED` | Cannot remove worktree | Check uncommitted changes |
-
-## Example Session
-
-```
-User: /worktree fix the login validation bug
-
-Claude: [Runs: node .claude/scripts/worktree.cjs info --json]
-        [Detects: standalone repo, envFiles: [".env.example"]]
-        [Detects prefix from "fix" keyword: fix]
-        [Converts slug: "login-validation-bug"]
-
-Claude: [Uses AskUserQuestion for env files]
-        "Which environment files should be copied?"
-        Options: .env.example
-
-User: .env.example
-
-Claude: [Runs: node .claude/scripts/worktree.cjs create "login-validation-bug" --prefix fix --env ".env.example"]
-
-Output: Worktree created at ../worktrees/myrepo-login-validation-bug
-        Branch: fix/login-validation-bug
-```

package/templates/memory/session-log.md

@@ -1,186 +0,0 @@
-
-## Session Ended - 2025-12-20T12:20:50.962Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-20T12:29:41.467Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-20T16:19:14.363Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-20T16:25:25.086Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-20T16:36:47.738Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-23T13:05:47.890Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T08:13:36.265Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T08:19:15.569Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T08:30:36.642Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T08:54:32.981Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T11:34:08.922Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T11:38:41.978Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T11:53:15.159Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T11:59:04.430Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T12:06:44.071Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T12:24:11.940Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T12:33:52.403Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T12:55:29.114Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T12:57:58.800Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T22:07:26.337Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T22:14:21.188Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T22:23:50.461Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T22:35:31.708Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T22:45:59.379Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T22:47:15.154Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-24T22:58:17.355Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-28T02:19:43.058Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-28T03:47:18.977Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-28T06:43:05.591Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-28T06:53:44.627Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----
-
-## Session Ended - 2025-12-28T08:25:50.147Z
-- Branch: main
-- Directory: C:\GitSources\EasyPlatform
-
----

package/templates/router/README.md

@@ -1,294 +0,0 @@
-# 🧭 Router - Bộ Não Quyết Định
-
-## Router là gì?
-
-**Router** là "bộ não" giúp AI quyết định **nên dùng cái gì** để xử lý yêu cầu của bạn. Giống như một tổng đài viên thông minh, router phân tích yêu cầu rồi chuyển đến đúng bộ phận.
-
-**Ví dụ đơn giản:**
-```
-Bạn: "Sửa lỗi login không được"
-
-Router phân tích:
-- Từ khóa "sửa lỗi" → Cần agent Debugger
-- Loại việc "bug" → Cần command /fix
-- Cần kiến thức gì? → Có thể cần skill authentication
-
-→ Router kết nối: Debugger + /fix + better-auth skill
-```
-
----
-
-## Các File Trong Router
-
-| File | Chức Năng | Khi Nào AI Đọc |
-|------|-----------|----------------|
-| **decision-flow.md** | Hướng dẫn quy trình phân tích từng bước | Khi gặp yêu cầu phức tạp, không rõ ràng |
-| **agents-guide.md** | Danh sách đầy đủ 17 agents | Khi cần chọn vai trò phù hợp |
-| **commands-guide.md** | Danh sách đầy đủ 50+ commands | Khi cần chọn quy trình làm việc |
-| **skills-guide.md** | Danh sách đầy đủ 59 skills | Khi cần kiến thức chuyên môn |
-| **workflows-guide.md** | Quy trình phối hợp nhiều agents | Khi công việc lớn, phức tạp |
-
----
-
-## Quy Trình Router Hoạt Động
-
-```
-    Bạn đưa ra yêu cầu
-           ↓
-┌─────────────────────────────────┐
-│  BƯỚC 1: Phân tích yêu cầu      │
-│  - Loại việc gì? (code/fix/test)│
-│  - Lĩnh vực nào? (frontend/DB)  │
-│  - Phức tạp không?              │
-└─────────────────────────────────┘
-           ↓
-┌─────────────────────────────────┐
-│  BƯỚC 2: Chọn Agent (Ai làm?)   │
-│  → Đọc agents-guide.md          │
-│  Ví dụ: debugger, developer...  │
-└─────────────────────────────────┘
-           ↓
-┌─────────────────────────────────┐
-│  BƯỚC 3: Chọn Command (Làm sao?)│
-│  → Đọc commands-guide.md        │
-│  Ví dụ: /fix, /code, /plan...   │
-└─────────────────────────────────┘
-           ↓
-┌─────────────────────────────────┐
-│  BƯỚC 4: Chọn Skill (Cần gì?)   │
-│  → Đọc skills-guide.md          │
-│  Chỉ khi cần kiến thức chuyên   │
-└─────────────────────────────────┘
-           ↓
-┌─────────────────────────────────┐
-│  BƯỚC 5: Áp dụng Workflow       │
-│  → Đọc workflows-guide.md       │
-│  Chỉ khi việc lớn, nhiều bước   │
-└─────────────────────────────────┘
-           ↓
-      Bắt đầu làm việc
-```
-
----
-
-## Chi Tiết Từng File
-
-### 1. decision-flow.md - Quy Trình Quyết Định
-
-**Mục đích:** Hướng dẫn AI cách phân tích yêu cầu từ đầu đến cuối
-
-**Nội dung chính:**
-- 5 bước phân tích (như sơ đồ ở trên)
-- Cách nhận diện loại công việc
-- Cách đánh giá độ phức tạp
-
-**AI đọc file này khi:**
-- Yêu cầu không rõ ràng
-- Không biết chọn gì
-- Cần hướng dẫn từng bước
-
----
-
-### 2. agents-guide.md - Danh Bạ Chuyên Gia
-
-**Mục đích:** Giúp AI biết có những "chuyên gia" nào và khi nào gọi ai
-
-**Nội dung chính:**
-```
-Từ khóa → Agent phù hợp
-
-"bug, lỗi, crash"     → debugger (thợ săn lỗi)
-"code, viết, tạo"     → developer (lập trình viên)
-"kế hoạch, thiết kế"  → planner (kiến trúc sư)
-"tìm, ở đâu"          → scout (thám tử)
-...
-```
-
-**AI đọc file này khi:** Cần biết nên nhập vai ai
-
----
-
-### 3. commands-guide.md - Sổ Tay Quy Trình
-
-**Mục đích:** Giúp AI biết có những quy trình nào và khi nào dùng
-
-**Nội dung chính:**
-```
-Từ khóa → Command phù hợp
-
-"sửa lỗi đơn giản"    → /fix/fast
-"sửa lỗi phức tạp"    → /fix/hard
-"sửa lỗi UI"          → /fix/ui
-"viết code có test"   → /code
-"viết code nhanh"     → /code/no-test
-...
-```
-
-**AI đọc file này khi:** Cần biết quy trình làm việc
-
----
-
-### 4. skills-guide.md - Thư Viện Kiến Thức
-
-**Mục đích:** Giúp AI biết có những kiến thức chuyên môn nào
-
-**Nội dung chính:**
-```
-Từ khóa → Skill cần load
-
-"React, component"      → frontend-development
-"đẹp, UI, thiết kế"     → ui-ux-pro-max
-"database, SQL"         → databases
-"OAuth, đăng nhập"      → better-auth
-"deploy, Docker"        → devops
-...
-```
-
-**AI đọc file này khi:** Công việc cần kiến thức chuyên sâu
-
----
-
-### 5. workflows-guide.md - Kịch Bản Phối Hợp
-
-**Mục đích:** Hướng dẫn cách phối hợp nhiều agents cho việc lớn
-
-**Nội dung chính:**
-- Quy trình làm tính năng mới (plan → code → test → review)
-- Cách chuyển giao giữa các agents
-- Checkpoints kiểm tra chất lượng
-
-**AI đọc file này khi:** Công việc lớn, cần nhiều bước và nhiều vai trò
-
----
-
-## Ví Dụ Router Làm Việc
-
-### Ví dụ 1: Yêu cầu đơn giản
-
-```
-Bạn: "Tìm file xử lý payment"
-
-Router quyết định nhanh:
-- Từ khóa "tìm" → Agent: scout
-- Không cần command đặc biệt → /scout
-- Không cần skill (việc đơn giản)
-
-→ Kết quả: AI dùng scout để tìm kiếm
-```
-
-### Ví dụ 2: Yêu cầu phức tạp
-
-```
-Bạn: "Xây dựng hệ thống chat real-time"
-
-Router phân tích kỹ:
-1. Đọc decision-flow.md
-   - Loại việc: Tạo tính năng mới
-   - Lĩnh vực: Backend + Frontend
-   - Độ phức tạp: Cao
-
-2. Chọn agents (agents-guide.md):
-   - planner → developer → tester → docs-manager
-
-3. Chọn commands (commands-guide.md):
-   - /plan/hard → /code → /test → /docs/update
-
-4. Chọn skills (skills-guide.md):
-   - backend-development (WebSocket)
-   - frontend-development (React)
-   - databases (lưu messages)
-
-5. Áp dụng workflow (workflows-guide.md):
-   - Dùng primary-workflow.md (nhiều giai đoạn)
-
-→ Kết quả: AI có kế hoạch đầy đủ để thực hiện
-```
-
-### Ví dụ 3: Yêu cầu mơ hồ
-
-```
-Bạn: "Làm cho app tốt hơn"
-
-Router nhận ra không đủ thông tin:
-- Đọc decision-flow.md
-- Không rõ: Tốt hơn về cái gì?
-
-→ AI hỏi lại: "Bạn muốn cải thiện về mặt nào? 
-   - Tốc độ (performance)?
-   - Giao diện (UI)?
-   - Tính năng mới?
-   - Sửa lỗi?"
-
-Bạn: "Tốc độ"
-
-→ Router chọn:
-   - Agent: debugger + planner
-   - Skill: arch-performance-optimization
-   - Command: /debug → /plan
-```
-
----
-
-## Hệ Thống Từ Khóa
-
-Router dùng từ khóa để nhận diện nhanh:
-
-### Từ khóa → Agent
-| Bạn nói | AI chọn Agent |
-|---------|---------------|
-| bug, lỗi, crash, không chạy | debugger |
-| code, viết, tạo, implement | fullstack-developer |
-| kế hoạch, architecture, thiết kế hệ thống | planner |
-| tìm, ở đâu, file nào | scout |
-| test, kiểm tra, coverage | tester |
-| đẹp, UI, giao diện | ui-ux-designer |
-
-### Từ khóa → Command
-| Bạn nói | AI chọn Command |
-|---------|-----------------|
-| sửa lỗi | /fix |
-| sửa nhanh | /fix/fast |
-| lỗi phức tạp | /fix/hard |
-| lỗi giao diện | /fix/ui |
-| lập kế hoạch | /plan |
-| kế hoạch chi tiết | /plan/hard |
-
-### Từ khóa → Skill
-| Bạn nói | AI load Skill |
-|---------|---------------|
-| React, component | frontend-development |
-| đẹp, stunning | ui-ux-pro-max |
-| database, SQL | databases |
-| login, OAuth | better-auth |
-| deploy, CI/CD | devops |
-
----
-
-## Tại Sao Cần Router?
-
-| ❌ Không có Router | ✅ Có Router |
-|-------------------|--------------|
-| AI làm bừa, không có hệ thống | AI làm theo quy trình chuẩn |
-| Dễ chọn sai công cụ | Luôn chọn đúng công cụ |
-| Thiếu hoặc thừa kiến thức | Load đúng kiến thức cần thiết |
-| Không nhất quán | Kết quả nhất quán, chất lượng |
-
----
-
-## Tóm Tắt
-
-| Khái niệm | Giải thích |
-|-----------|------------|
-| **Router là gì** | Bộ não giúp AI quyết định dùng gì |
-| **Có mấy file** | 5 files hướng dẫn |
-| **Hoạt động thế nào** | Phân tích từ khóa → Chọn agent/command/skill |
-| **Khi nào dùng** | Tự động, mỗi khi bạn đưa ra yêu cầu |
-
----
-
-## Xem Thêm
-
-- [Danh sách Agents (Vai trò)](../agents/README.md)
-- [Danh sách Commands (Quy trình)](../commands/README.md)
-- [Danh sách Skills (Kiến thức)](../skills/README.md)
-- [Danh sách Workflows (Phối hợp)](../workflows/README.md)

package/templates/router/agents-guide.md

@@ -1,38 +0,0 @@
-# Agents Guide
-
-> **Purpose**: Each agent file contains mindset, approach, and behavioral patterns for a specific role.
-> **Location**: `.claude/agents/<agent-name>.md`
-> **When to load**: After identifying the primary role needed for the task.
-
----
-
-## Available Agents
-
-| Trigger Keywords | Agent | Load File |
-|:---|:---|:---|
-| plan, architecture, system design, phase, roadmap | **Planner** | `.claude/agents/planner.md` |
-| code, implement, feature, logic, component | **Developer** | `.claude/agents/fullstack-developer.md` |
-| review, code quality, refactor, optimize code | **Reviewer** | `.claude/agents/code-reviewer.md` |
-| test, unit test, coverage, e2e, integration test | **Tester** | `.claude/agents/tester.md` |
-| bug, error, debug, log, trace, crash, exception | **Debugger** | `.claude/agents/debugger.md` |
-| find, search, scan, locate, where, which file | **Scout** | `.claude/agents/scout.md` |
-| external search, web, API docs, library docs | **Scout External** | `.claude/agents/scout-external.md` |
-| git, branch, commit, merge, conflict, PR | **Git Manager** | `.claude/agents/git-manager.md` |
-| database, SQL, schema, migration, query | **DB Admin** | `.claude/agents/database-admin.md` |
-| docs, documentation, README, changelog, notes | **Docs Manager** | `.claude/agents/docs-manager.md` |
-| UI, UX, interface, layout, wireframe | **UI/UX Designer** | `.claude/agents/ui-ux-designer.md` |
-| brainstorm, ideas, creative, suggestions | **Brainstormer** | `.claude/agents/brainstormer.md` |
-| content, copy, writing, marketing | **Copywriter** | `.claude/agents/copywriter.md` |
-| research, investigate, analyze, study | **Researcher** | `.claude/agents/researcher.md` |
-| MCP, tool, server, integration | **MCP Manager** | `.claude/agents/mcp-manager.md` |
-| project, task, deadline, management | **Project Manager** | `.claude/agents/project-manager.md` |
-| journal, diary, session log | **Journal Writer** | `.claude/agents/journal-writer.md` |
-
----
-
-## Usage Rules
-
-1. **Single agent for simple tasks**: Pick the most suitable one.
-2. **Multiple agents for complex tasks**: Chain them sequentially (e.g., Planner → Developer → Tester).
-3. **Load file to get mindset**: The agent file defines HOW to think and approach problems.
-4. **Combine with Command**: Agent = WHO, Command = WHAT workflow to follow.