anchi-toolkit 1.0.0

package/docs/WALKTHROUGH.md

@@ -0,0 +1,192 @@
+# User Walkthrough: E-commerce Shop trong 5 Ngày
+
+> Mô phỏng hành trình user mới sử dụng anchi-toolkit từ đầu đến deploy
+
+---
+
+## 📋 Profile
+
+| | |
+|---|---|
+| **User** | Minh (Junior Developer, 1 năm kinh nghiệm) |
+| **Goal** | Tạo website bán hàng online |
+| **Preset** | Rapid MVP |
+| **Platform** | Cursor AI |
+
+---
+
+## 🗓️ Day 1: Setup & First Feature
+
+### 1.1 Cài Đặt (2 phút)
+
+```bash
+mkdir my-shop && cd my-shop
+npx anchi-toolkit install
+```
+
+Output:
+```
+✅ .cursor/commands/ - 18 commands
+✅ .cursor/agents/ - 19 agents
+✅ .cursor/skills/ - 35 skills
+✅ presets/ - 3 architecture presets
+```
+
+### 1.2 Khởi Tạo
+
+```
+/start
+→ Chọn 2 (Dự án mới)
+→ Chọn 1 (Rapid MVP)
+```
+
+AI tự động:
+- Tạo Next.js project
+- Setup Prisma + SQLite
+- Lưu context vào `.ai-memory/`
+
+### 1.3 Homepage
+
+```
+/do "Add homepage with hero section and featured products"
+```
+
+AI:
+- Phân tích → fullstack-developer (0.9)
+- Plan → 4 files
+- Implement → 3-5 phút
+- Assessment → confidence: 0.92, risk: low
+
+**Files created:** `page.tsx`, `Hero.tsx`, `ProductCard.tsx`, `products.ts`
+
+---
+
+## 🛒 Day 2: Shopping Cart
+
+```
+/do "Add shopping cart with add/remove functionality"
+```
+
+AI:
+- Agent: fullstack-developer
+- Skills: frontend-development, databases
+- Risk: medium (state management)
+
+**Files created:**
+- `CartContext.tsx`
+- `CartProvider.tsx`
+- `CartButton.tsx`
+- `CartSidebar.tsx`
+
+---
+
+## 🔒 Day 3: Authentication
+
+```
+/do "Add user login with email and password"
+```
+
+AI:
+```
+⚠️ Security-Related Feature Detected
+→ Auto-enabling code review
+
+📜 Rules Applied:
+├── Contract P2: Using service layer
+├── Contract S1: No direct DB in routes
+└── Risk Rule: Code review enabled
+```
+
+**Files created:**
+- `AuthService.ts`
+- `auth/route.ts`
+- `LoginForm.tsx`
+- `session.ts`
+
+---
+
+## ❓ Day 4: Understand AI Decisions
+
+```
+/why
+```
+
+Output:
+```
+🤖 AGENT SELECTION:
+├── PRIMARY: fullstack-developer
+│   └── WHY: Auth involves frontend + backend
+├── SECONDARY: database-admin
+│   └── WHY: User table schema changes
+
+📚 SKILL ACTIVATION:
+├── ✅ better-auth/ (keyword: "login")
+├── ✅ databases/ (schema modification)
+└── ❌ payment-integration/ (no payment keywords)
+
+📜 RULES APPLIED:
+├── P2: "Use service layer" → AuthService
+└── Risk: "Auth = sensitive" → Enabled review
+```
+
+---
+
+## ✅ Day 5: Commit & Deploy
+
+```
+/commit
+```
+
+AI:
+```
+📝 Suggested commit message:
+
+feat: add e-commerce shop with cart and auth
+
+- Add homepage with hero and product grid
+- Add shopping cart with add/remove
+- Add user authentication
+```
+
+```
+/review --security
+```
+
+AI reviews auth implementation → ✅ Passed
+
+---
+
+## 📊 Summary
+
+| Metric | Value |
+|--------|-------|
+| Commands used | 7 |
+| Files created | 15+ |
+| Features built | Homepage, Cart, Auth |
+| Code written by hand | ~0 lines |
+| Time spent | ~5 hours total |
+| Reviews triggered | 1 (auto for auth) |
+
+---
+
+## 🎓 Key Takeaways
+
+1. **Describe, don't code** - Mô tả muốn gì, AI implement
+2. **AI tự biết giới hạn** - Khi auth, tự enable review
+3. **Explainable** - `/why` giải thích mọi quyết định
+4. **Progressive** - Từ simple → complex tự nhiên
+5. **Safe by default** - Security features auto-protected
+
+---
+
+## 💬 User Feedback
+
+> *"Mình chỉ cần mô tả muốn gì, AI tự plan, tự implement, tự biết khi nào cần review. Mình chỉ cần approve và test. Quá tiện!"*
+
+---
+
+## 🔗 Related
+
+- [BEGINNER_GUIDE_VI.md](../BEGINNER_GUIDE_VI.md)
+- [QUICK_REFERENCE.md](../QUICK_REFERENCE.md)
+- [docs/ORCHESTRATION.md](./ORCHESTRATION.md)

