@leejungkiin/awkit 1.3.8 → 1.4.0

package/skills/symphony-enforcer/SKILL.md

@@ -7,8 +7,8 @@ description: |
   v3.5: UI-First Three-Phase Execution with User Test Checkpoints.
 metadata:
   stage: core
-  version: "3.5"
-  replaces: "v3.4"
+  version: "3.6"
+  replaces: "v3.5"
   requires: symphony-orchestrator
   tags: [symphony, enforcement, checkpoint, task-lifecycle, core, spec-first, auto-next, kiro, ui-first, user-test]
 agent: Symphony Enforcer
@@ -24,14 +24,15 @@ invocation-type: auto
 priority: 1
 ---
 
-# Symphony Enforcer v3.5 — UI-First Three-Phase Execution + User Test Checkpoints
+# Symphony Enforcer v3.6 — UI-First Three-Phase Execution + Legacy Cleanup
 
 > **Purpose:** Đảm bảo AI KHÔNG BAO GIỜ quên cập nhật Symphony.
-> **Key Changes v3.5:**
+> **Key Changes v3.6:**
+> - **Step 0.5: Legacy Artifact Cleanup**: Auto-detect stale `.symphony/tasks.json` and warn user
 > - **Gate 4 Three-Phase Execution**: Phase A (Infra) → Phase B (UI Shell + User Test) → Phase C (Logic + User Test)
 > - **TP1.7: User Test Checkpoint**: Trigger dừng lại cho user test trên device thật
 > - **UI-First Task Ordering**: UI tasks PHẢI đi trước logic tasks trong Symphony
-> - Kế thừa tất cả features v3.4 (Kiro, Completion Status, Design Compliance).
+> - Kế thừa tất cả features v3.5 (Kiro, Completion Status, Design Compliance).
 > **Principle:** AI tự detect completion — user KHÔNG CẦN nói "xong".
 
 ---
@@ -52,16 +53,32 @@ KHÔNG CÓ NGOẠI LỆ:
 
 ## 🔒 STRICT STARTUP PROTOCOL (BẮT BUỘC)
 
-Mỗi khi bắt đầu task code/debug/plan, AI PHẢI đi qua **5 steps tuần tự**.
+Mỗi khi bắt đầu task code/debug/plan, AI PHẢI đi qua **6 steps tuần tự**.
 KHÔNG được bắt đầu work cho đến khi TẤT CẢ steps ✅.
 
+### Step 0.5: Legacy Artifact Cleanup (AUTO — v3.6)
+
+```
+→ Kiểm tra: .symphony/tasks.json tồn tại?
+→ CÓ  → ⚠️ CẢNH BÁO: "Legacy tasks.json detected. Symphony uses SQLite DB — this file is stale."
+       → Khuyên user xoá: "rm .symphony/tasks.json"
+       → KHÔNG tự xoá (safety guardrail) — chỉ cảnh báo.
+       → Ghi log vào NeuralMemory: "Legacy tasks.json found at {project}, warned user."
+→ KHÔNG → ✅ Clean (no legacy artifacts)
+→ Output: "🧹 Step 0.5: Legacy Check ✅ — No stale artifacts"
+```
+
+> **Lý do:** Symphony v2+ sử dụng SQLite DB (`symphony.db`) làm single source of truth.
+> File `tasks.json` là di sản từ phiên bản cũ (pre-SQLite). Nếu tồn tại song song sẽ gây
+> "split-brain" — một nửa tool đọc JSON, một nửa đọc DB → dữ liệu lệch pha.
+
 ### Step 1: Project Identity — `.project-identity`
 
 ```
 → Kiểm tra: file .project-identity có tồn tại?
 → CÓ  → Đọc projectId, projectName
 → KHÔNG → ⛔ DỪNG. Hỏi user hoặc tạo .project-identity.
-→ Output: "📋 Step 1/5: Project Identity ✅ — {projectId}"
+→ Output: "📋 Step 1/6: Project Identity ✅ — {projectId}"
 ```
 
 ### Step 2: NeuralMemory Brain — Switch brain
