@leejungkiin/awkit 1.4.3 → 1.5.1

package/skills/brainstorm-agent/SKILL.md

@@ -5,7 +5,7 @@ description: >-
   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
+version: 1.1.0
 trigger: conditional
 activation_keywords:
   - "/brainstorm"
@@ -14,363 +14,103 @@ activation_keywords:
   - "ideate"
   - "nên làm gì"
   - "tính năng mới"
-  - "khám phá hướng"
 priority: medium
 ---
 
-# 💡 Brainstorm Agent Skill
+# 💡 Brainstorm Agent — Router
 
-> **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.
+> **Purpose:** Biến ý tưởng mơ hồ thành bản thiết kế rõ ràng qua phiên brainstorm có cấu trúc.
 
----
-
-## ⚠️ SCOPE CLARITY
+## ⚠️ SCOPE
 
-| 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 symphony-orchestrator) |
-| 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 |
+| LÀM | KHÔNG làm |
+|-----|-----------|
+| Brainstorm ý tưởng, tư vấn hướng đi | Đọc/ghi brain/memory files |
+| Research thị trường, phân tích đối thủ | Track tasks (symphony) |
+| Tạo BRIEF.md output | Sửa lỗi code, 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.
-
----
+## 📋 Topic Index
 
-## 🚀 ACTIVATION TRIGGERS
+| Topic | Khi nào load | File |
+|-------|-------------|------|
+| BRIEF.md template + Symphony Notes auto-save | Khi tạo output | `templates/brief-template.md` |
 
-Skill này kích hoạt khi:
+## 🚀 ACTIVATION
 
 ```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
-  - .kiro/specs/ tồn tại với requirements.md → AUTO-SKIP (Kiro đã tạo spec)
-    → Thông báo: "🔍 Phát hiện .kiro/specs với product specs đầy đủ.
-       Brainstorm không cần thiết — Gate 1 AUTO-PASS. Chuyển thẳng Gate 1.5/2."
+high_confidence: "/brainstorm [topic]", "tôi muốn brainstorm", "khám phá ý tưởng"
+medium_confidence (confirm): "có ý tưởng mới", "nên làm gì tiếp theo"
+skip_if: Đang debug | Đang code cụ thể | .kiro/specs/ có requirements.md → AUTO-SKIP
 ```
 
----
+## 🎯 MODES
 
-## 🎯 OPERATING MODES
+| Mode | When | Focus |
+|------|------|-------|
+| **Quick** | `/brainstorm [topic]` | 1 ý tưởng cụ thể, ≤20 phút |
+| **Full Discovery** | `/brainstorm` (no topic) | All 6 phases, có research |
+| **Feature** | Existing project context | Fit với architecture hiện tại |
 
-### 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
+## 📋 PROCESS (6 Phases)
 
 ### Phase 1: Context Understanding
+- **Kiro check first** (.kiro/specs/ → AUTO-SKIP nếu có requirements.md)
+- Check existing BRIEF.md, active_plans.json
+- Set mode based on context
 