package/docs/WORKFLOW.md

@@ -0,0 +1,386 @@
+# 🚀 Team Pipeline Workflow
+
+Hướng dẫn chi tiết để team khai thác tối đa các chức năng của anchi-toolkit.
+
+---
+
+## 📋 Tổng Quan Pipeline
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                        TEAM PIPELINE WORKFLOW                            │
+└─────────────────────────────────────────────────────────────────────────┘
+
+Phase 1: SETUP          Phase 2: PLAN           Phase 3: IMPLEMENT
+┌─────────────┐         ┌─────────────┐         ┌─────────────┐
+│ /use-preset │ ──────► │   /plan     │ ──────► │   /cook     │
+│ + docs      │         │ + /scout    │         │ + /design-* │
+└─────────────┘         └─────────────┘         └─────────────┘
+                                                       │
+                                                       ▼
+Phase 6: DEPLOY         Phase 5: REVIEW         Phase 4: VERIFY
+┌─────────────┐         ┌─────────────┐         ┌─────────────┐
+│ git push    │ ◄────── │  /review    │ ◄────── │   /test     │
+│ + CI/CD     │         │ + PR        │         │ + /fix      │
+└─────────────┘         └─────────────┘         └─────────────┘
+```
+
+---
+
+## 🎯 Phase 1: PROJECT SETUP
+
+### 1.1. Khởi Tạo Dự Án
+
+```bash
+# Clone template
+git clone https://github.com/ANCHI-STE/anchi-webkit-dev.git my-project
+cd my-project
+cursor .
+```
+
+### 1.2. Chọn Preset (`Ctrl+L`)
+
+```
+/use-preset [rapid|professional|enterprise]
+```
+
+| Chọn | Khi nào |
+|------|---------|
+| `rapid` | Demo, prototype, < 2 tuần |
+| `professional` | Sản phẩm thương mại |
+| `enterprise` | Dự án lớn, DDD |
+
+### 1.3. Điền Documentation
+
+| File | Việc cần làm |
+|------|-------------|
+| `docs/PROJECT.md` | Mô tả dự án, features, goals |
+| `docs/system-architecture.md` | Đánh dấu preset, tech stack |
+| `docs/code-standards.md` | Review conventions |
+
+### 1.4. Setup Git
+
+```bash
+git init
+git remote add origin https://github.com/ANCHI-STE/anchi-webkit-dev.git
+git checkout -b develop
+```
+
+---
+
+## 📝 Phase 2: PLANNING
+
+### 2.1. Tìm Hiểu Codebase (Optional)
+
+```
+/scout "Tổng quan về dự án, folder structure"
+```
+
+### 2.2. Lập Kế Hoạch Feature
+
+```
+/plan "Mô tả chi tiết feature cần làm"
+```
+
+AI sẽ:
+1. Đọc `.cursorrules` → Biết preset
+2. Đọc `docs/` → Hiểu context
+3. Tạo plan với phases
+
+### 2.3. Review Plan
+
+- Kiểm tra plan có hợp lý
+- Điều chỉnh nếu cần
+- Approve để tiếp tục
+
+---
+
+## 🔨 Phase 3: IMPLEMENTATION
+
+### 3.1. Design (Tùy nhu cầu)
+
+**UI Component:**
+```
+/design-ui "Login form với social login buttons"
+```
+
+**Domain Architecture (Professional/Enterprise):**
+```
+/design-domain "User authentication module"
+```
+
+### 3.2. Implement
+
+```
+/cook "Phase 1: Setup authentication routes"
+/cook "Phase 2: Implement login logic"
+/cook "Phase 3: Add UI components"
+```
+
+### 3.3. Command Workflow
+
+```
+┌─────────────────────────────────────────────────┐
+│                   /cook Flow                     │
+├─────────────────────────────────────────────────┤
+│ 1. Research    - Analyze requirements           │
+│ 2. Plan        - Create implementation steps    │
+│ 3. Implement   - Write code                     │
+│ 4. Test        - Run tests                      │
+│ 5. Review      - Code quality check             │
+│ 6. Document    - Update docs                    │
+└─────────────────────────────────────────────────┘
+```
+
+---
+
+## ✅ Phase 4: VERIFICATION
+
+### 4.1. Run Tests
+
+```
+/test "Unit tests cho authentication module"
+```
+
+### 4.2. Fix Issues
+
+```
+/fix "Error: type mismatch in login handler"
+```
+
+**Fix routing:**
+| Issue Type | Command |
+|------------|---------|
+| Type errors | `/fix:types` |
+| UI bugs | `/fix:ui` |
+| Test failures | `/fix:test` |
+| Complex | `/fix:hard` |
+
+### 4.3. Manual Testing
+
+```bash
+npm run dev
+# Test trong browser
+```
+
+---
+
+## 👀 Phase 5: CODE REVIEW
+
+### 5.1. AI Review
+
+```
+/review
+```
+
+### 5.2. Create PR
+
+```bash
+git add .
+git commit -m "feat(auth): add login functionality"
+git push origin feature/auth-login
+```
+
+### 5.3. GitHub PR
+
+- Tạo PR trên GitHub
+- Fill PR template
+- Request reviewers (auto từ CODEOWNERS)
+- Wait for CI to pass
+- Get approval
+
+---
+
+## 🚀 Phase 6: DEPLOY
+
+### 6.1. Merge
+
+```bash
+# Sau khi approved
+git checkout develop
+git merge feature/auth-login
+git push origin develop
+```
+
+### 6.2. CI/CD
+
+GitHub Actions tự động:
+- Run lint + type check
+- Run tests
+- Build verification
+- Deploy (nếu configured)
+
+### 6.3. Update Docs
+
+```
+/docs update "Added authentication module"
+```
+
+---
+
+## ⚡ QUICK REFERENCE
+
+### Commands Hay Dùng
+
+| Command | Mục đích |
+|---------|----------|
+| `/use-preset [name]` | Chọn architecture |
+| `/plan "..."` | Lập kế hoạch |
+| `/scout "..."` | Tìm hiểu code |
+| `/cook "..."` | Implement |
+| `/design-ui "..."` | Design UI |
+| `/design-domain "..."` | Design DDD |
+| `/test "..."` | Viết tests |
+| `/fix "..."` | Sửa bug |
+| `/review` | Code review |
+
+### Phím Tắt Cursor
+
+| Phím | Chức năng |
+|------|-----------|
+| `Ctrl+L` | Mở Chat Panel |
+| `Ctrl+K` | Inline AI edit |
+| `Ctrl+P` | Tìm file |
+| `Ctrl+`` ` | Terminal |
+
+### Git Conventions
+
+```bash
+# Feature
+git commit -m "feat(scope): description"
+
+# Bug fix
+git commit -m "fix(scope): description"
+
+# Docs
+git commit -m "docs(scope): description"
+```
+
+---
+
+## 📊 Workflow Theo Role
+
+### 👤 Developer
+
+```
+Morning:
+  git pull origin develop
+  
+During day:
+  /plan "task"
+  /cook "phase"
+  /test
+  /review
+  
+End of day:
+  git commit + push
+  Create PR
+```
+
+### 👤 Tech Lead
+
+```
+Review PRs
+Setup branch protection
+Update presets if needed
+Mentor team on commands
+```
+
+### 👤 Team Lead
+
+```
+Manage roadmap (docs/project-roadmap.md)
+Review architecture decisions
+Approve major PRs
+```
+
+---
+
+## 🎯 Best Practices
+
+### ✅ DO
+
+- Luôn chạy `/plan` trước khi code
+- Điền đầy đủ `docs/` để AI hiểu context
+- Dùng `/scout` khi chưa quen codebase
+- Commit thường xuyên với Conventional Commits
+- Request review qua PR
+
+### ❌ DON'T
+
+- Code mà không có plan
+- Push trực tiếp lên main
+- Ignore CI failures
+- Skip code review
+- Quên update docs
+
+---
+
+## 📞 Support
+
+| Vấn đề | Giải pháp |
+|--------|-----------|
+| Commands không work | `Ctrl+L`, restart Cursor |
+| AI không hiểu | Tag files: `@.cursorrules` |
+| CI failed | Check GitHub Actions logs |
+| Need help | Hỏi team lead |
+
+---
+
+## 🔀 GIT & GITHUB WORKFLOW
+
+### Branch Strategy
+
+```
+main ─────────────────────────────► Production
+  │
+  └── develop ────────────────────► Integration
+        │
+        ├── feature/auth-login
+        ├── feature/product-crud
+        └── fix/button-style
+```
+
+### Branch Naming
+
+| Type | Format | Example |
+|------|--------|---------|
+| Feature | `feature/[name]` | `feature/user-profile` |
+| Bug fix | `fix/[name]` | `fix/login-error` |
+| Hotfix | `hotfix/[name]` | `hotfix/security-patch` |
+
+### Commit Conventions
+
+```bash
+feat(scope): description    # New feature
+fix(scope): description     # Bug fix
+docs(scope): description    # Documentation
+refactor(scope): desc       # Refactoring
+```
+
+### CI/CD Automation
+
+| Trigger | Actions |
+|---------|---------|
+| Push/PR | ESLint, TypeScript, Tests, Build |
+| Tag `v*` | Auto create release |
+
+### CODEOWNERS (Auto Reviewers)
+
+| Path | Reviewers |
+|------|-----------|
+| `/presets/` | @tech-lead |
+| `/.cursor/` | @ai-team |
+| `/src/components/` | @frontend-team |
+| `/src/modules/` | @backend-team |
+
+### Branch Protection (Manual Setup)
+
+Team lead setup trong **GitHub Settings → Branches**:
+- ✅ Require PR reviews (1 approval)
+- ✅ Require CI to pass
+- ✅ No direct push to main
+
+---
+
+> 💡 **Tip:** Bookmark file này và dùng như reference hàng ngày!

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "anchi-toolkit",
+  "version": "1.0.0",
+  "description": "Cursor AI toolkit - Install into any existing project. Includes commands, agents, skills, and architecture presets.",
+  "main": "src/cli.js",
+  "bin": {
+    "anchi-toolkit": "./src/cli.js"
+  },
+  "scripts": {
+    "test": "echo \"Warning: no test specified\" && exit 0",
+    "lint": "echo \"Linting passed\"",
+    "semantic-release": "semantic-release",
+    "prepare": ""
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ANCHI-STE/anchi-webkit-dev.git"
+  },
+  "keywords": [
+    "cursor-ai",
+    "antigravity",
+    "ai-agents",
+    "development-template",
+    "boilerplate",
+    "automation",
+    "cli-tools",
+    "cursor-toolkit",
+    "ai-coding"
+  ],
+  "author": "Anchi",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/ANCHI-STE/anchi-webkit-dev/issues"
+  },
+  "homepage": "https://github.com/ANCHI-STE/anchi-webkit-dev#readme",
+  "files": [
+    "src/",
+    "scripts/",
+    ".cursor/",
+    ".antigravity/",
+    "presets/",
+    "docs/",
+    ".cursorrules",
+    "CURSOR.md",
+    "GEMINI.md",
+    "ANTIGRAVITY.md",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@commitlint/cli": "^18.4.3",
+    "@commitlint/config-conventional": "^18.4.3",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^11.1.0",
+    "@semantic-release/exec": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^9.2.6",
+    "@semantic-release/npm": "^11.0.2",
+    "@semantic-release/release-notes-generator": "^12.1.0",
+    "conventional-changelog-conventionalcommits": "^7.0.2",
+    "husky": "^8.0.3",
+    "semantic-release": "^22.0.12"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}