@leejungkiin/awkit 1.0.0

package/workflows/context/user-intent-analysis-workflow.md

@@ -0,0 +1,206 @@
+---
+description: Phân tích và suy luận ý định thực sự của người dùng trước khi hành động.
+alwaysApply: true
+---
+
+# User Intent Analysis & Reasoning Workflow
+
+## Nguyên Tắc Cốt Lõi
+
+- **_BẮT BUỘC_** kiểm tra Beads task trước khi phân tích bất kỳ yêu cầu coding nào
+- **_BẮT BUỘC_** phân tích và suy luận ý định thực sự của người dùng
+- **_BẮT BUỘC_** đề xuất giải pháp tối ưu thay vì chỉ làm theo nghĩa đen
+- **_NGHIÊM CẤM_** bỏ qua Beads check kể cả khi user nói “nhanh lên”, “làm luôn”
+
+## ⛔ Pre-Analysis Beads Gate (LUÔN LUÔN CHẠY TRƯỚC)
+
+```bash
+# Trước khi phân tích bất kỳ yêu cầu coding/debug/plan:
+bd list --status in_progress
+
+# Nếu có task → Confirm: “Đây có liên quan đến Task #X không?”
+# Nếu không có → Tạo task mới sau khi confirm với user
+```
+
+
+
+## Trigger Conditions (Kích Hoạt)
+
+Workflow này được kích hoạt cho TẤT CẢ yêu cầu của người dùng, bao gồm:
+
+- Yêu cầu tạo/sửa code
+- Yêu cầu debug/fix lỗi
+- Yêu cầu thêm tính năng
+- Yêu cầu tối ưu hóa
+- Yêu cầu refactoring
+- Yêu cầu giải thích/hướng dẫn
+- Yêu cầu phân tích/review
+- Bất kỳ yêu cầu nào khác
+
+## Intent Analysis Process (Quy Trình Phân Tích Ý Định)
+
+### Phase 1: Request Parsing & Context Gathering
+
+```yaml
+steps:
+  1. parse_user_request:
+    - extract_explicit_requirements: "Những gì người dùng nói rõ ràng"
+    - identify_implicit_needs: "Những gì người dùng có thể cần nhưng chưa nói"
+    - detect_emotional_context: "Mức độ cấp thiết, frustration, confusion"
+
+  2. gather_project_context:
+    - check_project_identity: "Loại dự án, tech stack, mục tiêu"
+    - analyze_current_state: "Trạng thái hiện tại của codebase"
+    - review_recent_changes: "Những thay đổi gần đây"
+    - check_existing_plans: "Planning files, brainstorm documents"
+
+  3. assess_user_expertise:
+    - technical_level: "Beginner/Intermediate/Advanced"
+    - domain_knowledge: "Hiểu biết về lĩnh vực cụ thể"
+    - communication_style: "Formal/Casual, Vietnamese/English preference"
+```
+
+### Phase 2: Intent Classification & Analysis
+
+```yaml
+intent_categories:
+  immediate_fix:
+    description: "Sửa lỗi cấp thiết, unblock development"
+    priority: "High"
+    analysis_depth: "Quick but thorough"
+
+  feature_development:
+    description: "Thêm tính năng mới hoặc cải thiện existing"
+    priority: "Medium"
+    analysis_depth: "Comprehensive with suggestions"
+
+  learning_exploration:
+    description: "Hiểu cách hoạt động, học hỏi"
+    priority: "Low"
+    analysis_depth: "Educational with explanations"
+
+  optimization_improvement:
+    description: "Cải thiện performance, code quality"
+    priority: "Medium"
+    analysis_depth: "Detailed with alternatives"
+
+  planning_strategy:
+    description: "Lập kế hoạch, brainstorm, architecture"
+    priority: "High"
+    analysis_depth: "Strategic with long-term view"
+```
+
+### Phase 3: Root Cause & Goal Identification
+
+```yaml
+analysis_framework:
+  what_user_said:
+    - literal_request: "Yêu cầu đúng nghĩa đen"
+    - specific_details: "Chi tiết cụ thể được đề cập"
+
+  what_user_means:
+    - underlying_problem: "Vấn đề thực sự cần giải quyết"
+    - business_goal: "Mục tiêu kinh doanh/dự án"
+    - technical_goal: "Mục tiêu kỹ thuật"
+
+  what_user_needs:
+    - immediate_solution: "Giải pháp ngay lập tức"
+    - long_term_strategy: "Chiến lược dài hạn"
+    - knowledge_transfer: "Kiến thức cần truyền đạt"
+    - risk_mitigation: "Rủi ro cần tránh"
+```
+
+### Phase 4: Solution Strategy & Alternatives
+
+```yaml
+solution_generation:
+  primary_solution:
+    - direct_approach: "Giải pháp trực tiếp cho yêu cầu"
+    - pros_cons: "Ưu nhược điểm"
+    - implementation_effort: "Effort cần thiết"
+
+  alternative_solutions:
+    - better_approach: "Cách tiếp cận tốt hơn (nếu có)"
+    - simpler_solution: "Giải pháp đơn giản hơn"
+    - comprehensive_solution: "Giải pháp toàn diện hơn"
+
+  recommendation:
+    - suggested_approach: "Approach được đề xuất"
+    - reasoning: "Lý do tại sao đề xuất này"
+    - trade_offs: "Trade-offs cần cân nhắc"
+```
+
+## Reasoning Presentation Template
+
+```markdown
+## 🧠 Phân Tích Ý Định & Suy Luận
+
+### 📝 Yêu Cầu Của Bạn
+
+**Yêu cầu trực tiếp**: [Những gì user nói]
+**Ngữ cảnh dự án**: [Project context]
+**Mức độ ưu tiên**: [High/Medium/Low]
+
+### 🎯 Ý Định Thực Sự (Phân Tích)
+
+**Vấn đề cần giải quyết**: [Root problem]
+**Mục tiêu cuối cùng**: [End goal]
+**Tại sao cần làm**: [Business/technical justification]
+
+### 💡 Phân Tích Giải Pháp
+
+#### ✅ Giải Pháp Đề Xuất (Recommended)
+
+- **Approach**: [Recommended solution]
+- **Lý do**: [Why this is better]
+- **Effort**: [Implementation effort]
+- **Benefits**: [Key benefits]
+
+#### 🔄 Các Lựa Chọn Khác
+
+1. **[Alternative 1]**: [Description] - [Pros/Cons]
+2. **[Alternative 2]**: [Description] - [Pros/Cons]
+
+### ⚠️ Cân Nhắc Quan Trọng
+
+- **Rủi ro**: [Potential risks]
+- **Dependencies**: [What this depends on]
+- **Impact**: [How this affects other parts]
+
+### 🤔 Xác Nhận Hiểu Đúng
+
+**Tôi hiểu bạn muốn**: [Summary of understanding]
+**Approach tôi đề xuất**: [Recommended approach]
+**Có đúng không?** [Request confirmation]
+
+---
+
+_Nếu tôi hiểu đúng, tôi sẽ tiến hành với approach được đề xuất. Nếu không, hãy cho tôi biết điều chỉnh!_
+```
+
+## Quality Assurance
+
+### Analysis Quality Metrics
+
+```yaml
+quality_indicators:
+  understanding_accuracy:
+    - user_confirms_understanding: "User says 'yes, exactly'"
+    - no_follow_up_corrections: "No need to re-explain"
+    - solution_addresses_root_cause: "Solves the real problem"
+
+  solution_effectiveness:
+    - prevents_future_issues: "Addresses underlying problems"
+    - aligns_with_project_goals: "Supports overall objectives"
+    - considers_long_term_impact: "Sustainable solution"
+```
+
+## Implementation Guidelines
+
+### For AI Assistant
+
+1. **Always start with analysis** - Never jump straight to implementation
+2. **Show your reasoning** - Make thought process transparent
+3. **Seek confirmation** - Ensure understanding before proceeding
+4. **Offer alternatives** - Present multiple approaches when applicable
+5. **Consider context** - Factor in project state and user expertise

