anchi-toolkit 1.0.0

package/.cursor/commands/scout.md

@@ -0,0 +1,111 @@
+---
+description: ⚡⚡ Explore codebase and find relevant files
+argument-hint: [what to find or understand]
+---
+
+# /scout - Codebase Explorer
+
+**What:** Explore codebase, find files, understand structure.
+
+## Usage
+```
+/scout                         # Overview of codebase
+/scout "auth"                  # Find auth-related files
+/scout "how login works"       # Understand flow
+/scout --external              # Use external tools
+```
+
+---
+
+## 💰 Model Selection
+
+| Mode | Recommended Model | Cost |
+|------|-------------------|------|
+| Quick search | GPT-5.1 Codex Mini | 💚 Low |
+| Deep analysis | Sonnet 4.5 | 💛 Medium |
+| Large codebase (>200 files) | Gemini 3 Flash | 💚 Low |
+| External tools | Gemini 2.5 Flash | 💚 Low |
+
+---
+
+## Output
+
+```
+🔍 /scout "auth"
+
+═══════════ FOUND ═══════════
+
+📂 Files (8):
+  • lib/auth/session.ts
+  • lib/auth/password.ts  
+  • app/api/auth/login/route.ts
+  • app/api/auth/logout/route.ts
+  • components/LoginForm.tsx
+  • hooks/useAuth.ts
+  • types/auth.ts
+  • middleware.ts
+
+📊 Summary:
+  • Session-based auth with JWT
+  • Password hashing: bcrypt
+  • OAuth: Google, GitHub
+  • Middleware for protected routes
+
+🔗 Flow:
+  LoginForm → POST /api/auth/login → session.ts → JWT
+
+📌 Entry points:
+  • Login: app/api/auth/login/route.ts
+  • Auth hook: hooks/useAuth.ts
+```
+
+---
+
+## Flags
+
+| Flag | Mode |
+|------|------|
+| `--external` | Use MCP/external tools |
+| `--deep` | Deep analysis |
+| `--deps` | Analyze dependencies |
+
+---
+
+## Replaces
+
+```
+/scout replaces:
+  • /scout:ext
+  • /context
+```
+
+---
+
+## Agent & Skill Activation
+
+**Agents:**
+- `.cursor/agents/scout.md` - Primary codebase search
+- `.cursor/agents/scout-external.md` - For `--external` flag
+- `.cursor/agents/researcher.md` - For `--deep` analysis
+
+**Skills (auto-activated):**
+- `research/` - Research patterns
+- `docs-seeker/` - Find documentation
+- `problem-solving/` - Analyze structure
+- `sequential-thinking/` - Deep analysis
+
+---
+
+##  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/start.md

