anchi-toolkit 1.0.0

package/presets/professional/.cursorrules

@@ -0,0 +1,113 @@
+# Professional - Cursor Rules
+
+> **Mode:** Professional Development - Cân bằng tốc độ và quality, code có cấu trúc.
+
+---
+
+## ⚠️ SAFETY RULES (CRITICAL)
+
+> **AI KHÔNG được tự ý thay đổi code nếu chưa được user confirm.**
+
+- 🚫 **NEVER auto-implement** - Luôn đề xuất trước, chờ approval
+- 👀 **ALWAYS preview** - Show diff/plan trước khi thực hiện
+- ⚠️ **CONFIRM destructive** - Hỏi trước delete/overwrite/rename
+- 🚀 **NO auto-push** - Không git push nếu chưa được phép
+
+---
+
+## Tech Stack
+
+- **Framework:** Next.js 14 (App Router)
+- **Language:** TypeScript (strict)
+- **Database:** PostgreSQL + Prisma
+- **Auth:** NextAuth.js v5
+- **UI:** shadcn/ui + Radix + TailwindCSS
+- **State:** Zustand + React Query
+- **Validation:** Zod
+- **Testing:** Vitest + Testing Library
+
+---
+
+## Architecture
+
+**Modular Monolith (Feature-based)**
+
+```
+src/
+├── app/              # Routes
+├── modules/          # Feature modules
+│   └── [feature]/
+│       ├── components/
+│       ├── services/
+│       ├── hooks/
+│       ├── types/
+│       └── index.ts
+├── components/       # Shared UI
+├── lib/              # Core utilities
+└── shared/           # Shared code
+```
+
+---
+
+## Coding Principles
+
+### Module Rules
+- Export only via `index.ts`
+- Import cross-module via public API
+- Keep modules independent
+
+### Service Pattern
+```typescript
+// modules/users/services/user.service.ts
+export const userService = {
+  getById: (id: string) => prisma.user.findUnique({ where: { id } }),
+  create: (data: CreateUserInput) => prisma.user.create({ data }),
+};
+```
+
+### Type Safety
+- Zod schemas for all inputs
+- Infer types from schemas
+- No `any` allowed
+
+---
+
+## DO NOT
+
+- ❌ Import internal module files directly
+- ❌ Put business logic in components
+- ❌ Skip input validation
+- ❌ Use `any` type
+
+---
+
+## DO
+
+- ✅ Extract logic to services
+- ✅ Validate with Zod
+- ✅ Write tests for services
+- ✅ Keep components presentational
+- ✅ Use proper error handling
+
+---
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `/plan` | Detailed implementation plan |
+| `/design-domain` | Design module structure |
+| `/design-ui` | Design UI components |
+| `/cook` | Implement feature |
+| `/review` | Code review |
+| `/test` | Write tests |
+
+---
+
+## Quality Checklist
+
+- [ ] Service layer handles logic
+- [ ] Zod validates inputs
+- [ ] Types are inferred
+- [ ] Tests cover critical paths
+- [ ] Components are reusable

package/presets/professional/README.md

