npm - anchi-toolkit - Versions diffs - 1.0.0 → 1.2.1 - Mend

anchi-toolkit 1.0.0 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1989) hide show

package/docs/FAQ.md DELETED Viewed

@@ -1,174 +0,0 @@
-# ❓ FAQ - Câu Hỏi Thường Gặp
----
-## 🔧 Commands & Cursor
-### Q: Commands không hoạt động?
-**A:**
-1. Kiểm tra đang dùng **Chat Panel** (`Ctrl+L`), không phải Terminal
-2. Restart Cursor
-3. Kiểm tra folder `.cursor/commands/` có files
-### Q: AI không hiểu context dự án?
-**A:** Tag files vào câu hỏi:
-```
-@.cursorrules @docs/PROJECT.md
-[Câu hỏi của bạn]
-```
-### Q: Command nào dùng trước?
-**A:** Workflow chuẩn:
-```
-/plan → /cook → /test → /review
-```
-### Q: Sự khác biệt /plan:fast và /plan:hard?
-**A:**
-- `/plan:fast` - Task đơn giản, nhanh
-- `/plan:hard` - Task phức tạp, cần phân tích kỹ
----
-## 📦 Presets
-### Q: Chọn preset nào?
-**A:**
-| Timeline | Team Size | Chọn |
-|----------|-----------|------|
-| < 2 tuần | 1-2 người | `rapid` |
-| 1-6 tháng | 3-10 người | `professional` |
-| > 6 tháng | 10+ người | `enterprise` |
-### Q: Có thể đổi preset giữa chừng?
-**A:** Có, xem `presets/MIGRATION_GUIDE.md`
-### Q: Setup script bị lỗi?
-**A:**
-1. Kiểm tra đã cài Node.js 18+
-2. Chạy với quyền admin (Windows) hoặc sudo (Linux)
-3. Xóa `node_modules/` và chạy lại
----
-## 🔀 Git & GitHub
-### Q: Branch naming?
-**A:**
-```
-feature/[name]   # New feature
-fix/[name]       # Bug fix
-hotfix/[name]    # Critical fix
-```
-### Q: Commit message format?
-**A:** Conventional Commits:
-```
-feat(scope): description
-fix(scope): description
-docs(scope): description
-```
-### Q: CI failed, làm gì?
-**A:**
-1. Check GitHub Actions logs
-2. Fix lỗi locally
-3. Push lại
-### Q: PR cần bao nhiêu approval?
-**A:** Tối thiểu 1 approval (configurable)
----
-## 🗄️ Database
-### Q: Làm sao reset database?
-**A:**
-```bash
-npx prisma db push --force-reset
-```
-### Q: Migration lỗi?
-**A:**
-```bash
-npx prisma migrate reset
-npx prisma generate
-```
-### Q: Rapid dùng SQLite, muốn đổi sang PostgreSQL?
-**A:**
-1. Update `DATABASE_URL` trong `.env`
-2. Chạy `npx prisma migrate dev`
----
-## 🎨 UI/Styling
-### Q: Thêm component shadcn/ui?
-**A:**
-```bash
-npx shadcn-ui@latest add [component-name]
-```
-### Q: Customize theme?
-**A:** Edit `tailwind.config.ts` và `globals.css`
----
-## 🧪 Testing
-### Q: Chạy tests?
-**A:**
-```bash
-npm test              # Unit tests
-npm run test:e2e      # E2E tests (nếu có)
-```
-### Q: Test coverage?
-**A:**
-```bash
-npm run test:coverage
-```
----
-## 🚀 Deployment
-### Q: Deploy lên Vercel?
-**A:**
-1. Connect GitHub repo
-2. Set environment variables
-3. Deploy
-### Q: Environment variables?
-**A:** Không commit `.env`, dùng `.env.example` làm template
----
-## 💡 Tips
-### Q: Làm sao code nhanh hơn?
-**A:**
-1. Luôn `/plan` trước khi code
-2. Dùng `/scout` khi chưa quen codebase
-3. Chia task nhỏ
-4. Commit thường xuyên
-### Q: AI response quá dài?
-**A:** Thêm vào prompt: "Trả lời ngắn gọn"
-### Q: Muốn AI follow style cụ thể?
-**A:** Cập nhật `.cursorrules` hoặc `docs/code-standards.md`
----
-## 🆘 Vẫn Stuck?
-1. Search trong `docs/`
-2. Hỏi trong team chat
-3. Hỏi Team Lead
----
-> 💡 Có câu hỏi mới? Thêm vào file này để giúp team!

