anchi-kit 1.1.2

package/docs/ARCHITECTURE.md

@@ -0,0 +1,207 @@
+# anchi-kit Architecture
+
+> Understanding how anchi-kit works for Cursor AI & Antigravity
+
+---
+
+## 🏗️ Core Concepts
+
+### What is anchi-kit?
+
+anchi-kit is a **unified toolkit** that provides:
+
+- **22 Commands** - AI-powered workflows (Chat commands + CLI)
+- **21 Agents** - Specialized AI personas
+- **55 Skills** - Domain knowledge packs
+- **3+ Presets** - Architecture templates (Rapid, Professional, Enterprise)
+
+### Naming Clarification
+
+| Term            | Definition                         |
+| --------------- | ---------------------------------- |
+| **anchi-kit**   | The toolkit package (npm)          |
+| **Cursor AI**   | Primary runtime (VS Code-based)    |
+| **Antigravity** | Alternative runtime (Gemini-based) |
+
+---
+
+## 🔄 Execution Model
+
+### Command → Agent → Skill Flow
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ User: /do "Add user login"                                  │
+├─────────────────────────────────────────────────────────────┤
+│                         ↓                                   │
+│  ┌─────────────┐   ┌─────────────┐   ┌─────────────┐      │
+│  │   Command   │ → │    Agent    │ → │    Skill    │      │
+│  │    /do      │   │  planner    │   │ backend/    │      │
+│  │             │   │  fullstack  │   │ auth/       │      │
+│  └─────────────┘   └─────────────┘   └─────────────┘      │
+│                         ↓                                   │
+│  OUTPUT: Plan → Generate → Implement → Verify               │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Model Selection (Cost Optimization)
+
+| Task Complexity             | Recommended Model  | Cost      |
+| --------------------------- | ------------------ | --------- |
+| Simple (typo, rename)       | GPT-5.1 Codex Mini | 💚 Low    |
+| Medium (feature, fix)       | Sonnet 4.5         | 💛 Medium |
+| Complex (architecture)      | Opus 4.5           | 🔴 High   |
+| Large codebase (>200 files) | Gemini 3 Flash     | 💚 Low    |
+
+---
+
+## 📦 Presets
+
+Presets define **project architecture** and **workflow rigor**:
+
+| Preset           | Database           | Architecture     | Approval Gates |
+| ---------------- | ------------------ | ---------------- | -------------- |
+| **Rapid**        | SQLite             | Flat files       | None           |
+| **Professional** | PostgreSQL         | Modular Monolith | Code review    |
+| **Enterprise**   | PostgreSQL + Redis | Full DDD         | Multi-stage    |
+
+### Preset Selection
+
+```
+/start
+→ New project? → User chooses preset (1/2/3)
+→ Existing? → AI auto-detects from codebase
+```
+
+---
+
+## 🤖 Agents
+
+Agents are **AI personas** with specialized knowledge:
+
+| Category         | Agents                                   |
+| ---------------- | ---------------------------------------- |
+| **Development**  | fullstack-developer, debugger, tester    |
+| **Design**       | ui-ux-designer, design-system-architect  |
+| **Architecture** | ddd-architect, database-admin            |
+| **Management**   | project-manager, git-manager             |
+| **Research**     | researcher, scout, brainstormer          |
+| **Content**      | docs-manager, copywriter, journal-writer |
+
+### Agent Activation
+
+Commands **auto-activate** relevant agents:
+
+- `/do "add login"` → fullstack-developer + debugger
+- `/design "UI"` → ui-ux-designer
+- `/review` → code-reviewer
+
+---
+
+## 📚 Skills
+
+Skills are **domain knowledge modules**:
+
+| Category        | Skills                                              |
+| --------------- | --------------------------------------------------- |
+| **Frontend**    | frontend-development/, web-frameworks/, ui-styling/ |
+| **Backend**     | backend-development/, databases/, devops/           |
+| **Specialized** | payment-integration/, better-auth/, shopify/        |
+| **AI/MCP**      | ai-multimodal/, mcp-builder/, mcp-management/       |
+
+### Skill Auto-Detection
+
+Based on project files:
+
+- `package.json` has Next.js → `web-frameworks/`
+- `prisma/` exists → `databases/`
+- Tailwind config → `ui-styling/`
+
+---
+
+## 🔀 Cursor vs Antigravity
+
+### Giống Nhau (Same)
+
+| Aspect     | Both Platforms              |
+| ---------- | --------------------------- |
+| Commands   | 22 unified commands         |
+| Agents     | 21 AI personas              |
+| Skills     | 55 knowledge packs          |
+| Presets    | 3+ architecture templates   |
+| Philosophy | AI-assisted, human-approved |
+
+### Khác Nhau (Different)
+
+| Aspect       | Cursor AI                 | Antigravity       |
+| ------------ | ------------------------- | ----------------- |
+| **Location** | `.cursor/`                | `.antigravity/`   |
+| **Runtime**  | VS Code extension         | Gemini standalone |
+| **Context**  | Cursor context window     | Gemini 2M context |
+| **Models**   | Anthropic, OpenAI, Gemini | Gemini primary    |
+
+### Installation
+
+```bash
+# Cursor AI
+npx anchi-kit install
+
+# Antigravity
+npx anchi-kit antigravity
+```
+
+### CLI Flags & Aliases
+
+| Flag/Alias      | Command   | Description             |
+| --------------- | --------- | ----------------------- |
+| `-v, --version` | -         | Hiển thị version        |
+| `-y, --force`   | all       | Bỏ qua prompts xác nhận |
+| `--no-open`     | dashboard | Không tự mở browser     |
+| `b`             | brain     | Alias cho brain command |
+| `dash`          | dashboard | Alias cho dashboard     |
+| `pat`           | patterns  | Alias cho patterns      |
+
+---
+
+## 📁 Directory Structure
+
+```
+project/
+├── .cursor/              # Cursor AI
+│   ├── commands/         # 22 command files (Chat commands)
+│   ├── agents/           # 21 agent definitions
+│   ├── skills/           # 55 skill modules
+│   ├── .ai-audit/        # Decision logs
+│   ├── .ai-memory/       # Context storage
+│   └── presets/          # Architecture templates
+│
+├── .antigravity/         # Antigravity (Gemini)
+│   ├── workflows/        # 22 command files (same content)
+│   ├── agents/           # 21 agent definitions
+│   ├── skills/           # 55 skill modules
+│   ├── .ai-audit/        # Decision logs
+│   └── .ai-memory/       # Context storage
+│
+└── presets/              # (Also copied inside .cursor/.antigravity)
+    ├── rapid/
+    ├── professional/
+    └── enterprise/
+```
+
+---
+
+## ⚠️ AI Execution Rules
+
+The AI **must not**:
+
+- Skip required approval gates (Professional/Enterprise)
+- Use cheaper models for security-critical tasks
+- Generate code without matching project style
+- Commit without user confirmation
+
+The AI **must**:
+
+- Follow preset constraints
+- Activate appropriate agents/skills
+- Use cost-appropriate models
+- Report progress transparently

