anchi-toolkit 1.2.0 → 1.2.1

package/dist/.antigravity/workflows/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/.antigravity/workflows/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:**
+- `.antigravity/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 .antigravity/agent-skill-index.yaml
+2. CHECK command_mapping for this command
+3. APPLY skill activation rules
+4. CHECK .antigravity/failure-modes.yaml
+5. LOG decision to .ai-audit/
+```
+
+ [docs/ORCHESTRATION_RUNTIME.md](../docs/ORCHESTRATION_RUNTIME.md)

package/dist/.cursor/MODEL_COSTS.md

@@ -0,0 +1,61 @@
+# 💰 Model Cost Guide
+
+## Model Tiers (Chi phí tăng dần)
+
+| Tier | Models | Cost | Khi dùng |
+|------|--------|------|----------|
+| 🟢 **Economy** | Auto, GPT-5.1 Codex Mini | Free/$ | Mặc định cho mọi task |
+| 🟡 **Standard** | Sonnet 4.5, Gemini 3 Flash, GPT-5.2 | $$ | Tasks phức tạp hơn |
+| 🔴 **Premium** | Opus 4.5, GPT-5.1 Codex Max, MAX Mode | $$$ | Chỉ khi thật sự cần |
+
+---
+
+## Command → Model Mapping
+
+| Command | Default 🟢 | Escalate 🟡 | Premium 🔴 |
+|---------|-----------|-------------|------------|
+| `/plan:fast` | Auto | - | - |
+| `/plan` | Auto | Sonnet 4.5 | Opus 4.5 (architecture) |
+| `/cook` | Auto | Sonnet 4.5 | - |
+| `/fix:fast` | Auto | - | - |
+| `/fix` | Auto | Sonnet 4.5 | Opus 4.5 (stuck) |
+| `/scout` | Gemini 3 Flash | Gemini 2.5 Flash | - |
+| `/generate` | GPT-5.1 Codex Mini | - | - |
+| `/review` | Auto | Sonnet 4.5 | Opus 4.5 (critical) |
+| `/design-ui` | Auto | GPT-5.2 | - |
+| `/start` | Auto | Gemini 3 Flash | - |
+
+---
+
+## Khi nào Escalate?
+
+### Auto → Sonnet 4.5
+- Output không đủ chi tiết
+- Cần giải thích sâu hơn
+- Logic phức tạp
+
+### Sonnet 4.5 → Opus 4.5
+- Architecture decisions
+- Critical bugs không fix được
+- Code review cho production
+
+### Gemini 3 Flash
+- Large codebase scanning
+- Research nhiều files
+
+---
+
+## Quick Reference
+
+```
+Task đơn giản     → Auto 🟢
+Task coding       → Auto 🟢 (upgrade Sonnet nếu cần)
+Task phức tạp     → Sonnet 4.5 🟡
+Task quan trọng   → Opus 4.5 🔴
+Scan codebase     → Gemini 3 Flash 🟡
+UI creative       → GPT-5.2 🟡
+```
+
+---
+
+> ⚠️ **Nguyên tắc:** Luôn bắt đầu với model rẻ nhất. Chỉ upgrade khi kết quả không đạt yêu cầu.

package/dist/.cursor/UX_GUIDELINES.md

@@ -0,0 +1,146 @@
+# 💬 UX Guidelines for anchi-kit
+
+> Hướng dẫn tương tác với user để AI thân thiện và dễ sử dụng hơn.
+
+---
+
+## 1. Welcome Messages
+
+Mỗi command nên bắt đầu với greeting ngắn gọn:
+
+```markdown
+👋 /[command] đang chạy!
+[Mô tả ngắn về command sẽ làm gì]
+```
+
+**Ví dụ:**
+```markdown
+👋 /plan đang chạy!
+Tôi sẽ tạo kế hoạch chi tiết cho feature của bạn.
+```
+
+---
+
+## 2. Progress Indicators
+
+Khi thực hiện nhiều bước, show progress:
+
+```markdown
+📊 Đang thực hiện...
+
+[1/4] 🔍 Phân tích yêu cầu...
+[2/4] 📚 Đọc codebase liên quan...
+[3/4] 📝 Tạo kế hoạch...
+[4/4] ✅ Hoàn tất!
+```
+
+---
+
+## 3. Interactive Confirmations
+
+Thay vì `[Y/n]`, dùng format rõ ràng:
+
+```markdown
+📋 **Tóm tắt thay đổi:**
+• Tạo: `user.service.ts`
+• Sửa: `api/users/route.ts`
+• Thêm: 2 types
+
+👉 **Tiếp tục?**
+- Gõ `ok` hoặc `y` để thực hiện
+- Gõ feedback để tôi điều chỉnh
+```
+
+---
+
+## 4. Friendly Error Messages
+
+```markdown
+❌ **Lỗi:** [Mô tả ngắn]
+
+💡 **Gợi ý:**
+• [Cách fix 1]
+• [Cách fix 2]
+
+📌 **Thử lại:** [Command gợi ý]
+```
+
+---
+
+## 5. Quick Actions Menu
+
+Sau mỗi command, suggest next steps:
+
+```markdown
+✅ **Xong!**
+
+📌 **Tiếp theo:**
+• `/cook "Phase 1"` - Bắt đầu implement
+• `/review` - Review trước khi làm
+• Feedback - Để tôi điều chỉnh
+```
+
+---
+
+## 6. Session Summary Cards
+
+Cuối session quan trọng, show summary:
+
+```markdown
+┌─────────────────────────────────────┐
+│ 📊 SUMMARY                          │
+├─────────────────────────────────────┤
+│ ✅ Created: X files                 │
+│ 📝 Modified: Y files                │
+│ 🧪 Tests: Passed                    │
+├─────────────────────────────────────┤
+│ 📌 Next: /cook "Phase 2"            │
+└─────────────────────────────────────┘
+```
+
+---
+
+## Tone Guidelines
+
+| ❌ Tránh | ✅ Nên dùng |
+|---------|------------|
+| Formal, dài dòng | Ngắn gọn, thân thiện |
+| Technical jargon | Giải thích đơn giản |
+| Y/n | ok/feedback |
+| Error occurred | ❌ Lỗi: [chi tiết] |
+
+---
+
+## Emoji Usage
+
+| Emoji | Ý nghĩa |
+|-------|---------|
+| 👋 | Welcome |
+| 📊 | Progress/Summary |
+| ✅ | Success/Done |
+| ❌ | Error |
+| 💡 | Tip/Suggestion |
+| 📌 | Next steps |
+| ⚠️ | Warning |
+| 🔍 | Analyzing |
+| 📝 | Writing/Creating |
+
+---
+
+## Command Rating Legend
+
+Commands có rating ⚡ để indicate độ phức tạp/thời gian:
+
+| Rating | Meaning | Time |
+|--------|---------|------|
+| ⚡ | Basic | 1-2 min |
+| ⚡⚡ | Standard | 2-5 min |
+| ⚡⚡⚡ | Advanced | 5-15 min |
+| ⚡⚡⚡⚡ | Full workflow | 15-30 min |
+| ⚡⚡⚡⚡⚡ | Complete auto | 30+ min |
+
+**Ví dụ:**
+- `/fix:fast` ⚡ = Quick fix, 1-2 min
+- `/plan` ⚡⚡⚡ = Detailed planning, 5-15 min
+- `/auto:rapid` ⚡⚡⚡⚡⚡ = Full auto workflow, 5-15 min
+