-Trước khi bắt đầu, LUÔN:
-
-1. **Check Kiro specs (HIGHEST PRIORITY):**
-   - Scan `.kiro/specs/` folder tại project root
-   - Nếu tồn tại `requirements.md` → **AUTO-SKIP brainstorm**:
-     ```
-     "🔍 Phát hiện .kiro/specs/ với product specs từ IDE Kiro.
-        Gate 1 (Spec) đã được thỏa mãn bởi Kiro specs.
-        Chuyển thẳng sang Gate 1.5 (Module Spec) hoặc Gate 2 (Architecture)."
-     ```
-   - KHÔNG cần hỏi thêm user về product vision (Kiro đã chốt)
-   - Vẫn cho phép user gọi `/brainstorm` explicit để brainstorm cải tiến thêm
-
-2. **Check existing context (fallback):**
-   - Đọ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?"
-
-3. **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.
-- **CHỦ ĐỘNG KHAI THÁC & MỞ RỘNG:** Thay vì chỉ nhận ý tưởng thụ động, AI cần **chủ động đặt câu hỏi gợi mở, giả định tình huống hoặc các edge cases** để giúp user tự suy nghĩ sâu hơn và mở rộng ý tưởng của họ (Socratic questioning).
-- Dùng câu hỏi mở đầu thân thiện:
-
-```
-"💡 Kể em nghe chi tiết ý tưởng của anh đi! Anh đang muốn giải quyết bài toán gì?"
-
-Sau khi nghe, hãy chủ động probe sâu hơn. Thay vì hỏi chung chung, hãy hỏi cụ thể dựa trên ý tưởng của user:
-• "Nếu user làm [hành động X], hệ thống nên xử lý thế nào?"
-• "Điểm khác biệt lớn nhất giữa app của anh và các app hiện có là gì?"
-• "Ai sẽ là người dùng cốt lõi nhất, và họ gặp pain point gì nghiêm trọng nhất?"
-• "Anh có nghĩ đến việc thêm [Gợi ý góc nhìn mới/tính năng mở rộng] không, vì nó sẽ giúp [lợi ích]?"
-```
-
-**Active Listening & Expanding:**
-- Tóm tắt lại: "Em hiểu là anh muốn [X] để giải quyết [Y], đúng không?"
-- **Đào sâu:** "Em thấy phần [Z] khá thú vị, anh định triển khai nó theo hướng manual hay chạy auto?"
-- KHÔNG vội đưa ra giải pháp hoàn chỉnh — hãy giúp user tự làm rõ ý tưởng của mình trước.
-
----
+### Phase 2: Idea Exploration (1 question at a time)
+- Hỏi **một câu mỗi lần** — không overwhelm
+- **CHỦ ĐỘNG khai thác & mở rộng** (Socratic questioning)
+- Active listening: "Em hiểu là anh muốn [X] để giải quyết [Y], đúng không?"
 
 ### Phase 3: Idea Expansion & Alternatives
+- Đề xuất 2-3 hướng với trade-offs
+- Recommend 1 hướng với reasoning
 
-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 4: Feature Brainstorm
+- Thu thập TẤT CẢ → Nhóm → 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?"
-```
-
----
+- 🟢 DỄ | 🟡 TRUNG BÌNH | 🔴 KHÓ
+- Điều chỉnh scope nếu cần
 
 ### Phase 6: Output — BRIEF.md
+- Tạo file theo template → `templates/brief-template.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]
+## 🔗 HANDOFF
 
-### 💭 Backlog:
-- [ ] [Feature 4]
-
-## 5. MODULE BREAKDOWN
-
-### Module: [Module Name 1]
-- **Mục đích:** [1 dòng]
-- **Screens chính:** [list screens]
-- **Core flows:** [list main user journeys]
-
-### Module: [Module Name 2]
-- **Mục đích:** [1 dòng]
-- **Screens chính:** [list screens]
-- **Core flows:** [list main user journeys]
-
-## 6. ƯỚ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]
-- **Số modules:** [N]
-
-## 7. BƯỚC TIẾP THEO
-→ Module spec chi tiết (Gate 1.5) → Thiết kế kỹ thuật (Gate 2)
 ```
-
----
-
-## 🔗 HANDOFF PROTOCOL
-
-### Sau khi BRIEF.md được tạo:
-
+Sau BRIEF.md:
+1️⃣ Module spec chi tiết (Gate 1.5 → module-spec-writer)
+2️⃣ /plan trực tiếp (skip module spec)
+3️⃣ Sửa Brief
+4️⃣ Lưu lại — suy nghĩ thêm
 ```