@@ -0,0 +1,140 @@
+# 🏢 Professional Preset
+
+> **Mục tiêu:** Xây dựng webapp chuyên nghiệp, dễ mở rộng và maintain. Phù hợp cho sản phẩm thương mại.
+
+## Khi Nào Dùng?
+
+- ✅ Sản phẩm thương mại cần maintain lâu dài
+- ✅ Team 3-10 người
+- ✅ Cần scale features theo thời gian
+- ✅ Business logic phức tạp vừa phải
+- ✅ Timeline 1-6 tháng
+
+## Tech Stack
+
+| Layer | Technology | Lý do |
+|-------|------------|-------|
+| Framework | Next.js 14 (App Router) | Best DX, production-ready |
+| Database | PostgreSQL + Prisma | Reliable, scalable |
+| Auth | NextAuth.js v5 | Flexible, secure |
+| UI | shadcn/ui + Radix + TailwindCSS | Accessible, customizable |
+| State | Zustand (client) + React Query (server) | Simple but powerful |
+| Validation | Zod | End-to-end type safety |
+| Testing | Vitest + Testing Library | Fast, reliable |
+| Deploy | Vercel / Docker | Flexible options |
+
+## Architecture
+
+**Modular Monolith + Domain-Driven Design (Lite)**
+
+```
+src/
+├── app/                        # Next.js routes
+│   ├── (public)/
+│   ├── (auth)/
+│   ├── (dashboard)/
+│   └── api/
+│
+├── modules/                    # Feature modules
+│   ├── auth/
+│   │   ├── components/         # UI components
+│   │   ├── services/           # Business logic
+│   │   ├── hooks/              # Custom hooks
+│   │   ├── types/              # Types
+│   │   └── index.ts            # Public API
+│   │
+│   ├── users/
+│   ├── products/
+│   └── orders/
+│
+├── components/                 # Shared UI
+│   ├── ui/                     # Primitives
+│   ├── patterns/               # Composite
+│   └── layouts/                # Layouts
+│
+├── lib/                        # Core utilities
+│   ├── db/
+│   ├── auth/
+│   └── utils/
+│
+└── shared/                     # Shared code
+    ├── types/
+    └── constants/
+```
+
+## Module Structure
+
+```
+modules/[feature]/
+├── components/           # Feature UI
+│   ├── ProductList.tsx
+│   └── ProductCard.tsx
+├── services/             # Business logic
+│   ├── product.service.ts
+│   └── product.queries.ts
+├── hooks/                # Feature hooks
+│   └── useProducts.ts
+├── types/                # Feature types
+│   └── product.types.ts
+├── schemas/              # Zod schemas
+│   └── product.schema.ts
+└── index.ts              # Public exports
+```
+
+## Key Principles
+
+### 1. Module Boundaries
+- Modules chỉ export qua `index.ts`
+- Import cross-module qua public API
+- Không import internal files
+
+### 2. Service Pattern
+```typescript
+// modules/products/services/product.service.ts
+export const productService = {
+  async getAll() {
+    return prisma.product.findMany();
+  },
+  
+  async create(data: CreateProductInput) {
+    return prisma.product.create({ data });
+  }
+};
+```
+
+### 3. Type Safety
+```typescript
+// modules/products/schemas/product.schema.ts
+export const createProductSchema = z.object({
+  name: z.string().min(1),
+  price: z.number().positive(),
+  description: z.string().optional(),
+});
+
+export type CreateProductInput = z.infer<typeof createProductSchema>;
+```
+
+## Migration Path
+
+### From Rapid MVP
+1. Tổ chức lại code vào `modules/`
+2. Extract services từ API routes
+3. Add Zod validation
+4. Setup proper testing
+
+### To Enterprise
+1. Add Domain layer (entities, value objects)
+2. Implement Domain Events
+3. Add CQRS if needed
+4. Setup monitoring
+
+> 📖 Xem: `presets/MIGRATION_GUIDE.md`
+
+## Quick Start
+
+```bash
+cp presets/professional/.cursorrules .cursorrules
+
+# Hoặc
+/use-preset professional
+```

package/presets/professional/contract.json

@@ -0,0 +1,72 @@
+{
+    "name": "professional",
+    "displayName": "Professional",
+    "version": "3.2.0",
+    "architecture": {
+        "type": "modular-monolith",
+        "database": "PostgreSQL",
+        "structure": "modules"
+    },
+    "rules": {
+        "allowed": [
+            "modular structure",
+            "service layer pattern",
+            "repository pattern",
+            "component composition"
+        ],
+        "forbidden": [
+            "logic in components",
+            "direct database in routes",
+            "circular dependencies",
+            "god objects",
+            "inline SQL"
+        ],
+        "warnings": [
+            "missing tests for new features",
+            "missing documentation"
+        ]
+    },
+    "checks": {
+        "required": [
+            "syntax",
+            "lint",
+            "type-check"
+        ],
+        "optional": [
+            "test"
+        ],
+        "coverage_min": 60
+    },
+    "approvals": {
+        "code_changes": false,
+        "architecture_changes": true,
+        "destructive_actions": true
+    },
+    "ai_behavior": {
+        "speed_priority": false,
+        "explanation_level": "standard",
+        "auto_approve": false
+    },
+    "migration": {
+        "previous": "rapid",
+        "next": "enterprise",
+        "requirements": [
+            "Add DDD structure",
+            "Add domain events",
+            "Add CQRS if needed",
+            "Add comprehensive tests"
+        ]
+    },
+    "patterns": {
+        "file_naming": "kebab-case",
+        "component_naming": "PascalCase",
+        "function_naming": "camelCase",
+        "module_structure": [
+            "{module}/",
+            "{module}/components/",
+            "{module}/services/",
+            "{module}/hooks/",
+            "{module}/types/"
+        ]
+    }
+}

