anchi-toolkit 1.0.0

package/LICENSE

@@ -0,0 +1,18 @@
+Copyright (c) 2024-2025 ClaudeKit. All Rights Reserved.
+
+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.
+
+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.
+
+For licensing inquiries, please contact: support@claudekit.com
+
+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.

package/README.md

@@ -0,0 +1,132 @@
+# anchi-toolkit
+
+**Cursor AI & Antigravity Toolkit** - AI Execution Framework with control, audit, and team scaling.
+
+> 🚀 **v1.0.0** | 18 commands | 19 agents | 35 skills | 3 presets | Complete IDE Packages
+
+---
+
+## ⚡ Quick Start
+
+### 🎯 Cài Đặt Chọn Lọc (Recommended)
+
+```bash
+cd your-project
+npx anchi-toolkit init
+```
+
+Wizard sẽ:
+1. 🔍 Auto-detect tech stack
+2. 📋 Chọn profile (Minimal / Developer / Full)
+3. 📊 Preview size trước khi cài
+4. ✅ Chỉ cài những gì bạn cần
+
+### 📦 Cài Đặt Nhanh (Full)
+
+```bash
+# Cursor AI - Cài tất cả
+npx anchi-toolkit install
+
+# Antigravity (Gemini) - Cài tất cả
+npx anchi-toolkit antigravity
+```
+
+### 🚀 Bắt Đầu
+
+```
+/start          → Initialize project
+/do "..."       → Universal command
+/commit         → Git operations
+```
+
+**That's it!** 🎉
+
+---
+
+## 📦 What You Get
+
+| Component | Count | Description |
+|-----------|-------|-------------|
+| **Commands** | 18 | AI-powered workflows (`/do`, `/commit`, `/test`...) |
+| **Agents** | 19 | Specialized AI personas |
+| **Skills** | 35 | Domain knowledge packs |
+| **Presets** | 3 | Architecture templates |
+
+---
+
+## 🎯 Core Command: `/do`
+
+One command for everything:
+
+```bash
+/do "Add user login"           # AI decides approach
+/do "Fix checkout bug"         # Auto-detects fix mode
+/do "Refactor API layer"       # Refactor mode
+
+# Flags
+/do "feature" --fast           # Skip reviews
+/do "feature" --careful        # Extra validation
+```
+
+---
+
+## 📊 18 Commands
+
+| Essential | Support | Specialized |
+|-----------|---------|-------------|
+| `/start` | `/scout` | `/design` |
+| `/do` | `/review` | `/generate` |
+| `/test` | `/docs` | `/theme` |
+| `/commit` | `/status` | `/integrate` |
+| `/help` | `/undo` | `/memory` |
+
+📖 Full reference: [QUICK_REFERENCE.md](./QUICK_REFERENCE.md)
+
+---
+
+## 🏗️ Presets
+
+| Preset | Database | Architecture | Best For |
+|--------|----------|--------------|----------|
+| **Rapid** | SQLite | Flat | MVP, prototype |
+| **Professional** | PostgreSQL | Modular | Startup, team |
+| **Enterprise** | PostgreSQL + Redis | DDD | Large projects |
+
+---
+
+## 📚 Documentation
+
+| Doc | Purpose |
+|-----|---------|
+| [QUICK_REFERENCE.md](./QUICK_REFERENCE.md) | Command cheat sheet |
+| [docs/ALL_COMMANDS.md](./docs/ALL_COMMANDS.md) | Full command reference |
+| [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md) | Core concepts, execution model |
+| [CHANGELOG.md](./CHANGELOG.md) | Version history |
+
+---
+
+## 🌌 Cursor vs Antigravity
+
+| Aspect | Cursor AI | Antigravity |
+|--------|-----------|-------------|
+| Install | `npx anchi-toolkit install` | `npx anchi-toolkit antigravity` |
+| Location | `.cursor/` | `.antigravity/` |
+| Runtime | VS Code extension | Gemini standalone |
+
+**Same:** Commands, Agents, Skills, Presets, Workflow
+
+📖 Details: [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md#-cursor-vs-antigravity)
+
+---
+
+## 🔗 Links
+
+- **npm:** [anchi-toolkit](https://www.npmjs.com/package/anchi-toolkit)
+- **GitHub:** [ANCHI-STE/anchi-webkit-dev](https://github.com/ANCHI-STE/anchi-webkit-dev)
+- **Issues:** [Report bugs](https://github.com/ANCHI-STE/anchi-webkit-dev/issues)
+
+---
+
+## 📄 License
+
+MIT © ANCHI-STE

package/docs/AI_CONTRACT.md

@@ -0,0 +1,150 @@
+# AI Execution Contract
+
+> **Hiến pháp AI** - Luật bắt buộc mà AI phải tuân thủ
+
+---
+
+## 📜 Rule Priority (Thứ Tự Ưu Tiên)
+
+```
+1. SAFETY RULES     ← Không bao giờ vi phạm
+2. PROJECT RULES    ← Từ preset + project config
+3. COMMAND RULES    ← Từ command đang thực thi
+4. USER REQUEST     ← Yêu cầu hiện tại
+```
+
+> **Nếu conflict: Rule cao hơn thắng.**
+
+---
+
+## 🔴 Level 1: Safety Rules (Bất khả xâm phạm)
+
+| Rule | Description |
+|------|-------------|
+| **S1** | Không xóa file quan trọng (.env, config, database) mà không hỏi |
+| **S2** | Không commit/push mà không có confirmation |
+| **S3** | Không chạy destructive commands (rm -rf, DROP TABLE) tự động |
+| **S4** | Không expose secrets trong code hoặc logs |
+| **S5** | Phải backup trước khi thay đổi lớn |
+
+**Violation Action:** DỪNG ngay, hỏi user.
+
+---
+
+## 🟡 Level 2: Project Rules (Từ Preset)
+
+### Rapid Preset
+```json
+{
+  "allowed": ["any structure", "SQLite", "quick patterns"],
+  "forbidden": [],
+  "checks": ["syntax only"]
+}
+```
+
+### Professional Preset
+```json
+{
+  "allowed": ["modular structure", "PostgreSQL"],
+  "forbidden": ["logic in components", "direct DB in routes"],
+  "checks": ["lint", "type-check", "test coverage > 60%"]
+}
+```
+
+### Enterprise Preset
+```json
+{
+  "allowed": ["DDD structure", "PostgreSQL + Redis"],
+  "forbidden": ["anemic domain", "circular deps", "skip reviews"],
+  "checks": ["lint", "type-check", "test coverage > 80%", "security scan"]
+}
+```
+
+**Violation Action:** Cảnh báo, đề xuất sửa, yêu cầu approval.
+
+---
+
+## 🟢 Level 3: Command Rules
+
+Mỗi command có rules riêng:
+
+| Command | Rules |
+|---------|-------|
+| `/do --fast` | Skip reviews OK, nhưng vẫn check Safety |
+| `/do --careful` | Extra validation, require tests |
+| `/commit` | Require confirmation trước push |
+| `/design` | Follow design system nếu có |
+| `/generate` | Match existing patterns |
+
+---
+
+## ⚖️ Conflict Resolution
+
+```
+User: /do "Add logic to Button component"
+AI: ⚠️ CONFLICT DETECTED
+
+    User Request: Add logic to Button
+    Project Rule: "logic in components forbidden" (Professional)
+    
+    Resolution:
+    → Create ButtonService for logic
+    → Button component calls service
+    
+    Proceed with corrected approach? [y/n]
+```
+
+---
+
+## 📋 Enforcement Checklist
+
+Trước mỗi action, AI PHẢI kiểm tra:
+
+- [ ] Safety rules OK?
+- [ ] Project rules OK?
+- [ ] Command rules OK?
+- [ ] Conflicts resolved?
+
+**Chỉ proceed khi tất cả OK hoặc đã có user approval.**
+
+---
+
+## 🔄 Violation Handling
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ VIOLATION DETECTED                                          │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  Level 1 (Safety):   STOP immediately, ask user             │
+│  Level 2 (Project):  Warn, suggest fix, ask approval        │
+│  Level 3 (Command):  Adjust approach, inform user           │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 📝 Audit Trail
+
+Mọi decision được log:
+
+```json
+{
+  "timestamp": "2024-12-26T10:30:00",
+  "command": "/do 'Add payment'",
+  "rules_checked": ["S1", "S2", "P3", "C1"],
+  "violations": [],
+  "decision": "Proceed with Stripe integration",
+  "approved_by": "auto"
+}
+```
+
+---
+
+## 🔗 Related Files
+
+- `CURSOR.md` - AI behavior configuration
+- `.cursorrules` - Project-specific rules
+- `.cursor/team.yaml` - Team roles
+- `presets/*/contract.json` - Preset contracts

package/docs/ALL_COMMANDS.md

@@ -0,0 +1,94 @@
+# 📖 anchi-toolkit Commands
+
+> v1.0.0 - 18 Commands | Dynamic Orchestration | Cursor + Antigravity
+
+---
+
+## 🎯 Essential (5)
+
+| Command | Description | Flags |
+|---------|-------------|-------|
+| `/start` | Initialize project | - |
+| `/do "..."` | Universal command (plan, code, fix) | `--fast`, `--careful`, `--plan-only` |
+| `/test` | Run tests | `--unit`, `--e2e`, `--coverage` |
+| `/commit` | Git operations | `--push`, `--pr`, `--amend` |
+| `/help` | Show help | `--beginner` |
+
+---
+
+## 🔧 Support (5)
+
+| Command | Description | Flags |
+|---------|-------------|-------|
+| `/scout "..."` | Explore codebase | `--external`, `--deep` |
+| `/review` | Code review | `--security`, `--performance` |
+| `/docs` | Documentation | `--init`, `--changelog`, `--api` |
+| `/status` | Project health dashboard | `--deps`, `--tests` |
+| `/undo` | Rollback changes | `--list`, `--force` |
+
+---
+
+## 🎨 Specialized (5)
+
+| Command | Description | Flags |
+|---------|-------------|-------|
+| `/design "..."` | UI/Domain design | `--domain`, `--screenshot`, `--library` |
+| `/generate "..."` | Generate code | `--page`, `--api`, `--component`, `--model` |
+| `/theme` | Theme management | `dark`, `light`, `system` |
+| `/integrate "..."` | Third-party services | Service name |
+| `/memory` | Context management | `save`, `load`, `add` |
+
+---
+
+## 📊 Command Comparison
+
+| Old (94 commands) | New (15 commands) |
+|-------------------|-------------------|
+| 8 /plan variants | `/do` handles all |
+| 4 /cook variants | `/do` handles all |
+| 10 /fix variants | `/do` handles all |
+| 4 /auto variants | `/do` handles all |
+| 4 /git variants | `/commit` |
+| 9 /design variants | `/design` + flags |
+| 4 /generate variants | `/generate` + flags |
+| 4 /test variants | `/test` + flags |
+| 4 /docs variants | `/docs` + flags |
+| 4 /memory variants | `/memory` + args |
+
+---
+
+## 💡 Usage Examples
+
+### Beginner
+```
+/start                     # Setup
+/do "Add user login"       # Everything auto
+/commit                    # Save
+```
+
+### Intermediate
+```
+/do "Add payment" --careful    # With extra validation
+/test --coverage               # Check coverage
+/review --security             # Security review
+```
+
+### Expert
+```
+/do "Complex feature" --plan-only   # Plan first
+/design "API" --domain              # DDD design
+/generate "users" --api --full      # Full stack
+```
+
+---
+
+## 🔄 Migration Guide
+
+If you used old commands:
+- `/plan`, `/cook`, `/fix`, `/auto:*` → Use `/do`
+- `/git:cm`, `/git:pr` → Use `/commit`
+- `/design:ui`, `/design:domain` → Use `/design` with flags
+- `/generate:page`, `/generate:api` → Use `/generate` with flags
+
+> Legacy commands have been removed in v3.1.0
+

package/docs/ARCHITECTURE.md

@@ -0,0 +1,186 @@
+# anchi-toolkit Architecture
+
+> Understanding how anchi-toolkit works for Cursor AI & Antigravity
+
+---
+
+## 🏗️ Core Concepts
+
+### What is anchi-toolkit?
+
+anchi-toolkit is a **unified toolkit** that provides:
+- **18 Commands** - AI-powered workflows
+- **19 Agents** - Specialized AI personas  
+- **35 Skills** - Domain knowledge packs
+- **3 Presets** - Architecture templates
+
+### Naming Clarification
+
+| Term | Definition |
+|------|------------|
+| **anchi-toolkit** | 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 | 18 unified commands |
+| Agents | 19 AI personas |
+| Skills | 35 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-toolkit install
+
+# Antigravity
+npx anchi-toolkit antigravity
+```
+
+---
+
+## 📁 Directory Structure
+
+```
+project/
+├── .cursor/              # Cursor AI
+│   ├── commands/         # 18 command files
+│   ├── agents/           # 19 agent definitions
+│   └── skills/           # 35 skill modules
+│
+├── .antigravity/               # Antigravity
+│   ├── workflows/        # 18 command files (same content)
+│   ├── agents/           # 19 agent definitions
+│   └── skills/           # 35 skill modules
+│
+└── presets/              # Architecture templates
+    ├── 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