@leejungkiin/awkit 1.1.0 → 1.1.2

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)

package/workflows/git/smart-git-ops.md

@@ -1,10 +1,10 @@
 ---
-description: 🤖 Tự động hóa git workflow hoàn chỉnh (audit → commit → push)
+description: 🤖 Tự động hóa git workflow hoàn chỉnh (audit → commit → push → telegram report)
 ---
 
 # /smart-git-ops - Complete Git Automation
 
-**Tự động hóa toàn bộ:** Audit → Semantic Commit → Push
+**Tự động hóa toàn bộ:** Audit → Semantic Commit → Push → Telegram Report
 
 ---
 
@@ -20,7 +20,7 @@ echo "🔍 Running pre-commit audit..."
 
 ---
 
-## Phase 2: Status & Staging
+## Phase 2: Status & Smart Staging
 
 // turbo
 ```bash
@@ -78,6 +78,48 @@ git push origin HEAD
 
 ---
 
+## Phase 7: Telegram Report 📨
+
+**Mục đích:** Sau khi push thành công, tự động tóm tắt các thay đổi và gửi báo cáo vào Telegram group.
+
+**Logic:**
+1. Lấy thông tin commit vừa push:
+   ```bash
+   COMMIT_HASH=$(git log -1 --format='%h')
+   COMMIT_MSG=$(git log -1 --format='%s')
+   BRANCH=$(git branch --show-current)
+   AUTHOR=$(git log -1 --format='%an')
+   FILES_CHANGED=$(git diff --stat HEAD~1 HEAD | tail -1)
+   REPO_NAME=$(basename $(git rev-parse --show-toplevel))
+   ```
+
+2. Tạo message tóm tắt (Markdown):
+   ```
+   🚀 *Git Push Report*
+   
+   📦 *Repo:* `{REPO_NAME}`
+   🌿 *Branch:* `{BRANCH}`
+   🔖 *Commit:* `{COMMIT_HASH}`
+   👤 *Author:* {AUTHOR}
+   
+   📝 *Message:* {COMMIT_MSG}
+   📊 *Changes:* {FILES_CHANGED}
+   🕐 *Time:* {timestamp}
+   ```
+
+3. Gửi qua `awkit tg send`:
+   // turbo
+   ```bash
+   awkit tg send --parse-mode md "<generated-report>"
+   ```
+
+**Fallback:** Nếu `awkit tg send` fail (chưa config), hiển thị hướng dẫn:
+```
+⚠️ Telegram chưa được cấu hình. Chạy: awkit tg setup
+```
+
+---
+
 ## 🎛️ Configuration
 
 User có thể config trong `.gemini/config.json`:
@@ -86,7 +128,8 @@ User có thể config trong `.gemini/config.json`:
   "smart_git_ops": {
     "auto_approve_timeout": 5,
     "run_audit": true,
-    "run_tests_before_push": false
+    "run_tests_before_push": false,
+    "telegram_report": true
   }
 }
 ```
@@ -95,9 +138,9 @@ User có thể config trong `.gemini/config.json`:
 
 ## ⚠️ NEXT STEPS
 
-Sau khi push thành công:
+Sau khi push & report thành công:
 ```
 1️⃣ Xem commit log (`git log --oneline -3`)
-2️⃣ Đóng task Beads liên quan (`bd update <id> --status done`)
+2️⃣ Đóng task trong Symphony (`symphony_complete_task(task_id)`)
 3️⃣ Tiếp tục task tiếp theo (`/next`)
 ```

package/workflows/lifecycle/debug.md

@@ -2,7 +2,7 @@
 description: 🐞 Sửa lỗi & Debug (Dual-Mode v5.0)
 ---
 
-# WORKFLOW: /debug - The Sherlock Holmes (Dual-Mode + Beads)
+# WORKFLOW: /debug - The Sherlock Holmes (Dual-Mode + Symphony)
 
 > **Mode A (Expert):** `/debug --auto-fix` -> Tự động phân tích và sửa lỗi.
 > **Mode B (Guided):** `/debug` -> Hướng dẫn thu thập thông tin -> Phân tích -> Menu sửa.
