@leejungkiin/awkit 1.0.0

package/skills/beads-manager/SKILL.md

@@ -0,0 +1,323 @@
+---
+name: beads-manager
+description: Smart Beads task management with Brain integration
+trigger: always
+---
+
+# Beads Manager Skill (v5.0)
+
+> **Purpose:** Quản lý tasks trong Beads với Brain context awareness.
+
+---
+
+## Core Functions
+
+### 1. Smart Task Creation
+
+**Auto-Context:**
+```bash
+# Khi tạo task, tự động:
+1. Detect current plan/phase từ Brain
+2. Link task to parent phase
+3. Set priority based on dependencies
+4. Add relevant labels
+```
+
+**Example:**
+```bash
+# User gõ
+bd create "Fix login bug"
+
+# Skill auto-enhance
+bd create "Fix login bug" \
+  --parent $CURRENT_PHASE_TASK \
+  --label bug \
+  --priority 0 \
+  --note "Related to plan: Shopping Cart, Phase 02"
+```
+
+---
+
+### 2. Task Status Tracking
+
+**Auto-Update:**
+```bash
+# Khi workflow hoàn thành
+/codeExpert → Auto: bd update $TASK_ID --status done
+
+# Khi gặp blocker
+/debugExpert fail → Auto: bd update $TASK_ID --status blocked
+```
+
+**Status Sync:**
+- `open` → Task mới tạo
+- `in_progress` → Đang làm
+- `blocked` → Bị chặn bởi task khác
+- `done` → Hoàn thành
+- `cancelled` → Hủy bỏ
+
+---
+
+### 3. Dependency Management
+
+**Auto-Detect:**
+```bash
+# Khi tạo task từ plan
+Phase 01 → Task A, B, C
+Phase 02 → Task D, E (depends on Phase 01)
+
+# Auto-create dependencies
+bd dep add D A
+bd dep add D B
+bd dep add D C
+```
+
+**Blocker Alert:**
+```bash
+# Khi user chọn task bị block
+/codeExpert → Check dependencies
+→ "Task #125 blocked by #120 (not done yet)"
+→ Suggest: "Do task #120 first?"
+```
+
+---
+
+### 4. Task Filtering & Search
+
+**Smart Filters:**
+```bash
+# By status
+bd list --status open
+bd list --status in_progress
+
+# By label
+bd list --label bug
+bd list --label feature
+
+# By priority
+bd list --priority 0    # Critical
+bd list --priority 1    # High
+bd list --priority 2    # Normal
+
+# Ready to work (no blockers)
+bd ready
+```
+
+---
+
+### 5. Task Completion Flow
+
+**When task done:**
+```bash
+1. bd update $TASK_ID --status done
+2. Check if phase complete (all tasks done)
+3. If phase complete → Update plan.md progress
+4. Suggest next task: bd ready
+5. Prompt: "Save knowledge? /save-brain"
+```
+
+---
+
+## Integration with Workflows
+
+### `/planExpert` Integration
+
+```bash
+# After plan generation
+1. Call sync_plan_to_beads.sh
+2. Create parent + phase + task hierarchy
+3. Set dependencies
+4. Report: "Created 42 tasks in Beads"
+```
+
+### `/codeExpert` Integration
+
+```bash
+# Before coding
+1. bd list --status in_progress
+2. If found → Resume that task
+3. If not → bd ready → Pick P0 task
+4. Update task status to in_progress
+
+# After coding
+1. Run tests
+2. If pass → bd update --status done
+3. If fail → bd update --status blocked + create bug task
+```
+
+### `/debugExpert` Integration
+
+```bash
+# When bug found
+1. bd create "Fix: $ERROR_MESSAGE" --label bug --priority 0
+2. Link to failing task (if any)
+3. After fix → bd update --status done
+```
+
+---
+
+## Brain Integration
+
+### Active Plans Tracking
+
+```json
+// brain/active_plans.json
+{
+  "current": {
+    "plan_path": "plans/260130-1025-shopping-cart/",
+    "feature": "Shopping Cart",
+    "beads_parent_id": 456,
+    "phases": [
+      {
+        "name": "Phase 01: Setup",
+        "beads_id": 457,
+        "status": "done"
+      },
+      {
+        "name": "Phase 02: Backend",
+        "beads_id": 458,
+        "status": "in_progress",
+        "tasks": [123, 124, 125]
+      }
+    ]
+  }
+}
+```
+
+### Task-Knowledge Linking
+
+```bash
+# When save knowledge
+/save-brain "How to fix N+1 query"
+
+# Auto-link to current task
+→ Save to: brain/solutions/n1-query-fix_#123.md
+→ Add reference in task: bd update 123 --note "Solution: brain/solutions/..."
+```
+
+---
+
+## Commands Reference
+
+### Basic Commands
+
+```bash
+# Create task
+bd create "Task name" [--priority 0-2] [--label tag]
+
+# List tasks
+bd list [--status STATUS] [--label LABEL]
+
+# Update task
+bd update <id> --status STATUS
+
+# Show task details
+bd show <id>
+
+# Add dependency
+bd dep add <child> <parent>
+
+# Ready tasks (no blockers)
+bd ready
+```
+
+### Enhanced Commands (via Skill)
+
+```bash
+# Smart create (auto-context)
+/task "Task name"    # Alias, auto-add context
+
+# Quick status
+/todo                # Alias for bd list
+/done "Note"         # Mark current task done + save note
+
+# Task navigation
+/next                # Show next recommended task
+```
+
+---
+
+## Error Handling
+
+### Beads Not Available
+
+```bash
+if ! command -v bd &> /dev/null; then
+    echo "⚠️ Beads not installed"
+    echo "Fallback: Use Brain-only mode"
+    # Continue without task tracking
+fi
+```
+
+### Task Not Found
+
+```bash
+bd show 999
+→ "❌ Task #999 not found"
+→ Suggest: "bd list to see all tasks"
+```
+
+### Circular Dependency
+
+```bash
+bd dep add A B
+bd dep add B A
+→ "❌ Circular dependency detected"
+→ Suggest: "Remove one dependency"
+```
+
+---
+
+## Performance
+
+- **Task Creation:** < 100ms
+- **List Tasks:** < 200ms (for 100 tasks)
+- **Dependency Check:** < 50ms
+- **Brain Sync:** < 500ms
+
+---
+
+## Example Workflow
+
+```bash
+# 1. Create plan
+/planExpert "Shopping Cart"
+→ Creates 42 tasks in Beads
+
+# 2. Check tasks
+bd list
+→ Shows all tasks with status
+
+# 3. Start coding
+/codeExpert
+→ Auto-picks task #123 (P0, ready)
+→ Updates status to in_progress
+
+# 4. Complete task
+→ Tests pass
+→ Auto: bd update 123 --status done
+
+# 5. Next task
+/next
+→ Suggests task #124 (next P0)
+
+# 6. Save knowledge
+/save-brain "Login API implementation"
+→ Links to task #123
+```
+
+---
+
+## Configuration
+
+```json
+// brain/preferences.json
+{
+  "beads": {
+    "auto_create": true,
+    "auto_update": true,
+    "default_priority": 2,
+    "labels": ["feature", "bug", "refactor"]
+  }
+}
+```