@@ -0,0 +1,135 @@
+---
+description: ⚡⚡⚡⚡ Bắt đầu sử dụng anchi-kit - Entry point cho mọi dự án
+---
+
+# INSTRUCTION: Follow this workflow exactly
+
+> ⛔ **CRITICAL: PAUSE POINTS**
+> 
+> This command has MULTIPLE decision points where you MUST STOP.
+> 
+> At each decision point:
+> 1. **ONLY show the question** - No other actions
+> 2. **DO NOT call any tools** in parallel with the question
+> 3. **WAIT for user's number input** before proceeding
+> 4. **DO NOT assume or decide** for the user
+>
+> Decision points:
+> - STEP 1: Ask "1 or 2" (existing vs new project) → STOP
+> - STEP 2B: Ask "1, 2, or 3" (preset selection) → STOP
+
+---
+
+## ▶️ STEP 1: Show Welcome (⛔ STOP HERE)
+
+**Show ONLY this, then STOP:**
+
+```
+👋 Chào mừng đến với anchi-kit!
+
+Tôi sẽ giúp bạn setup dự án. Chỉ cần trả lời 1 câu hỏi:
+
+📂 Dự án của bạn là:
+  1️⃣ Dự án có sẵn - Đã có code
+  2️⃣ Dự án mới - Bắt đầu từ đầu
+
+👉 Gõ 1 hoặc 2:
+```
+
+⛔ **STOP. Wait for user to type 1 or 2. Do not proceed until user responds.**
+
+---
+
+## ▶️ STEP 2A: Existing Project (User typed "1")
+
+If user typed 1, proceed with scanning:
+
+### Phase 1: Deploy Scout Agents
+Spawn scout agents to scan codebase in parallel.
+
+### Phase 2: Activate Skills
+Based on detected tech stack.
+
+### Phase 3: Auto-Detect Preset
+Analyze and suggest preset.
+
+### Phase 4: Fill Docs
+Generate project documentation.
+
+---
+
+## ▶️ STEP 2B: New Project (User typed "2") (⛔ STOP HERE)
+
+If user typed 2, **show ONLY this, then STOP:**
+
+```
+📂 Bạn chọn: 2️⃣ Dự án mới
+
+📋 Chọn Architecture Preset:
+
+┌─────────────────────────────────────────────────────────────┐
+│ 1️⃣ 🚀 RAPID MVP                                             │
+│    SQLite | Flat structure | Skip tests OK                 │
+│    Best for: Prototype, demo, hackathon                    │
+│    ⏱️ ~5 min setup                                          │
+├─────────────────────────────────────────────────────────────┤
+│ 2️⃣ 💼 PROFESSIONAL                                          │
+│    PostgreSQL | Modular | Tests required                   │
+│    Best for: Startup, production app                       │
+│    ⏱️ ~10 min setup                                         │
+├─────────────────────────────────────────────────────────────┤
+│ 3️⃣ 🏢 ENTERPRISE                                            │
+│    PostgreSQL + Redis | DDD | Full compliance              │
+│    Best for: Large project, regulated industry             │
+│    ⏱️ ~20 min setup                                         │
+└─────────────────────────────────────────────────────────────┘
+
+👉 Gõ 1, 2, hoặc 3:
+```
+
+⛔ **STOP. Wait for user to type 1, 2, or 3. Do not proceed until user responds.**
+
+---
+
+## ▶️ STEP 3: Execute Preset Setup
+
+After user selects preset (1/2/3):
+
+1. Create project folder if needed
+2. Initialize project with selected preset
+3. Copy preset-specific .cursorrules
+4. Setup documentation templates
+5. Show completion message
+
+---
+
+## Agent & Skill Summary
+
+| Agent | Role |
+|-------|------|
+| `scout` | Scan codebase |
+| `researcher` | Deep analysis |
+| `planner` | Preset detection |
+| `docs-manager` | Fill templates |
+
+| Detected Tech | Skills |
+|---------------|--------|
+| Next.js/React | `frontend-development/` |
+| Prisma/DB | `databases/` |
+| TailwindCSS | `ui-styling/` |
+
+---
+
+## 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/status.md