package/docs/CI_CD.md

@@ -0,0 +1,60 @@
+# ☁️ CI/CD Integration (Cloud Brain)
+
+> Mang trí tuệ của Anchi Kit lên GitHub Actions để tự động hóa quy trình Review.
+
+---
+
+## 🚀 Setup Automated Review
+
+Để kích hoạt "Cloud Brain" cho dự án, bạn làm như sau:
+
+### 1. Cài đặt Workflow
+
+Copy file workflow mẫu vào dự án của bạn:
+
+```bash
+mkdir -p .github/workflows
+cp node_modules/anchi-kit/presets/ci-cd/ai-review.yml .github/workflows/
+```
+
+_(Nếu cài từ source: copy từ `presets/ci-cd/ai-review.yml`)_
+
+### 2. Cấu hình Secrets (Nếu dùng tính năng AI)
+
+Vào **Settings -> Secrets and variables -> Actions**, thêm:
+
+- `GEMINI_API_KEY`: API Key của bạn (lấy tại Google AI Studio).
+
+### 3. Tận hưởng
+
+Mỗi khi có ai đó tạo **Pull Request**, Anchi Bot sẽ:
+
+1.  **Doctor Check:** Kiểm tra cấu trúc project.
+2.  **Safety Net:** Chạy Unit Test tự động.
+3.  **AI Review:** (Coming in v2.0) Đọc diff và comment góp ý trực tiếp.
+
+---
+
+## 🛠️ Customization
+
+Bạn có thể sửa file `.github/workflows/ai-review.yml` để thêm các bước:
+
+- Build Docker image.
+- Deploy to Vercel/Netlify.
+- Gửi thông báo về Slack/Discord.
+
+---
+
+## 🧠 Memory Sharing Strategy (Team Scaling)
+
+> **Vấn đề:** Mặc định, bộ nhớ Active Memory (`.ai-memory`) là **Local-Last** (chỉ lưu trên máy user) để tránh conflict git.
+
+### Giải pháp hiện tại (v2.x)
+
+1.  **Shared Rules:** File `.cursorrules` và `anchi-kit.config.yaml` là nơi chứa luật chung của cả team (được commit lên git).
+2.  **Local Context:** Mỗi dev có một "bộ não" riêng để tối ưu cho task của họ.
+3.  **Onboarding:** Dev mới chỉ cần chạy `/scout` để AI tự học lại dự án trong 5 phút.
+
+### Giải pháp tương lai (Roadmap)
+
+Chúng tôi đang xây dựng **"Acchi Cloud Brain"** - một server riêng để đồng bộ Semantic Memory cho cả team, giúp AI của người A biết được người B vừa sửa gì ngay lập tức.