@@ -27,8 +27,8 @@ description: 🐞 Sửa lỗi & Debug (Dual-Mode v5.0)
 3.  **Auto-Fix (Safe Only):**
     -   Lỗi *Safe-to-fix*: Missing import, typo, undefined check -> Sửa ngay.
     -   Lỗi *Logic*: Báo cáo và đề xuất (không tự ý sửa).
-4.  **Beads Sync:**
-    -   Nếu lỗi Critical và không thể auto-fix -> `bd create "Fix Critical Bug in Cart.tsx" --label bug`.
+4.  **Symphony Sync:**
+    -   Nếu lỗi Critical và không thể auto-fix -> `symphony_create_task(title="Fix Critical Bug in Cart.tsx")`.
 5.  **Report:** "✅ Fixed 1 issue. ⚠️ Created task #456 for manual review."
 
 ---
@@ -74,7 +74,7 @@ description: 🐞 Sửa lỗi & Debug (Dual-Mode v5.0)
 2.  **Fix Options:**
     ```markdown
     1️⃣ 🔧 Em sửa ngay (Auto-fix)
-    2️⃣ 📿 Tạo task Beads để sửa sau
+    2️⃣ 📿 Tạo task Symphony để sửa sau
     3️⃣ 📝 Hướng dẫn anh tự sửa
     4️⃣ 🔍 Điều tra sâu hơn
     ```
@@ -86,11 +86,11 @@ description: 🐞 Sửa lỗi & Debug (Dual-Mode v5.0)
 
 ---
 
-## 🧠 Brain & Beads Logic
+## 🧠 Brain & Symphony Logic
 
 ### 1. Bug Tracking
 -   Mọi lỗi được phát hiện -> Ghi vào `brain/bugs/[date]_[issue].md`.
--   Nếu lỗi Critical -> Auto-create Beads task với tag `bug` và `high-priority`.
+-   Nếu lỗi Critical -> Auto-create Symphony task với tag `bug` và `high-priority`.
 
 ### 2. Knowledge Base
 -   Lỗi đã fix -> Lưu vào `brain/solutions/` để tham khảo sau.
@@ -104,7 +104,7 @@ description: 🐞 Sửa lỗi & Debug (Dual-Mode v5.0)
 ## 🛡️ Resilience Patterns
 
 -   **False Fix Detection:** Sau khi sửa, tự động chạy test. Nếu fail -> Rollback ngay.
--   **Unknown Error:** Nếu không tìm ra nguyên nhân sau 3 lần -> Tạo task Beads "Investigate Unknown Error" và gợi ý user tìm expert.
+-   **Unknown Error:** Nếu không tìm ra nguyên nhân sau 3 lần -> Tạo task Symphony "Investigate Unknown Error" và gợi ý user tìm expert.
 
 ---
 

package/workflows/lifecycle/deploy.md

@@ -2,7 +2,7 @@
 description: 🚀 Deploy lên Production (Dual-Mode v5.0)
 ---
 
-# WORKFLOW: /deploy - The Release Manager (Dual-Mode + Beads)
+# WORKFLOW: /deploy - The Release Manager (Dual-Mode + Symphony)
 
 > **Mode A (Expert):** `/deploy --prod --force` -> Bỏ qua checks, deploy ngay.
 > **Mode B (Guided):** `/deploy` -> Pre-flight Checks -> Config -> Deploy -> Verify.
@@ -23,9 +23,9 @@ description: 🚀 Deploy lên Production (Dual-Mode v5.0)
 2.  **Execute:**
     -   Chạy build script (`npm run build`).
     -   Chạy deploy command (Vercel/Docker/AWS).
-3.  **Beads Sync:**
-    -   Tạo release tag trong Beads: `bd release create v1.0.0`.
-    -   Mark tất cả tasks `in_progress` -> `done` (Optional).
+3.  **Symphony Sync:**
+    -   Complete all in-progress tasks: `symphony_complete_task(task_id, summary)`.
+    -   Report deployment progress.
 4.  **Report:** "✅ Deployed to Production. URL: [Link]"
 
 ---
@@ -35,7 +35,7 @@ description: 🚀 Deploy lên Production (Dual-Mode v5.0)
 ### Phase 1: Pre-Audit & Health Check
 1.  **Blocker Check:**
     -   Check `session.json`: Có test nào đang `skipped` không?
