anchi-kit 1.1.2

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/add-shebang.js

@@ -0,0 +1,13 @@
+const fs = require('fs');
+const path = require('path');
+const distPath = path.join(__dirname, '../dist/index.js');
+if (fs.existsSync(distPath)) {
+  const content = fs.readFileSync(distPath, 'utf8');
+  if (!content.startsWith('#!')) {
+    fs.writeFileSync(distPath, '#!/usr/bin/env node\n' + content);
+    console.log('✅ Shebang added to dist/index.js');
+  }
+} else {
+    console.error('❌ dist/index.js not found!');
+    process.exit(1);
+}

package/scripts/analyze-skills.js

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+// Read all SKILL.md files
+const skillsDir = path.join(__dirname, '../.cursor/skills');
+const skills = [];
+
+function readSkillMetadata(skillPath) {
+  const skillMdPath = path.join(skillPath, 'SKILL.md');
+  if (!fs.existsSync(skillMdPath)) return null;
+  
+  const content = fs.readFileSync(skillMdPath, 'utf-8');
+  const lines = content.split('\n');
+  
+  let name = '';
+  let description = '';
+  let inFrontmatter = false;
+  
+  for (const line of lines) {
+    if (line.trim() === '---') {
+      if (!inFrontmatter) {
+        inFrontmatter = true;
+      } else {
+        break;
+      }
+      continue;
+    }
+    
+    if (inFrontmatter) {
+      const nameMatch = line.match(/^name:\s*(.+)$/);
+      const descMatch = line.match(/^description:\s*(.+)$/);
+      
+      if (nameMatch) name = nameMatch[1].trim();
+      if (descMatch) description = descMatch[1].trim();
+    }
+  }
+  
+  return { name, description, path: skillPath };
+}
+
+// Scan all skill directories
+const skillDirs = fs.readdirSync(skillsDir, { withFileTypes: true })
+  .filter(dirent => dirent.isDirectory())
+  .map(dirent => path.join(skillsDir, dirent.name));
+
+skillDirs.forEach(dir => {
+  const metadata = readSkillMetadata(dir);
+  if (metadata && metadata.name) {
+    skills.push(metadata);
+  }
+  
+  // Check for nested skills (like document-skills)
+  const nestedDirs = fs.readdirSync(dir, { withFileTypes: true })
+    .filter(d => d.isDirectory())
+    .map(d => path.join(dir, d.name));
+  
+  nestedDirs.forEach(nestedDir => {
+    const nestedMetadata = readSkillMetadata(nestedDir);
+    if (nestedMetadata && nestedMetadata.name) {
+      skills.push(nestedMetadata);
+    }
+  });
+});
+
+console.log(`\n📊 Total Skills Found: ${skills.length}\n`);
+console.log('═'.repeat(80));
+
+// Check for duplicates by name
+const nameMap = {};
+skills.forEach(skill => {
+  if (!nameMap[skill.name]) {
+    nameMap[skill.name] = [];
+  }
+  nameMap[skill.name].push(skill);
+});
+
+const duplicateNames = Object.entries(nameMap).filter(([_, instances]) => instances.length > 1);
+
+if (duplicateNames.length > 0) {
+  console.log('\n❌ DUPLICATE SKILL NAMES FOUND:\n');
+  duplicateNames.forEach(([name, instances]) => {
+    console.log(`  Name: "${name}" (${instances.length} instances)`);
+    instances.forEach(inst => {
+      console.log(`    - ${path.relative(skillsDir, inst.path)}`);
+    });
+    console.log('');
+  });
+} else {
+  console.log('\n✅ No duplicate skill names found\n');
+}
+
+// Check for similar descriptions (potential overlaps)
+console.log('\n🔍 CHECKING FOR OVERLAPPING DESCRIPTIONS:\n');
+
+const keywords = {};
+skills.forEach(skill => {
+  const words = skill.description.toLowerCase()
+    .split(/\s+/)
+    .filter(w => w.length > 4); // Only words longer than 4 chars
+  
+  words.forEach(word => {
+    if (!keywords[word]) keywords[word] = [];
+    keywords[word].push(skill.name);
+  });
+});
+
+// Find skills with similar keyword patterns
+const similarityThreshold = 3; // Number of common keywords to flag
+const potentialOverlaps = [];
+
+for (let i = 0; i < skills.length; i++) {
+  for (let j = i + 1; j < skills.length; j++) {
+    const skill1 = skills[i];
+    const skill2 = skills[j];
+    
+    const words1 = skill1.description.toLowerCase().split(/\s+/);
+    const words2 = skill2.description.toLowerCase().split(/\s+/);
+    
+    const commonWords = words1.filter(w => words2.includes(w) && w.length > 4);
+    
+    if (commonWords.length >= similarityThreshold) {
+      potentialOverlaps.push({
+        skill1: skill1.name,
+        skill2: skill2.name,
+        commonWords: commonWords.slice(0, 5),
+        count: commonWords.length
+      });
+    }
+  }
+}
+
+if (potentialOverlaps.length > 0) {
+  console.log('⚠️  Potential overlaps found (skills with similar keywords):\n');
+  potentialOverlaps
+    .sort((a, b) => b.count - a.count)
+    .slice(0, 10) // Top 10
+    .forEach(overlap => {
+      console.log(`  "${overlap.skill1}" ↔️ "${overlap.skill2}"`);
+      console.log(`    Common words (${overlap.count}): ${overlap.commonWords.join(', ')}`);
+      console.log('');
+    });
+} else {
+  console.log('✅ No significant overlaps detected\n');
+}
+
+// List all skills organized by category
+console.log('\n📋 ALL SKILLS ORGANIZED:\n');
+const categories = {
+  'Frontend': ['frontend', 'ui-', 'design', 'aesthetic'],
+  'Backend': ['backend', 'database', 'api'],
+  'Testing': ['test', 'debug', 'playwright', 'chrome-devtools'],
+  'DevOps': ['devops', 'git', 'deployment'],
+  'AI/Automation': ['ai-', 'mcp-', 'prompt-engineering', 'changelog'],
+  'Documentation': ['document', 'docs', 'pdf', 'docx', 'pptx', 'xlsx'],
+  'Architecture': ['architecture', 'ddd', 'planning', 'problem-solving'],
+  'Specialized': ['shopify', 'payment', 'threejs', 'mobile', 'repomix']
+};
+
+Object.entries(categories).forEach(([category, patterns]) => {
+  const categorySkills = skills.filter(skill => 
+    patterns.some(pattern => skill.name.toLowerCase().includes(pattern.toLowerCase()))
+  );
+  
+  if (categorySkills.length > 0) {
+    console.log(`\n${category} (${categorySkills.length} skills):`);
+    categorySkills.forEach(skill => {
+      const desc = skill.description.substring(0, 60) + (skill.description.length > 60 ? '...' : '');
+      console.log(`  ✓ ${skill.name.padEnd(30)} - ${desc}`);
+    });
+  }
+});
+
+// List uncategorized
+const categorizedNames = new Set();
+Object.values(categories).flat().forEach(pattern => {
+  skills.forEach(skill => {
+    if (skill.name.toLowerCase().includes(pattern.toLowerCase())) {
+      categorizedNames.add(skill.name);
+    }
+  });
+});
+
+const uncategorized = skills.filter(s => !categorizedNames.has(s.name));
+if (uncategorized.length > 0) {
+  console.log(`\nUncategorized (${uncategorized.length} skills):`);
+  uncategorized.forEach(skill => {
+    console.log(`  ? ${skill.name.padEnd(30)} - ${skill.description.substring(0, 60)}...`);
+  });
+}
+
+console.log('\n' + '═'.repeat(80));
+console.log('\n✅ Analysis complete!\n');

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,74 @@
+# ═══════════════════════════════════════════════════════════════
+# 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"
+
+# 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 (Enforce Tests)
+$preCommitHook = @"
+#!/bin/sh
+# anchi-kit pre-commit hook
+# Enforces code quality by running tests
+
+echo "🛡️  anchi-kit: Checking Safety Net..."
+
+# 1. Check for tests
+if [ -f "package.json" ] && grep -q "\"test\":" "package.json"; then
+    echo "🧪 Running npm test..."
+    npm test
+    
+    if [ $? -ne 0 ]; then
+        echo "❌ TESTS FAILED. Commit blocked."
+        echo "   (Use --no-verify to force if you really must)"
+        exit 1
+    fi
+else
+    echo "⚠️  No test script found in package.json. Skipping tests."
+fi
+
+echo "✅ Safety Check Passed."
+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 (Reminder)
+$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 verify tests before commit." -ForegroundColor Yellow
+Write-Host "   To skip: use --no-verify flag" -ForegroundColor Gray
+Write-Host ""