package/docs/ONBOARDING.md DELETED Viewed

@@ -1,111 +0,0 @@
-# 📋 Onboarding Checklist
-Checklist cho member mới vào team. Đánh dấu `[x]` khi hoàn thành.
----
-## 🗓️ Day 1: Setup Environment
-### Software Installation
-- [ ] Node.js 18+ installed
-- [ ] Git installed
-- [ ] Cursor IDE installed
-- [ ] Đăng nhập Cursor (Google/GitHub)
-### Project Setup
-- [ ] Cài anchi-toolkit: `npx anchi-toolkit init` (chọn profile phù hợp)
-- [ ] Mở project: `cursor .`
-- [ ] Chạy `/start` và chọn option
-- [ ] Chọn preset: `/use-preset [name]`
-### Verification
-- [ ] Chạy `npm run dev` thành công
-- [ ] Truy cập localhost:3000
----
-## 📖 Day 1: Read Documentation
-### Required Reading
-- [ ] `.cursorrules` - Biết preset và conventions
-- [ ] `docs/PROJECT.md` - Hiểu dự án
-- [ ] `docs/WORKFLOW.md` - Workflow chuẩn
-- [ ] `BEGINNER_GUIDE_VI.md` - Hướng dẫn sử dụng
-### Optional Reading
-- [ ] `docs/code-standards.md` - Chi tiết coding standards
-- [ ] `docs/system-architecture.md` - Kiến trúc hệ thống
-- [ ] `docs/WORKFLOW.md` - Git workflow (đã merged)
----
-## 🔧 Day 1: Practice Commands
-### Essential Commands
-- [ ] Thử `/scout "Tổng quan project"`
-- [ ] Thử `/plan "Simple test task"`
-- [ ] Thử `/cook "Phase 1"` (cancel nếu không cần)
-### Verify Understanding
-- [ ] Biết cách mở Chat Panel (`Ctrl+L`)
-- [ ] Biết cách tag files (`@filename`)
-- [ ] Biết phím tắt cơ bản
----
-## ✅ Day 1: First Task
-### Complete First Task
-- [ ] Nhận task từ Team Lead
-- [ ] `/plan "task description"`
-- [ ] Review plan
-- [ ] `/cook "phase 1"`
-- [ ] `/test` hoặc manual test
-- [ ] `/review`
-- [ ] Git commit và push
-- [ ] Create Pull Request
----
-## 📝 Day 2-3: Deep Dive
-### Codebase Understanding
-- [ ] Dùng `/scout` để tìm hiểu modules chính
-- [ ] Đọc `docs/CODEBASE.md`
-- [ ] Hiểu folder structure
-### Team Integration
-- [ ] Join team channels (Slack/Discord)
-- [ ] Attend standup meetings
-- [ ] Ask questions khi stuck
----
-## 🎯 Week 1: Milestones
-- [ ] Hoàn thành 3+ tasks
-- [ ] Có ít nhất 1 PR merged
-- [ ] Comfortable với workflow
-- [ ] Có thể giúp đỡ member mới khác
----
-## 📞 Contacts
-| Role | Person | Contact |
-|------|--------|---------|
-| Team Lead | [Name] | [Email/Slack] |
-| Tech Lead | [Name] | [Email/Slack] |
-| Buddy | [Name] | [Email/Slack] |
----
-## 🆘 Stuck?
-1. Xem `docs/FAQ.md`
-2. Hỏi trong Chat Panel: `@.cursorrules explain this project`
-3. Hỏi Team Lead/Buddy
----
-> ✅ Khi hoàn thành tất cả, báo Team Lead để nhận badge "Onboarded"!