-    -   Check `bd list`: Có task nào `critical` đang mở không?
+    -   Check Symphony: Có task nào `critical` đang mở không?
     -   *If Issue:* ❌ "Khoan! Còn 2 bugs nghiêm trọng chưa fix. Bạn chắc chắn muốn deploy?"
 
 2.  **Environment Check:**
@@ -56,9 +56,9 @@ description: 🚀 Deploy lên Production (Dual-Mode v5.0)
 1.  **Smoke Test:**
     -   AI tự truy cập URL vừa deploy.
     -   Check HTTP 200, check JS errors.
-2.  **Beads Release:**
+2.  **Symphony Release:**
     -   "Tạo Release Note từ các tasks đã làm?"
-    -   Action: `bd release create` kèm danh sách tasks.
+    -   Action: Complete all related tasks in Symphony.
 3.  **Action Menu:**
     ```markdown
     1️⃣ 📢 Thông báo team (Copy release note)
@@ -68,11 +68,11 @@ description: 🚀 Deploy lên Production (Dual-Mode v5.0)
 
 ---
 
-## 🧠 Brain & Beads Logic
+## 🧠 Brain & Symphony Logic
 
 ### 1. Release Tracking
 -   Mỗi lần deploy thành công -> Tạo bản ghi trong `brain/releases/`.
--   Nội dung: Version, Date, Commit Hash, Link tới Beads Release.
+-   Nội dung: Version, Date, Commit Hash.
 
 ### 2. Deployment Knowledge
 -   Lưu các preferences của user (vd: "Luôn dung Vercel", "Luôn skip test ở Staging").
@@ -91,5 +91,5 @@ description: 🚀 Deploy lên Production (Dual-Mode v5.0)
 ```
 1️⃣ Monitor logs (`/logs`)
 2️⃣ Rollback nhanh (`/rollback`)
-3️⃣ Đóng task trong Beads (`/done`)
+3️⃣ Đóng task trong Symphony (`/done`)
 ```

package/workflows/lifecycle/init.md

@@ -1,152 +1,164 @@
 ---
-description: ✨ Khởi tạo dự án chuẩn Antigravity (v4.1 - Master Orchestrator)
+description: ✨ Khởi tạo dự án chuẩn Antigravity (v5.0 - Spec-First + CLI Hybrid)
 ---
 
-# WORKFLOW: /init - The Antigravity Orchestrator (v4.1)
+# WORKFLOW: /init - The Antigravity Orchestrator (v5.0)
 
-> **Mission:** Không chỉ tạo file. `/init` thiết lập toàn bộ "Hệ điều hành phát triển" (OS for Development), tích hợp sẵn tư duy Spec-First, Clean Architecture và MCP Tools.
+> **Mission:** Thiết lập "Hệ điều hành phát triển" (OS for Development) với Spec-First approach.
+> **Key Change v5.0:** Tạo Project-Level Spec (PROJECT.md, REQUIREMENTS.md, ROADMAP.md, TECH-SPEC.md) ngay từ đầu.
+> **Hybrid:** CLI scaffolds → AI fills content through brainstorm.
 
 ---
 
-## 🚀 Giai đoạn 0: Environment & MCP Check (New in v4.1)
-Trước khi làm bất cứ điều gì, kiểm tra "vũ khí":
+## 🚀 Giai đoạn 0: Environment & MCP Check
 
 1.  **MCP Status Check**:
-    *   `firebase-mcp-server`: [Check] -> Nếu thiếu, hỏi user có cần Backend/Auth không?
-    *   `maestro`: [Check] -> Nếu thiếu, warn "Sẽ không thể chạy test UI tự động".
-    *   `ios-simulator`: [Check] -> Nếu là dự án Mobile, yêu cầu bật Simulator.
-    *   `google-ads-mcp`: [Check] -> (Optional) Cho Marketing.
+    *   `firebase-mcp-server`: [Check] → Nếu thiếu, hỏi user có cần Backend/Auth không?
+    *   `maestro`: [Check] → Nếu thiếu, warn "Sẽ không thể chạy test UI tự động".
+    *   `ios-simulator`: [Check] → Nếu là dự án Mobile, yêu cầu bật Simulator.
 
-2.  **Dev Environment**:
-    *   Node/Ruby/Java/Swift versions.
-    *   Docker status (nếu là Backend).
+2.  **Dev Environment**: Node/Ruby/Java/Swift versions.
 
 ---
 
 ## ⚡ Giai đoạn 1: Context Awareness & Smart Adoption
-*Thay vì hỏi máy móc, hãy quan sát:*
 
 **Kịch bản A: Thư mục trống (New Project)**
-*   Chạy quy trình phỏng vấn **Vision Capture** (như bản cũ).
-*   Hỏi thêm: "Anh muốn dùng template có sẵn không?" (Clean Arch, Boilerplate).
+*   Chạy quy trình phỏng vấn **Vision Capture**.
+*   Hỏi: "Anh muốn dùng template có sẵn không?" (Clean Arch, Boilerplate).
 
 **Kịch bản B: Thư mục có Code (Adoption Mode)**
 *   AI quét cấu trúc hiện tại.
 *   Tự động điền `.project-identity`.
-*   Đề xuất: "Em thấy dự án này đang dùng [Stack]. Anh có muốn em setup lại folder `docs/` và `scripts/` để chuẩn hóa theo Antigravity Workflow không?"
+*   Đề xuất chuẩn hóa theo Antigravity Workflow.
 
 ---
 
-## 🧠 Giai đoạn 2: The Antigravity Core Injection
-*Đây là "bí mật" tạo nên sự khác biệt. Setup nền tảng cho các workflow nâng cao.*
+## 🧠 Giai đoạn 2: Project Skeleton
 
-### 2.1. Create Standard Ecosystem
-Tự động tạo các thư mục và file mẫu:
+1.  **Generate `.project-identity`** (Bắt buộc):
+    *   Copy template từ `~/.gemini/antigravity/templates/project-identity/[platform].json`.
+    *   Customize: Thay thế `{{DATE}}`, `projectName` bằng thông tin thực tế.
 
-1.  **Antigravity Core**:
+2.  **Create Standard Ecosystem**:
     ```bash