package/workflows/expert/codeExpert.md

@@ -0,0 +1,126 @@
+---
+description: 💻 Code ngay lập tức (Expert Mode)
+---
+
+# WORKFLOW: /codeExpert - Instant Coding
+
+> **Expert Mode Only:** Code ngay dựa trên spec/plan, không hỏi gì cả.
+
+---
+
+## Usage
+
+```bash
+/codeExpert [target]
+```
+
+**Examples:**
+```bash
+/codeExpert phase-01           # Code toàn bộ phase 01
+/codeExpert "Login API"        # Code task cụ thể
+/codeExpert                    # Code task tiếp theo (auto-detect từ Beads)
+```
+
+---
+
+## Execution Flow
+
+### 1. Context Detection (Auto)
+
+**Priority 1: Beads**
+```bash
+bd list --status in_progress
+```
+- Nếu có → Resume task đó
+- Nếu không → Check `bd list --status open` → Pick P0 task
+
+**Priority 2: Argument**
+- Nếu có `phase-XX` → Load phase file
+- Nếu có task name → Search trong plan
+
+**Priority 3: Brain**
+- Đọc `brain/active_plans.json` → Load plan mới nhất
+
+### 2. Load Spec/Plan
+- Đọc spec từ `docs/specs/` hoặc phase file
+- Parse requirements và implementation steps
+
+### 3. Execute (Zero Questions)
+- Viết code theo spec
+- Tự động thêm:
+  - Input validation
+  - Error handling
+  - Type safety
+  - Comments (minimal, code tự giải thích)
+
+### 4. Auto-Test
+- Chạy test liên quan (nếu có)
+- Fix lỗi tự động (max 3 lần)
+- Nếu fail sau 3 lần → Tạo Beads task "Fix test for [Feature]"
+
+### 5. Update Beads
+```bash
+bd update [task-id] --status done
+```
+
+### 6. Report
+```
+✅ **CODE COMPLETE**
+
+📝 **Task:** Implement Login API
+📂 **Files:**
+- src/api/auth/login.ts (created)
+- src/api/auth/login.test.ts (created)
+
+✅ **Tests:** 5/5 passed
+
+📿 **Beads:** Task #123 → Done
+
+➡️ **Next:** /codeExpert (Auto-pick next task)
+```
+
+---
+
+## Assumptions (Expert Mode)
+
+AI sẽ tự động quyết định:
+- ✅ File structure (theo project conventions)
+- ✅ Naming conventions (camelCase/PascalCase based on language)
+- ✅ Error handling strategy (try-catch + logging)
+- ✅ Test coverage (critical paths only)
+
+**Không hỏi về code quality level.** Mặc định: **PRODUCTION**.
+
+---
+
+## Error Handling
+
+### No Context
+```
+❌ Error: No active task or plan found
+
+Suggestions:
+1. Create plan first: /planExpert "Feature"
+2. Specify target: /codeExpert "Task Name"
+3. Check Beads: bd list
+```
+
+### Test Fail (After 3 Retries)
+```
+⚠️ Auto-fix failed after 3 attempts
+
+📿 Created task: #456 "Fix test for Login API"
+
+Options:
+1. Debug manually: /debugExpert
+2. Skip tests: /codeExpert --skip-tests (Not recommended)
+3. Continue next task: /codeExpert
+```
+
+---
+
+## Integration
+
+- **Beads:** Auto-update task status
+- **Brain:** Auto-save code patterns to knowledge base
+- **Git:** Auto-stage changes (optional)