-"📋 Em đã tổng hợp Brief xong:
-   [Summary 3-4 dòng]
-
-Anh muốn làm gì tiếp:
-1️⃣ Viết module spec chi tiết (Gate 1.5) — Mô tả screens, flows, rules per module
-2️⃣ /plan — Thiết kế kỹ thuật ngay (skip module spec)
-3️⃣ Sửa Brief — Điều chỉnh thêm
-4️⃣ Lưu lại — Anh cần suy nghĩ thêm"
-```
-
-**Nếu chọn 1 (module spec):**
-- Trigger module-spec-writer skill với context từ BRIEF.md
-- Sau khi module specs approved → auto-proceed Gate 2 (spec-gate)
 
-**Nếu chọn 2 (plan/skip):**
-- Trigger `/plan` workflow trực tiếp
-- Memory-sync sẽ tự động lưu kiến trúc sau khi plan hoàn thành
-
----
-
-## 💾 SYMPHONY NOTES AUTO-SAVE (BẮT BUỘC)
-
-> **Rule:** Sau khi tạo BẤT KỲ brainstorm artifact nào (BRIEF.md, analysis, brainstorm doc),
-> AI PHẢI POST metadata vào Symphony Notes API. Content ĐỌC TỪ FILE, KHÔNG lưu vào DB.
-
-### Khi nào trigger:
-
-```yaml
-triggers:
-  - BRIEF.md tạo xong
-  - Analysis document tạo xong (pricing, market, competitor...)
-  - Brainstorm document tạo xong
-  - Bất kỳ artifact có giá trị lâu dài
-```
-
-### Cách thực hiện:
-
-```bash
-curl -X POST http://localhost:3100/api/notes -H 'Content-Type: application/json' -d '{
-  "projectId": "<current-project-id>",
-  "type": "brainstorm",
-  "title": "<artifact-title>",
-  "content": "<summary-2-3-lines-ONLY — KHÔNG copy full content>",
-  "filePath": "<absolute-path-to-artifact-file>",
-  "conversationId": "<current-conversation-id>",
-  "metadata": {
-    "mode": "quick|full|feature",
-    "tags": ["pricing", "features", "architecture", ...],
-    "created_by": "brainstorm-agent"
-  }
-}'
-```
-
-### Quy tắc:
-
-```yaml
-rules:
-  - content CHỈ chứa summary ngắn 2-3 dòng
-  - filePath trỏ đến file .resolved hoặc .md thực tế
-  - Nếu Symphony server không chạy → skip (không block workflow)
-  - type: "brainstorm" cho ý tưởng, "analysis" cho phân tích dữ liệu
-```
-
----
-
-## 🚫 ANTI-PATTERNS
+## 🚫 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)
+  - Code trong khi brainstorm
+  - Hỏi quá nhiều câu một lúc
+  - Skip vào technical solution trước khi hiểu vấ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
+  - Hỏi confirm trước khi output BRIEF
 ```
 
----
-
-## 🔔 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
+## 🧩 Relationships
 
 ```
-Works WITH:  /brainstorm workflow (skill này hỗ trợ workflow)
-Delegates TO: module-spec-writer (Gate 1.5, sau khi BRIEF xong)
-Delegates TO: /plan (nếu user skip module spec)
-NOT: memory-sync (hoàn toàn độc lập — memory-sync tự theo dõi)
-NOT: symphony-orchestrator (không tạo task, chỉ brainstorm)
-Triggers: memory-sync W3 sẽ tự kích hoạt khi BRIEF.md tạo xong
+Works WITH:  /brainstorm workflow
+Delegates TO: module-spec-writer (Gate 1.5) | /plan
+NOT: memory-sync (hoàn toàn độc lập)
+Triggers: memory-sync W3 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*
+*brainstorm-agent v1.1.0 — Modular Router Architecture*

package/skills/brainstorm-agent/templates/brief-template.md

@@ -0,0 +1,76 @@
+# BRIEF.md Template & Brainstorm Output
+
+```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. MODULE BREAKDOWN
+
+### Module: [Module Name 1]
+- **Mục đích:** [1 dòng]
+- **Screens chính:** [list screens]
+- **Core flows:** [list main user journeys]
+
+### Module: [Module Name 2]
+- **Mục đích:** [1 dòng]
+- **Screens chính:** [list screens]
+- **Core flows:** [list main user journeys]
+
+## 6. ƯỚ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]
+- **Số modules:** [N]
+
+## 7. BƯỚC TIẾP THEO
+→ Module spec chi tiết (Gate 1.5) → Thiết kế kỹ thuật (Gate 2)
+```
+
+---
+
+# Symphony Notes Auto-Save
+
+Sau khi tạo BẤT KỲ brainstorm artifact nào → POST metadata vào Symphony Notes API:
+
+```bash
+curl -X POST http://localhost:3100/api/notes -H 'Content-Type: application/json' -d '{
+  "projectId": "<current-project-id>",
+  "type": "brainstorm",
+  "title": "<artifact-title>",
+  "content": "<summary-2-3-lines-ONLY>",
+  "filePath": "<absolute-path-to-artifact-file>",
+  "conversationId": "<current-conversation-id>",
+  "metadata": {
+    "mode": "quick|full|feature",
+    "tags": ["pricing", "features", "architecture"],
+    "created_by": "brainstorm-agent"
+  }
+}'
+```
+
+**Rules:** content CHỈ 2-3 dòng summary. Nếu Symphony offline → skip silently.