@@ -69,7 +86,7 @@ KHÔNG được bắt đầu work cho đến khi TẤT CẢ steps ✅.
 ```
 → nmem brain use <projectId>
 → nmem_recap(level=1) — load context
-→ Output: "🧠 Step 2/5: Brain ✅ — switched to {projectId}"
+→ Output: "🧠 Step 2/6: Brain ✅ — switched to {projectId}"
 ```
 
 ### Step 3: Spec Alignment — Đọc Project Spec (v3.4 + Kiro)
@@ -82,7 +99,7 @@ KHÔNG được bắt đầu work cho đến khi TẤT CẢ steps ✅.
      - .kiro/specs/<module>/design.md → architecture
      - .kiro/specs/<module>/tasks.md → task breakdown (cho Step 4)
      → Extract constraints liên quan đến task hiện tại
-     → Output: "📐 Step 3/5: Kiro Specs Loaded ✅ — {N} modules, {M} design docs"
+     → Output: "📐 Step 3/6: Kiro Specs Loaded ✅ — {N} modules, {M} design docs"
 
 → CHECK 2 (fallback): docs/specs/PROJECT.md tồn tại?
   → CÓ  → Đọc silent: PROJECT.md + TECH-SPEC.md + REQUIREMENTS.md
@@ -90,8 +107,8 @@ KHÔNG được bắt đầu work cho đến khi TẤT CẢ steps ✅.
          → NẾU PLANNING mode:
             - Hỏi user 1-3 câu về constraints/UX cụ thể của feature
             - Ví dụ: "Feature này cần offline support không?"
-         → Output: "📐 Step 3/5: Spec Aligned ✅"
-  → KHÔNG → Skip (project chưa /init) → "📐 Step 3/5: No spec — skipped"
+         → Output: "📐 Step 3/6: Spec Aligned ✅"
+  → KHÔNG → Skip (project chưa /init) → "📐 Step 3/6: No spec — skipped"
 ```
 
 > **Quan trọng:** Nếu .kiro/specs hoặc TECH-SPEC.md có "Constraints & Non-Negotiables",
@@ -105,7 +122,7 @@ KHÔNG được bắt đầu work cho đến khi TẤT CẢ steps ✅.
      - Group theo module name
      - Đánh tag kèm module name
      → ⛔ CẢNH BÁO: KHÔNG đồng bộ hàng loạt các item nhỏ này lên Trello (để tránh rác board). Chỉ đồng bộ lên cấp module hoặc feature lớn.
-     → Output: "🎯 Step 4/5: Kiro Tasks Imported ✅ — {N} tasks created"
+     → Output: "🎯 Step 4/6: Kiro Tasks Imported ✅ — {N} tasks created"
      → Claim task phù hợp nhất với user request
   → CÓ + đã import → symphony_available_tasks → claim task phù hợp
 
@@ -114,7 +131,7 @@ KHÔNG được bắt đầu work cho đến khi TẤT CẢ steps ✅.
   → CÓ task ready phù hợp → symphony_claim_task
   → KHÔNG CÓ → symphony_create_task(title) → symphony_claim_task(new_id)
 → Lưu task_id cho TP1-TP4
-→ Output: "🎯 Step 4/5: Task ✅ — #sym-XYZ claimed"
+→ Output: "🎯 Step 4/6: Task ✅ — #sym-XYZ claimed"
 ```
 
 ### Step 5: Confirmation Block
@@ -122,11 +139,12 @@ KHÔNG được bắt đầu work cho đến khi TẤT CẢ steps ✅.
 ```
 🚦 STARTUP PROTOCOL COMPLETE
 ══════════════════════════════════════
-  Step 1: 📋 Project Identity  ✅  {projectId}
-  Step 2: 🧠 NeuralMemory      ✅  brain: {projectId}
-  Step 3: 📐 Spec Alignment     ✅  {constraints_count} constraints loaded
-  Step 4: 🎯 Task              ✅  #sym-XYZ — "{title}"
-  Step 5: ✅ READY TO WORK
+  Step 0.5: 🧹 Legacy Check     ✅  No stale artifacts
+  Step 1:   📋 Project Identity  ✅  {projectId}
+  Step 2:   🧠 NeuralMemory      ✅  brain: {projectId}
+  Step 3:   📐 Spec Alignment     ✅  {constraints_count} constraints loaded
+  Step 4:   🎯 Task              ✅  #sym-XYZ — "{title}"
+  Step 5:   ✅ READY TO WORK
 ══════════════════════════════════════
 ```
 

