@leejungkiin/awkit 1.0.9 → 1.1.1

package/workflows/conductor.md

@@ -0,0 +1,97 @@
+---
+description: 🎼 CLI Conductor — Gọi Gemini CLI phân tích, lên chiến lược, và review code project-wide
+---
+
+# /conductor — Two-Agent Orchestration Workflow
+
+> Antigravity chủ động gọi Gemini CLI (headless) khi cần tầm nhìn toàn project.
+> CLI chạy quota pool riêng → nhân đôi AI capacity.
+
+// turbo-all
+
+---
+
+## Sub-commands
+
+### `/conductor:analyze` — Phân tích project-wide
+
+1. Xác định project root (dùng `.project-identity` hoặc `CODEBASE.md`)
+2. Thông báo user: "📡 Đang gọi Gemini CLI phân tích cấu trúc project..."
+3. Gọi CLI:
+```bash
+cd <PROJECT_ROOT> && timeout 60 gemini -p "Analyze the project structure. List main modules, their responsibilities, key files, and dependencies. Be concise." --approval-mode plan 2>/dev/null
+```
+4. Parse output → tóm tắt cho user
+5. Nếu project có `conductor/tracks.md` → cập nhật
+6. Nếu chưa có `conductor/` → hỏi user có muốn tạo không
+
+### `/conductor:track` — Tạo/cập nhật strategic track
+
+1. Đọc `conductor/tracks.md` hiện tại (nếu có)
+2. User mô tả mục tiêu chiến lược
+3. Gọi CLI:
+```bash
+cd <PROJECT_ROOT> && timeout 60 gemini -p "Given this project context and goal: <GOAL>. Create a strategic track with: objectives, key milestones, and task breakdown. Current tracks: <EXISTING_TRACKS>" --approval-mode plan 2>/dev/null
+```
+4. Parse output → ghi vào `conductor/tracks.md`
+5. Tạo Symphony tasks từ task breakdown (nếu user đồng ý)
+
+### `/conductor:delegate` — Delegate task cho CLI xử lý
+
+1. Xác định task cần CLI (phân tích, review, generate)
+2. Build prompt với context đầy đủ
+3. Gọi CLI:
+```bash
+cd <PROJECT_ROOT> && timeout 60 gemini -p "<TASK_PROMPT>" --approval-mode plan 2>/dev/null
+```
+4. Nhận kết quả → tích hợp vào workflow hiện tại
+5. Tiếp tục code/debug với insights từ CLI
+
+### `/conductor:review` — Pre-commit review qua CLI
+
+1. Lấy diff: `git diff --staged` hoặc `git diff`
+2. Gọi CLI:
+```bash
+cd <PROJECT_ROOT> && timeout 60 gemini -p "Review these code changes for bugs, security issues, and best practices: $(git diff --staged --stat)" --approval-mode plan 2>/dev/null
+```
+3. Parse output → báo cáo issues cho user
+4. Nếu clean → suggest `git commit`
+
+### `/conductor:setup` — Khởi tạo conductor infrastructure
+
+1. Tạo thư mục `conductor/` tại project root
+2. Copy template `conductor-tracks.md` → `conductor/tracks.md`
+3. Thêm `conductor/` vào `.gitignore` (nếu user muốn)
+4. Thông báo: "✅ Conductor infrastructure ready!"
+
+---
+
+## Fallback Rules
+
+```yaml
+cli_unavailable:
+  - "⚠️ Gemini CLI không khả dụng, tiếp tục với Antigravity-only mode"
+  - Do NOT block workflow
+
+cli_timeout:
+  - "⏳ CLI phân tích quá lâu (>60s), bỏ qua và tiếp tục"
+
+cli_error:
+  - Log error
+  - Fall back gracefully
+  - Suggest: "gemini --version" to check installation
+```
+
+---
+
+## Communication
+
+Mỗi khi gọi CLI, LUÔN thông báo user:
+```
+📡 Đang gọi Gemini CLI để [mục đích]...
+```
+
+Sau khi nhận kết quả:
+```
+✅ CLI phân tích xong. Tóm tắt: [key findings]
+```

package/workflows/context/auto-implement.md

@@ -23,10 +23,10 @@ FEATURE=$1  # Pass feature name as argument
 Đọc và parse:
 1. `requirements.md` → Hiểu WHAT & WHY
 2. `design.md` → Hiểu HOW (architecture, models, UI)
-3. `bd list` → Hiểu execution plan (list tasks in JSON format for parsing)
+3. `symphony_available_tasks()` → Hiểu execution plan (list tasks in JSON format for parsing)
 
 ### 0.3. Parse Tasks