package/presets/rapid/contract.json

@@ -0,0 +1,53 @@
+{
+    "name": "rapid",
+    "displayName": "Rapid MVP",
+    "version": "3.2.0",
+    "architecture": {
+        "type": "flat",
+        "database": "SQLite",
+        "structure": "flexible"
+    },
+    "rules": {
+        "allowed": [
+            "any file structure",
+            "direct database access",
+            "inline styles",
+            "quick patterns",
+            "skip tests"
+        ],
+        "forbidden": [],
+        "warnings": [
+            "no type checking",
+            "no test coverage"
+        ]
+    },
+    "checks": {
+        "required": [
+            "syntax"
+        ],
+        "optional": [
+            "lint",
+            "type-check",
+            "test"
+        ],
+        "coverage_min": 0
+    },
+    "approvals": {
+        "code_changes": false,
+        "architecture_changes": false,
+        "destructive_actions": true
+    },
+    "ai_behavior": {
+        "speed_priority": true,
+        "explanation_level": "minimal",
+        "auto_approve": true
+    },
+    "migration": {
+        "next": "professional",
+        "requirements": [
+            "Add module structure",
+            "Add service layer",
+            "Add basic tests"
+        ]
+    }
+}

package/presets/rapid-mvp/.cursorrules

@@ -0,0 +1,98 @@
+# Rapid MVP - Cursor Rules
+
+> **Mode:** Rapid Development - Ưu tiên tốc độ, code đơn giản, ship nhanh.
+
+---
+
+## ⚠️ SAFETY RULES (CRITICAL)
+
+> **AI KHÔNG được tự ý thay đổi code nếu chưa được user confirm.**
+
+- 🚫 **NEVER auto-implement** - Luôn đề xuất trước, chờ approval
+- 👀 **ALWAYS preview** - Show diff/plan trước khi thực hiện
+- ⚠️ **CONFIRM destructive** - Hỏi trước delete/overwrite/rename
+- 🚀 **NO auto-push** - Không git push nếu chưa được phép
+
+---
+
+## Tech Stack
+
+- **Framework:** Next.js 14 (App Router)
+- **Language:** TypeScript
+- **Database:** SQLite + Prisma
+- **Auth:** NextAuth.js
+- **UI:** shadcn/ui + TailwindCSS
+- **Deploy:** Vercel
+
+---
+
+## Project Structure
+
+```
+src/
+├── app/              # Pages + API
+├── components/       # UI components
+│   ├── ui/           # shadcn/ui
+│   └── features/     # Feature components
+├── lib/              # Utilities
+├── hooks/            # Custom hooks
+└── types/            # TypeScript types
+```
+
+---
+
+## Coding Style
+
+### Keep It Simple
+- Logic trong Server Components OK
+- API routes inline validation OK
+- Không cần tách services layer
+
+### Components
+- Functional components only
+- Props interface cùng file
+- Co-locate styles với component
+
+### Data Fetching
+- Server Components cho static data
+- Route Handlers cho mutations
+- React Query nếu cần client-side
+
+---
+
+## DO NOT
+
+- ❌ Over-engineer với nhiều layers
+- ❌ Premature optimization
+- ❌ Complex state management (unless needed)
+- ❌ Microservices architecture
+
+---
+
+## DO
+
+- ✅ Ship fast, iterate later
+- ✅ Use shadcn/ui components
+- ✅ Keep files small (< 200 lines)
+- ✅ Write basic tests for critical paths
+
+---
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `/plan` | Quick plan (keep simple) |
+| `/cook` | Implement feature |
+| `/design-ui` | Design component |
+
+---
+
+## Migration Ready
+
+Code được viết sẵn để dễ migrate:
+- Prisma schema → PostgreSQL compatible
+- Components → Reusable
+- Types → Shared interfaces
+
+> Khi cần scale: `/migrate-to professional`

package/presets/rapid-mvp/README.md