package/skills/trello-sync/SKILL.md

@@ -30,21 +30,23 @@ priority: 2
 KHÔNG CÓ NGOẠI LỆ:
 - 1 Dự án = 1 Trello Card (KHÔNG tạo card mới cho mỗi task).
 - **Mô tả Card (Description)** BẮT BUỘC phải được update chứa cái nhìn tổng thể về dự án (Mục tiêu, Tech Stack, Tình trạng chung) để Quản lý dễ nắm bắt.
-- **Trello (PM View) vs Kiro (Dev View):** Trello là màn hình dành cho Quản lý (PM, QC), còn `.kiro/specs/tasks.md` là nơi để AI/Dev làm việc. Hai khái niệm này hoàn toàn khác nhau.
-- [QUAN TRỌNG] Checklist Items trên Trello = ĐẦU VIỆC NGHIỆP VỤ (Business Features). VD: "Màn hình Đăng Nhập", "Chức năng AI Chat", "Tích hợp Thanh Toán".
-- ⛔ TUYỆT ĐỐI CẤM đưa các GIAI ĐOẠN QUY TRÌNH (Process Gates) vào Checklist Items. KHÔNG CÓ CÁC MỤC NHƯ: "Tài liệu", "Thiết kế Giao diện", "Gate 1", "Phase 2", "App Scaffolding".
-- PM KHÔNG QUAN TÂM ĐẾN QUY TRÌNH GATE CỦA AI. Progress qua các Gate (Gate 1, Gate 2...) CHỈ ĐƯỢC BÁO CÁO qua Comment.
-- KHÔNG BAO GIỜ bứng nguyên các task kỹ thuật chi tiết (VD: "Tạo file `BloodPressureViewModel.kt`") lên Trello. CẤM ĐỒNG BỘ (bulk-sync) raw `tasks.md` sang Trello.
-- BẮT BUỘC ĐỒNG BỘ TOÀN BỘ DANH SÁCH NGHIỆP VỤ TỔNG HỢP (Features): Chờ đến khi Đặc tả kỹ thuật (Specs) đã có rõ các tính năng, AI mới parse ra các Features thành các Checklist Items để Quản lý (PM) có thể thấy trọn vẹn scope.
-- Card KHÔNG di chuyển giữa lists (list = team member, cố định).
-- Comment ở milestone quan trọng PHẢI bao gồm các quyết định cốt lõi hoặc sự thay đổi phase (VD: "Đã hoàn thành Gate 2 Design", "Bắt đầu code Logic").
+- **Trello (PM View) vs Kiro (Dev View):** Trello là màn hình dành cho Quản lý (PM, QC), còn `.kiro/specs/tasks.md` hay `task.md` là nơi để AI/Dev làm việc.
+- [QUAN TRỌNG NHẤT VỀ ĐỘ CHI TIẾT (GRANULARITY)]: Khi được yêu cầu chia task để sync lên Trello, AI PHẢI CHIA NHỎ các phase/tính năng lớn ra thành các Sub-features / Điểm chạm nghiệp vụ (Medium-detail). CẤM làm task quá chung chung.
+  - BAD (Quá chung chung): "Hoàn thiện Launch", "Setup Thanh Toán", "Xử lý Logic".
+  - BAD (Quá chi tiết / Dev task): "Tạo file BillingManager.kt", "Sửa padding cho nút Share".
+  - GOOD (Chuẩn PM View): "Tích hợp Google Play Billing v7", "Xử lý AlarmManager nhắc nhở đo huyết áp", "Cài đặt Crashlytics", "Thiết kế Store Assets (Icon, Screenshots)".
+- AI NÊN gom nhóm các Items vào thành nhiều Checklist rõ ràng theo từng phân khu lớn (VD: `Checklist: 1. Hoàn Thiện Logic`, `Checklist: 2. Monetization`, `Checklist: 3. Analytics & QA`).
+- ⛔ TUYỆT ĐỐI CẤM đưa các GIAI ĐOẠN QUY TRÌNH (Process Gates) vào Checklist Items. KHÔNG CÓ CÁC MỤC NHƯ: "Tài liệu", "Thiết kế Giao diện", "Gate 1", "Phase 2".
+- Progress qua các Gate (Gate 1, Gate 2...) CHỈ ĐƯỢC BÁO CÁO qua Comment. Quản lý không quan tâm AI đang ở Gate nào trên Checklists.
+- BẮT BUỘC ĐỒNG BỘ TOÀN BỘ DANH SÁCH NGHIỆP VỤ TỔNG HỢP: Khi Spec/dự án đã hòm hòm, AI phân mảnh các scope thành các Checklist Items (như quy tắc Granularity ở trên).
+- Comment ở milestone quan trọng PHẢI bao gồm các quyết định cốt lõi hoặc sự thay đổi phase (VD: "Đã thiết kế xong màn hình Home", "Bắt đầu code Logic tracking").
 ```
 
 ---
 
 ## 🔐 Auth & Config
 
-Credentials được lưu dưới dạng **environment variables** (`TRELLO_KEY`, `TRELLO_TOKEN`) trong shell profile (`~/.zshrc` hoặc `~/.bashrc`). Cấu hình dự án (Board/List/Card) lưu tại `.trello-config.json` ở root mỗi dự án.
+Credentials được lưu dưới dạng **environment variables** (`TRELLO_KEY`, `TRELLO_TOKEN`) trong shell profile (`~/.zshrc` hoặc `~/.bashrc`). Cấu hình dự án (Board/List/Card) lưu trong `"trello"` key của `.project-identity` ở root mỗi dự án (fallback: `.trello-config.json`).
 
 ### 1. Global Credentials (Environment Variables)
 
@@ -52,15 +54,21 @@ User setup lần đầu qua **interactive wizard** khi chạy `awkit init`:
 - CLI tự hỏi API Key → tạo link authorize token → hỏi Token → lưu vào `~/.zshrc`.
 - Nếu user đã setup rồi, CLI tự skip bước này.
 
-### 2. Local Project Config (`.trello-config.json` tại root dự án)
+### 2. Local Project Config (`"trello"` key trong `.project-identity`)
 ```json
 {
-  "board": "Appdexter - Code Magic",
-  "list": "Kiên",
-  "card": "Tên Card Dự Án"
+  "projectName": "MyApp",
+  "projectId": "myapp",
+  "trello": {
+    "board": "Appdexter - Code Magic",
+    "list": "Kiên",
+    "card": "Tên Card Dự Án"
+  }
 }
 ```
 
+> **Fallback:** Nếu `.project-identity` không có key `trello`, CLI sẽ thử đọc `.trello-config.json` (backward compat).
+
 | Field | Mô tả |
 |-------|--------|
 | `board` | Tên board (TÊN, không dùng ID) |
@@ -81,7 +89,7 @@ Lần 3 (vẫn lỗi): báo user "Trello chưa được cấu hình. Vui lòng c
 
 ### Tự Động Hóa Qua `awkit trello` (BẮT BUỘC)
 
-AI không cần tự inject ENV hay tìm kiếm cấu hình. Công cụ lệnh `awkit trello` v1.3.0+ sẽ TỰ ĐỘNG đọc từ env vars và `.trello-config.json`. MỌI thao tác Trello phải đi qua `awkit trello`.
+AI không cần tự inject ENV hay tìm kiếm cấu hình. Công cụ lệnh `awkit trello` v1.3.0+ sẽ TỰ ĐỘNG đọc từ env vars và `.project-identity`. MỌI thao tác Trello phải đi qua `awkit trello`.
 ---
 
 ## 📚 Command Reference
@@ -99,7 +107,7 @@ Công cụ `awkit` đã cung cấp sẵn các lệnh native quản lý Trello. P
 | Báo Blocked / Lỗi | `awkit trello block "<reason>"` |
 | Tạo checklist mới | `awkit trello checklist "<name>"` |
 
-> 💡 Nếu gặp board/list/card "not found", cấu hình có thể sai, báo user kiểm tra lại `.trello-config.json`.
+> 💡 Nếu gặp board/list/card "not found", cấu hình có thể sai, báo user kiểm tra lại `trello` key trong `.project-identity`.
 
 ---
 
@@ -222,14 +230,14 @@ Trong comment, **PHẢI** ghi Symphony Task ID: `Symphony: #sym-XXX`
 
 | Tình huống | Xử lý |
 |-----------|--------|