-Retrieve tasks using `bd list --json`:
+Retrieve tasks using Symphony:
 - Extract task ID
 - Extract description and body
 - Extract requirements from body tags
@@ -45,7 +45,7 @@ FOR each task WHERE status = "[ ]":
   4. GENERATE code
   5. WRITE to specified file
   6. VERIFY (syntax check)
-  7. MARK task as complete: `bd close [id]`
+  7. MARK task as complete: `symphony_complete_task(task_id)`
   8. REPORT progress
 END FOR
 ```
@@ -113,7 +113,7 @@ Mọi code phải tuân thủ:
 ### 3.1. Update Status
 Sau mỗi task hoàn thành:
 ```bash
-bd close [id]
+symphony_complete_task(task_id)
 ```
 
 ### 3.2. Progress Report

package/workflows/context/codebase-sync.md

@@ -83,17 +83,29 @@ for each missing_file:
 
 ## Phase 3: Update CODEBASE.md
 
+> [!IMPORTANT]
+> CODEBASE.md dùng **compact format** — AI đọc nhanh, tốn ít context.
+> KHÔNG dùng format verbose (multi-line per file).
+
 ```yaml
 MO:
   - APPEND vào đúng section, không xóa gì cũ
   - Update "Last Updated" timestamp
   - Nếu thêm feature mới → thêm section mới
 
-Format mỗi entry thêm vào:
-  #### [FileName.swift]
-  **Layer:** [Layer name]
-  **Purpose:** [Description]
-  **Key class/struct:** `ClassName`
+Compact Format (BẮT BUỘC):
+  Mỗi file = 1 dòng trong table:
+  | `path/to/File.swift` | Purpose mô tả ngắn (1 câu) |
+
+  Ví dụ:
+  | `Core/Services/PushNotificationService.swift` | FCM push notification registration & handling |
+  | `Features/WeeklyGoal/ViewModels/WeeklyGoalVM.swift` | Weekly goal progress tracking logic |
+
+  ❌ KHÔNG dùng format cũ:
+    #### FileName.swift
+    **Layer:** ...
+    **Purpose:** ...
+    **Key class:** ...
 
 Footer update:
   **Last Updated**: [current date]
@@ -103,9 +115,8 @@ Footer update:
 **Preview trước khi apply:**
 ```
 📝 Sẽ thêm [K] entries vào CODEBASE.md:
-  + Core/Services/PushNotificationService.swift → Services Layer
-  + Features/WeeklyGoal/ViewModels/WeeklyGoalViewModel.swift → Features
-  + Presentation/Views/Dashboard/CombinedDashboardHeader.swift → Views
+  + Core/Services/PushNotificationService.swift → FCM push notification
+  + Features/WeeklyGoal/ViewModels/WeeklyGoalVM.swift → Weekly goal logic
 
 Apply? [auto-yes nếu < 10 entries / confirm nếu lớn hơn]
 ```

package/workflows/context/next.md

@@ -1,36 +1,36 @@
 ---
-description: ➡️ Không biết làm gì tiếp? (v5.0 - Beads + Brain)
+description: ➡️ Không biết làm gì tiếp? (v5.0 - Symphony + Brain)
 ---
 
-# WORKFLOW: /next - The Smart Compass (Beads + Brain Navigator)
+# WORKFLOW: /next - The Smart Compass (Symphony + Brain Navigator)
 
-> **Mục tiêu:** Phân tích context từ Beads (Tasks) và Brain (Plans/Knowledge) để gợi ý bước tiếp theo CHÍNH XÁC.
+> **Mục tiêu:** Phân tích context từ Symphony (Tasks) và Brain (Plans/Knowledge) để gợi ý bước tiếp theo CHÍNH XÁC.
 
 ---
 
 ## Giai đoạn 1: Multi-Source Context Check (Tự động)
 
-### 1.1. Priority 1: Check Beads (Task Tracker)
-```bash
-bd list --status in_progress
+### 1.1. Priority 1: Check Symphony (Task Tracker)
+```
+symphony_available_tasks(filter="my")
 ```
 
 **Case A: Có task đang làm dở**
 ```
-📿 **Beads Context:**
+🎵 **Symphony Context:**
 Task #123: "Implement Login API" (in_progress)
 └─ Started: 2 hours ago
 └─ Blocker: None
 
 ➡️ **Bước tiếp theo:**
 1️⃣ Tiếp tục task này? `/code` (AI sẽ tự load context)
