@leejungkiin/awkit 1.1.1 → 1.1.3

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/core/AGENTS.md

@@ -1,38 +0,0 @@
-# Agent Instructions
-
-This project uses **Symphony** for task management and issue tracking.
-
-## Quick Reference
-
-```bash
-symphony_available_tasks          # Find available work
-symphony_claim_task <id>          # Claim a task
-symphony_report_progress <id>     # Report progress
-symphony_complete_task <id>       # Complete work
-symphony_status                   # Check system status
-```
-
-## Landing the Plane (Session Completion)
-
-**When ending a work session**, you MUST complete ALL steps below. Work is NOT complete until `git push` succeeds.
-
-**MANDATORY WORKFLOW:**
-
-1. **File issues for remaining work** — Create tasks for anything that needs follow-up
-2. **Run quality gates** (if code changed) — Tests, linters, builds
-3. **Update task status** — Complete finished work, update in-progress items
-4. **PUSH TO REMOTE** — This is MANDATORY:
-   ```bash
-   git pull --rebase
-   git push
-   git status  # MUST show "up to date with origin"
-   ```
-5. **Clean up** — Clear stashes, prune remote branches
-6. **Verify** — All changes committed AND pushed
-7. **Hand off** — Provide context for next session
-
-**CRITICAL RULES:**
-- Work is NOT complete until `git push` succeeds
-- NEVER stop before pushing — that leaves work stranded locally
-- NEVER say "ready to push when you are" — YOU must push
-- If push fails, resolve and retry until it succeeds