thanh-kit 2.5.0

package/templates/output-styles/coding-level-5-god.md

@@ -0,0 +1,91 @@
+---
+name: God Mode (Level 5)
+description: Maximum velocity, zero hand-holding - for 15+ years experience or domain experts
+keep-coding-instructions: true
+---
+
+# God Mode Communication
+
+You are pair programming with an expert (15+ years, or deep domain specialist). They likely know the answer already and want validation, a second opinion, or just faster typing. Stay out of the way. Be a force multiplier, not a teacher.
+
+---
+
+## MANDATORY RULES (You MUST follow ALL of these)
+
+### Communication Rules
+1. **MUST** answer exactly what was asked - nothing more
+2. **MUST** default to code, not prose
+3. **MUST** assume they understand everything - zero explanation unless asked
+4. **MUST** be terse - every word must earn its place
+5. **MUST** challenge their approach if you see a critical flaw (they want a peer, not a yes-man)
+
+### Code Rules
+1. **MUST** show production-ready code immediately
+2. **MUST** use advanced patterns without explanation
+3. **MUST** optimize for their stated constraints (perf, readability, safety - whatever they care about)
+4. **MUST** include edge cases only if non-obvious
+5. **MUST** trust their judgment on style, naming, architecture
+
+### Interaction Rules
+1. **MUST** match their communication style and pace
+2. **MUST** offer alternatives only when genuinely superior
+3. **MUST** flag only critical issues (security holes, data loss, production outages)
+4. **MUST** skip the "here's what I did" - just show it
+5. **MUST** respect their time as the most valuable resource
+
+---
+
+## FORBIDDEN at this level (You MUST NOT do these)
+
+1. **NEVER** explain concepts, patterns, or syntax
+2. **NEVER** add context, background, or motivation
+3. **NEVER** use phrases like "Here's how...", "Let me explain...", "This works by..."
+4. **NEVER** add comments unless they request it
+5. **NEVER** include "Key Takeaways", summaries, or next steps
+6. **NEVER** ask clarifying questions for minor ambiguities - make reasonable assumptions
+7. **NEVER** pad responses with alternatives unless they're meaningfully better
+8. **NEVER** treat them like they need hand-holding
+9. **NEVER** use filler words or hedging language
+10. **NEVER** repeat back what they asked
+
+---
+
+## Response Format
+
+No required structure. Match the request:
+
+- **"How do I X?"** → Code block. Done.
+- **"What's wrong with X?"** → Point to the bug. One sentence max.
+- **"Which approach?"** → One-liner recommendation + brief rationale if non-obvious.
+- **"Review this"** → Bullet points of issues. No praise.
+- **Complex question** → Minimal prose + code. No sections.
+
+---
+
+## Example Response Pattern
+
+**Question:** "How should I handle API errors in my service layer?"
+
+**Response:**
+
+```typescript
+type ApiError =
+  | { type: 'network'; retryable: true }
+  | { type: 'auth'; retryable: false }
+  | { type: 'notFound'; resource: string }
+  | { type: 'validation'; fields: Record<string, string> };
+
+type Result<T, E = ApiError> = { ok: true; data: T } | { ok: false; error: E };
+
+async function getUser(id: string): Promise<Result<User>> {
+  try {
+    const res = await this.http.get(`/users/${id}`);
+    return { ok: true, data: res.data };
+  } catch (e) {
+    return { ok: false, error: this.classify(e) };
+  }
+}
+```
+
+Result pattern. Classify at the edge, pattern match at call sites.
+

package/templates/router/README.md

@@ -0,0 +1,294 @@
+# 🧭 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

@@ -0,0 +1,38 @@
+# 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.

package/templates/router/commands-guide.md

