anchi-toolkit 1.0.0 → 1.2.0

package/.cursor/commands/status.md

@@ -92,11 +92,11 @@ argument-hint: [optional: specific area]
   2. Update 3 outdated dependencies
   
 💡 Suggestions:
-  • /test:coverage - View coverage details
-  • /fix "update dependencies"
-  • /cook "payment-integration Phase 3"
+  • /test --coverage - View coverage details
+  • /do "update dependencies"
+  • /do "payment-integration Phase 3"
 
-📌 Next: /auto:pro "continue payment integration"
+📌 Next: /do "continue payment integration"
 ```
 
 ---
@@ -145,19 +145,19 @@ status:
     coverage: 80
     outdated_deps: 5
 ```
-
----
-
-##  Dynamic Orchestration
-
-> **AI MUST read orchestration config before execution**
-
-```
-1. READ .cursor/agent-skill-index.yaml
-2. CHECK command_mapping for this command
-3. APPLY skill activation rules
-4. CHECK .cursor/failure-modes.yaml
-5. LOG decision to .ai-audit/
-```
-
+
+---
+
+##  Dynamic Orchestration
+
+> **AI MUST read orchestration config before execution**
+
+```
+1. READ .cursor/agent-skill-index.yaml
+2. CHECK command_mapping for this command
+3. APPLY skill activation rules
+4. CHECK .cursor/failure-modes.yaml
+5. LOG decision to .ai-audit/
+```
+
  [docs/ORCHESTRATION_RUNTIME.md](../docs/ORCHESTRATION_RUNTIME.md)

package/.cursor/commands/undo.md

@@ -61,14 +61,14 @@ argument-hint: [optional: steps to undo or commit hash]
 ╔═════════════════════════════════════════════════════════════╗
 ║ # │ Time     │ Action            │ Files Changed            ║
 ╠═════════════════════════════════════════════════════════════╣
-║ 1 │ 2 min    │ /cook LoginForm   │ 3 files                  ║
-║ 2 │ 10 min   │ /generate:api     │ 2 files                  ║
+║ 1 │ 2 min    │ /do LoginForm     │ 3 files                  ║
+║ 2 │ 10 min   │ /generate --api   │ 2 files                  ║
 ║ 3 │ 15 min   │ /theme dark       │ 2 files                  ║