@@ -0,0 +1,163 @@
+---
+description: ⚡⚡ Show project health and status dashboard
+argument-hint: [optional: specific area]
+---
+
+# /status - Project Status Dashboard
+
+**What:** Show project health, metrics, và recommendations.
+
+## Usage
+```
+/status                        # Full project status
+/status --deps                 # Check dependencies
+/status --tests                # Test status only
+```
+
+---
+
+## 💰 Model Selection
+
+| Check | Recommended Model | Cost |
+|-------|-------------------|------
+| Quick status | GPT-5.1 Codex Mini | 💚 Low |
+| Full analysis | Sonnet 4.5 | 💛 Medium |
+| Large codebase | Gemini 3 Flash | 💚 Low |
+
+---
+
+## Workflow
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ 📊 STATUS CHECK                                             │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  [AUTO] Check: Git status                                   │
+│  [AUTO] Check: Dependencies (outdated, vulnerabilities)     │
+│  [AUTO] Check: Tests (last run, coverage)                   │
+│  [AUTO] Check: Build (last build, errors)                   │
+│  [AUTO] Check: TODOs in code                                │
+│  [AUTO] Check: Open tasks in plans/                         │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Output
+
+```
+📊 PROJECT STATUS
+
+═══════════ OVERVIEW ═══════════
+
+┌─────────────────────────────────────────────────────────────┐
+│ 🏠 my-app v1.2.0                                            │
+│ 📂 Next.js + TypeScript + Prisma                            │
+│ 🏢 Preset: Professional                                     │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  📁 Files: 150 | 📝 Lines: 15,000 | 📦 Deps: 45            │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+
+═══════════ HEALTH CHECK ═══════════
+
+| Check | Status | Details |
+|-------|--------|---------|
+| 🔀 Git | ✅ Clean | 0 uncommitted changes |
+| 🧪 Tests | ✅ Pass | 45/45 (100%) |
+| 📊 Coverage | ⚠️ 72% | Below 80% threshold |
+| 📦 Deps | ⚠️ 3 outdated | next, prisma, tailwind |
+| 🔒 Security | ✅ 0 vulns | Last scan: 2h ago |
+| 🏗️ Build | ✅ Pass | Last: 30 min ago |
+
+═══════════ OPEN TASKS ═══════════
+
+| Type | Count |
+|------|-------|
+| 📋 Plans | 2 active |
+| 📌 TODOs | 5 in code |
+| ⚠️ FIXMEs | 2 in code |
+
+📋 Active Plans:
+  1. plans/payment-integration/ (Phase 2/3)
+  2. plans/user-settings/ (Phase 1/2)
+
+═══════════ RECOMMENDATIONS ═══════════
+
+⚠️ Issues to address:
+  1. Increase test coverage to 80%+
+  2. Update 3 outdated dependencies
+  
+💡 Suggestions:
+  • /test:coverage - View coverage details
+  • /fix "update dependencies"
+  • /cook "payment-integration Phase 3"
+
+📌 Next: /auto:pro "continue payment integration"
+```
+
+---
+
+## Health Checks
+
+| Check | What |
+|-------|------|
+| Git | Uncommitted changes, branch status |
+| Tests | Last run result, pass rate |
+| Coverage | Percentage vs threshold |
+| Dependencies | Outdated packages |
+| Security | npm audit results |
+| Build | Last build status |
+| TODOs | TODO/FIXME comments in code |
+| Plans | Open plans in plans/ folder |
+
+---
+
+## Agent & Skill Activation
+
+**Agents:**
+- `.cursor/agents/project-manager.md` - Status overview
+- `.cursor/agents/scout.md` - Code analysis
+
+**Skills:**
+- `devops/` - Build and deploy
+- `code-review/` - Quality assessment
+
+---
+
+## Configuration
+
+```yaml
+status:
+  checks:
+    git: true
+    tests: true
+    coverage: true
+    dependencies: true
+    security: true
+    build: true
+    todos: true
+    plans: true
+  thresholds:
+    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/
+```
+
+ [docs/ORCHESTRATION_RUNTIME.md](../docs/ORCHESTRATION_RUNTIME.md)

package/.cursor/commands/test.md

@@ -0,0 +1,121 @@
+---
+description: ⚡⚡ Run tests (unit, e2e, coverage)
+argument-hint: [optional: specific test or mode]
+---
+
+# /test - Unified Test Command
+
+**What:** Run tests with auto-detection of test type.
+
+## Usage
+```
+/test                          # Run all tests
+/test "login"                  # Run tests matching "login"
+/test --unit                   # Unit tests only
+/test --e2e                    # E2E tests only
+/test --coverage               # With coverage report
+```
+
+---
+
+## 💰 Model Selection
+
+| Mode | Recommended Model | Cost |
+|------|-------------------|------|
+| Unit tests | GPT-5.1 Codex Mini | 💚 Low |
+| E2E tests | Sonnet 4.5 | 💛 Medium |
+| Coverage analysis | Sonnet 4.5 | 💛 Medium |
+| Test generation | GPT-5.1 Codex Max | 💛 Medium |
+
+---
+
+## Auto-Detection
+
+```
+/test
+
+[AUTO] Detecting test framework...
+  ✅ Found: Vitest + Playwright
+
+[AUTO] Running tests...
+  Unit: 45 tests
+  E2E: 12 tests
+
+═══════════ RESULTS ═══════════
+
+📊 Unit Tests:
+  ✅ Passed: 43
+  ❌ Failed: 2
+  
+📊 E2E Tests:
+  ✅ Passed: 12
+  ❌ Failed: 0
+
+📊 Coverage: 78%
+
+❌ Failed Tests:
+  1. auth.test.ts › should validate email
+  2. cart.test.ts › should calculate total
+
+👉 Fix failed tests? (ok/skip)
+```
+
+---
+
+## Flags
+
+| Flag | Mode |
+|------|------|
+| `--unit` | Unit tests only |
+| `--e2e` | E2E tests only |
+| `--coverage` | Include coverage |
+| `--watch` | Watch mode |
+| `--fix` | Auto-fix failures |
+
+---
+
+## Replaces
+
+```
+/test replaces:
+  • /test:unit
+  • /test:e2e
+  • /test:coverage
+
+Total: 4 commands → 1 command
+```
+
+---
+
+## Agent & Skill Activation
+
+### Mode-Based Agents
+
+| Mode | Primary Agent | Support Agents |
+|------|---------------|----------------|
+| Unit | `tester.md` | `debugger.md` |
+| E2E | `tester.md` | `ui-ux-designer.md` |
+| Coverage | `tester.md` | `code-reviewer.md` |
+
+### Auto-Activated Skills
+
+| Mode | Skills |
+|------|--------|
+| Unit | `debugging/`, `code-review/` |
+| E2E | `debugging/`, `chrome-devtools/`, `frontend-development/` |
+| Coverage | `debugging/`, `code-review/`, `problem-solving/` |
+---
+
+##  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/theme.md