-2️⃣ Xem chi tiết task? `bd show 123`
-3️⃣ Chuyển sang task khác? `bd list`
+2️⃣ Xem chi tiết task? `symphony_workspace_status(task_id)`
+3️⃣ Chuyển sang task khác? `symphony_available_tasks(filter="ready")`
 ```
 
 **Case B: Không có task in_progress**
-```bash
-bd list --status open
+```
+symphony_available_tasks(filter="ready")
 ```
 → Hiển thị danh sách tasks đang chờ (ready to start).
 
@@ -46,7 +46,7 @@ else:
 **Từ Brain lấy được:**
 - Feature đang làm
 - Phase hiện tại
-- Tasks trong phase (so sánh với Beads)
+- Tasks trong phase (so sánh với Symphony)
 
 ### 1.3. Priority 3: Check Git State (Fallback)
 - `git status` → File nào đang thay đổi?
@@ -62,16 +62,16 @@ else:
 
 ➡️ **Bước tiếp theo:**
 1️⃣ Lập kế hoạch: `/plan "Feature Name"`
-   → Sẽ tự động tạo tasks trong Beads
+   → Sẽ tự động tạo tasks trong Symphony
 2️⃣ Brainstorm ý tưởng: `/brainstorm`
 ```
 
 ### 2.2. Scenario: Có Plan nhưng chưa có Task
 ```
-🧭 **Tình trạng:** Có plan tại `plans/260130-login/` nhưng chưa sync Beads.
+🧭 **Tình trạng:** Có plan tại `plans/260130-login/` nhưng chưa sync Symphony.
 
 ➡️ **Bước tiếp theo:**
-1️⃣ Sync plan sang Beads? (Em sẽ tạo tasks tự động)
+1️⃣ Sync plan sang Symphony? (Em sẽ tạo tasks tự động)
 2️⃣ Bắt đầu code luôn? `/code phase-01`
 ```
 
@@ -79,13 +79,13 @@ else:
 ```
 🧭 **Tình trạng:** Có 3 tasks sẵn sàng làm:
 
-📿 **Beads Tasks:**
-#101 Setup Database Schema (P0)
-#102 Create User Model (P1)
-#103 Write API Tests (P2)
+🎵 **Symphony Tasks:**
+#101 Setup Database Schema (P1 - High)
+#102 Create User Model (P2 - Medium)
+#103 Write API Tests (P3 - Low)
 
 ➡️ **Bước tiếp theo:**
-1️⃣ Làm task #101? `/code` (AI sẽ tự chọn P0)
+1️⃣ Làm task #101? `/code` (AI sẽ tự chọn P1)
 2️⃣ Chọn task khác? Gõ số task (vd: "102")
 ```
 
@@ -95,7 +95,7 @@ else:
 
 📊 **Progress:**
 - Brain: Phase 02 - Backend (50%)
-- Beads: Task #123 (in_progress, 2h ago)
+- Symphony: Task #123 (in_progress, 2h ago)
 - Git: 3 files changed
 
 ➡️ **Bước tiếp theo:**
@@ -136,7 +136,7 @@ else:
 
 ➡️ **Gợi ý:**
 1️⃣ Tiếp tục task này? `/code`
-2️⃣ Đóng task (không làm nữa)? `bd update 115 --status cancelled`
+2️⃣ Bỏ task (không làm nữa)? `symphony_abandon_task(task_id, reason)`
 ```
 
 ### 3.3. Knowledge Gap
@@ -152,9 +152,9 @@ else:
 
 ```markdown
 🧭 **ĐANG Ở ĐÂU:**
-[Context từ Beads + Brain + Git]
+[Context từ Symphony + Brain + Git]
 
-📿 **BEADS STATUS:**
+🎵 **SYMPHONY STATUS:**
 - In Progress: X tasks
 - Ready: Y tasks
 - Blocked: Z tasks
@@ -174,11 +174,11 @@ else:
 
 ## 🛡️ Resilience Patterns
 
-### Beads Unavailable
+### Symphony Unavailable
 ```
-if bd_command_fails:
+if symphony_command_fails:
     → Fallback to Brain only
-    → Warning: "Beads không khả dụng. Dùng context từ Brain."
+    → Warning: "Symphony không khả dụng. Dùng context từ Brain."
 ```
 
 ### Brain Empty

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

@@ -7,16 +7,16 @@ alwaysApply: true
 
 ## 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_** kiểm tra Symphony 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”
+- **_NGHIÊM CẤM_** bỏ qua Symphony 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)
+## ⛔ Pre-Analysis Symphony 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
+symphony_available_tasks(filter="my")
 
 # 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

package/workflows/expert/codeExpert.md

@@ -18,42 +18,39 @@ description: 💻 Code ngay lập tức (Expert Mode)
 ```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)