package/docs/ORCHESTRATION_RUNTIME.md DELETED Viewed

@@ -1,173 +0,0 @@
-# Dynamic Orchestration Runtime
-> **Quy trình AI tự động điều phối agents/skills khi thực thi command**
----
-## 🔄 Execution Flow
-```
-┌─────────────────────────────────────────────────────────────┐
-│ USER INPUT: /do "Add payment with Stripe"                   │
-└─────────────────────────────────────────────────────────────┘
-                           ↓
-┌─────────────────────────────────────────────────────────────┐
-│ STEP 1: LOAD ORCHESTRATION CONFIG                           │
-│                                                             │
-│   Read: .cursor/agent-skill-index.yaml                      │
-│   Read: .cursor/orchestration.yaml                          │
-│   Read: .cursor/failure-modes.yaml                          │
-└─────────────────────────────────────────────────────────────┘
-                           ↓
-┌─────────────────────────────────────────────────────────────┐
-│ STEP 2: ANALYZE USER REQUEST                                │
-│                                                             │
-│   Keywords detected: ["payment", "stripe"]                  │
-│   Files affected: [*.ts, prisma/schema.prisma]              │
-│   Complexity: medium                                        │
-└─────────────────────────────────────────────────────────────┘
-                           ↓
-┌─────────────────────────────────────────────────────────────┐
-│ STEP 3: DYNAMIC AGENT SELECTION                             │
-│                                                             │
-│   Check command_mapping:                                     │
-│   ├── /do → default: fullstack-developer                   │
-│   └── conditionals: none matched                             │
-│                                                             │
-│   Check agent boundaries:                                    │
-│   └── fullstack-developer.boundaries:                        │
-│       └── NOT: security_audit → security-auditor            │
-│                                                             │
-│   Result:                                                   │
-│   ├── PRIMARY: fullstack-developer (confidence: 0.85)       │
-│   └── SECONDARY: security-auditor (payment = sensitive)     │
-└─────────────────────────────────────────────────────────────┘
-                           ↓
-┌─────────────────────────────────────────────────────────────┐
-│ STEP 4: DYNAMIC SKILL ACTIVATION                            │
-│                                                             │
-│   Scan skills.activation rules:                              │
-│                                                             │
-│   payment-integration:                                       │
-│   ├── keyword: ["payment", "stripe"] → MATCH ✓              │
-│   ├── package: ["stripe"] → CHECK package.json              │
-│   └── requires_security_review: true → FLAG                 │
-│                                                             │
-│   databases:                                                 │
-│   └── file: prisma/schema.prisma → MATCH ✓                  │
-│                                                             │
-│   better-auth:                                               │
-│   └── keyword: ["auth", "login"] → NO MATCH                 │
-│                                                             │
-│   Activated: [payment-integration, databases]               │
-└─────────────────────────────────────────────────────────────┘
-                           ↓
-┌─────────────────────────────────────────────────────────────┐
-│ STEP 5: CHECK FAILURE MODES                                 │
-│                                                             │
-│   low_confidence:                                            │
-│   └── confidence 0.85 > 0.5 → OK                            │
-│                                                             │
-│   security_concern:                                          │
-│   └── payment = sensitive → ESCALATE to security-auditor    │
-│                                                             │
-│   architecture_violation:                                    │
-│   └── Check preset contract → OK                            │
-└─────────────────────────────────────────────────────────────┘
-                           ↓
-┌─────────────────────────────────────────────────────────────┐
-│ STEP 6: DETERMINE RISK LEVEL                                │
-│                                                             │
-│   Check orchestration.yaml risk_levels:                      │
-│   ├── keywords: ["payment"] → HIGH risk                     │
-│   └── chain: security_chain                                  │
-│                                                             │
-│   Required:                                                 │
-│   ├── auto_approve: false                                    │
-│   ├── require_review: true                                   │
-│   └── require_lead_approval: true                            │
-└─────────────────────────────────────────────────────────────┘
-                           ↓
-┌─────────────────────────────────────────────────────────────┐
-│ STEP 7: BUILD EXECUTION CHAIN                               │
-│                                                             │
-│   Chain: security_chain                                      │
-│   [1] planner → Create plan                                 │
-│   [2] fullstack-developer → Implement                       │
-│   [3] security-auditor → Security review                    │
-│   [4] code-reviewer → Final review                          │
-└─────────────────────────────────────────────────────────────┘
-                           ↓
-┌─────────────────────────────────────────────────────────────┐
-│ STEP 8: LOG TO AUDIT                                         │
-│                                                             │
-│   Write to .ai-audit/YYYY-MM-DD.jsonl:                       │
-│   {                                                         │
-│     "command": "/do 'Add payment'",                         │
-│     "agents": ["fullstack-developer", "security-auditor"],  │
-│     "skills": ["payment-integration", "databases"],         │
-│     "risk_level": "high",                                    │
-│     "chain": "security_chain"                                │
-│   }                                                         │
-└─────────────────────────────────────────────────────────────┘
-                           ↓
-┌─────────────────────────────────────────────────────────────┐
-│ STEP 9: EXECUTE WITH ORCHESTRATION                          │
-│                                                             │
-│   Apply agents, skills, and chain to implementation         │
-└─────────────────────────────────────────────────────────────┘
-```
----
-## 📋 Quy Tắc Điều Phối
-### Rule 1: Agent Selection Priority
-```
-1. Check command_mapping.conditionals
-2. If no match → Use command_mapping.default
-3. Check agent.boundaries for escalation
-4. Check skill.requires_security_review
-```
-### Rule 2: Skill Activation
-```
-FOR EACH skill IN agent-skill-index.yaml:
-  IF skill.activation.keyword MATCHES request:
-    ACTIVATE skill
-  IF skill.activation.file_pattern MATCHES affected_files:
-    ACTIVATE skill
-  IF skill.activation.package EXISTS IN package.json:
-    ACTIVATE skill
-```
-### Rule 3: Risk Assessment
-```
-Scan request for risk_levels keywords:
-  low: ["typo", "rename", "format"]
-  medium: ["feature", "component", "api"]
-  high: ["payment", "auth", "admin"]
-  critical: ["delete", "drop", "production"]
-Apply corresponding chain and approvals.
-```
-### Rule 4: Failure Mode Check
-```
-BEFORE execution:
-  IF confidence < 0.5 → ASK user
-  IF security_concern → ESCALATE
-  IF architecture_violation → STOP
-  IF outside_expertise → ESCALATE to appropriate agent
-```
----
-## 🔗 Config Files
-| File | Purpose |
-|------|---------|
-| `.cursor/agent-skill-index.yaml` | Agent capabilities, skill activation |
-| `.cursor/orchestration.yaml` | Chains, risk levels, escalation |
-| `.cursor/failure-modes.yaml` | Stop conditions, restraints |
-| `.ai-audit/` | Audit logs |