@@ -0,0 +1,158 @@
+---
+description: ⚡⚡ Switch theme mode and customize color scheme
+argument-hint: [dark/light/system or color scheme]
+---
+
+# /theme - Theme Management
+
+**What:** Switch dark/light mode và customize color scheme.
+
+## Usage
+```
+/theme dark                    # Switch to dark mode
+/theme light                   # Switch to light mode
+/theme system                  # Follow system preference
+/theme --color purple          # Change color scheme
+```
+
+---
+
+## 💰 Model Selection
+
+| Action | Recommended Model | Cost |
+|--------|-------------------|------|
+| Theme switch | GPT-5.1 Codex Mini | 💚 Low |
+| Color scheme | GPT-5.1 Codex Mini | 💚 Low |
+
+> Simple CSS changes - always use cheap models.
+
+---
+
+## Workflow
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ 🎨 THEME MANAGEMENT                                         │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  Current Theme:                                             │
+│  ├── Mode: Dark 🌙                                          │
+│  ├── Primary: Indigo (#6366f1)                             │
+│  ├── Accent: Pink (#ec4899)                                │
+│  └── Radius: 0.5rem                                        │
+│                                                             │
+│  Options:                                                   │
+│  1. Switch mode (dark/light/system)                        │
+│  2. Change color scheme                                    │
+│  3. Custom CSS variables                                   │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Color Schemes
+
+```
+🎨 AVAILABLE SCHEMES
+
+| Name     | Primary  | Preview                    |
+|----------|----------|----------------------------|
+| Default  | Slate    | ███ Neutral, professional  |
+| Blue     | Blue     | ███ Corporate, trust       |
+| Purple   | Violet   | ███ Creative, modern       |
+| Green    | Emerald  | ███ Natural, calm          |
+| Orange   | Orange   | ███ Energetic, warm        |
+| Rose     | Rose     | ███ Elegant, feminine      |
+
+👉 Choose scheme: (1-6 or name)
+```
+
+---
+
+## Output
+
+```
+🎨 Theme Updated!
+
+Before → After:
+  Mode: Light → Dark 🌙
+  Primary: Blue → Purple
+  
+📂 Files Updated:
+  ✅ globals.css (CSS variables)
+  ✅ tailwind.config.ts (colors)
+  ✅ components.json (if shadcn)
+
+💡 Preview:
+  Run: npm run dev
+  Theme toggle: useTheme() hook available
+
+📌 Tip:
+  Add <ThemeProvider> to layout if not present
+```
+
+---
+
+## Theme Configuration
+
+```css
+/* What gets updated in globals.css */
+:root {
+  --background: 0 0% 100%;
+  --foreground: 222.2 84% 4.9%;
+  --primary: 262.1 83.3% 57.8%;
+  --accent: 330 81% 60%;
+  /* ... */
+}
+
+.dark {
+  --background: 222.2 84% 4.9%;
+  --foreground: 210 40% 98%;
+  --primary: 263.4 70% 50.4%;
+  /* ... */
+}
+```
+
+---
+
+## Agent & Skill Activation
+
+**Agents:**
+- `.cursor/agents/ui-ux-designer.md` - Color theory
+- `.cursor/agents/design-system-architect.md` - Theme tokens
+
+**Skills:**
+- `ui-styling/` - CSS patterns
+- `aesthetic/` - Color harmonies
+- `frontend-design/` - Design systems
+
+---
+
+## Configuration
+
+```yaml
+theme:
+  mode: dark        # dark, light, system
+  scheme: purple    # default, blue, purple, green, orange, rose
+  radius: 0.5rem
+  custom:
+    primary: "#6366f1"
+    accent: "#ec4899"
+```
+
+---
+
+##  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)