+/codeExpert                    # Code task tiếp theo (auto-detect từ Symphony)
 ```
 
 ---
 
 ## Execution Flow
 
-### 1. Context Detection — `smart_pick()` (v6.5)
+### 1. Context Detection — `smart_pick()`
 
-**Priority 1: Active Epic (Hierarchical)**
-```bash
-# Read epic from brain
-EPIC_ID=$(cat brain/active_plans.json | jq -r '.current.epic_id // empty')
-
-if [ -n "$EPIC_ID" ]; then
-  # Check in-progress first
-  bd list --status in_progress --parent $EPIC_ID --json
-  # If none → Get ready (unblocked) tasks
-  bd ready --parent $EPIC_ID --json --limit 5
-  # Auto-claim first ready task
-  bd update <id> --claim
-fi
+**Priority 1: Active Tasks (Symphony)**
+```
+# Read task mapping from brain
+TASK_MAPPING = read brain/active_plans.json
+
+# Check in-progress first
+symphony_available_tasks(filter="my")
+# If none → Get ready tasks
+symphony_available_tasks(filter="ready")
+# Auto-claim first ready task
+symphony_claim_task(task_id)
 ```
 
 **Priority 2: Argument**
 - Nếu có `phase-XX` → Load phase file
 - Nếu có task name → Search trong plan
 
-**Priority 3: Legacy Flat (no epic)**
-```bash
-bd list --status in_progress
-bd ready --limit 5
+**Priority 3: Fallback**
+```
+symphony_available_tasks(filter="ready")
 ```
 
 ### 2. Load Spec/Plan
-- Đọc acceptance criteria từ task metadata (`bd show <id> --json`)
+- Đọc acceptance criteria từ Symphony task
 - Đọc spec từ `docs/specs/` hoặc phase file
 
 ### 3. Execute (Zero Questions)
@@ -67,15 +64,15 @@ bd ready --limit 5
 ### 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]"
+- Nếu fail sau 3 lần → Tạo Symphony task "Fix test for [Feature]"
 
-### 5. Update Beads — `cascade_complete()` (v6.5)
-```bash
-# Close task with reason + suggest next
-bd close <task-id> --reason "Completed" --suggest-next
+### 5. Update Symphony — `complete_task()`
+```
+# Complete task with summary
+symphony_complete_task(task_id, summary="Completed", files_changed=[...])
 
-# Auto-close parent phase/epic if all children done
-bd epic close-eligible
+# Report progress if partially done
+symphony_report_progress(task_id, progress=100)
 ```
 
 ### 6. Report
@@ -89,7 +86,7 @@ bd epic close-eligible
 
 ✅ **Tests:** 5/5 passed
 
-📿 **Beads:** Task #123 → Done
+🎵 **Symphony:** Task #123 → Done
 
 ➡️ **Next:** /codeExpert (Auto-pick next task)
 ```
@@ -117,14 +114,14 @@ AI sẽ tự động quyết định:
 Suggestions:
 1. Create plan first: /planExpert "Feature"
 2. Specify target: /codeExpert "Task Name"
-3. Check Beads: bd list
+3. Check Symphony: symphony_available_tasks()
 ```
 
 ### Test Fail (After 3 Retries)
 ```
 ⚠️ Auto-fix failed after 3 attempts
 
-📿 Created task: #456 "Fix test for Login API"
+🎵 Created task: "Fix test for Login API"
 
 Options:
 1. Debug manually: /debugExpert
@@ -136,6 +133,6 @@ Options:
 
 ## Integration
 
-- **Beads:** Auto-update task status
+- **Symphony:** Auto-update task status via `symphony_complete_task()`
 - **Brain:** Auto-save code patterns to knowledge base
 - **Git:** Auto-stage changes (optional)

package/workflows/expert/debugExpert.md

@@ -58,15 +58,15 @@ description: 🐞 Sửa lỗi tự động (Expert Mode)
 - ✅ Linting issues
 
 **Need-Review:**
-- ⚠️ Logic errors → Create Beads task
-- ⚠️ Security issues → Create Beads task + Alert
-- ⚠️ Performance issues → Create Beads task
+- ⚠️ Logic errors → Create Symphony task
+- ⚠️ Security issues → Create Symphony task + Alert
+- ⚠️ Performance issues → Create Symphony task
 
 ### 4. Verify Fix
 
 - Chạy lại test/linter
 - Nếu pass → Done
-- Nếu fail → Rollback + Create Beads task
+- Nếu fail → Rollback + Create Symphony task
 
 ### 5. Report
 
@@ -81,7 +81,7 @@ Added null check before mapping products array
 
 ✅ **Verification:** Tests passed
 
-📿 **Beads:** No new tasks (auto-fixed)
+🎵 **Symphony:** No new tasks (auto-fixed)
 
 ➡️ **Next:** /codeExpert (Continue coding)
 ```