package/docs/WALKTHROUGH.md DELETED Viewed

@@ -1,192 +0,0 @@
-# User Walkthrough: E-commerce Shop trong 5 Ngày
-> Mô phỏng hành trình user mới sử dụng anchi-toolkit từ đầu đến deploy
----
-## 📋 Profile
-| | |
-|---|---|
-| **User** | Minh (Junior Developer, 1 năm kinh nghiệm) |
-| **Goal** | Tạo website bán hàng online |
-| **Preset** | Rapid MVP |
-| **Platform** | Cursor AI |
----
-## 🗓️ Day 1: Setup & First Feature
-### 1.1 Cài Đặt (2 phút)
-```bash
-mkdir my-shop && cd my-shop
-npx anchi-toolkit install
-```
-Output:
-```
-✅ .cursor/commands/ - 18 commands
-✅ .cursor/agents/ - 19 agents
-✅ .cursor/skills/ - 35 skills
-✅ presets/ - 3 architecture presets
-```
-### 1.2 Khởi Tạo
-```
-/start
-→ Chọn 2 (Dự án mới)
-→ Chọn 1 (Rapid MVP)
-```
-AI tự động:
-- Tạo Next.js project
-- Setup Prisma + SQLite
-- Lưu context vào `.ai-memory/`
-### 1.3 Homepage
-```
-/do "Add homepage with hero section and featured products"
-```
-AI:
-- Phân tích → fullstack-developer (0.9)
-- Plan → 4 files
-- Implement → 3-5 phút
-- Assessment → confidence: 0.92, risk: low
-**Files created:** `page.tsx`, `Hero.tsx`, `ProductCard.tsx`, `products.ts`
----
-## 🛒 Day 2: Shopping Cart
-```
-/do "Add shopping cart with add/remove functionality"
-```
-AI:
-- Agent: fullstack-developer
-- Skills: frontend-development, databases
-- Risk: medium (state management)
-**Files created:**
-- `CartContext.tsx`
-- `CartProvider.tsx`
-- `CartButton.tsx`
-- `CartSidebar.tsx`
----
-## 🔒 Day 3: Authentication
-```
-/do "Add user login with email and password"
-```
-AI:
-```
-⚠️ Security-Related Feature Detected
-→ Auto-enabling code review
-📜 Rules Applied:
-├── Contract P2: Using service layer
-├── Contract S1: No direct DB in routes
-└── Risk Rule: Code review enabled
-```
-**Files created:**
-- `AuthService.ts`
-- `auth/route.ts`
-- `LoginForm.tsx`
-- `session.ts`
----
-## ❓ Day 4: Understand AI Decisions
-```
-/why
-```
-Output:
-```
-🤖 AGENT SELECTION:
-├── PRIMARY: fullstack-developer
-│   └── WHY: Auth involves frontend + backend
-├── SECONDARY: database-admin
-│   └── WHY: User table schema changes
-📚 SKILL ACTIVATION:
-├── ✅ better-auth/ (keyword: "login")
-├── ✅ databases/ (schema modification)
-└── ❌ payment-integration/ (no payment keywords)
-📜 RULES APPLIED:
-├── P2: "Use service layer" → AuthService
-└── Risk: "Auth = sensitive" → Enabled review
-```
----
-## ✅ Day 5: Commit & Deploy
-```
-/commit
-```
-AI:
-```
-📝 Suggested commit message:
-feat: add e-commerce shop with cart and auth
-- Add homepage with hero and product grid
-- Add shopping cart with add/remove
-- Add user authentication
-```
-```
-/review --security
-```
-AI reviews auth implementation → ✅ Passed
----
-## 📊 Summary
-| Metric | Value |
-|--------|-------|
-| Commands used | 7 |
-| Files created | 15+ |
-| Features built | Homepage, Cart, Auth |
-| Code written by hand | ~0 lines |
-| Time spent | ~5 hours total |
-| Reviews triggered | 1 (auto for auth) |
----
-## 🎓 Key Takeaways
-1. **Describe, don't code** - Mô tả muốn gì, AI implement
-2. **AI tự biết giới hạn** - Khi auth, tự enable review
-3. **Explainable** - `/why` giải thích mọi quyết định
-4. **Progressive** - Từ simple → complex tự nhiên
-5. **Safe by default** - Security features auto-protected
----
-## 💬 User Feedback
-> *"Mình chỉ cần mô tả muốn gì, AI tự plan, tự implement, tự biết khi nào cần review. Mình chỉ cần approve và test. Quá tiện!"*
----
-## 🔗 Related
-- [BEGINNER_GUIDE_VI.md](../BEGINNER_GUIDE_VI.md)
-- [QUICK_REFERENCE.md](../QUICK_REFERENCE.md)
-- [docs/ORCHESTRATION.md](./ORCHESTRATION.md)