anchi-toolkit 1.0.0 → 1.2.1

package/dist/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)

package/dist/commands/undo.md

@@ -0,0 +1,166 @@
+---
+description: ⚡⚡ Rollback last workflow or specific changes
+argument-hint: [optional: steps to undo or commit hash]
+---
+
+# /undo - Rollback Changes
+
+**What:** Rollback last workflow hoặc specific changes.
+
+## Usage
+```
+/undo                      # Undo last action
+/undo 3                    # Undo last 3 steps
+/undo "abc1234"            # Undo to specific commit
+/undo --list               # Show undo history
+```
+
+---
+
+## 💰 Model Selection
+
+| Action | Recommended Model | Cost |
+|--------|-------------------|------|
+| Simple undo | GPT-5.1 Codex Mini | 💚 Low |
+| Complex rollback | Sonnet 4.5 | 💛 Medium |
+
+> Undo operations primarily use git - minimal AI needed.
+
+---
+
+## Workflow
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ ↩️ UNDO WORKFLOW                                            │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  Step 1: ANALYZE                                            │
+│  [AUTO] Identify last workflow/changes                      │
+│                                                             │
+│  Step 2: SHOW                                               │
+│  Display: What will be undone                               │
+│                                                             │
+│  Step 3: CONFIRM                                            │
+│  User: Confirm or select specific items                     │
+│                                                             │
+│  Step 4: EXECUTE                                            │
+│  [AUTO] Rollback changes                                    │
+│  [AUTO] Update memory                                       │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Output
+
+```
+↩️ Undo Available Actions
+
+╔═════════════════════════════════════════════════════════════╗
+║ # │ Time     │ Action            │ Files Changed            ║
+╠═════════════════════════════════════════════════════════════╣
+║ 1 │ 2 min    │ /do LoginForm     │ 3 files                  ║
+║ 2 │ 10 min   │ /generate --api   │ 2 files                  ║
+║ 3 │ 15 min   │ /theme dark       │ 2 files                  ║
+║ 4 │ 30 min   │ /do "feature"     │ 8 files                  ║
+╚═════════════════════════════════════════════════════════════╝
+
+📋 Latest Action Details (#1):
+  Command: /do "Add LoginForm"
+  Time: 2 minutes ago
+  
+  Files to restore:
+  ├── components/LoginForm.tsx (delete)
+  ├── app/login/page.tsx (revert)
+  └── lib/auth.ts (revert)
+
+⚠️ This will:
+  • Delete 1 new file
+  • Revert 2 files to previous state
+  • Remove 1 commit
+
+👉 Undo this action? (ok/select #/cancel)
+```
+
+---
+
+## Undo Options
+
+```
+/undo               # Undo last action (confirmed)
+/undo --force       # Undo without confirmation
+/undo --soft        # Keep files, just update memory
+/undo --list        # Show all undo options
+/undo --all         # Undo entire session
+```
+
+---
+
+## Safety Features
+
+| Feature | Description |
+|---------|-------------|
+| **Backup** | Auto-backup before undo |
+| **Selective** | Choose specific items |
+| **Preview** | See what will change |
+| **Memory Sync** | Update AI memory |
+
+---
+
+## Undo History
+
+```
+/undo --list
+
+📜 UNDO HISTORY (Last 24h)
+
+| # | Command | Files | Commit | Undoable |
+|---|---------|-------|--------|----------|
+| 1 | /cook LoginForm | 3 | abc123 | ✅ |
+| 2 | /generate:api | 2 | def456 | ✅ |
+| 3 | /theme dark | 2 | - | ✅ |
+| 4 | /auto:rapid | 8 | ghi789 | ✅ |
+| 5 | /fix:types | 1 | jkl012 | ✅ |
+
+💡 Tip: /undo 4 to undo back to step 4
+```
+
+---
+
+## Agent & Skill Activation
+
+**Agents:**
+- `.cursor/agents/git-manager.md` - Git operations
+
+**Skills:**
+- `devops/` - Version control
+
+---
+
+## Configuration
+
+```yaml
+undo:
+  max_history: 50
+  auto_backup: true
+  backup_dir: .undo/
+  confirm_before: true
+```
+
+---
+
+##  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/dist/commands/why.md