package/docs/CODEBASE.md

@@ -0,0 +1,187 @@
+# Codebase Technical Reference
+
+> 🛠️ **Purpose:** TECHNICAL document - HOW the code is structured
+>
+> **For project planning (WHY/WHAT):** See [PROJECT.md](./PROJECT.md)
+
+> [!NOTE] > **Template File:** Đây là file template. Điền thông tin codebase thực tế của dự án của bạn.
+
+---
+
+## 📁 Folder Structure
+
+```
+[Điền cấu trúc thư mục của dự án]
+
+src/
+├── app/              # Next.js App Router
+├── components/       # React Components
+│   ├── ui/          # Shared UI components
+│   └── features/    # Feature-specific components
+├── lib/             # Utilities & helpers
+├── hooks/           # Custom React hooks
+├── types/           # TypeScript type definitions
+└── ...
+```
+
+---
+
+## 🔧 Tech Stack
+
+### Frontend
+
+| Technology  | Version | Purpose   |
+| ----------- | ------- | --------- |
+| [Framework] | [vX.X]  | [Purpose] |
+| [Styling]   | [vX.X]  | [Purpose] |
+
+### Backend
+
+| Technology | Version | Purpose   |
+| ---------- | ------- | --------- |
+| [Runtime]  | [vX.X]  | [Purpose] |
+| [Database] | [vX.X]  | [Purpose] |
+
+### DevOps
+
+| Tool      | Purpose   |
+| --------- | --------- |
+| [CI/CD]   | [Purpose] |
+| [Hosting] | [Purpose] |
+
+---
+
+## 🗃️ Database Schema
+
+### Entities
+
+```
+[Mô tả các entities chính]
+
+User:
+  - id: string (PK)
+  - email: string (unique)
+  - name: string
+  - createdAt: datetime
+
+[Add more entities...]
+```
+
+### Key Relationships
+
+```
+User → Orders (1:N)
+Order → OrderItems (1:N)
+Product → Categories (N:M)
+```
+
+---
+
+## 🔌 API Endpoints
+
+### Core APIs
+
+| Method   | Endpoint              | Description   |
+| -------- | --------------------- | ------------- |
+| `GET`    | `/api/[resource]`     | [Description] |
+| `POST`   | `/api/[resource]`     | [Description] |
+| `PUT`    | `/api/[resource]/:id` | [Description] |
+| `DELETE` | `/api/[resource]/:id` | [Description] |
+
+---
+
+## 🧩 Key Modules
+
+### Module 1: [Name]
+
+**Purpose:** [What it does]
+
+**Key Files:**
+
+- `src/[path]` - [Description]
+- `src/[path]` - [Description]
+
+**Dependencies:**
+
+- [Module X]
+- [Module Y]
+
+---
+
+## 🔐 Authentication & Authorization
+
+### Auth Flow
+
+```
+1. User submits credentials
+2. Server validates → Issues JWT
+3. Client stores token in [httpOnly cookie / localStorage]
+4. Subsequent requests include token
+5. Server validates token on each request
+```
+
+### Roles & Permissions
+
+| Role    | Permissions         |
+| ------- | ------------------- |
+| `admin` | Full access         |
+| `user`  | Read/Write own data |
+| `guest` | Read only           |
+
+---
+
+## 🚀 Running Locally
+
+```bash
+# Install dependencies
+npm install
+
+# Setup environment
+cp .env.example .env
+
+# Run development server
+npm run dev
+
+# Run tests
+npm test
+```
+
+---
+
+## 📦 Environment Variables
+
+| Variable          | Required | Description                |
+| ----------------- | -------- | -------------------------- |
+| `DATABASE_URL`    | Yes      | Database connection string |
+| `NEXTAUTH_SECRET` | Yes      | Auth secret key            |
+| `[OTHER_VAR]`     | [Yes/No] | [Description]              |
+
+---
+
+## 🧪 Testing Strategy
+
+### Test Types
+
+- **Unit Tests:** `src/**/*.test.ts`
+- **Integration Tests:** `tests/integration/`
+- **E2E Tests:** `tests/e2e/`
+
+### Commands
+
+```bash
+npm test              # Run unit tests
+npm run test:e2e      # Run E2E tests
+npm run test:coverage # Generate coverage report
+```
+
+---
+
+## 🔗 Related Documentation
+
+- [PROJECT.md](./PROJECT.md) - Project requirements & planning
+- [CODE_STYLE.md](./CODE_STYLE.md) - Coding conventions
+- [WORKFLOW.md](./WORKFLOW.md) - Team workflow
+
+---
+
+> 💡 **Tip:** Cập nhật file này khi có thay đổi architecture. AI sẽ đọc file này để hiểu codebase.