-| `.trello-config.json` không tồn tại | ⛔ Bỏ qua Trello sync, log cảnh báo, tiếp tục code |
+| Trello config not found | ⛔ Bỏ qua Trello sync, log cảnh báo, tiếp tục code |
 | **Credentials not found** | `source ~/.zshrc` → retry (max 2 lần). Vẫn lỗi → báo user chạy `awkit init` |
 | Card not found | Chạy `sync`, retry. Nếu vẫn lỗi → báo user |
 | Checklist chưa có | Tạo checklist mới bằng `awkit trello checklist` |
 | Item trùng tên | Dùng `card:checklists` kiểm tra trước khi thêm |
 | Rate limit / API error | Log warning, tiếp tục code, KHÔNG block flow. CLI tự retry 429. |
 | Token hết hạn | Báo user chạy `awkit init` để setup lại credential mới |
-| Dự án chưa có card trên Trello | Báo user tạo card trên board, cập nhật `.trello-config.json` |
+| Dự án chưa có card trên Trello | Báo user tạo card trên board, cập nhật `trello` trong `.project-identity` |
 
 ---
 

package/templates/CODEBASE.md

@@ -1,14 +1,15 @@
 # {{PROJECT_NAME}} — Codebase Map
 
-> **Project Type:** {{PROJECT_TYPE}} | **Stage:** {{PROJECT_STAGE}}
-> **Tech Stack:** {{TECH_STACK_SUMMARY}}
+> **Project Type:** {{PROJECT_TYPE}} | **Tech Stack:** {{TECH_STACK_SUMMARY}}
 > **Last Synced:** {{DATE}}
 