@@ -0,0 +1,107 @@
+# 🚀 Rapid MVP Preset
+
+> **Mục tiêu:** Xây dựng sản phẩm demo nhanh nhất có thể. Phù hợp cho MVP, prototype, hackathon.
+
+## Khi Nào Dùng?
+
+- ✅ Cần demo nhanh cho khách hàng
+- ✅ Validate ý tưởng sản phẩm
+- ✅ Hackathon, side projects
+- ✅ Deadline gấp (< 2 tuần)
+- ✅ Team nhỏ (1-2 người)
+
+## Tech Stack
+
+| Layer | Technology | Lý do |
+|-------|------------|-------|
+| Framework | Next.js 14 (App Router) | Full-stack trong 1 repo |
+| Database | SQLite / Prisma | Zero config, portable |
+| Auth | NextAuth.js | Quick setup |
+| UI | shadcn/ui + TailwindCSS | Beautiful, ready-to-use |
+| State | React hooks only | Simple, no overhead |
+| Forms | React Hook Form | Easy validation |
+| Deploy | Vercel | 1-click deploy |
+
+## Folder Structure
+
+```
+src/
+├── app/                    # Pages + API routes
+│   ├── (public)/
+│   ├── (auth)/
+│   ├── api/
+│   └── layout.tsx
+│
+├── components/             # UI Components
+│   ├── ui/                 # shadcn/ui components
+│   └── features/           # Feature-specific
+│
+├── lib/                    # Utilities
+│   ├── db.ts               # Prisma client
+│   ├── auth.ts             # Auth config  
+│   └── utils.ts
+│
+├── hooks/                  # Custom hooks
+└── types/                  # TypeScript types
+```
+
+## Coding Guidelines
+
+### Simple is Better
+- Không cần tách layers phức tạp
+- Logic có thể để trong Server Components
+- API routes đơn giản, inline validation
+
+### Example: Simple CRUD
+
+```typescript
+// app/api/products/route.ts
+import { prisma } from '@/lib/db';
+
+export async function GET() {
+  const products = await prisma.product.findMany();
+  return Response.json(products);
+}
+
+export async function POST(req: Request) {
+  const data = await req.json();
+  const product = await prisma.product.create({ data });
+  return Response.json(product);
+}
+```
+
+### Example: Simple Component
+
+```tsx
+// components/features/ProductCard.tsx
+export function ProductCard({ product }: { product: Product }) {
+  return (
+    <div className="rounded-lg border p-4 hover:shadow-lg transition">
+      <h3 className="font-semibold">{product.name}</h3>
+      <p className="text-muted-foreground">{product.description}</p>
+      <span className="text-lg font-bold">${product.price}</span>
+    </div>
+  );
+}
+```
+
+## Migration Path
+
+Khi cần upgrade lên Professional:
+
+1. **Database:** SQLite → PostgreSQL (chỉ đổi connection string)
+2. **Structure:** Tách logic vào `services/` folder
+3. **Auth:** Thêm role-based access
+4. **State:** Add Zustand/React Query nếu cần
+
+> 📖 Xem: `presets/MIGRATION_GUIDE.md`
+
+## Quick Start
+
+```bash
+# Copy preset này
+cp presets/rapid-mvp/.cursorrules .cursorrules
+
+# Hoặc chạy command
+/use-preset rapid
+```

package/scripts/check-setup.ps1