@@ -0,0 +1,122 @@
+# Commands Guide
+
+> **Purpose**: Each command file contains step-by-step workflow for a specific task type.
+> **Location**: `.claude/commands/<command>.md` or `.claude/commands/<category>/<variant>.md`
+> **When to load**: After selecting an Agent, to know the exact steps to execute.
+
+---
+
+## Main Commands
+
+| Trigger | Command | Load File |
+|:---|:---|:---|
+| code, write code, implement | `/code` | `.claude/commands/code.md` |
+| fix, fix bug, fix error | `/fix` | `.claude/commands/fix.md` |
+| test, run tests | `/test` | `.claude/commands/test.md` |
+| plan, make plan | `/plan` | `.claude/commands/plan.md` |
+| review, review code | `/review-changes` | `.claude/commands/review-changes.md` |
+| build, compile, package | `/build` | `.claude/commands/build.md` |
+| debug, investigate | `/debug` | `.claude/commands/debug.md` |
+| scout, search | `/scout` | `.claude/commands/scout.md` |
+| brainstorm | `/brainstorm` | `.claude/commands/brainstorm.md` |
+
+---
+
+## Sub-commands (Specialized Variants)
+
+### Code Variants
+| Trigger | Load File |
+|:---|:---|
+| auto code, automatic | `.claude/commands/code/auto.md` |
+| code without tests | `.claude/commands/code/no-test.md` |
+| parallel coding | `.claude/commands/code/parallel.md` |
+
+### Fix Variants
+| Trigger | Load File |
+|:---|:---|
+| quick fix | `.claude/commands/fix/fast.md` |
+| hard fix, complex bug | `.claude/commands/fix/hard.md` |
+| fix UI issue | `.claude/commands/fix/ui.md` |
+| fix failing tests | `.claude/commands/fix/test.md` |
+| fix type errors, typescript | `.claude/commands/fix/types.md` |
+| fix CI/CD | `.claude/commands/fix/ci.md` |
+| fix from logs | `.claude/commands/fix/logs.md` |
+| parallel fixing | `.claude/commands/fix/parallel.md` |
+
+### Plan Variants
+| Trigger | Load File |
+|:---|:---|
+| quick plan | `.claude/commands/plan/fast.md` |
+| complex plan | `.claude/commands/plan/hard.md` |
+| parallel planning | `.claude/commands/plan/parallel.md` |
+| two-phase plan | `.claude/commands/plan/two.md` |
+| validate plan | `.claude/commands/plan/validate.md` |
+| archive plan | `.claude/commands/plan/archive.md` |
+| CRO plan | `.claude/commands/plan/cro.md` |
+
+### Git Commands
+| Trigger | Load File |
+|:---|:---|
+| commit | `.claude/commands/git/cm.md` |
+| cherry-pick | `.claude/commands/git/cp.md` |
+| merge | `.claude/commands/git/merge.md` |
+| PR, pull request | `.claude/commands/git/pr.md` |
+
+### Docs Commands
+| Trigger | Load File |
+|:---|:---|
+| init docs | `.claude/commands/docs/init.md` |
+| update docs | `.claude/commands/docs/update.md` |
+| summarize docs | `.claude/commands/docs/summarize.md` |
+
+### Design Commands
+| Trigger | Load File |
+|:---|:---|
+| quick design | `.claude/commands/design/fast.md` |
+| good design | `.claude/commands/design/good.md` |
+| design from screenshot | `.claude/commands/design/screenshot.md` |
+| design from video | `.claude/commands/design/video.md` |
+| 3D design | `.claude/commands/design/3d.md` |
+| describe design | `.claude/commands/design/describe.md` |
+
+### Review Commands
+| Trigger | Load File |
+|:---|:---|
+| review codebase | `.claude/commands/review/codebase.md` |
+| post-task review | `.claude/commands/review/post-task.md` |
+
+### Skill Management
+| Trigger | Load File |
+|:---|:---|
+| add skill | `.claude/commands/skill/add.md` |
+| create skill | `.claude/commands/skill/create.md` |
+| plan skill | `.claude/commands/skill/plan.md` |
+| optimize skill | `.claude/commands/skill/optimize.md` |
+
+### Other Commands
+| Trigger | Load File |
+|:---|:---|
+| bootstrap project | `.claude/commands/bootstrap.md` |
+| create feature | `.claude/commands/create-feature.md` |
+| db migrate | `.claude/commands/db-migrate.md` |
+| generate DTO | `.claude/commands/generate-dto.md` |
+| lint | `.claude/commands/lint.md` |
+| kanban | `.claude/commands/kanban.md` |
+| preview | `.claude/commands/preview.md` |
+| worktree | `.claude/commands/worktree.md` |
+| use MCP | `.claude/commands/use-mcp.md` |
+| cook (recipe) | `.claude/commands/cook.md` |
+| journal | `.claude/commands/journal.md` |
+| watzup (status) | `.claude/commands/watzup.md` |
+| coding level | `.claude/commands/coding-level.md` |
+| ask (Q&A) | `.claude/commands/ask.md` |
+| scout external | `.claude/commands/scout/ext.md` |
+| test UI | `.claude/commands/test/ui.md` |
+
+---
+
+## Usage Rules
+
+1. **Prefer specific over generic**: Use `/fix/ui` instead of `/fix` when fixing UI bugs.
+2. **Command = Workflow**: The file contains exact steps to follow.
+3. **Combine with Agent**: Agent defines mindset, Command defines process.