----
+> [!NOTE]
+> AI PHẢI đọc file này TRƯỚC KHI dùng `grep_search` / `codebase_search` / `list_dir`.
+> Đọc → xác định target → search cụ thể. KHÔNG search "mù".
 
-## 🗺️ Layer Map
+---
 
-> _AI: Dùng bản đồ này để định vị file trước khi scan directory_
+## 🗺️ Directory Structure
 
 ```
 {{DIR_STRUCTURE}}
@@ -16,47 +17,32 @@
 
 ---
 
-## 📁 Feature Areas
-
-| Area | Location | Description |
-|------|----------|-------------|
-| _(example)_ Features | `{{FEATURES_DIR}}` | Main feature modules |
-| _(example)_ Shared UI | `{{SHARED_UI_DIR}}` | Reusable UI components |
-| _(example)_ Services | `{{SERVICES_DIR}}` | Business logic & data layer |
-| _(example)_ Models | `{{MODELS_DIR}}` | Data models & DTOs |
-
-> ⚠️ Update this table after adding new feature areas.
-
----
+## 📁 File Index
 
-## 🔥 Firebase Integration
+> Compact format: `path` → purpose (1 line mỗi file)
 
-| Feature | Status | Notes |
-|---------|--------|-------|
-| Analytics | ✅ | Event tracking |
-| Crashlytics | ✅ | Crash reporting |
-| Remote Config | ✅ | Feature flags |
-| Auth | ✅ | Sign in methods |
-| Firestore | ⬜ | — |
-| Storage | ⬜ | — |
+### Core / Infrastructure
 
----
+| Path | Purpose |
+|------|---------|
+| `{{CORE_FILE_1}}` | {{PURPOSE_1}} |
+| `{{CORE_FILE_2}}` | {{PURPOSE_2}} |
 
-## 🏗️ Architecture
+### Features
 
-- **Pattern:** {{ARCHITECTURE}}
-- **State Management:** {{STATE_MANAGEMENT}}
-- **Networking:** {{NETWORKING}}
-- **Storage:** {{STORAGE}}
+| Path | Purpose |
+|------|---------|
+| `{{FEATURE_FILE_1}}` | {{PURPOSE_1}} |
+| `{{FEATURE_FILE_2}}` | {{PURPOSE_2}} |
 
----
+### UI / Views
 
-## 📏 Naming Conventions
+| Path | Purpose |
+|------|---------|
+| `{{VIEW_FILE_1}}` | {{PURPOSE_1}} |
+| `{{VIEW_FILE_2}}` | {{PURPOSE_2}} |
 
-- **Files:** `PascalCase` (Swift/Kotlin) or `kebab-case` (JS/TS)
-- **Functions/Methods:** `camelCase`
-- **Constants:** `UPPER_SNAKE_CASE`
-- **Variables:** `camelCase`
+> ⚠️ Thêm file mới vào section phù hợp. Dùng `/codebase-sync` để auto-update.
 
 ---
 
@@ -67,14 +53,12 @@
 | `.project-identity` | AI project context |
 | `CODEBASE.md` | This file — codebase map for AI |
 
-> Add important files here as the project grows.
-
 ---
 
 ## 📝 Notes
 
-_Add architecture decisions, gotchas, and important context here._
+_Architecture decisions, gotchas, và context quan trọng._
 
 ---
 
-*Auto-generated by `awkit init` — keep this file updated with `/codebase-sync`*
+*Auto-generated by `awkit init` — keep updated with `/codebase-sync`*

package/templates/configs/trello-config.json

@@ -1,5 +1,5 @@
 {
   "BOARD_NAME": "Appdexter - Code Magic",
-  "LIST_NAME": "Your Backlog List",
-  "CARD_NAME": "Project Card Name or ID"
+  "LIST_NAME": "Kiên",
+  "CARD_NAME": "FitWitness Android"
 }

package/templates/project-identity/android.json

@@ -1,5 +1,10 @@
 {
+  "_comments": {
+    "projectId": "Auto-generated from folder name. DO NOT change — used by Symphony for task scoping.",
+    "trello": "Fill in your Trello board/list/card names. Run 'awkit trello info' to verify."
+  },
   "projectName": "MyAndroidApp",
+  "projectId": "myandroidapp",
   "projectType": "android",
   "packageName": "com.company.myandroidapp",
   "primaryLanguage": "en",
@@ -16,6 +21,11 @@
     "testing": "JUnit + Espresso",
     "buildSystem": "Gradle (KTS)"
   },
+  "trello": {
+    "board": "Your Board Name",
+    "list": "Your List Name",
+    "card": "Your Card Name"
+  },
   "projectStage": "planning",
   "codingStandards": {
     "language": "en",

package/templates/project-identity/backend-nestjs.json

@@ -1,5 +1,10 @@
 {
+  "_comments": {
+    "projectId": "Auto-generated from folder name. DO NOT change — used by Symphony for task scoping.",
+    "trello": "Fill in your Trello board/list/card names. Run 'awkit trello info' to verify."
+  },
   "projectName": "MyBackendAPI",
+  "projectId": "mybackendapi",
   "projectType": "backend",
   "primaryLanguage": "en",
   "techStack": {
@@ -12,6 +17,11 @@
     "testing": "Jest",
     "deployment": "Docker + Cloud Run"
   },
+  "trello": {
+    "board": "Your Board Name",
+    "list": "Your List Name",
+    "card": "Your Card Name"
+  },
   "projectStage": "planning",
   "codingStandards": {
     "language": "en",

package/templates/project-identity/expo.json

@@ -1,5 +1,10 @@
 {
+  "_comments": {
+    "projectId": "Auto-generated from folder name. DO NOT change — used by Symphony for task scoping.",
+    "trello": "Fill in your Trello board/list/card names. Run 'awkit trello info' to verify."
+  },
   "projectName": "MyExpoApp",
+  "projectId": "myexpoapp",
   "projectType": "expo",
   "bundleIdentifier": "com.company.myexpoapp",
   "primaryLanguage": "en",
@@ -15,6 +20,11 @@
     "testing": "Jest + Detox",
     "build": "EAS Build"
   },
+  "trello": {
+    "board": "Your Board Name",
+    "list": "Your List Name",
+    "card": "Your Card Name"
+  },
   "projectStage": "planning",
   "codingStandards": {
     "language": "en",

package/templates/project-identity/ios.json

@@ -1,5 +1,10 @@
 {
+  "_comments": {
+    "projectId": "Auto-generated from folder name. DO NOT change — used by Symphony for task scoping.",
+    "trello": "Fill in your Trello board/list/card names. Run 'awkit trello info' to verify."
+  },
   "projectName": "MyiOSApp",
+  "projectId": "myiosapp",
   "projectType": "ios",
   "bundleIdentifier": "com.company.myiosapp",
   "primaryLanguage": "en",
@@ -15,6 +20,11 @@
     "testing": "XCTest",
     "packageManager": "SPM"
   },
+  "trello": {
+    "board": "Your Board Name",
+    "list": "Your List Name",
+    "card": "Your Card Name"
+  },
   "projectStage": "planning",
   "codingStandards": {
     "language": "en",

package/templates/project-identity/web-nextjs.json

@@ -1,5 +1,10 @@
 {
+  "_comments": {
+    "projectId": "Auto-generated from folder name. DO NOT change — used by Symphony for task scoping.",
+    "trello": "Fill in your Trello board/list/card names. Run 'awkit trello info' to verify."
+  },
   "projectName": "MyWebApp",
+  "projectId": "mywebapp",
   "projectType": "react_web",
   "primaryLanguage": "en",
   "techStack": {
@@ -12,6 +17,11 @@
     "auth": "NextAuth.js",
     "deployment": "Vercel"
   },
+  "trello": {
+    "board": "Your Board Name",
+    "list": "Your List Name",
+    "card": "Your Card Name"
+  },
   "projectStage": "planning",
   "codingStandards": {
     "language": "en",

package/templates/workflow_dual_mode_template.md

@@ -34,7 +34,7 @@ description: [Short description of the workflow]
 ### Phase 1: Context & Setup
 1. **Understand Intent:**
    - "Bạn muốn làm gì với [Command]?"
-   - (AI analyzes context from `.project-identity` & `.symphony`)
+   - (AI analyzes context from `.project-identity` & `.beads`)
 
 2. **Configuration:**
    - [Question 1]
@@ -68,7 +68,7 @@ description: [Short description of the workflow]
    - Locations of artifacts.
 
 2. **Memory Sync:**
-   - Auto-sync with Symphony (Task) & Brain (Knowledge).
+   - Auto-sync with Beads (Task) & Brain (Knowledge).
 
 3. **Next Steps Menu:**
    ```markdown