@@ -0,0 +1,59 @@
+# Script: Kiểm Tra Setup Dự Án
+# Cách dùng: .\check-setup.ps1
+
+Write-Host ""
+Write-Host "🔍 Kiểm tra setup dự án..." -ForegroundColor Cyan
+Write-Host ""
+
+$checks = @(
+    @{Name = ".cursorrules"; Path = ".cursorrules"; Required = $true; Description = "AI rules chính" },
+    @{Name = ".cursor/"; Path = ".cursor"; Required = $true; Description = "Cursor configuration" },
+    @{Name = ".cursor/agents/"; Path = ".cursor/agents"; Required = $true; Description = "Agent definitions" },
+    @{Name = ".cursor/commands/"; Path = ".cursor/commands"; Required = $true; Description = "Slash commands" },
+    @{Name = ".cursor/skills/"; Path = ".cursor/skills"; Required = $true; Description = "Skills modules" },
+    @{Name = ".antigravity/"; Path = ".antigravity"; Required = $true; Description = "Antigravity agents" },
+    @{Name = "CURSOR.md"; Path = "CURSOR.md"; Required = $true; Description = "AI instructions" },
+    @{Name = "ANTIGRAVITY.md"; Path = "ANTIGRAVITY.md"; Required = $false; Description = "Orchestration guide" },
+    @{Name = "docs/"; Path = "docs"; Required = $true; Description = "Documentation folder" },
+    @{Name = "docs/PROJECT.md"; Path = "docs/PROJECT.md"; Required = $true; Description = "Project description" },
+    @{Name = "docs/code-standards.md"; Path = "docs/code-standards.md"; Required = $true; Description = "Coding standards" },
+    @{Name = "package.json"; Path = "package.json"; Required = $true; Description = "Package config" }
+)
+
+$passed = 0
+$failed = 0
+
+foreach ($check in $checks) {
+    if (Test-Path $check.Path) {
+        Write-Host "  ✅ $($check.Name)" -ForegroundColor Green
+        $passed++
+    }
+    else {
+        if ($check.Required) {
+            Write-Host "  ❌ $($check.Name) - MISSING (Required)" -ForegroundColor Red
+            $failed++
+        }
+        else {
+            Write-Host "  ⚠️ $($check.Name) - Missing (Optional)" -ForegroundColor Yellow
+        }
+    }
+}
+
+Write-Host ""
+Write-Host "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" -ForegroundColor Gray
+Write-Host "Kết quả: $passed passed, $failed failed" -ForegroundColor White
+
+if ($failed -eq 0) {
+    Write-Host ""
+    Write-Host "✅ Setup hoàn chỉnh! Có thể mở Cursor IDE." -ForegroundColor Green
+    Write-Host ""
+    Write-Host "Tiếp theo:" -ForegroundColor Yellow
+    Write-Host "  cursor ." -ForegroundColor Cyan
+}
+else {
+    Write-Host ""
+    Write-Host "❌ Thiếu $failed file(s) bắt buộc." -ForegroundColor Red
+    Write-Host "Kiểm tra lại template hoặc chạy lại setup." -ForegroundColor Yellow
+}
+
+Write-Host ""

package/scripts/install-hooks.ps1

@@ -0,0 +1,60 @@
+# ═══════════════════════════════════════════════════════════════
+# anchi-kit Git Hooks Installer (Windows)
+# ═══════════════════════════════════════════════════════════════
+
+Write-Host ""
+Write-Host "🔗 anchi-kit Git Hooks Installer" -ForegroundColor Cyan
+Write-Host "═══════════════════════════════════════════════════════════════" -ForegroundColor Gray
+Write-Host ""
+
+$gitDir = ".git"
+$hooksDir = "$gitDir\hooks"
+$configFile = ".cursor\hooks.yaml"
+
+# Check if git repository
+if (-not (Test-Path $gitDir)) {
+    Write-Host "❌ Not a git repository" -ForegroundColor Red
+    exit 1
+}
+
+# Create hooks directory
+if (-not (Test-Path $hooksDir)) {
+    New-Item -ItemType Directory -Path $hooksDir -Force | Out-Null
+}
+
+# Create pre-commit hook
+$preCommitHook = @"
+#!/bin/sh
+# anchi-kit pre-commit hook
+# Reminder: Run /review:fast before committing
+
+echo "💡 anchi-kit reminder: Consider running /review:fast"
+echo "   To skip: git commit --no-verify"
+exit 0
+"@
+
+$preCommitPath = "$hooksDir\pre-commit"
+Set-Content -Path $preCommitPath -Value $preCommitHook -NoNewline
+Write-Host "✅ Installed: pre-commit hook" -ForegroundColor Green
+
+# Create post-merge hook
+$postMergeHook = @"
+#!/bin/sh
+# anchi-kit post-merge hook
+# Reminder: Update docs after merge
+
+echo "💡 anchi-kit reminder: Consider running /docs:update"
+exit 0
+"@
+
+$postMergePath = "$hooksDir\post-merge"
+Set-Content -Path $postMergePath -Value $postMergeHook -NoNewline
+Write-Host "✅ Installed: post-merge hook" -ForegroundColor Green
+
+Write-Host ""
+Write-Host "═══════════════════════════════════════════════════════════════" -ForegroundColor Gray
+Write-Host "✅ Git hooks installed successfully!" -ForegroundColor Green
+Write-Host ""
+Write-Host "📌 Hooks will show reminders for anchi-kit commands." -ForegroundColor Yellow
+Write-Host "   To skip: use --no-verify flag" -ForegroundColor Gray
+Write-Host ""