package/workflows/expert/debugExpert.md

@@ -0,0 +1,136 @@
+---
+description: 🐞 Sửa lỗi tự động (Expert Mode)
+---
+
+# WORKFLOW: /debugExpert - Auto Debug & Fix
+
+> **Expert Mode Only:** Tự động phân tích và sửa lỗi, không hỏi gì cả.
+
+---
+
+## Usage
+
+```bash
+/debugExpert [file]
+```
+
+**Examples:**
+```bash
+/debugExpert                          # Auto-detect lỗi từ logs
+/debugExpert src/api/auth/login.ts    # Debug file cụ thể
+```
+
+---
+
+## Execution Flow
+
+### 1. Error Detection (Auto)
+
+**Source Priority:**
+1. Terminal output (last 100 lines)
+2. Log files (`logs/*.log`)
+3. Test failures (Jest/Mocha/XCTest output)
+4. Linter errors (ESLint/SwiftLint)
+
+**Parse:**
+- Error type
+- File & line number
+- Stack trace
+- Error message
+
+### 2. Root Cause Analysis (Auto)
+
+**Common Patterns:**
+- `undefined/null` → Add null check
+- `Module not found` → Add import
+- `Type error` → Fix type annotation
+- `API 401/403` → Check auth token
+- `API 500` → Check server logs
+- `CORS` → Update server config
+
+### 3. Auto-Fix (Safe Only)
+
+**Safe-to-Fix:**
+- ✅ Missing imports
+- ✅ Typos in variable names
+- ✅ Undefined checks (`if (x)` before `x.map()`)
+- ✅ Type annotations
+- ✅ Linting issues
+
+**Need-Review:**
+- ⚠️ Logic errors → Create Beads task
+- ⚠️ Security issues → Create Beads task + Alert
+- ⚠️ Performance issues → Create Beads task
+
+### 4. Verify Fix
+
+- Chạy lại test/linter
+- Nếu pass → Done
+- Nếu fail → Rollback + Create Beads task
+
+### 5. Report
+
+```
+✅ **DEBUG COMPLETE**
+
+🐛 **Issue:** TypeError: Cannot read 'map' of undefined
+📂 **File:** src/components/ProductList.tsx:42
+
+🔧 **Fix Applied:**
+Added null check before mapping products array
+
+✅ **Verification:** Tests passed
+
+📿 **Beads:** No new tasks (auto-fixed)
+
+➡️ **Next:** /codeExpert (Continue coding)
+```
+
+---
+
+## Assumptions (Expert Mode)
+
+AI sẽ tự động quyết định:
+- ✅ Fix strategy (null check vs default value vs error throw)
+- ✅ Test coverage (add test for fixed bug)
+- ✅ Rollback on failure
+
+**Không hỏi về fix approach.** Chọn cách an toàn nhất.
+
+---
+
+## Error Handling
+
+### Cannot Auto-Fix
+```
+⚠️ Cannot auto-fix: Complex logic error
+
+📿 Created task: #789 "Fix logic error in calculateTotal()"
+
+📋 **Analysis:**
+- Issue: Calculation returns negative value
+- Root cause: Missing validation for discount > price
+- Suggested fix: Add validation before calculation
+
+➡️ **Next:** 
+1. Fix manually: Open task #789
+2. Get help: /debug (Guided Mode)
+```
+
+### Multiple Errors
+```
+⚠️ Found 5 errors
+
+✅ Auto-fixed: 3 errors
+📿 Created tasks: 2 errors (#790, #791)
+
+➡️ **Next:** bd list --label bug
+```
+
+---
+
+## Integration
+
+- **Beads:** Auto-create tasks for complex bugs
+- **Brain:** Save bug patterns to `brain/bugs/`
+- **Git:** Auto-commit fixes with message "fix: [description]"

