@leejungkiin/awkit 1.0.0

package/workflows/lifecycle/debug.md

@@ -0,0 +1,116 @@
+---
+description: 🐞 Sửa lỗi & Debug (Dual-Mode v5.0)
+---
+
+# WORKFLOW: /debug - The Sherlock Holmes (Dual-Mode + Beads)
+
+> **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.
+
+---
+
+## 🅰️ Expert Mode (Direct Execution)
+
+**Usage:**
+```bash
+/debug --auto-fix --file src/components/Cart.tsx
+```
+
+**Logic:**
+1.  **Auto-Detect:**
+    -   Đọc logs gần nhất.
+    -   Parse error stack trace.
+    -   Identify file & line number.
+2.  **Root Cause Analysis:**
+    -   Phân tích code tại vị trí lỗi.
+    -   Đưa ra 1-2 giả thuyết.
+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`.
+5.  **Report:** "✅ Fixed 1 issue. ⚠️ Created task #456 for manual review."
+
+---
+
+## 🅱️ Guided Mode (Interactive Wizard)
+
+### Phase 1: Error Discovery
+1.  **Symptom Check:**
+    ```markdown
+    Lỗi xảy ra như thế nào?
+    1️⃣ Trang trắng toát
+    2️⃣ Loading mãi không dừng
+    3️⃣ Báo lỗi đỏ
+    4️⃣ Nút không hoạt động
+    5️⃣ Dữ liệu sai
+    ```
+
+2.  **Context Gathering:**
+    -   "Lỗi xảy ra khi nào? (Mở app / Sau login / Bấm nút X)"
+    -   "Có chụp màn hình hoặc copy error message không?"
+
+### Phase 2: Investigation
+1.  **AI Autonomous Analysis:**
+    -   Đọc logs, stack trace.
+    -   Inspect code liên quan.
+    -   Đưa ra 2-3 giả thuyết.
+
+2.  **Hypothesis Menu:**
+    ```markdown
+    Em nghĩ có 3 nguyên nhân:
+    1️⃣ Database chưa bật (Khả năng cao)
+    2️⃣ API trả về lỗi 500
+    3️⃣ Biến undefined
+
+    Muốn em kiểm tra cái nào trước?
+    ```
+
+### Phase 3: Fix Strategy
+1.  **Root Cause Explanation:**
+    -   Giải thích bằng ngôn ngữ đời thường.
+    -   Ví dụ: "Danh sách sản phẩm đang trống nên code bị lỗi khi cố hiển thị."
+
+2.  **Fix Options:**
+    ```markdown
+    1️⃣ 🔧 Em sửa ngay (Auto-fix)
+    2️⃣ 📿 Tạo task Beads để sửa sau
+    3️⃣ 📝 Hướng dẫn anh tự sửa
+    4️⃣ 🔍 Điều tra sâu hơn
+    ```
+
+### Phase 4: Execution & Verification
+1.  **Action:** Thực hiện sửa lỗi.
+2.  **Regression Check:** "Chạy lại test để đảm bảo không làm hỏng gì khác."
+3.  **Cleanup:** Xóa debug logs đã thêm.
+
+---
+
+## 🧠 Brain & Beads 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`.
+
+### 2. Knowledge Base
+-   Lỗi đã fix -> Lưu vào `brain/solutions/` để tham khảo sau.
+-   Pattern lỗi lặp lại -> Gợi ý tạo Rule hoặc Linter.
+
+### 3. Smart Resume
+-   Nếu user quay lại debug cùng 1 lỗi -> "Hôm qua anh đang debug lỗi này. Em đã tìm ra [Solution]. Áp dụng không?"
+
+---
+
+## 🛡️ 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.
+
+---
+
+## ⚠️ NEXT STEPS (Menu số):
+```
+1️⃣ Chạy test toàn bộ (`/test`)
+2️⃣ Vẫn còn lỗi? (`/debug` lại)
+3️⃣ Xem danh sách bugs (`/todo --label bug`)
+```

package/workflows/lifecycle/deploy.md

