# Brainstorming: AWKit Smart Setup & Ecosystem Engine (SAEE)

> **Revision History**
> | Version | Date | Author | Description |
> |---|---|---|---|
> | v1.0.0 | 2026-05-28 | Antigravity Orchestrator | Initial concept proposal for Smart Setup inspired by `claude-code-setup` |

---

## 💡 Bối Cảnh & Cơ Hội

Anthropic vừa ra mắt `claude-code-setup` nhằm tối ưu hóa môi trường lập trình của Claude Code dựa trên phân tích cấu trúc dự án. Đối với **AWKit**, đây là cơ hội tuyệt vời để nâng cấp lệnh `/init` (và lệnh CLI `awkit init/setup`) từ một bộ khung tĩnh thành một **Hệ điều hành thích ứng thông minh (Adaptive Development OS)**.

Thay vì chỉ copy-paste các template tĩnh, AWKit có thể chủ động quét, phân tích và cấu hình toàn bộ hệ sinh thái phù hợp nhất cho dự án của người dùng.

---

## 🎯 5 Trụ Cột Của AWKit Smart Setup (SAEE)

Chúng ta có thể xây dựng tính năng này xoay quanh 5 trục chính:

```mermaid
graph TD
    A[Codebase Quét & Phân Tích] --> B(1. Smart Stack Analyzer)
    B --> C(2. MCP Auto-Recommender)
    B --> D(3. Adaptive Skill Activation)
    B --> E(4. Automated Hook System)
    B --> F(5. Tailored Workflows)
    C & D & E & F --> G[Cập nhật .project-identity & specs/]
```

### 1. Smart Stack Analyzer (SSA)
Bộ quét thông minh phân tích sâu codebase để phát hiện:
- **Ngôn ngữ & Runtime**: Node.js, Python, Swift, Kotlin, Go, v.v.
- **Framework & Libraries**: React, Next.js, Expo, UIKit, Jetpack Compose, FastAPI, Express.
- **Database & Cloud**: Firebase, SQLite, PostgreSQL, Appwrite.
- **Package Manager**: npm, pnpm, yarn, bun, poetry, swift package manager.

### 2. MCP Auto-Recommender (MCP-AR)
Đề xuất và tự động thiết lập các kết nối MCP phù hợp với dự án:
*   *Web/Frontend Apps*: Đề xuất `playwright` cho việc test UI và debug giao diện trực quan.
*   *Mobile Apps*: Đề xuất `maestro` cho end-to-end testing, `ios-simulator` và `android-cli-plugin`.
*   *Database & Backend*: Đề xuất `sqlite-mcp-server` hoặc `firebase-mcp-server` khi phát hiện các gói firebase trong dependency.

### 3. Adaptive Skill Activation (ASA)
AWKit sở hữu hơn 90+ skills chuyên sâu (ví dụ: `expo-build-optimizer`, `swiftui-pro`, `android-aso`, `firebase-firestore`). SAEE sẽ:
- Nhận diện những skills có ích nhất cho stack hiện tại.
- Tự động điền các skill này vào mục tiêu của agent để kích hoạt chúng một cách tối ưu, giảm thiểu noise context từ các skill không liên quan.

### 4. Automated Hook System (AHS)
Thiết lập các quy tắc tự động hóa trong phiên làm việc:
- **Preflight build hooks**: Tự động chạy `awkit build` trước khi cho phép auto-commit.
- **Git Hook Automation**: Liên kết với quy tắc *Auto-Commit After Build* (qua `awkit gate git auto`).
- **Security Check Hook**: Cảnh báo hoặc chặn chỉnh sửa các file nhạy cảm (`.env`, private keys) được định nghĩa sẵn.

### 5. Tailored Workflows & Roles (TWR)
Tự động tinh chỉnh và nạp các workflows thích ứng:
- Nếu phát hiện dự án mobile: Tự động nạp `/aso-audit`, `/ios-build`, `/app-store-screenshots`.
- Nếu phát hiện dự án backend/API: Nạp `/api-test`, `/deploy-app-hosting`.
- Đề xuất các **Subagents / Roles chuyên dụng** trong `AGENTS.md` (như Security Auditor, UX Reviewer).

---

## 🛠️ Luồng Thực Thi Đề Xuất (Interactive /init Workflow)

Khi người dùng chạy `/init` hoặc CLI `awkit setup`, quy trình sẽ diễn ra như sau:

> [!IMPORTANT]
> Triết lý thiết kế: **Smart Recommendations, Explicit Approvals**. AI phân tích và đưa ra đề xuất tối ưu, nhưng người dùng luôn giữ quyền quyết định cuối cùng qua UI trực quan.

### 🔄 Chi Tiết Quy Trình 3 Bước

```
┌────────────────────────────────────────────────────────┐
│  Bước 1: Quét Codebase & Nhận Diện                     │
├────────────────────────────────────────────────────────┤
│  Analyzing package.json, Xcode project, App.tsx...     │
│  🔍 Tech stack phát hiện: React Native, Expo, Firebase  │
└──────────────────────────┬─────────────────────────────┘
                           ▼
┌────────────────────────────────────────────────────────┐
│  Bước 2: Brainstorm Đề Xuất Hệ Sinh thái                │
├────────────────────────────────────────────────────────┤
│  💡 MCP: Đề xuất kích hoạt maestro, firebase-mcp       │
│  🎯 Skills: Tự động bật expo-build-optimizer, firestore│
│  ⚡ Hooks: Bật auto-lint, auto-commit sau build        │
└──────────────────────────┬─────────────────────────────┘
                           ▼
┌────────────────────────────────────────────────────────┐
│  Bước 3: Ghi nhận & Cấu hình                           │
├────────────────────────────────────────────────────────┤
│  ✓ Cập nhật .project-identity                          │
│  ✓ Khởi tạo specs/PROJECT.md & REQUIREMENTS.md         │
└────────────────────────────────────────────────────────┘
```

---

## 🚀 Kế Hoạch Triển Khai (Roadmap)

Chúng ta có thể thực hiện theo mô hình **7-Gate System** của AWKit:

### Phase 1: Infrastructure & Analyzer (🏗️ Gate 4 - Phase A)
- Phát triển module `scripts/smart-analyzer.js` sử dụng Node.js để phân tích nhanh các file cấu hình dự án (`package.json`, `Gemfile`, `build.gradle`, `Package.swift`).
- Định nghĩa schema map cho các gợi ý (Stack -> MCPs, Skills, Workflows).

### Phase 2: CLI Integration (🎨 Gate 4 - Phase B)
- Mở rộng lệnh CLI `awkit setup` và `/init` workflow trong `workflows/lifecycle/init.md`.
- Xây dựng giao diện CLI interactive đẹp mắt sử dụng `inquirer` hoặc các form UI tương tác của AWKit.

### Phase 3: Actionable Execution (⚡ Gate 4 - Phase C)
- Hiện thực hóa việc tự động cập nhật `.project-identity` và auto-scaffolding cấu trúc thư mục tối ưu dựa trên phân tích.
- Tích hợp chặt chẽ với Symphony để tạo bộ task mẫu cho từng stack (ví dụ: Task bootstrap cho Expo).