@leejungkiin/awkit 1.3.8 → 1.4.2

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/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]
+```

package/workflows/_uncategorized/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/_uncategorized/ship-to-code.md

@@ -0,0 +1,85 @@
+---
+description: 🚢 Chuyển đổi mã nguồn từ ngôn ngữ bất kỳ sang ngôn ngữ bất kỳ với cấu trúc hiện đại.
+skill: ship-to-code
+---
+
+# /ship-to-code — Universal Code Porting Workflow
+
+> **Skill:** `ship-to-code` v1.0 | **Tech:** Agnostic (Any-to-Any)
+> **Philosophy:** "Map Dependencies → Bootstrap Architecture → Translate Idiomatically → Parity Check"
+
+---
+
+## ⚡ QUICK START
+
+User cung cấp: Source code hoặc thư mục chứa codebase cũ, và cho biết NGÔN NGỮ NGUỒN + NGÔN NGỮ ĐÍCH.  
+Ví dụ:  
+- "Dịch folder này từ Java sang Go"
+- "/ship-to-code từ Python Django sang Node.js NestJS"
+- "Dùng codebase Ruby làm tham chiếu để viết lại bằng Rust"
+
+Workflow dẫn dắt qua pipeline **6 Phases** để đảm bảo quá trình chuyển đổi an toàn, kiến trúc chuẩn xác, và không bị thất thoát business logic.
+
+---
+
+## 🔵 Session Setup
+
+### Bước 0.1: Khởi tạo session state
+
+```yaml
+porting_session:
+  source_lang: "[Nguồn]"
+  target_lang: "[Đích]"
+  source_dir: "[path_to_source]"
+  current_phase: 0
+  dependency_matrix: pending
+  completed_modules: []
+```
+
+### Bước 0.2: Xác nhận input
+
+```
+🚢 Universal Code Porting v1.0
+
+Xin chào! Để đảm bảo tính chính xác cho quá trình migrate (vừa không rớt logic, vừa chuẩn idiomatic code), cho phép em hỏi để map cấu trúc:
+1. Thư mục chứa code nguồn cũ nằm ở đâu trên máy anh?
+2. Ngôn ngữ / Framework gốc là gì?
+3. Trọng tâm của framework / kiến trúc đích anh đang hướng đến là gì? (Ví dụ: Go standard layout vs NestJS Clean Architecture)
+```
+
+---
+
+## 📋 Pipeline Overview (6 Phases)
+
+| Phase | Name | Focus | Output |
+|-------|------|-------|--------|
+| 0 | 🔍 Ecosystem Mapping | Quét configuration dependencies của code cũ, đề xuất specs/thư viện thay thế. | Dependency Matrix |
+| 1 | 🏗️ Architecture Design | Phân tích app entry points, lifecycle. Thiết kế cấu trúc thư mục mới phù hợp môi trường đích. | Project Scaffold |
+| 2 | 💾 Data & Domain | Port Database schemas/Migrations, Models/DTOs, API Clients, Core Repositories. | Stable Data Layer |
+| 3 | 🧮 Logic & Utils | Dịch thuật toán, mã hóa crypto, helper functions. **PHẢI có Unit Tests**. | Logic + Test Parity |
+| 4 | 🎨 Presentation/Controllers | Dịch Controllers/Routes (Backend) hoặc UI Components (Frontend/Mobile). | Final UX / Routes |
+| 5 | ✅ Final Parity | Kiểm tra Branch coverage của edge-cases. Rà soát Data/Params Parity. | Ready to Deploy |
+
+---
+
+## 🔬 EXECUTION RULES
+
+```yaml
+never_skip:
+  - Phase 0 (Mapping) — Bắt buộc phải ánh xạ thư viện Nguồn → Đích rõ ràng trước khi code.
+  - Viết Unit Tests ở Phase 3 cho các utility xử lý chuỗi/mã hóa/thời gian.
+
+never_do:
+  - Dịch "word-by-word" (Line-by-line syntax translation). 
+    Ví dụ: Không bê nguyên class tĩnh Java sang Go, không xài `try-catch` ép buộc trong Rust, v.v.
+  - Tự ý bỏ qua các nhánh (if-else, try-catch) bắt lỗi ngầm trong codebase gốc.
+
+always_do:
+  - Report / Xin phép chỉ đạo sau mỗi Phase trước khi qua Phase mới.
+  - Viết code **Idiomatic** — áp dụng convention, design patterns và best practices riêng biệt và tự nhiên nhất của NGÔN NGỮ ĐÍCH.
+  - Đảm bảo I/O Parity (mọi Response Data, Crypto Hash) trả về phải GIỐNG Y HỆT API/Logic nguồn.
+```
+
+---
+
+*ship-to-code workflow v1.0.0 — Any-to-Any Porting Pipeline*

package/workflows/_uncategorized/trello-sync.md

@@ -0,0 +1,52 @@
+---
+description: 🔄 Đồng bộ thủ công Project Status lên Trello Card (tuân thủ quy tắc Anti-Spam)
+---
+
+# 🔄 Trello Sync Workflow (`/trello-sync`)
+
+Quy trình này hướng dẫn AI đồng bộ thủ công mức độ hoàn thành của dự án hiện tại lên Trello Card, dựa trên dữ liệu từ thiết kế, Kiro Specs, hoặc Symphony tasks.
+
+## 🎯 Mục đích
+Được sử dụng khi người dùng muốn ép (force) AI cập nhật tiến độ tổng thể lên Trello, hoặc khi AI cần tổng kết (summarize) status sau một Sprint/Milestone quan trọng.
+
+## 📋 Hướng dẫn thực thi
+
+### Bước 1: Thu thập ngữ cảnh hiện tại
+1. Kiểm tra trạng thái dự án hiện tại (đọc `Symphony` tasks, `.kiro/specs/tasks.md` hoặc các file spec nội bộ).
+2. Tóm tắt lại các **module hoặc tính năng lớn** (High-level features) đã hoàn thành, đang làm, và chưa làm.
+
+### Bước 2: Load Trello Configuration
+1. Đảm bảo shell đã có sẵn `TRELLO_KEY` và `TRELLO_TOKEN` (từ biến môi trường máy). CLI đã tự động thừa hưởng.
+2. Đọc file `.trello-config.json` tại thư mục gốc của dự án để lấy thông tin `<board>`, `<list>`, và `<card>`.
+3. Nếu file cấu hình không tồn tại, báo lỗi và yêu cầu user tạo cấu hình hoặc chạy `/init`.
+
+### Bước 3: Cập nhật Trello (Cân bằng giữa Chi tiết và Tối giản)
+> **⛔ CẢNH BÁO QUAN TRỌNG:**
+> Đừng "spam" tạo checklist item cho các task code le te. Nhưng cũng ĐỪNG quá trống rỗng. Hãy cập nhật Card Description và Comment đầy đủ ý nghĩa cho Quản lý dự án.
+
+1. Hãy sử dụng thư viện native CLI `awkit trello`. Không dùng lệnh `trello-cli` thuần hay script Python/Bash.
+2. **Cập nhật Mô tả (Description)** tổng quan của dự án (cực kỳ quan trọng để Quản lý nắm bắt):
+   ```bash
+   awkit trello desc "**Tech Stack:** Kotlin, Compose... **Hiện trạng:** Đang làm module Foundation..."
+   ```
+3. CHỈ đồng bộ tên Milestone / Module / Feature lớn vào Checklist Item.
+4. **Thêm Checklist mới** (nếu module đó chưa có checklist riêng):
+   ```bash
+   awkit trello checklist "<Milestone / Module Name>"
+   ```
+5. **Thêm item mới vào Checklist** (Task mới):
+   ```bash
+   awkit trello item "<Feature Name>"
+   ```
+6. **Mark done một item** (Module lớn đã xong):
+   ```bash
+   awkit trello complete "<Feature Name>"
+   ```
+7. **Thêm Comment** tổng kết milestone:
+   ```bash
+   awkit trello comment "🎯 Milestone Update: Chúng ta đã hoàn thành feature..."
+   ```
+
+### Bước 4: Hoàn tất
+1. Tóm tắt lại với user về các module/tính năng đã được sync thành công lên Trello card.
+2. Gợi ý Next step: Gọi `/next` hoặc `/code` để tiếp tục làm việc.

package/workflows/context/codebase-sync.md

@@ -23,102 +23,25 @@ MANUAL trigger:
 
 ---
 
-## Phase 1: Assess Current State
+## Execution Phase: Delegate to Gemini CLI
 
-```bash
-# 1. Đọc CODEBASE.md hiện tại
-cat CODEBASE.md
-
-# 2. Check git: files changed/added gần đây (14 ngày)
-git log --since="14 days ago" --name-only --pretty=format: | sort -u | grep -v '^$'
-
-# 3. Lấy session file edits từ memory-sync W6
-cat brain/session.json | grep files_touched_this_session
-
-# 4. Check new files không có trong CODEBASE.md
-# AI tự compare danh sách git + session với entries trong CODEBASE.md
-```
-
-**Output:**
-```
-📊 CODEBASE Sync Assessment:
-  - Files in CODEBASE.md: [N files documented]
-  - New/changed files (14d): [M files]
-  - Missing from CODEBASE.md: [K files listed]
-  - Last updated: [date from CODEBASE.md]
-```
-
----
-
-## Phase 2: Generate Delta
-
-Với mỗi file thiếu trong CODEBASE.md, AI tự suy luận:
-
-```yaml
-for each missing_file:
-  1. Xác định layer:
-     - App/ → App Layer
-     - Core/Domain/ → Domain Layer
-     - Core/Data/ → Data Layer
-     - Core/Services/ → Services Layer
-     - Features/[X]/ → Features Layer
-     - Presentation/Views/ → Views
-     - Presentation/ViewModels/ → ViewModels
-
-  2. Xác định responsibility từ:
-     - Filename (AuthenticationViewModel → Auth UI logic)
-     - Directory (Core/Domain/UseCases → Business logic)
-     - Content (nếu cần, đọc file — chỉ khi không đủ context)
-
-  3. Generate entry:
-     - File: path/to/File.swift
-     - Layer: [layer name]
-     - Purpose: [1-line description]
-     - Key exports: [main class/struct/func]
-
-  4. Xác định section trong CODEBASE.md phù hợp để append
-```
-
----
-
-## Phase 3: Update CODEBASE.md
+Thực thi workflow bằng cách gọi Gemini CLI để tận dụng LLM phân tích chuyên sâu mà không làm ảnh hưởng context của Antigravity. Gemini CLI sẽ tự check file, tính toán delta và cập nhật `CODEBASE.md`.
 
 > [!IMPORTANT]
-> CODEBASE.md dùng **compact format** — AI đọc nhanh, tốn ít context.
+> CODEBASE.md dùng **compact format** dạng bảng.
 > 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
-
-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]
-  **Sync:** Auto-updated via /codebase-sync
+```bash
+gemini -p "Đọc CODEBASE.md, git log (14 ngày gần nhất), và brain/session.json. So sánh để tìm các file mới/bị sửa nhưng chưa có trong CODEBASE.md. Suy luận Layer và Purpose cho mỗi file. Sinh ra Delta dưới dạng bảng (compact format) và APPEND vào CODEBASE.md. Cập nhật ngày Last Updated." --approval-mode auto
 ```
 
-**Preview trước khi apply:**
+**Output mong đợi từ Gemini CLI:**
 ```
-📝 Sẽ thêm [K] entries vào CODEBASE.md:
-  + Core/Services/PushNotificationService.swift → FCM push notification
-  + Features/WeeklyGoal/ViewModels/WeeklyGoalVM.swift → Weekly goal logic
+✅ CODEBASE.md Synced!
 
-Apply? [auto-yes nếu < 10 entries / confirm nếu lớn hơn]
+  📊 Added: [K] new entries
+  📁 Sections updated: [list]
+  🕐 Last Updated: [current date]
 ```
 
 ---