@@ -0,0 +1,95 @@
+---
+description: 🚀 Deploy lên Production (Dual-Mode v5.0)
+---
+
+# WORKFLOW: /deploy - The Release Manager (Dual-Mode + Beads)
+
+> **Mode A (Expert):** `/deploy --prod --force` -> Bỏ qua checks, deploy ngay.
+> **Mode B (Guided):** `/deploy` -> Pre-flight Checks -> Config -> Deploy -> Verify.
+
+---
+
+## 🅰️ Expert Mode (Direct Execution)
+
+**Usage:**
+```bash
+/deploy --prod --force --skip-tests
+```
+
+**Logic:**
+1.  **Safety Check:** (Trừ khi có `--force`)
+    -   Check Git clean state.
+    -   Check CI/CD status (nếu có).
+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).
+4.  **Report:** "✅ Deployed to Production. URL: [Link]"
+
+---
+
+## 🅱️ Guided Mode (Interactive Wizard)
+
+### 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?
+    -   *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:**
+    -   Target: Staging hay Production?
+    -   Secrets: `.env` đủ chưa?
+
+### Phase 2: Build & Optimization
+1.  **Action:** Chạy build thử nghiệm (`npm run build`).
+2.  **SEO & Assets:**
+    -   "Có muốn tự động tạo `sitemap.xml` và `robots.txt` không?"
+    -   "Ảnh chưa tối ưu, muốn chạy nén ảnh không?"
+
+### Phase 3: Deployment
+1.  **Action:** Thực hiện deploy (theo platform detect được: Vercel, Netlify, VPS...).
+2.  **Progress:** Hiển thị realtime logs (đơn giản hóa).
+
+### Phase 4: Verification & Handoff
+1.  **Smoke Test:**
+    -   AI tự truy cập URL vừa deploy.
+    -   Check HTTP 200, check JS errors.
+2.  **Beads Release:**
+    -   "Tạo Release Note từ các tasks đã làm?"
+    -   Action: `bd release create` kèm danh sách tasks.
+3.  **Action Menu:**
+    ```markdown
+    1️⃣ 📢 Thông báo team (Copy release note)
+    2️⃣ 💾 Lưu cấu hình deploy (`/save-brain`)
+    3️⃣ 🔍 Monitor realtime logs
+    ```
+
+---
+
+## 🧠 Brain & Beads 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.
+
+### 2. Deployment Knowledge
+-   Lưu các preferences của user (vd: "Luôn dung Vercel", "Luôn skip test ở Staging").
+-   Tự động suggest lại vào lần sau.
+
+---
+
+## 🛡️ Resilience Patterns
+
+-   **Rollback Strategy:** Nếu Smoke Test fail -> Tự động gợi ý `/rollback`.
+-   **Environment Protection:** Cấm deploy Production vào chiều Thứ 6 (trừ khi `--force`).
+
+---
+
+## ⚠️ NEXT STEPS (Menu số):
+```
+1️⃣ Monitor logs (`/logs`)
+2️⃣ Rollback nhanh (`/rollback`)
+3️⃣ Đóng task trong Beads (`/done`)
+```

package/workflows/lifecycle/init.md

@@ -0,0 +1,152 @@
+---
+description: ✨ Khởi tạo dự án chuẩn Antigravity (v4.1 - Master Orchestrator)
+---
+
+# WORKFLOW: /init - The Antigravity Orchestrator (v4.1)
+
+> **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.
+
+---
+
+## 🚀 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í":
+
+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.
+
+2.  **Dev Environment**:
+    *   Node/Ruby/Java/Swift versions.
+    *   Docker status (nếu là Backend).
+
+---
+
+## ⚡ 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).
+
+**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?"
+
+---
+
+## 🧠 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.*
+
+### 2.1. Create Standard Ecosystem
+Tự động tạo các thư mục và file mẫu:
+
+1.  **Antigravity Core**:
+    ```bash
+    mkdir -p docs/specs/_templates
+    mkdir -p docs/architecture/decisions
+    mkdir -p .gemini/scripts
+    ```
+
+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`, ...
+
+### 2.2. Inject Templates (Spec & Architecture)
+Tạo file mẫu để workflow `/plan` (create-spec) hoạt động trơn tru:
+
+**`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)*
+
+### 2.3. Inject Automation Scripts
+Tạo script để user gõ lệnh tắt là chạy workflow:
+
+**`scripts/scaffold_feature.sh`**:
+*(Script gọi đến `structure-clean-architect` workflow)*
+
+---
+
+## 🏗️ 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).
+
+---
+
+## 🎨 Giai đoạn 4: Visual Vision (The WOW Factor)
+*Không để user chờ đợi với màn hình đen trắng.*
+
+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!"
+
+---
+
+## 🔗 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.*
+
+Báo cáo hoàn tất và trỏ ngay sang các bước tiếp theo:
+
+### ⚠️ NEXT STEPS (Choose your path):
+
+**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).
+
+**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`).
+
+**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`).
+
+---
+
+## 📝 Example Execution for User
+
+```text
+Antigravity Initializer v4.1
+----------------------------
+✅ Checking Environment... OK
+✅ Checking MCPs... Firebase (OFF), 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
+
+🎨 Generating Vision Concept... [Done]
+   (Image: A sleek, dark-themed dashboard for [AppName])
+
+🎉 SETUP COMPLETE!
+Your "Operating System" is ready.
+
+What's your first move?
+1. /plan [FeatureName] (Recommended: Create Specs first)
+2. /structure [FeatureName] (Scaffold Code)
+3. /visualize (Design UI)
+```

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