package/scripts/install-hooks.sh

@@ -0,0 +1,69 @@
+#!/bin/bash
+# ═══════════════════════════════════════════════════════════════
+# anchi-kit Git Hooks Installer (macOS/Linux)
+# ═══════════════════════════════════════════════════════════════
+
+echo ""
+echo "🔗 anchi-kit Git Hooks Installer"
+echo "═══════════════════════════════════════════════════════════════"
+echo ""
+
+GIT_DIR=".git"
+HOOKS_DIR="$GIT_DIR/hooks"
+
+# Check if git repository
+if [ ! -d "$GIT_DIR" ]; then
+    echo "❌ Not a git repository"
+    exit 1
+fi
+
+# Create hooks directory
+mkdir -p "$HOOKS_DIR"
+
+# Create pre-commit hook
+cat > "$HOOKS_DIR/pre-commit" << 'EOF'
+#!/bin/sh
+# anchi-kit pre-commit hook
+# Enforces code quality by running tests
+
+echo "🛡️  anchi-kit: Checking Safety Net..."
+
+# 1. Check for tests
+if [ -f "package.json" ] && grep -q "\"test\":" "package.json"; then
+    echo "🧪 Running npm test..."
+    npm test
+    
+    if [ $? -ne 0 ]; then
+        echo "❌ TESTS FAILED. Commit blocked."
+        echo "   (Use --no-verify to force if you really must)"
+        exit 1
+    fi
+else
+    echo "⚠️  No test script found in package.json. Skipping tests."
+fi
+
+echo "✅ Safety Check Passed."
+exit 0
+EOF
+chmod +x "$HOOKS_DIR/pre-commit"
+echo "✅ Installed: pre-commit hook"
+
+# Create post-merge hook
+cat > "$HOOKS_DIR/post-merge" << 'EOF'
+#!/bin/sh
+# anchi-kit post-merge hook
+# Reminder: Update docs after merge
+
+echo "💡 anchi-kit reminder: Consider running /docs:update"
+exit 0
+EOF
+chmod +x "$HOOKS_DIR/post-merge"
+echo "✅ Installed: post-merge hook"
+
+echo ""
+echo "═══════════════════════════════════════════════════════════════"
+echo "✅ Git hooks installed successfully!"
+echo ""
+echo "📌 Hooks will show reminders for anchi-kit commands."
+echo "   To skip: use --no-verify flag"
+echo ""