package/templates/router/decision-flow.md

@@ -0,0 +1,92 @@
+# Decision Flow - How AI Routes Requests
+
+## Request Processing Pipeline
+
+```
+User Request
+    │
+    ▼
+┌─────────────────────────────────────────────────────────┐
+│ STEP 1: Analyze Request                                 │
+│ - Identify WORK TYPE (code/fix/test/plan/review...)     │
+│ - Identify DOMAIN (frontend/backend/database/devops...) │
+│ - Identify COMPLEXITY (simple/complex/multi-step)       │
+└─────────────────────────────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────────────────────────────┐
+│ STEP 2: Select Agent (PRIMARY ROLE)                     │
+│ - Simple task: Pick 1 most suitable Agent               │
+│ - Complex task: May need multiple Agents coordination   │
+│ → Load file `.claude/agents/<agent-name>.md` for mindset│
+│ → See: .claude/router/agents-guide.md                   │
+└─────────────────────────────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────────────────────────────┐
+│ STEP 3: Select Command (WORKFLOW)                       │
+│ - Identify main command (code/fix/test/plan...)         │
+│ - If more specific variant exists, use sub-command      │
+│ → Load file `.claude/commands/<command>.md` for steps   │
+│ → See: .claude/router/commands-guide.md                 │
+└─────────────────────────────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────────────────────────────┐
+│ STEP 4: Load Skill (EXPERT KNOWLEDGE) - IF NEEDED       │
+│ - Scan keywords in request                              │
+│ - Only load when deep expertise is required             │
+│ → Load file `.claude/skills/<skill>/SKILL.md`           │
+│ → See: .claude/router/skills-guide.md                   │
+└─────────────────────────────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────────────────────────────┐
+│ STEP 5: Apply Workflow (IF large/complex task)          │
+│ - New feature → primary-workflow.md                     │
+│ - Multi-agent → orchestration-protocol.md               │
+│ → Load file `.claude/workflows/<workflow>.md`           │
+│ → See: .claude/router/workflows-guide.md                │
+└─────────────────────────────────────────────────────────┘
+    │
+    ▼
+  EXECUTE
+```
+
+---
+
+## Quick Decision Matrix
+
+| Situation | Agent | Command | Skill | Workflow |
+|:---|:---|:---|:---|:---|
+| Small bug, clear cause | Debugger | `/fix/fast` | ❌ | ❌ |
+| Hard bug, needs investigation | Debugger | `/fix/hard` | `debugging/` | ❌ |
+| New feature code | Developer | `/code` | By domain | `primary-workflow` |
+| Create unit tests | Tester | `/test` | `test-generation/` | ❌ |
+| Code review before merge | Reviewer | `/review-changes` | `code-review/` | ❌ |
+| Plan large task | Planner | `/plan` | `planning/` | ❌ |
+| Find file/function in repo | Scout | `/scout` | ❌ | ❌ |
+| Create PR with proper message | Git Manager | `/git/pr` | ❌ | ❌ |
+| Design UI from screenshot | UI/UX Designer | `/design/screenshot` | `frontend-design/` | ❌ |
+| Complex multi-step task | Planner → Developer → Tester | `/plan` → `/code` → `/test` | Multiple | `primary-workflow` |
+
+---
+
+## Selection Principles
+
+1. **Agent**: Always pick 1 primary agent. Only coordinate multiple agents when truly needed.
+2. **Command**: Prefer specific sub-command over generic command (e.g., `/fix/ui` over `/fix`).
+3. **Skill**: Only load when deep expertise is required. Skip for simple tasks.
+4. **Workflow**: Only use for large, multi-step tasks requiring orchestration.
+
+---
+
+## Example Routing
+
+| User Request | → Agent | → Command | → Skill | → Workflow |
+|:---|:---|:---|:---|:---|
+| "Fix UI bug" | `.claude/agents/debugger.md` | `.claude/commands/fix/ui.md` | ❌ | ❌ |
+| "Write tests for feature X" | `.claude/agents/tester.md` | `.claude/commands/test.md` | `.claude/skills/test-generation/` | ❌ |
+| "Create PR" | `.claude/agents/git-manager.md` | `.claude/commands/git/pr.md` | ❌ | ❌ |
+| "Optimize performance" | `.claude/agents/developer.md` | `.claude/commands/code.md` | `.claude/skills/arch-performance-optimization/` | ❌ |
+| "Plan microservice architecture" | `.claude/agents/planner.md` | `.claude/commands/plan.md` | `.claude/skills/arch-cross-service-integration/` | `.claude/workflows/primary-workflow` |