@@ -0,0 +1,300 @@
+---
+description: Quy trình thiết kế tính năng toàn diện từ kiến trúc đến triển khai chi tiết.
+---
+
+# /master-code-workflow - Feature Design Pipeline
+
+> **Antigravity Lead Architect** - Master workflow for complete feature development
+
+**Mission:** Production-ready features with comprehensive specs, clean architecture, and premium UI/UX.
+
+---
+
+## 🎯 Pipeline Overview
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                  FEATURE DESIGN PIPELINE                    │
+├─────────────────────────────────────────────────────────────┤
+│  Phase 1: PROJECT STEERING (1x per project)                │
+│  └── product.md → structure.md → tech.md                   │
+│                          ↓                                  │
+│  Phase 2: CLEAN ARCHITECTURE                               │
+│  └── Domain → Data → Presentation layers                   │
+│                          ↓                                  │
+│  Phase 3: FEATURE SPECS                       │
+│  └── requirements.md → design.md → bd tasks                │
+│                          ↓                                  │
+│  Phase 4: UI/UX DESIGN                                     │
+│  └── Design analysis + Platform guidelines                 │
+│                          ↓                                  │
+│  Phase 5: IMPLEMENTATION                                   │
+│  └── Code → Tests → Security → Localization               │
+│                          ↓                                  │
+│  Phase 6: QUALITY ASSURANCE                                │
+│  └── Review → Polish → Documentation                       │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Phase 0: Prerequisites
+
+### 0.1. Check Project Identity
+// turbo
+```bash
+[ -f ".project-identity" ] && echo "✅ Found" || echo "❌ Missing"
+```
+
+**If missing**: Run `/init` workflow first.
+
+### 0.2. Detect Platform
+Read `.project-identity` to detect:
+- **iOS**: Swift/SwiftUI → Apple HIG
+- **Android**: Kotlin/Compose → Material Design 3
+- **Expo**: TypeScript/React Native → Platform-adaptive
+- **Web**: React/Vue/Next.js → Modern web patterns
+
+### 0.3. Check Steering Docs
+// turbo
+```bash
+[ -d "docs/steering" ] && echo "✅ Exists" || echo "❌ Missing"
+```
+
+---
+
+## Phase 1: Project Steering (One-time)
+
+> **Skip if `docs/steering/` exists and is complete.**
+
+### 1.1. Create Steering Directory
+// turbo
+```bash
+mkdir -p docs/steering
+```
+
+### 1.2. Create Steering Documents
+
+**Required Files:**
+- `docs/steering/product.md` - Product overview, mission, target users
+- `docs/steering/structure.md` - Project structure, naming conventions
+- `docs/steering/tech.md` - Tech stack, build commands, conventions
+
+**Templates:** See `templates/specs/steering-*.md` for detailed templates.
+
+**Content Guidelines:**
+- **product.md**: Target users, key features, design philosophy, business model
+- **structure.md**: Directory structure, file naming, architecture patterns
+- **tech.md**: Build system, tech stack, common commands, code style
+
+---
+
+## Phase 2: Clean Architecture Setup
+
+### 2.1. Create Feature Directory Structure
+
+Based on platform:
+
+**iOS (Swift/SwiftUI):**
+```bash
+mkdir -p Features/[FeatureName]/{Views,ViewModels,Models,Services,Tests}
+```
+
+**Android (Kotlin/Compose):**
+```bash
+mkdir -p app/src/main/java/com/[package]/features/[featurename]/{ui,viewmodel,model,repository}
+```
+
+**Expo (TypeScript):**
+```bash
+mkdir -p src/features/[featurename]/{screens,hooks,components,types}
+```
+
+### 2.2. Architecture Compliance Checklist
+- [ ] Domain layer has no UI/Framework dependencies
+- [ ] Data layer implements Domain interfaces
+- [ ] Presentation layer depends on Domain only
+- [ ] Proper separation of concerns
+
+---
+
+## Phase 3: Feature Specs (Kiro-style)
+
+### 3.1. Create Feature Specs Directory
+// turbo
+```bash
+mkdir -p docs/specs/[feature-name]
+```
+
+### 3.2. Generate Spec Documents
+
+**Required Files:**
+1. `requirements.md` - User stories & acceptance criteria
+2. `design.md` - Technical design & architecture
+
+**Templates Location:**
+- `templates/specs/requirements-template.md`
+- `templates/specs/design-template.md`
+- `templates/specs/tasks-template.md`
+
+**Generation Process:**
+1. Copy templates to `docs/specs/[feature-name]/`
+2. Fill in feature-specific details
+3. Ensure traceability: tasks → design → requirements
+
+### 3.3. Spec Quality Checklist
+- [ ] All requirements have acceptance criteria
+- [ ] Design includes component hierarchy
+- [ ] Data models are fully defined
+- [ ] Tasks reference specific requirements
+- [ ] Correctness properties defined
+- [ ] UI/UX specifications complete
+
+---
+
+## Phase 4: UI/UX Design
+
+### 4.1. Design Source Analysis
+
+**If design file provided:**
+- Analyze layout, components, interactions
+- Extract color palette, typography, spacing
+- Document animations and transitions
+
+**If no design file:**
+- Follow platform guidelines (HIG/Material Design)
+- Use design system tokens
+- Ensure accessibility compliance
+
+### 4.2. Platform-Specific Adaptations
+
+**iOS:**
+- SF Symbols for icons
+- NavigationStack for navigation
+- .ultraThinMaterial for glass effects
+- Haptic feedback on key actions
+
+**Android:**
+- Material Icons
+- NavHost for navigation
+- Material Design 3 surfaces
+- Standard Android haptics
+
+---
+
+## Phase 5: Implementation
+
+### 5.1. Recommended Approach
+
+**Option A: Manual Implementation**
+Use `/create-feature` for hands-on coding with spec guidance.
+
+**Option B: Automated Implementation**
+Use `/auto-implement [feature-name]` for spec-driven auto-coding.
+
+### 5.2. Implementation Standards
+
+**Must Include:**
+- [ ] Input validation
+- [ ] Error handling (try-catch)
+- [ ] Security measures (auth, validation)
+- [ ] Performance optimization (lazy loading, caching)
+- [ ] Logging for important actions
+- [ ] Localization (no hardcoded strings)
+- [ ] Accessibility labels
+- [ ] Unit tests (>80% coverage)
+
+### 5.3. Progress Tracking
+
+Update `bd` status as you complete each task:
+```bash
+bd close [id]
+```
+
+---
+
+## Phase 6: Quality Assurance
+
+### 6.1. Code Review Checklist
+- [ ] All requirements validated
+- [ ] Build passes without errors
+- [ ] No hardcoded strings
+- [ ] Accessibility implemented
+- [ ] Security measures in place
+- [ ] Tests written and passing
+- [ ] Performance acceptable
+
+### 6.2. Final Validation
+- [ ] Test on multiple device sizes
+- [ ] Verify offline functionality
+- [ ] Check error recovery scenarios
+- [ ] Validate all user flows
+
+---
+
+## Workflow Integration
+
+### Related Workflows
+
+**Design Phase:**
+- `/design-feature` - Create specs only (no code)
+
+**Implementation Phase:**
+- `/auto-implement` - Auto-execute from specs
+- `/create-feature` - Manual implementation with guidance
+
+**Quality Phase:**
+- `/code-review` - Pre-push review
+- `/self-healing-test` - Auto-fix failing tests
+
+---
+
+## Usage Examples
+
+### Complete New Feature
+```
+1. /master-code-workflow
+   → Creates steering docs (if needed)
+   → Creates feature specs
+   → Guides through implementation
+
+2. /auto-implement [feature-name]
+   → Auto-executes tasks from specs
+```
+
+### Specs Only (Design First)
+```
+1. /design-feature
+   → Creates requirements.md, design.md
+
+2. Review and refine specs manually
+
+3. /auto-implement [feature-name]
+   → Auto-executes when ready
+```
+
+---
+
+## Success Criteria
+
+✅ **Complete Documentation:**
+- Steering docs (product, structure, tech)
+- Feature specs (requirements, design, tasks)
+
+✅ **Clean Architecture:**
+- Proper layer separation
+- Clear dependencies
+- Testable code
+
+✅ **Production Quality:**
+- All tests passing
+- Security validated
+- Accessibility compliant
+- Performance optimized
+
+---
+
+**Next Steps After Completion:**
+- `/run` - Test on device
+- `/code-review` - Pre-merge review
+- `/save-brain` - Document decisions