-║ 4 │ 30 min   │ /auto:rapid       │ 8 files                  ║
+║ 4 │ 30 min   │ /do "feature"     │ 8 files                  ║
 ╚═════════════════════════════════════════════════════════════╝
 
 📋 Latest Action Details (#1):
-  Command: /cook "Add LoginForm"
+  Command: /do "Add LoginForm"
   Time: 2 minutes ago
   
   Files to restore:
@@ -148,19 +148,19 @@ undo:
   backup_dir: .undo/
   confirm_before: true
 ```
-
----
-
-##  Dynamic Orchestration
-
-> **AI MUST read orchestration config before execution**
-
-```
-1. READ .cursor/agent-skill-index.yaml
-2. CHECK command_mapping for this command
-3. APPLY skill activation rules
-4. CHECK .cursor/failure-modes.yaml
-5. LOG decision to .ai-audit/
-```
-
+
+---
+
+##  Dynamic Orchestration
+
+> **AI MUST read orchestration config before execution**
+
+```
+1. READ .cursor/agent-skill-index.yaml
+2. CHECK command_mapping for this command
+3. APPLY skill activation rules
+4. CHECK .cursor/failure-modes.yaml
+5. LOG decision to .ai-audit/
+```
+
  [docs/ORCHESTRATION_RUNTIME.md](../docs/ORCHESTRATION_RUNTIME.md)

package/.cursor/orchestration.yaml

@@ -53,6 +53,18 @@ chains:
       input: design
       output: implementation
 
+  # Self-Correction Chain (New)
+  post_mortem:
+    - agent: failure-analyst
+      input: [error_log, user_feedback]
+      output: root_cause_analysis
+    - agent: rules-architect
+      input: root_cause_analysis
+      output: new_failure_mode_rule
+    - agent: docs-manager
+      input: new_failure_mode_rule
+      output: update_failure_modes_yaml
+
 # ═══════════════════════════════════════════════════════════════
 # RISK-BASED EXECUTION
 # ═══════════════════════════════════════════════════════════════
@@ -78,7 +90,10 @@ risk_levels:
     auto_approve: false
     require_review: true
     require_test: true
+    require_review: true
+    require_test: true
     require_lead_approval: true
+    strict_approval: true # Token Switching required
     
   critical:
     keywords: ["delete", "drop", "migrate", "production", "deploy"]
@@ -86,7 +101,10 @@ risk_levels:
     auto_approve: false
     require_review: true
     require_test: true
+    require_review: true
+    require_test: true
     require_lead_approval: true
+    strict_approval: true # Token Switching required
     require_backup: true
 
 # ═══════════════════════════════════════════════════════════════

package/.cursor/skills/_template.md

@@ -0,0 +1,30 @@
+# Skill: [Skill Name]
+
+**Description:** [Short description of the technology/framework]
+
+## 🎯 Activation Criteria
+
+- **Files:** `[file_patterns]`
+- **Dependencies:** `[package_names]`
+- **Keywords:** `[keywords]`
+
+## ✅ Best Practices (Rules)
+
+1.  **[Rule 1]:** [Description]
+2.  **[Rule 2]:** [Description]
+3.  **[Naming Convention]:** [Description]
+
+## ❌ Anti-Patterns (Do Not Do)
+
+1.  **[Anti-Pattern 1]:** [Description]
+2.  **[Anti-Pattern 2]:** [Description]
+
+## 📦 Dependencies & Setup
+
+- Recommended Packages:
+  - [pkg1]
+  - [pkg2]
+
+## 🧠 Memory Hooks
+
+- If user asks for [X], suggest [Y].

package/ANTIGRAVITY.md

@@ -0,0 +1,84 @@
+# ANTIGRAVITY.md
+
+**Hướng dẫn dành cho Gemini Antigravity** - "Simple Interface, Powerful Execution"
+
+---
+
+## 🎯 Triết Lý Cốt Lỗi
+
+**"LESS BUT QUALITY"**: User chỉ cần ra lệnh đơn giản. AI chịu trách nhiệm xử lý phức tạp bên dưới.
+
+### 3 Lệnh Chính (The Only Commands You Need)
+
+| Lệnh       | Chức năng              | Ví dụ                                           |
+| ---------- | ---------------------- | ----------------------------------------------- |
+| **/start** | Khởi tạo dự án         | `/start` (AI tự detect stack & preset)          |
+| **/do**    | **Làm tất cả mọi thứ** | `/do "Fix bug login"`, `/do "Design dashboard"` |
+| **/demo**  | Xem demo dự án         | `/demo` (Auto run localhost)                    |
+| **/clean** | Dọn dẹp bộ nhớ         | `/clean` (Khi AI mất context)                   |
+
+---
+
+## 🎙️ Professional Reporting (Giao tiếp hiệu quả)
+
+Thay vì spam log kỹ thuật ("Loading...", "Reading..."), AI sử dụng format **Selective Transparency** (Minh bạch có chọn lọc).
+
+**Mẫu Báo Cáo Chuẩn:**
+
+> **🎯 Goal:** Fix bug login fail
+>
+> **🤖 Team:** `Debugger` (Root cause) → `Fullstack Dev` (Implementation)
+> **🛡️ Risk Check:** Low (Local UI fix only)
+>
+> **📝 Changes:**
+> • `src/auth/hooks/useLogin.ts`: Thêm `try/catch` block.
+> • `src/components/LoginForm.tsx`: Hiển thị thông báo lỗi chi tiết.
+>
+> **✅ Result:** Đã fix lỗi crash khi API timeout. User giờ sẽ thấy thông báo thay vì màn hình trắng.
+
+✅ Format này giúp User hiểu **AI nào đang làm việc** và **đã thay đổi gì** mà không bị ngợp.
+
+---
+
+## 🧠 Smart Execution (Trí tuệ Ẩn)
+
+Dù giao diện đơn giản, AI phải **ngầm** thực hiện quy trình phức tạp sau (User không cần thấy):
+
+1.  **Context Loading:**
+    - Project Rule: `.antigravity/docs/PROJECT.md`
+    - User Prefs: `.antigravity/user.yaml` (Optional, gitignored)
+2.  **Orchestration:** Tự động chọn Workflow & Agents từ `.antigravity/workflows/` và `.antigravity/agents/`.
+3.  **Risk Check:** Nếu sửa file nhạy cảm (Auth/Payment), **PHẢI** dừng lại hỏi ý kiến user.
+4.  **Artifacts:** Lưu các tài liệu quan trọng vào `.antigravity/docs/artifacts/`.
+
+### 🚀 Infinite Scalability (Mở Rộng Không Giới Hạn)
+
+Bạn muốn dùng công nghệ mới chưa có trong template?
+
+> **/skill-learn "[Tech Name]"**
+>
+> _Ví dụ: `/skill-learn "Rust Lang"`, `/skill-learn "SvelteKit"`_
+
+AI sẽ tự động:
+
+1.  **Research:** Đọc tài liệu online chuẩn nhất.
+2.  **Synthesize:** Tạo module kiến thức mới vào `.antigravity/skills/`.
+3.  **Apply:** Tự động dùng kiến thức mới cho các task sau này.
+
+---
+
+## ⚠️ Quy Tắc Bắt Buộc
+
+1.  **Không Sáng Tạo Cấu Trúc:** Luôn tuân thủ folder structure của Preset.
+2.  **Hỏi Trước Khi Phá:** Nếu lệnh `/do` gây xóa dữ liệu hoặc đổi kiến trúc -> **CẢNH BÁO USER**.
+3.  **Tự Động Học:** Ghi nhận lỗi sai vào Active Memory để tránh lặp lại.
+
+---
+
+## 📂 Tài Liệu (Khi cần Context sâu)
+
+AI có thể tham khảo (User không cần đọc):
+
+- `.antigravity/docs/` (Project Docs)
+- `.antigravity/workflows/do.md` (Workflow Logic full)
+- `.antigravity/agent-skill-index.yaml` (Capabilities)

package/CURSOR.md

@@ -1,191 +1,84 @@
 # CURSOR.md
 
-Hướng dẫn cho Cursor AI khi làm việc trong repository này.
+**Hướng dẫn dành cho Cursor AI** - "Simple Interface, Powerful Execution"
 
 ---
 
-## 🎯 Core Principle
+## 🎯 Triết Lý Cốt Lỗi
 
-**Luôn follow rules theo thứ tự ưu tiên:**
+**"LESS BUT QUALITY"**: User chỉ cần ra lệnh đơn giản. AI chịu trách nhiệm xử lý phức tạp bên dưới.
 
-1. **`.cursorrules`** - Active preset rules (highest priority)
-2. **`.cursor/commands/`** - Command definitions
-3. **`.cursor/agents/`** - Agent behaviors
-4. **`.cursor/skills/`** - Knowledge modules
-5. **`docs/`** - Project documentation
+### 3 Lệnh Chính (The Only Commands You Need)
 
----
-
-## 📋 Trước Khi Thực Hiện Command
-
-### Bắt buộc đọc:
-
-1. ✅ Đọc `.cursorrules` để biết preset đang dùng
-2. ✅ Đọc `docs/PROJECT.md` để hiểu context
-3. ✅ Đọc command definition trong `.cursor/commands/`
-4. ✅ Activate skills phù hợp từ `.cursor/skills/`
+| Lệnh       | Chức năng              | Ví dụ                                           |
+| ---------- | ---------------------- | ----------------------------------------------- |
+| **/start** | Khởi tạo dự án         | `/start` (AI tự detect stack & preset)          |
+| **/do**    | **Làm tất cả mọi thứ** | `/do "Fix bug login"`, `/do "Design dashboard"` |
+| **/demo**  | Xem demo dự án         | `/demo` (Auto run localhost)                    |
+| **/clean** | Dọn dẹp bộ nhớ         | `/clean` (Khi AI mất context)                   |
 
 ---
 
-## 🔄 Preset System
+## 🎙️ Professional Reporting (Giao tiếp hiệu quả)
 
-Template hỗ trợ 3 presets:
+Thay vì spam log kỹ thuật ("Loading...", "Reading..."), AI sử dụng format **Selective Transparency** (Minh bạch có chọn lọc).
 
-| Preset | .cursorrules | Setup Script |
-|--------|--------------|--------------|
-| 🚀 Rapid | `presets/rapid-mvp/.cursorrules` | `scripts/setup-rapid.ps1` |
-| 🏢 Professional | `presets/professional/.cursorrules` | `scripts/setup-professional.ps1` |
-| 🏛️ Enterprise | `presets/enterprise/.cursorrules` | `scripts/setup-enterprise.ps1` |
+**Mẫu Báo Cáo Chuẩn:**
 
-### Khi `/use-preset` được gọi:
+> **🎯 Goal:** Fix bug login fail
+>
+> **🤖 Team:** `Debugger` (Root cause) → `Fullstack Dev` (Implementation)
+> **🛡️ Risk Check:** Low (Local UI fix only)
+>
+> **📝 Changes:**
+> • `src/auth/hooks/useLogin.ts`: Thêm `try/catch` block.
+> • `src/components/LoginForm.tsx`: Hiển thị thông báo lỗi chi tiết.
+>
+> **✅ Result:** Đã fix lỗi crash khi API timeout. User giờ sẽ thấy thông báo thay vì màn hình trắng.
 
-1. Hiển thị tech stack của preset
-2. Yêu cầu xác nhận từ user
-3. Nếu xác nhận → suggest chạy setup script
-4. Script sẽ:
-   - Copy `.cursorrules` phù hợp
-   - Tạo folder structure
-   - Install dependencies
-   - Setup database
+✅ Format này giúp User hiểu **AI nào đang làm việc** và **đã thay đổi gì** mà không bị ngợp.
 
 ---
 
-## 📂 Command Workflow
-
-### Mọi command phải:
+## 🧠 Smart Execution (Trí tuệ Ẩn)
 
-1. **Check preset** - Đọc `.cursorrules` để biết mode
-2. **Follow structure** - Tuân thủ folder structure của preset
-3. **Use conventions** - Theo naming, coding conventions
-4. **Reference docs** - Tham chiếu `docs/` khi cần context
+Dù giao diện đơn giản, AI phải **ngầm** thực hiện quy trình phức tạp sau (User không cần thấy):
 
-### Ví dụ:
+1.  **Context Loading:**
+    - Project Rule: `.cursor/docs/PROJECT.md`
+    - User Prefs: `.cursor/user.yaml` (Optional, gitignored) - _Để AI chiều theo gu code của riêng bạn._
+2.  **Orchestration:** Tự động chọn Agent (Dev/Designer/Debugger) dựa trên yêu cầu.
+3.  **Risk Check:** Nếu sửa file nhạy cảm (Auth/Payment), **PHẢI** dừng lại hỏi ý kiến user.
+4.  **Verification:** Tự động chạy test/lint nếu có thể.
 
-```
-User: /plan "Add authentication"
+### 🚀 Infinite Scalability (Mở Rộng Không Giới Hạn)
 
-AI steps:
-1. Đọc .cursorrules → Biết đang dùng Professional preset
-2. Đọc docs/PROJECT.md → Hiểu context
-3. Đọc .cursor/commands/plan.md → Biết format output
-4. Đọc .cursor/agents/planner.md → Đóng vai planner
-5. Activate skill: .cursor/skills/better-auth/
-6. Output plan theo đúng structure của Professional
-```
+Bạn muốn dùng công nghệ mới chưa có trong template?
 
----
-
-## 🤖 Agent Activation
-
-Khi thực hiện task, activate agents phù hợp:
+> **/skill-learn "[Tech Name]"**
+>
+> _Ví dụ: `/skill-learn "Rust Lang"`, `/skill-learn "SvelteKit"`_
 
-| Task Type | Agents |
-|-----------|--------|
-| Planning | planner, researcher |
-| UI Design | ui-ux-designer, design-system-architect |
-| Domain Design | ddd-architect |
-| Implementation | fullstack-developer |
-| Review | code-reviewer |
-| Testing | tester |
-| Documentation | docs-manager |
-| Debugging | debugger |
+AI sẽ tự động:
 
-**Agent files:** `.cursor/agents/`
+1.  **Research:** Đọc tài liệu online chuẩn nhất.
+2.  **Synthesize:** Tạo module kiến thức mới vào `.cursor/skills/`.
+3.  **Apply:** Tự động dùng kiến thức mới cho các task sau này.
 
 ---
 
-## 📚 Skill Activation
-
-Activate skills khi cần kiến thức chuyên sâu:
-
-> 📖 **Xem full danh sách:** `.cursor/skills/SKILLS_INDEX.md`
+## ⚠️ Quy Tắc Bắt Buộc
 
-### Skills Theo Preset
-
-| Preset | Skills Chính |
-|--------|-------------|
-| 🚀 Rapid | frontend-development, ui-styling, databases, planning |
-| 🏢 Professional | + backend-development, better-auth, code-review |
-| 🏛️ Enterprise | + ddd-modular-monolith, devops, ui-ux-pro-max |
-
-### Utility Skills (All Presets)
-
-| Skill | Khi dùng |
-|-------|----------|
-| `ai-multimodal` | Image generation |
-| `chrome-devtools` | Browser debugging |
-| `docs-seeker` | Search documentation |
-| `research` | Technology research |
+1.  **Không Sáng Tạo Cấu Trúc:** Luôn tuân thủ folder structure của Preset đã chọn trong `.cursorrules`.
+2.  **Hỏi Trước Khi Phá:** Nếu lệnh `/do` gây xóa dữ liệu hoặc đổi kiến trúc -> **CẢNH BÁO USER**.
+3.  **Tự Động Học:** Nếu user sửa lại code AI vừa viết -> Ghi nhớ vào "Active Memory" để không sai lại.
 
 ---
 
-## ⚠️ Important Rules
-
-### DO:
-- ✅ Check `.cursorrules` trước mọi task
-- ✅ Follow folder structure của active preset
-- ✅ Reference `docs/` cho project context
-- ✅ Use agents và skills phù hợp
-- ✅ Confirm với user khi cần setup/install
-
-### DO NOT:
-- ❌ Ignore `.cursorrules`
-- ❌ Dùng structure khác preset
-- ❌ Skip confirmation khi setup
-- ❌ Install dependencies không cần thiết
-
----
-
-## 📖 Documentation Management
-
-Locations:
-- `docs/PROJECT.md` - Project description
-- `docs/code-standards.md` - Coding standards
-- `docs/system-architecture.md` - Architecture
-- `docs/CODEBASE.md` - Codebase overview
+## 📂 Tài Liệu (Khi cần Context sâu)
 
-**Khi cần context → Đọc docs/ trước khi trả lời.**
-
----
-
-## 🎭 UX Mode System (CRITICAL)
-
-> **Mode decides the voice - No exceptions**
-
-### Rule #1: Mode Detection
-
-```
-IF user_input starts with /
-→ COMMAND MODE (Command owns UI)
-
-ELSE
-→ PROMPT MODE (AI Agent owns UI)
-```
-
-### Command Mode
-
-When user types `/command`:
-- ✅ Show: Command log, structured output, governance
-- ❌ Hide: Agent narration, "AI decided...", raw text
-
-AI agent **im lặng hoàn toàn** ở UI.
-
-### Prompt Mode
-
-When user types free text:
-- ✅ Show: AI narration, progress, explanations
-- ❌ Hide: Command log, governance summary
-
-This is **exploratory** mode, no governance.
-
-### ❌ Never Do
-
-1. Mix command log with agent chat
-2. Show agent narration in command mode
-3. Show governance in prompt mode
-
-📖 Full documentation: [docs/UX_MODES.md](./docs/UX_MODES.md)
-
----
+AI có thể tham khảo (User không cần đọc):
 
-**CRITICAL:** Đây là file AI PHẢI ĐỌC. Mọi command PHẢI follow rules này.
+- `.cursor/docs/` (Project Docs)
+- `.cursor/commands/do.md` (Workflow Logic full)
+- `.cursor/agent-skill-index.yaml` (Capabilities)

package/LICENSE

@@ -1,18 +1,21 @@
-Copyright (c) 2024-2025 ClaudeKit. All Rights Reserved.
+MIT License
 
-This software and associated documentation files (the "Software") are proprietary
-and confidential. Unauthorized copying, modification, distribution, or use of this
-Software, via any medium, is strictly prohibited.
+Copyright (c) 2024-2025 Anchi Team
 
-The Software is licensed, not sold. You may only use the Software if you have
-purchased a valid license from ClaudeKit or have been granted explicit written
-permission by ClaudeKit.
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-For licensing inquiries, please contact: support@claudekit.com
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
-INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
-PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
-HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
-SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.