@@ -79,9 +79,9 @@ description: [Short description of the workflow]
 
 ---
 
-## 🧠 Brain & Symphony Integration
+## 🧠 Brain & Beads Integration
 
-- **Input:** Check `symphony_available_tasks(filter="my")` to resume context.
+- **Input:** Check `bd list --status in_progress` to resume context.
 - **Output:**
-  - Create/Update Symphony task.
+  - Create/Update Beads task.
   - Create Brain memory file if knowledge is valuable.

package/workflows/_uncategorized/conductor-codex.md

@@ -0,0 +1,125 @@
+---
+description: 🔍 Codex Conductor — Gọi Codex CLI rà soát code, debug, review logic, và verify refactor
+---
+
+# /conductor-codex — Three-Agent Inspector Workflow
+
+> Antigravity gọi Codex CLI (headless, read-only) khi cần rà soát chuyên sâu.
+> Codex CHỈ ĐỌC + TẠO BÁO CÁO `.md`. KHÔNG BAO GIỜ sửa code.
+
+// turbo-all
+
+---
+
+## Prerequisites
+
+1. Kiểm tra Codex CLI:
+```bash
+which codex || echo "NOT_INSTALLED"
+```
+2. Nếu chưa cài → đề xuất cài:
+```bash
+npm i -g @openai/codex
+```
+3. Tạo thư mục report nếu chưa có:
+```bash
+mkdir -p codex-reports
+```
+
+---
+
+## Sub-commands
+
+### `/conductor-codex:debug` — Phân tích root cause bug
+
+1. User mô tả bug (crash, lỗi logic, unexpected behavior)
+2. Thông báo: "🔍 Đang gọi Codex CLI phân tích bug..."
+3. Gọi CLI:
+```bash
+cd <PROJECT_ROOT> && timeout 120 codex "A bug was reported: <BUG_DESCRIPTION>. Analyze the codebase to find the root cause. List: (1) most likely root cause with file:line, (2) contributing factors, (3) suggested fix approach. DO NOT edit any files." --approval-mode suggest -q 2>/dev/null
+```
+4. Parse output → lưu vào `codex-reports/bug-analysis-<DATE>.md`
+5. Tóm tắt findings cho user
+6. Nếu critical → Antigravity thực hiện fix
+
+### `/conductor-codex:review` — Pre-commit code review
+
+1. Kiểm tra có uncommitted changes: `git diff --stat`
+2. Thông báo: "🔍 Đang gọi Codex CLI review code..."
+3. Gọi CLI:
+```bash
+cd <PROJECT_ROOT> && timeout 120 codex "Review the uncommitted changes in this repo. Check for: bugs, logic errors, edge cases, thread safety, security issues, performance problems. Rank issues by severity (critical/warning/info). DO NOT edit any files." --approval-mode suggest -q 2>/dev/null
+```
+4. Parse output → lưu vào `codex-reports/review-<DATE>.md`
+5. Tóm tắt: issues found + severity
+6. Nếu clean → suggest `git commit`
+
+### `/conductor-codex:logic` — Phân tích logic & edge cases
+
+1. Xác định file/module cần kiểm tra
+2. Thông báo: "🔍 Đang gọi Codex CLI kiểm tra logic..."
+3. Gọi CLI:
+```bash
+cd <PROJECT_ROOT> && timeout 120 codex "Analyze <FILE_OR_MODULE> for logic correctness. Focus on: edge cases (null, empty, boundary), race conditions, error handling gaps, unreachable code, off-by-one errors. List each issue with file:line and severity. DO NOT edit any files." --approval-mode suggest -q 2>/dev/null
+```
+4. Parse output → lưu vào `codex-reports/logic-analysis-<DATE>.md`
+5. Tóm tắt findings cho user
+
+### `/conductor-codex:test` — Generate test cases
+
+1. Xác định feature/module cần test
+2. Thông báo: "🔍 Đang gọi Codex CLI generate test cases..."
+3. Gọi CLI:
+```bash
+cd <PROJECT_ROOT> && timeout 120 codex "Analyze <FILE_OR_MODULE> and generate a comprehensive list of test cases. Include: happy path, edge cases, error cases, boundary values. Format as markdown table with columns: Test Name | Input | Expected Output | Type. DO NOT edit any files." --approval-mode suggest -q 2>/dev/null
+```
+4. Parse output → lưu vào `codex-reports/test-cases-<DATE>.md`
+5. Trình bày test plan cho user
+
+### `/conductor-codex:plan-review` — Review implementation plan
+
+1. Đọc `implementation_plan.md` hiện tại
+2. Thông báo: "🔍 Đang gọi Codex CLI review plan..."
+3. Gọi CLI:
+```bash
+cd <PROJECT_ROOT> && timeout 120 codex "Review this implementation plan in the current directory. Find: logic holes, missing error handling, security risks, race conditions, scalability issues, missing edge cases. Rate each issue by severity (critical/warning/info). DO NOT edit any files." --approval-mode suggest -q 2>/dev/null
+```
+4. Parse output → lưu vào `codex-reports/plan-review-<DATE>.md`
+5. Tóm tắt issues → Antigravity cập nhật plan
+
+---
+
+## Fallback Rules
+
+```yaml
+cli_not_installed:
+  - "⚠️ Codex CLI chưa cài. Chạy: npm i -g @openai/codex"
+  - Offer to install automatically
+
+cli_unavailable:
+  - "⚠️ Codex CLI không khả dụng, tiếp tục với Antigravity-only"
+  - Do NOT block workflow
+
+cli_timeout:
+  - "⏳ Codex phân tích quá lâu (>120s), bỏ qua và tiếp tục"
+
+cli_error:
+  - Log error
+  - Fall back gracefully
+  - Suggest: "codex --version" to check installation
+```
+
+---
+
+## Communication
+
+Mỗi khi gọi CLI, LUÔN thông báo user:
+```
+🔍 Đang gọi Codex CLI để [mục đích]...
+```
+
+Sau khi nhận kết quả:
+```
+✅ Codex rà soát xong. Báo cáo: codex-reports/<file>.md
+📊 Tóm tắt: [key findings]
+```