-    mkdir -p docs/specs/_templates
+    mkdir -p docs/specs
     mkdir -p docs/architecture/decisions
-    mkdir -p .gemini/scripts
+    mkdir -p .planning/research
     ```
 
-2.  **App Structure (Platform-Specific)**:
-    *   **Action:** Đọc template cấu trúc từ `~/.gemini/antigravity/templates/structures/[platform].txt`.
-    *   **Execute:** Tạo folder tree tương ứng.
-    *   *Ví dụ iOS:* `App/Features`, `App/Shared`, `Tests`, ...
+3.  **App Structure (Platform-Specific)**:
+    *   Đọc template từ `~/.gemini/antigravity/templates/structures/[platform].txt`.
+    *   Tạo folder tree tương ứng.
 
-### 2.2. Inject Templates (Spec & Architecture)
-Tạo file mẫu để workflow `/plan` (create-spec) hoạt động trơn tru:
+4.  **Git Setup**: `.gitignore` thông minh theo stack.
 
-**`docs/specs/_templates/requirements_template.md`**:
-*(Mẫu chuẩn Requirements từng dùng ở `create-spec-architect`)*
+---
 
-**`docs/specs/_templates/architecture_template.md`**:
-*(Mẫu chuẩn Clean Architecture Decision)*
+## 📐 Giai đoạn 3: Project Spec Generation (NEW — Spec-First)
 
-### 2.3. Inject Automation Scripts
-Tạo script để user gõ lệnh tắt là chạy workflow:
+> **Đây là bước mới quan trọng nhất.** AI brainstorm với user để tạo ra "hiến pháp" của dự án.
+> Tất cả feature-level planning SAU NÀY phải tuân theo spec này.
 
-**`scripts/scaffold_feature.sh`**:
-*(Script gọi đến `structure-clean-architect` workflow)*
+### 3.1. Copy Templates
+```bash
+# CLI tự động copy templates vào project
+cp ~/.gemini/antigravity/templates/specs/PROJECT.md docs/specs/PROJECT.md
+cp ~/.gemini/antigravity/templates/specs/requirements-template.md docs/specs/REQUIREMENTS.md
+cp ~/.gemini/antigravity/templates/specs/ROADMAP.md docs/specs/ROADMAP.md
+cp ~/.gemini/antigravity/templates/specs/TECH-SPEC.md docs/specs/TECH-SPEC.md
+```
 
----
+### 3.2. AI Fills Content (Brainstorm Session)
 
-## 🏗️ Giai đoạn 3: Project Skeleton & Hidden Setup
-*(Kế thừa từ v4.0 nhưng mạnh mẽ hơn)*
-
-1.  **Generate `.project-identity`**: (Bắt buộc, là trái tim của mọi workflow).
-    *   **Action:** Copy template từ `~/.gemini/antigravity/templates/project-identity/`:
-        *   `ios.json` cho iOS.
-        *   `android.json` cho Android.
-        *   `expo.json` cho Cross-platform.
-        *   `web-nextjs.json` cho Web App.
-        *   `backend-nestjs.json` cho API.
-    *   **Customize:** Thay thế các placeholder (`{{DATE}}`, `projectName`) bằng thông tin thực tế.
-2.  **Git Setup**: `.gitignore` thông minh theo stack.
-3.  **Linter/Formatter**: Cài ESLint/SwiftLint/Detekt ngay lập tức.
-4.  **CI/CD Basics**: Tạo `.github/workflows/ci.yml` cơ bản (build test).
+AI **chủ động** brainstorm với user để fill từng file:
 
----
+1.  **PROJECT.md** — Hỏi về vision, goals, target audience, success metrics.
+    *   "Dự án này giải quyết vấn đề gì?"
+    *   "Ai là người dùng chính?"
+    *   "Thành công sẽ trông như thế nào?"
 
-## 🎨 Giai đoạn 4: Visual Vision (The WOW Factor)
-*Không để user chờ đợi với màn hình đen trắng.*
+2.  **REQUIREMENTS.md** — Hỏi về features, scope, priorities.
+    *   "Features nào BẮT BUỘC có trong v1?"
+    *   "Có features nào nên để v2?"
+    *   Dùng user story format: "As a [user], I want [action] so that [benefit]"
 
-1.  **Brainstorm UI Concept**:
-    *   Dựa trên ý tưởng user, AI tự nghĩ ra 1 `prompt` mô tả giao diện cực xịn (Dark/Light mode, Glassmorphism...).
-2.  **Generate Mockup**:
-    *   Gọi tool `generate_image` để tạo ngay 1 ảnh "Vision Art".
-    *   Hiển thị cho user: "App của anh trông sẽ ngầu như thế này này!"
+3.  **ROADMAP.md** — Tự động sinh từ requirements.
+    *   Chia phases dựa trên priority + dependencies.
+    *   Mỗi phase có Definition of Done rõ ràng.
+
+4.  **TECH-SPEC.md** — Hỏi về architecture constraints.
+    *   "Có yêu cầu offline-first không?"
+    *   "AI model nào sẽ dùng?"
+    *   Ghi nhận Architecture Decisions (AD-1, AD-2...).
+
+### 3.3. Review & Confirm
+*   AI present tổng kết spec cho user review trước khi lưu.
+*   User approve → spec trở thành "source of truth".
 
 ---
 
-## 🔗 Giai đoạn 5: Handover to Specialized Workflows
-*Sự kết nối chặt chẽ với các quy trình user yêu thích.*
+## 🎨 Giai đoạn 4: Visual Vision (Optional)
+
+1.  **Brainstorm UI Concept** dựa trên spec vừa tạo.
+2.  **Generate Mockup** via `generate_image` tool.
+3.  Hiển thị cho user: "App trông sẽ như thế này!"
 
-Báo cáo hoàn tất và trỏ ngay sang các bước tiếp theo:
+---
 
-### ⚠️ NEXT STEPS (Choose your path):
+## 🔗 Giai đoạn 5: Handover — Symphony + Next Steps
 
-**Path A: The Planner (Chậm mà chắc)**
-> "Tôi muốn lên kế hoạch chi tiết cho tính năng đầu tiên."
-👉 Gõ: **/plan** (Sẽ chạy `create-spec-architect` dùng template vừa tạo).
+1.  **Register project trong Symphony**:
+    ```bash
+    symphony project register --id <projectId> --name "<projectName>"
+    ```
 
-**Path B: The Builder (Mì ăn liền)**
-> "Tôi muốn thấy cấu trúc code ngay."
-👉 Gõ: **/structure** (Sẽ chạy `structure-clean-architect` dựa trên `.project-identity`).
+2.  **Tạo initial tasks từ ROADMAP.md Phase 1**:
+    *   Mỗi feature trong Phase 1 → 1 Symphony task (status: ready).
 
-**Path C: The Artist (UI First)**
-> "Tôi muốn thiết kế giao diện trước."
-👉 Gõ: **/visualize** (Sẽ chạy `design-to-ui` / `ui-first-methodology`).
+3.  **Present next steps**:
+    ```
+    🎉 SETUP COMPLETE!
+    
+    📐 Specs created:
+       + docs/specs/PROJECT.md
+       + docs/specs/REQUIREMENTS.md
+       + docs/specs/ROADMAP.md
+       + docs/specs/TECH-SPEC.md
+    
+    🎯 Symphony tasks created from Phase 1:
+       📋 #sym-A1 — [Feature 1] (ready)
+       📋 #sym-A2 — [Feature 2] (ready)
+    
+    ➡️ Next: Pick a feature to start PLANNING mode.
+       AI will read your specs automatically.
+    ```
 
 ---
 
-## 📝 Example Execution for User
+## 📝 Example Execution
 
 ```text