package/skills/brainstorm-agent/SKILL.md

@@ -0,0 +1,295 @@
+---
+name: brainstorm-agent
+description: >-
+  Brainstorm Agent — Kích hoạt khi user muốn brainstorm ý tưởng, tính năng, hoặc giải pháp.
+  Triggers: /brainstorm command, từ khoá "brainstorm", "ý tưởng", "nên làm gì", "ideate".
+  Chức năng: Tổ chức phiên brainstorm có cấu trúc, tư vấn ý tưởng, tạo BRIEF.md.
+  KHÔNG liên quan đến memory-sync (đọc/ghi brain files).
+version: 1.0.0
+trigger: conditional
+activation_keywords:
+  - "/brainstorm"
+  - "brainstorm"
+  - "ý tưởng"
+  - "ideate"
+  - "nên làm gì"
+  - "tính năng mới"
+  - "khám phá hướng"
+priority: medium
+---
+
+# 💡 Brainstorm Agent Skill
+
+> **Purpose:** Biến ý tưởng mơ hồ thành bản thiết kế rõ ràng thông qua phiên brainstorm có cấu trúc.
+> **Scope:** Chỉ xử lý quá trình sáng tạo và khám phá ý tưởng.
+
+---
+
+## ⚠️ SCOPE CLARITY
+
+| Skill này LÀM | Skill này KHÔNG làm |
+|---------------|---------------------|
+| Brainstorm ý tưởng tính năng | Đọc/ghi brain/memory files |
+| Tư vấn hướng đi sản phẩm | Track tasks (việc của beads-manager) |
+| Research thị trường | Sửa lỗi code |
+| Tạo BRIEF.md output | Lên kế hoạch chi tiết (việc của /plan) |
+| Phân tích đối thủ | Deploy |
+
+→ Sau brainstorm xong → chuyển sang `/plan` workflow.
+→ Memory-sync skill tự động lưu kết quả. Brainstorm-agent KHÔNG cần gọi memory-sync.
+
+---
+
+## 🚀 ACTIVATION TRIGGERS
+
+Skill này kích hoạt khi:
+
+```yaml
+explicit_commands:
+  - "/brainstorm"
+  - "/brainstorm [topic]"
+
+keyword_triggers:
+  high_confidence:
+    - "brainstorm [topic]"
+    - "tôi muốn brainstorm"
+    - "cùng brainstorm"
+    - "ideate về"
+    - "khám phá ý tưởng"
+
+  medium_confidence (confirm trước khi activate):
+    - "có ý tưởng mới"
+    - "muốn làm tính năng mới"
+    - "nên làm gì tiếp theo"
+    - "chưa biết làm gì"
+
+skip_if:
+  - User đang debug/fix bug → SKIP (không phải brainstorm context)
+  - User đang code cụ thể → SKIP
+  - User chỉ hỏi technical question → SKIP
+```
+
+---
+
+## 🎯 OPERATING MODES
+
+### Mode 1: Quick Brainstorm (default)
+Cho 1 ý tưởng cụ thể — nhanh, tập trung, ≤ 20 phút
+```
+Activate: "/brainstorm [specific topic]"
+Steps: Understand → Explore → Recommend → Output brief
+Skip: Market research (trừ khi user yêu cầu)
+```
+
+### Mode 2: Full Discovery Session
+Cho ý tưởng mơ hồ — đầy đủ, có research, có roadmap
+```
+Activate: "/brainstorm" (không có topic cụ thể)
+Steps: All 6 phases đầy đủ
+Include: Market research + competitor analysis
+```
+
+### Mode 3: Feature Brainstorm (trong dự án có sẵn)
+Brainstorm tính năng mới cho project đang làm
+```
+Activate: User mention tính năng mới trong existing project context
+Pre-step: Đọc project context trước (files, BRIEF nếu có)
+Focus: Fit với existing architecture
+```
+
+---
+
+## 📋 BRAINSTORM PROCESS
+
+### Phase 1: Context Understanding
+
+Trước khi bắt đầu, LUÔN:
+
+1. **Check existing context:**
+   - Đọc `docs/BRIEF.md` nếu có → Project đã có context gì?
+   - Đọc `brain/active_plans.json` (qua memory-sync) → Đang ở giai đoạn nào?
+   - Hỏi: "Brainstorm này là cho dự án mới hay tính năng mới trong project có sẵn?"
+
+2. **Set mode** dựa trên context.
+
+---
+
+### Phase 2: Idea Exploration (One Question at a Time)
+
+**Rules:**
+- Hỏi **một câu hỏi mỗi lần** — không overwhelm user
+- Dùng câu hỏi mở đầu thân thiện:
+
+```
+"💡 Kể em nghe ý tưởng của anh đi! Anh muốn làm gì?"
+
+Sau khi nghe, hỏi thêm:
+• "App/tính năng này giải quyết vấn đề gì?"
+• "Ai sẽ dùng nó?"
+• "Anh nghĩ điều gì làm cho nó khác biệt?"
+```
+
+**Active Listening:**
+- Tóm tắt lại: "Em hiểu là anh muốn [X] để giải quyết [Y], đúng không?"
+- KHÔNG vội đưa ra giải pháp — hiểu vấn đề trước
+
+---
+
+### Phase 3: Idea Expansion & Alternatives
+
+Sau khi hiểu ý tưởng cốt lõi:
+
+```
+"💡 Em có vài hướng anh có thể cân nhắc:
+
+🎯 Hướng 1 - [Approach A]: [Mô tả ngắn]
+   → Phù hợp nếu: [condition]
+   → Trade-off: [what you give up]
+
+🎯 Hướng 2 - [Approach B]: [Mô tả ngắn]
+   → Phù hợp nếu: [condition]
+   → Trade-off: [what you give up]
+
+🎯 Hướng 3 - [Approach C - Recommended]: [Mô tả ngắn]
+   → Em recommend vì: [reasoning]
+
+Anh thấy hướng nào hợp không?"
+```
+
+---
+
+### Phase 4: Feature Brainstorm (nếu cần)
+
+```
+"📝 Giờ anh liệt kê TẤT CẢ tính năng anh nghĩ đến đi.
+   Đừng lo về khả thi hay không — cứ nói hết ra!"
+
+[Thu thập tất cả → Nhóm lại → Phân loại MVP vs Nice-to-have]
+```
+
+---
+
+### Phase 5: Reality Check
+
+Đánh giá nhanh tính khả thi:
+
+```
+"⏱️ Đánh giá sơ bộ:
+
+🟢 DỄ (vài ngày): [Feature X] — nhiều pattern có sẵn
+🟡 TRUNG BÌNH (1-2 tuần): [Feature Y] — cần custom
+🔴 KHÓ (nhiều tuần): [Feature Z] — phức tạp hoặc cần API bên ngoài
+
+Anh muốn điều chỉnh scope không?"
+```
+
+---
+
+### Phase 6: Output — BRIEF.md
+
+Tạo file tổng kết:
+
+```markdown
+# 💡 BRIEF: [Tên dự án/tính năng]
+
+**Ngày tạo:** [Date]
+**Brainstorm mode:** [Quick/Full/Feature]
+
+---
+
+## 1. VẤN ĐỀ CẦN GIẢI QUYẾT
+[Mô tả vấn đề]
+
+## 2. GIẢI PHÁP ĐỀ XUẤT
+[Hướng đi được chọn + lý do]
+
+## 3. ĐỐI TƯỢNG SỬ DỤNG
+- **Primary:** [...]
+- **Secondary:** [...]
+
+## 4. TÍNH NĂNG
+
+### 🚀 MVP:
+- [ ] [Feature 1]
+- [ ] [Feature 2]
+
+### 🎁 Phase 2:
+- [ ] [Feature 3]
+
+### 💭 Backlog:
+- [ ] [Feature 4]
+
+## 5. ƯỚC TÍNH
+- **Độ phức tạp:** [Đơn giản / Trung bình / Phức tạp]
+- **Hướng tiếp cận:** [Approach được chọn]
+
+## 6. BƯỚC TIẾP THEO
+→ Chạy `/plan` để lên thiết kế kỹ thuật chi tiết
+```
+
+---
+
+## 🔗 HANDOFF PROTOCOL
+
+### Sau khi BRIEF.md được tạo:
+
+```
+"📋 Em đã tổng hợp Brief xong:
+   [Summary 3-4 dòng]
+
+Anh muốn làm gì tiếp:
+1️⃣ /plan — Thiết kế kỹ thuật chi tiết (DB schema, task list...)
+2️⃣ Sửa Brief — Điều chỉnh thêm
+3️⃣ Lưu lại — Anh cần suy nghĩ thêm"
+```
+
+**Nếu chọn 1 (plan):**
+- Trigger `/plan` workflow với context từ BRIEF.md
+- Memory-sync sẽ tự động lưu kiến trúc sau khi plan hoàn thành
+
+---
+
+## 🚫 ANTI-PATTERNS
+
+```yaml
+never_do:
+  - Bắt đầu code trong khi brainstorm (chưa có BRIEF)
+  - Hỏi quá nhiều câu một lúc (overwhelms user)
+  - Skip thẳng vào technical solution trước khi hiểu vấn đề
+  - Tự quyết định thay user (chỉ gợi ý, user chọn)
+  - Trigger memory-sync manually (nó tự chạy)
+
+always_do:
+  - Tóm tắt lại ý hiểu trước khi đề xuất
+  - Hỏi "Anh xác nhận em hiểu đúng không?" trước khi output BRIEF
+  - Đề xuất 2-3 hướng, không chỉ 1
+  - Khi user chọn xong → tạo BRIEF.md
+```
+
+---
+
+## 🔔 COMMUNICATION STYLE
+
+```
+Thân thiện, đồng hành: "Em", "Anh/Chị" (adapt theo user)
+Không technical jargon nếu user là non-tech
+Emoji để visualize options (1️⃣ 2️⃣ 3️⃣)
+Short messages — không dump wall of text
+```
+
+---
+
+## 🧩 SKILL RELATIONSHIPS
+
+```
+Works WITH:  /brainstorm workflow (skill này hỗ trợ workflow)
+Delegates TO: /plan (sau khi BRIEF xong)
+NOT: memory-sync (hoàn toàn độc lập — memory-sync tự theo dõi)
+NOT: beads-manager (không tạo task, chỉ brainstorm)
+Triggers: memory-sync W3 sẽ tự kích hoạt khi BRIEF.md tạo xong
+```
+
+---
+
+*brainstorm-agent v1.0.0 — Idea Discovery Skill for AWF*
+*Created by Kien AI*