@@ -0,0 +1,155 @@
+---
+description: ⚡⚡ Explain AI decisions and reasoning
+argument-hint: [optional: --last | --command <name>]
+---
+
+# /why - AI Decision Explainability
+
+**What:** Giải thích vì sao AI chọn agent, skill, và rules cho quyết định.
+
+## Usage
+```
+/why                    # Explain last decision
+/why --last 3           # Explain last 3 decisions
+/why --command "/do"    # Explain specific command type
+```
+
+---
+
+## 💰 Model Selection
+
+| Action | Recommended Model | Cost |
+|--------|-------------------|------|
+| Explain decision | GPT-5.1 Codex Mini | 💚 Low |
+
+---
+
+## Output
+
+```
+/why
+
+═══════════ DECISION EXPLANATION ═══════════
+
+📋 Last Command: /do "Add user authentication"
+
+🤖 AGENT SELECTION:
+
+   ┌─────────────────────────────────────────────────────────────┐
+   │ PRIMARY: fullstack-developer                                │
+   │ ├── WHY: Task involves both frontend (login page) +        │
+   │ │        backend (API routes, session handling)            │
+   │ └── Confidence: 0.85                                       │
+   ├─────────────────────────────────────────────────────────────┤
+   │ SECONDARY: database-admin                                   │
+   │ ├── WHY: User table schema changes detected                │
+   │ └── Auto-escalated for: schema modification                │
+   ├─────────────────────────────────────────────────────────────┤
+   │ NOT SELECTED: security-auditor                              │
+   │ ├── WHY: Basic auth flow, no payment/sensitive data        │
+   │ └── Would activate if: payment, admin access, API keys     │
+   └─────────────────────────────────────────────────────────────┘
+
+📚 SKILL ACTIVATION:
+
+   ┌─────────────────────────────────────────────────────────────┐
+   │ ✅ ACTIVATED:                                               │
+   │ ├── better-auth/                                            │
+   │ │   └── Trigger: Detected "next-auth" in package.json     │
+   │ ├── databases/                                              │
+   │ │   └── Trigger: prisma/schema.prisma modification needed  │
+   │ └── frontend-development/                                   │
+   │     └── Trigger: Creating login page component             │
+   ├─────────────────────────────────────────────────────────────┤
+   │ ❌ NOT ACTIVATED:                                           │
+   │ ├── payment-integration/                                    │
+   │ │   └── WHY: No payment keywords detected                  │
+   │ └── shopify/                                                │
+   │     └── WHY: Not an e-commerce context                     │
+   └─────────────────────────────────────────────────────────────┘
+
+📜 RULES APPLIED:
+
+   ┌─────────────────────────────────────────────────────────────┐
+   │ CONTRACT RULES:                                             │
+   │ ├── P2: "Use service layer"                                │
+   │ │   └── Applied: Created AuthService                       │
+   │ ├── S1: "No direct DB in routes"                           │
+   │ │   └── Applied: Used UserRepository                       │
+   │ └── C1: "Match existing patterns"                          │
+   │     └── Applied: Followed project's naming conventions     │
+   ├─────────────────────────────────────────────────────────────┤
+   │ PRESET RULES (Professional):                                │
+   │ ├── "Modular structure required" → Created auth module     │
+   │ └── "Tests required" → Added auth.test.ts                  │
+   └─────────────────────────────────────────────────────────────┘
+
+📊 RISK ASSESSMENT:
+
+   ┌─────────────────────────────────────────────────────────────┐
+   │ Risk Level: MEDIUM                                          │
+   │ ├── Factors:                                                │
+   │ │   ├── + Authentication = sensitive                       │
+   │ │   ├── - Using established library (next-auth)            │
+   │ │   └── - Following project patterns                       │
+   │ ├── Confidence: 0.85                                        │
+   │ └── Actions Taken:                                          │
+   │     └── Auto-enabled code review                           │
+   └─────────────────────────────────────────────────────────────┘
+
+💡 ALTERNATIVE APPROACHES CONSIDERED:
+
+   1. JWT tokens → Rejected (project uses session-based)
+   2. Custom auth → Rejected (next-auth already configured)
+   3. OAuth only → Rejected (user requested email/password)
+```
+
+---
+
+## Flags
+
+| Flag | Description |
+|------|-------------|
+| `--last N` | Explain last N decisions |
+| `--command <name>` | Filter by command type |
+| `--detailed` | Show full decision tree |
+| `--quiet` | Summary only |
+
+---
+
+## Use Cases
+
+| Scenario | Command |
+|----------|---------|
+| Debug AI decision | `/why` |
+| Onboard new team member | `/why --last 5` |
+| Audit AI behavior | `/why --command "/do"` |
+| Understand skill selection | `/why --detailed` |
+
+---
+
+## Agent & Skill Activation
+
+**Primary Agents:**
+- `.cursor/agents/docs-manager.md` - Explanation generation
+
+**Skills:**
+- `document-skills/` - Clear communication
+
+> /why reads from audit logs and orchestration config.
+
+---
+
+##  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/dist/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/dist/docs/ALL_COMMANDS.md

@@ -0,0 +1,52 @@
+# 📖 anchi-toolkit Command Reference (v1.1.0)
+
+> **Philosophy:** "Less but Quality" - 3 Main Commands rule them all.
+
+---
+
+## 💎 The Core Trinity (User Interface)
+
+These are the ONLY commands you need to memorize:
+
+| Command    | Function             | Internal Agent          |
+| ---------- | -------------------- | ----------------------- |
+| **/start** | Init/Resume Project  | `Planner` + `Memory`    |
+| **/do**    | **Execute Anything** | `Dynamic Orchestration` |
+| **/clean** | Maintenance          | `System Cleaner`        |
+
+---
+
+## ⚡ Power User Utilities
+
+For specific needs:
+
+| Command          | Function                 |
+| ---------------- | ------------------------ |
+| **/demo**        | Auto-preview (One-Click) |
+| **/skill-learn** | Teach AI new tech        |
+
+---
+
+## 🧩 Internal Capabilities (Subsumed by `/do`)
+
+The following concepts are now handled **automatically** by `/do`. You don't need to call them, but `/do` will use them:
+
+| Capability  | How to trigger                           |
+| ----------- | ---------------------------------------- |
+| **Testing** | `/do "Run tests"` or `--careful` flag    |
+| **Commit**  | `/do` auto-commits (if config enabled)   |
+| **Design**  | `/do "Design API for..."`                |
+| **Review**  | `/do "Review this file"`                 |
+| **Scout**   | `/do` automatically scouts before acting |
+
+---
+
+## 🗑️ Legacy Commands (Deprecated)
+
+Do not use these directly anymore:
+
+- `/plan`, `/cook`, `/fix` (Use `/do`)
+- `/auto:*` (Use `/do`)
+- `/git:*` (Use `/do`)
+
+---