-Antigravity Initializer v4.1
+Antigravity Initializer v5.0
 ----------------------------
 ✅ Checking Environment... OK
-✅ Checking MCPs... Firebase (OFF), Maestro (ON)
+✅ Checking MCPs... Firebase (ON), Maestro (ON)
 📂 Project detected: Empty folder
 
 🤖 Let's build something great!
-... [Vision Capture Questions] ...
-
-🚀 Setting up Antigravity Core...
-   + docs/specs/_templates
-   + .project-identity
-   + .gitignore
-   + scripts/scaffold_feature.sh
+... [Vision Capture + Spec Brainstorm] ...
 
-🎨 Generating Vision Concept... [Done]
-   (Image: A sleek, dark-themed dashboard for [AppName])
+📐 Filling Project Specs...
+   ✅ docs/specs/PROJECT.md — filled
+   ✅ docs/specs/REQUIREMENTS.md — filled (12 requirements)
+   ✅ docs/specs/ROADMAP.md — filled (3 phases)
+   ✅ docs/specs/TECH-SPEC.md — filled (5 architecture decisions)
 
-🎉 SETUP COMPLETE!
-Your "Operating System" is ready.
+🎯 Symphony tasks created:
+   📋 #sym-A1 — User Authentication (P0, ready)
+   📋 #sym-A2 — Onboarding Flow (P0, ready)
+   📋 #sym-A3 — Dashboard UI (P1, ready)
 
-What's your first move?
-1. /plan [FeatureName] (Recommended: Create Specs first)
-2. /structure [FeatureName] (Scaffold Code)
-3. /visualize (Design UI)
+🎉 SETUP COMPLETE! Your "Operating System" is ready.
+➡️ Pick a feature to start building.
 ```

package/workflows/lifecycle/master-code-workflow.md

@@ -23,7 +23,7 @@ description: Quy trình thiết kế tính năng toàn diện từ kiến trúc
 │  └── Domain → Data → Presentation layers                   │
 │                          ↓                                  │
 │  Phase 3: FEATURE SPECS                       │
-│  └── requirements.md → design.md → bd tasks                │
+│  └── requirements.md → design.md → Symphony tasks                │
 │                          ↓                                  │
 │  Phase 4: UI/UX DESIGN                                     │
 │  └── Design analysis + Platform guidelines                 │
@@ -206,9 +206,9 @@ Use `/auto-implement [feature-name]` for spec-driven auto-coding.
 
 ### 5.3. Progress Tracking
 
-Update `bd` status as you complete each task:
+Update Symphony status as you complete each task:
 ```bash
-bd close [id]
+symphony_complete_task(task_id)
 ```
 
 ---