package/workflows/expert/planExpert.md

@@ -0,0 +1,112 @@
+---
+description: 📝 Thiết kế tính năng (Expert Mode - Zero Questions)
+---
+
+# WORKFLOW: /planExpert - Instant Plan Generation
+
+> **Expert Mode Only:** Tạo plan ngay lập tức, không hỏi gì cả.
+
+---
+
+## Usage
+
+```bash
+/planExpert "Feature Name"
+```
+
+**Example:**
+```bash
+/planExpert "E-commerce Shopping Cart"
+```
+
+---
+
+## Execution Flow
+
+### 1. Parse Input
+- Extract feature name from argument.
+- If missing → Error: "Usage: /planExpert \"Feature Name\""
+
+### 2. Auto-Generate Spec
+- Tạo `docs/specs/[feature-slug]_spec.md` với:
+  - Executive Summary
+  - User Stories (3-5 stories cơ bản)
+  - Database Design (ERD chuẩn)
+  - API Contract (RESTful endpoints)
+  - UI Components (danh sách components)
+
+### 3. Auto-Generate Phases
+- Tạo `plans/[YYMMDD]-[HHMM]-[feature-slug]/`
+- Số phases tự động dựa trên complexity:
+  - Simple: 4 phases (Setup → Backend → Frontend → Test)
+  - Medium: 6 phases (+ Database + Integration)
+  - Complex: 8+ phases (+ Auth + Deploy + Monitoring)
+
+### 4. Sync to Beads
+```bash
+for each phase:
+  bd create "Phase X: [Name]" --priority [0-2]
+  
+for each task in phase:
+  bd create "[Task Name]" --parent [Phase ID]
+```
+
+### 5. Report
+```
+✅ **PLAN CREATED**
+
+📁 Location: plans/260130-1025-shopping-cart/
+📋 Spec: docs/specs/shopping-cart_spec.md
+
+📊 **Structure:**
+- 6 Phases
+- 42 Tasks
+- Estimated: 3-4 sessions
+
+📿 **Beads:**
+- Created 6 phase tasks
+- Created 42 sub-tasks
+- Ready to start: bd list
+
+➡️ **Next:** /codeExpert phase-01
+```
+
+---
+
+## Assumptions (Expert Mode)
+
+AI sẽ tự động quyết định:
+- ✅ Tech stack (dựa trên `.project-identity`)
+- ✅ Database schema (chuẩn 3NF)
+- ✅ API design (RESTful best practices)
+- ✅ UI components (Material/Tailwind based on project)
+- ✅ Test strategy (Unit + Integration)
+
+**Không hỏi gì cả.** Nếu cần customize → Dùng `/plan` (Guided Mode).
+
+---
+
+## Error Handling
+
+### Missing Feature Name
+```
+❌ Error: Feature name required
+Usage: /planExpert "Feature Name"
+```
+
+### Duplicate Plan
+```
+⚠️ Warning: Plan for "Shopping Cart" already exists at plans/260128-1430-shopping-cart/
+
+Options:
+1. Overwrite? /planExpert "Shopping Cart" --force
+2. Create new version? (Auto-append v2)
+```
+
+---
+
+## Integration
+
+- **Brain:** Auto-save to `brain/active_plans.json`
+- **Beads:** Auto-create tasks with dependencies
+- **Git:** Auto-commit plan files (optional)