@@ -105,15 +105,15 @@ AI sẽ tự động quyết định:
 ```
 ⚠️ Cannot auto-fix: Complex logic error
 
-📿 Created task: #789 "Fix logic error in calculateTotal()"
+🎵 Created task: "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
+➡️ **Next:**
+1. Fix manually: Open task in Symphony
 2. Get help: /debug (Guided Mode)
 ```
 
@@ -122,15 +122,15 @@ AI sẽ tự động quyết định:
 ⚠️ Found 5 errors
 
 ✅ Auto-fixed: 3 errors
-📿 Created tasks: 2 errors (#790, #791)
+🎵 Created Symphony tasks: 2 errors
 
-➡️ **Next:** bd list --label bug
+➡️ **Next:** symphony_available_tasks(filter="ready")
 ```
 
 ---
 
 ## Integration
 
-- **Beads:** Auto-create tasks for complex bugs
+- **Symphony:** 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

@@ -42,34 +42,20 @@ description: 📝 Thiết kế tính năng (Expert Mode - Zero Questions)
   - Medium: 6 phases (+ Database + Integration)
   - Complex: 8+ phases (+ Auth + Deploy + Monitoring)
 
-### 4. Sync to Beads (Hierarchical — v6.5)
-```bash
-# Step 1: Create epic (1 per plan)
-EPIC_ID=$(bd create "<Feature Name>" -t epic -p 1 \
-  --description "<feature summary>" \
-  --acceptance "<high-level acceptance>" \
-  --design "<architecture approach>" \
-  --json | jq -r '.id')
-
-# Step 2: Create phase tasks as children of epic
+### 4. Sync to Symphony
+```
+# Step 1: Create root task (1 per plan)
+symphony_create_task(title="<Feature Name>", priority=1, description="<feature summary>")
+
+# Step 2: Create phase tasks
 for each phase:
-  PHASE_ID=$(bd create "Phase X: [Name]" \
-    --parent $EPIC_ID -p 1 \
-    --description "<phase summary>" \
-    --json | jq -r '.id')
-
-  # Step 3: Create subtasks as children of phase
-  for each task in phase:
-    bd create "[Task Name]" \
-      --parent $PHASE_ID -p 2 \
-      --acceptance "<definition of done>" \
-      --json
-
-# Step 4: Set inter-phase dependencies
-bd dep add $PHASE2_ID $PHASE1_ID  # Sequential phases
-
-# Step 5: Save to brain/active_plans.json
-# → { "current": { "epic_id": $EPIC_ID, "feature": "...", "phases": [...] } }
+  symphony_create_task(title="Phase X: [Name]", description="<phase summary>")
+
+# Step 3: Create subtasks for each phase
+for each task in phase:
+  symphony_create_task(title="[Task Name]", acceptance="<definition of done>")
+
+# Step 4: Save to brain/active_plans.json
 ```
 
 ### 5. Report
@@ -80,15 +66,14 @@ bd dep add $PHASE2_ID $PHASE1_ID  # Sequential phases
 📋 Spec: docs/specs/shopping-cart_spec.md
 
 📊 **Structure:**
-- 🏔️ 1 Epic
-- 📦 6 Phases (sequential dependencies)
+- 🏔️ 1 Root Task
+- 📦 6 Phases (sequential)
 - 📝 42 Subtasks (with acceptance criteria)
 - Estimated: 3-4 sessions
 
-📿 **Beads (Hierarchical):**
-- Epic: bd-xxxx
-- Tree: bd list --parent bd-xxxx --tree
-- Ready: bd ready --parent bd-xxxx
+🎵 **Symphony:**
+- Tasks: symphony_available_tasks()
+- Status: symphony_status()
 
 ➡️ **Next:** /codeExpert (auto-picks first ready subtask)
 ```
@@ -129,7 +114,7 @@ Options:
 
 ## Integration
 
-- **Brain:** Auto-save epic mapping to `brain/active_plans.json` (with epic_id + phase IDs)
-- **Beads:** Auto-create epic → phase → subtask hierarchy with dependencies
-- **Skill:** Uses `plan_to_beads()` from `beads-manager` skill v6.5
+- **Brain:** Auto-save task mapping to `brain/active_plans.json`
+- **Symphony:** Auto-create task hierarchy via `symphony_create_task()`
+- **Skill:** Uses `symphony-orchestrator` skill
 - **Git:** Auto-commit plan files (optional)