package/workflows/git/cloudflare-tunnel.md

@@ -0,0 +1,135 @@
+---
+description: 🌐 Quản lý Cloudflare Tunnel
+---
+
+# Cloudflare Tunnel Configuration
+
+## ⚠️ QUAN TRỌNG - ĐỌC TRƯỚC KHI THAY ĐỔI
+
+Hệ thống sử dụng **MỘT tunnel duy nhất** cho nhiều services. KHÔNG tạo tunnel mới, chỉ thêm hostname vào config hiện có.
+
+---
+
+## 📋 Hiện Trạng (Cập nhật: 2026-01-13)
+
+### Tunnel đang sử dụng
+| Thuộc tính | Giá trị |
+|------------|---------|
+| **Tunnel ID** | `aa304557-6390-44bd-a052-7d7fe2a6e7d6` |
+| **Tunnel Name** | `revenue-bot` |
+| **Domain** | `ebebot.click` |
+| **Chạy như** | Windows Scheduled Task (`CloudflaredTunnel`) dưới SYSTEM account |
+
+### Scheduled Tasks (chạy khi startup)
+| Task Name | Executable | Mô tả |
+|-----------|------------|-------|
+| `CloudflaredTunnel` | `cloudflared.exe tunnel run` | Cloudflare Tunnel daemon |
+| `WebhookServer` | `node.exe D:\revenue-bot\webhook-server.js` | LINE Bot webhook server (port 39412) |
+
+### Hostname đã cấu hình
+| Hostname | Service (Port) | Mô tả |
+|----------|----------------|-------|
+| `webhook.ebebot.click` | `http://localhost:39412` | LINE Bot webhook server |
+| `pg.ebebot.click` | `http://localhost:8888` | Erablue App (Docker production) |
+
+### Config file locations
+| User | Path |
+|------|------|
+| **SYSTEM (production)** | `C:\Windows\System32\config\systemprofile\.cloudflared\config.yml` |
+| **Backend user** | `C:\Users\15931 - Backend\.cloudflared\config.yml` |
+
+---
+
+## 🔧 Cách Thêm Hostname Mới
+
+### Bước 1: Cập nhật config.yml
+Thêm hostname mới vào **TRƯỚC** dòng `- service: http_status:404`:
+
+```yaml
+tunnel: aa304557-6390-44bd-a052-7d7fe2a6e7d6
+credentials-file: C:\Windows\System32\config\systemprofile\.cloudflared\aa304557-6390-44bd-a052-7d7fe2a6e7d6.json
+ingress:
+  - hostname: webhook.ebebot.click
+    service: http://localhost:39412
+  - hostname: pg.ebebot.click
+    service: http://localhost:8888
+  # === THÊM HOSTNAME MỚI Ở ĐÂY ===
+  - hostname: new-service.ebebot.click
+    service: http://localhost:XXXX
+  # ================================
+  - service: http_status:404  # <-- LUÔN ĐỂ CUỐI CÙNG
+```
+
+### Bước 2: Thêm DNS route
+```powershell
+cloudflared tunnel route dns aa304557-6390-44bd-a052-7d7fe2a6e7d6 new-service.ebebot.click
+```
+
+### Bước 3: Restart tunnel (PowerShell Admin)
+```powershell
+Stop-ScheduledTask -TaskName "CloudflaredTunnel"
+Start-Sleep 2
+Start-ScheduledTask -TaskName "CloudflaredTunnel"
+```
+
+### Bước 4: Verify
+```powershell
+curl https://new-service.ebebot.click
+```
+
+---
+
+## ⚠️ Các Lỗi Thường Gặp
+
+### Lỗi 1033 - Tunnel không kết nối
+**Nguyên nhân**: Cloudflared không chạy hoặc credentials sai
+**Giải pháp**:
+```powershell
+# Kiểm tra process
+tasklist /FI "IMAGENAME eq cloudflared.exe"
+
+# Nếu không chạy, start lại task
+Start-ScheduledTask -TaskName "CloudflaredTunnel"
+```
+
+### Lỗi 502 - Bad Gateway
+**Nguyên nhân**: Service backend không chạy hoặc port sai
+**Giải pháp**: Kiểm tra port đúng chưa
+```powershell
+netstat -ano | findstr ":PORT_NUMBER"
+```
+
+### Lỗi "Failed to add route: record already exists"
+**Nguyên nhân**: DNS record đã tồn tại
+**Giải pháp**: Vào Cloudflare Dashboard → DNS → xóa record cũ → chạy lại lệnh
+
+---
+
+## 📁 Credentials & Files
+
+| File | Mô tả |
+|------|-------|
+| `aa304557-...7d6.json` | Tunnel credentials (KHÔNG xóa!) |
+| `cert.pem` | Account certificate |
+| `config.yml` | Ingress rules |
+
+---
+
+## 🚫 KHÔNG LÀM
+
+1. ❌ KHÔNG tạo tunnel mới - chỉ thêm hostname vào tunnel hiện có
+2. ❌ KHÔNG xóa file `.json` credentials
+3. ❌ KHÔNG chạy cloudflared thủ công (dùng Scheduled Task)
+4. ❌ KHÔNG dùng tunnel cũ `d164e5de-...` (đã hỏng)
+
+---
+
+## ✅ Checklist Khi Thêm Service Mới
+
+- [ ] Service đang chạy ở localhost:PORT?
+- [ ] Port đã confirm bằng `netstat`?
+- [ ] Đã thêm hostname vào config.yml (SYSTEM path)?
+- [ ] Đã chạy `cloudflared tunnel route dns`?
+- [ ] Đã restart Scheduled Task?
+- [ ] Đã test bằng curl/browser?
+- [ ] Đã cập nhật bảng "Hostname đã cấu hình" trong file này?