anchi-toolkit 1.0.0 → 1.2.0

package/docs/CODEBASE.md

@@ -1,178 +0,0 @@
-# Codebase Summary - Technical Details
-
-> 💻 **Purpose:** TECHNICAL document - HOW the code is structured
-> 
-> **For planning/requirements:** See [PROJECT.md](./PROJECT.md)
-
----
-
-## 📊 Quick Stats
-
-| Metric | Value |
-|--------|-------|
-| **Total Files** | [X] |
-| **Components** | [X] |
-| **API Routes** | [X] |
-| **DB Models** | [X] |
-| **Last Updated** | [DD/MM/YYYY] |
-
----
-
-## 📦 Tech Stack
-
-### Frontend
-
-| Technology | Version | Purpose |
-|------------|---------|---------|
-| Next.js | 14.x | Framework |
-| TypeScript | 5.x | Language |
-| TailwindCSS | 3.x | Styling |
-| shadcn/ui | - | UI Components |
-
-### Backend
-
-| Technology | Version | Purpose |
-|------------|---------|---------|
-| Next.js API | 14.x | API Routes |
-| Prisma | 5.x | ORM |
-| Zod | 3.x | Validation |
-
-### Database
-
-| Type | Technology |
-|------|------------|
-| Primary | [PostgreSQL/SQLite] |
-| Cache | [Redis] (optional) |
-
----
-
-## 📂 Project Structure
-
-```
-src/
-├── app/                    # Next.js App Router
-│   ├── (public)/           # Public routes
-│   ├── (auth)/             # Auth routes
-│   └── api/                # API routes
-├── components/
-│   ├── ui/                 # Base UI components
-│   └── features/           # Feature components
-├── lib/                    # Utilities
-├── modules/                # Feature modules
-├── hooks/                  # Custom hooks
-└── types/                  # TypeScript types
-```
-
----
-
-## 🔧 Core Modules
-
-### [Module 1: Authentication]
-
-**Path:** `src/modules/auth/` or `src/lib/auth/`
-
-| File | Purpose |
-|------|---------|
-| `auth.ts` | Auth config |
-| `providers.ts` | OAuth providers |
-
-### [Module 2: ...]
-
-**Path:** `src/modules/[name]/`
-
-| File | Purpose |
-|------|---------|
-| ... | ... |
-
----
-
-## 🗄️ Database Models
-
-| Model | Key Fields | Relations |
-|-------|------------|-----------|
-| User | id, email, name | Account, Session |
-| [Model] | [fields] | [relations] |
-
-**Schema:** `prisma/schema.prisma`
-
----
-
-## 🔌 API Endpoints
-
-### Auth
-
-| Method | Endpoint | Description |
-|--------|----------|-------------|
-| POST | `/api/auth/login` | User login |
-| POST | `/api/auth/register` | User register |
-
-### [Resource]
-
-| Method | Endpoint | Description |
-|--------|----------|-------------|
-| GET | `/api/[resource]` | List all |
-| POST | `/api/[resource]` | Create |
-| PUT | `/api/[resource]/:id` | Update |
-| DELETE | `/api/[resource]/:id` | Delete |
-
----
-
-## 🪝 Custom Hooks
-
-| Hook | Path | Purpose |
-|------|------|---------|
-| `useAuth` | `src/hooks/useAuth.ts` | Auth state |
-| `useDebounce` | `src/hooks/useDebounce.ts` | Input debounce |
-
----
-
-## 🛠️ Utilities
-
-| Utility | Path | Purpose |
-|---------|------|---------|
-| `cn` | `src/lib/utils.ts` | Tailwind class merge |
-| `fetcher` | `src/lib/fetcher.ts` | API fetcher |
-
----
-
-## ⚙️ Configuration Files
-
-| File | Purpose |
-|------|---------|
-| `.env` | Environment variables |
-| `next.config.js` | Next.js config |
-| `tailwind.config.js` | Tailwind config |
-| `prisma/schema.prisma` | DB schema |
-
----
-
-## 📦 Key Dependencies
-
-| Package | Version | Purpose |
-|---------|---------|---------|
-| next | 14.x | Framework |
-| prisma | 5.x | ORM |
-| zod | 3.x | Validation |
-| react-hook-form | 7.x | Forms |
-
-Run `npm list --depth=0` for full list.
-
----
-
-## 🐛 Known Issues / Tech Debt
-
-| Issue | Location | Priority |
-|-------|----------|----------|
-| [Issue] | [path] | High/Med/Low |
-
----
-
-## 📝 Recent Code Changes
-
-| Date | Change | Files |
-|------|--------|-------|
-| [Date] | [Description] | [files] |
-
----
-
-> 💡 **Note:** File này focus vào TECHNICAL. Xem [PROJECT.md](./PROJECT.md) cho planning/requirements.

package/docs/COMMAND_MAPPING.md

@@ -1,217 +0,0 @@
-# Command → Agent/Skill Mapping
-
-> Ánh xạ các commands với agents và skills tương ứng
-
----
-
-## 🎯 Core Commands
-
-### `/plan`
-```yaml
-Agents:
-  - planner.md          # Lập kế hoạch chi tiết
-  
-Skills:
-  - planning/           # Phương pháp lập kế hoạch
-  - sequential-thinking/  # Tư duy logic
-  - problem-solving/    # Giải quyết vấn đề
-```
-
-### `/cook`
-```yaml
-Agents:
-  - fullstack-developer.md  # Implement code
-  - researcher.md           # Nghiên cứu solutions
-  - code-reviewer.md        # Review trước khi xong
-  
-Skills:
-  - frontend-development/   # UI/Frontend code
-  - backend-development/    # API/Backend code
-  - web-frameworks/         # Next.js, React patterns
-  - databases/              # Database queries
-  - sequential-thinking/    # Logic phức tạp
-```
-
-### `/fix`
-```yaml
-Agents:
-  - debugger.md             # Debug và phân tích lỗi
-  - tester.md               # Verify fixes
-  
-Skills:
-  - debugging/              # Debug techniques
-  - problem-solving/        # Root cause analysis
-  - code-review/            # Identify issues
-```
-
-### `/scout`
-```yaml
-Agents:
-  - scout.md                # Explore codebase
-  - scout-external.md       # External resources
-  - researcher.md           # Deep research
-  
-Skills:
-  - research/               # Tìm kiếm thông tin
-  - docs-seeker/            # Đọc documentation
-```
-
-### `/test`
-```yaml
-Agents:
-  - tester.md               # Viết và chạy tests
-  
-Skills:
-  - code-review/            # Quality checks
-  - debugging/              # Test failure analysis
-```
-
----
-
-## 📝 Generate Commands
-
-### `/generate:page`
-```yaml
-Agents:
-  - fullstack-developer.md
-  - ui-ux-designer.md
-  
-Skills:
-  - frontend-development/
-  - frontend-design/
-  - ui-styling/
-  - web-frameworks/         # Next.js page patterns
-```
-
-### `/generate:api`
-```yaml
-Agents:
-  - fullstack-developer.md
-  - database-admin.md
-  
-Skills:
-  - backend-development/
-  - databases/
-  - web-frameworks/
-```
-
-### `/generate:component`
-```yaml
-Agents:
-  - ui-ux-designer.md
-  - design-system-architect.md
-  
-Skills:
-  - frontend-development/
-  - frontend-design/
-  - ui-styling/
-  - aesthetic/
-```
-
----
-
-## 🎨 Design Commands
-
-### `/design/ui`
-```yaml
-Agents:
-  - ui-ux-designer.md
-  - design-system-architect.md
-  
-Skills:
-  - frontend-design/
-  - frontend-design-pro/
-  - ui-ux-pro-max/
-  - aesthetic/
-  - ui-styling/
-```
-
-### `/design/domain`
-```yaml
-Agents:
-  - ddd-architect.md
-  
-Skills:
-  - ddd-modular-monolith/
-  - backend-development/
-  - databases/
-```
-
----
-
-## 🔧 Utility Commands
-
-### `/context`
-```yaml
-Agents:
-  - scout.md
-  
-Skills:
-  - research/
-  - docs-seeker/
-```
-
-### `/memory`
-```yaml
-Skills:
-  - common/                 # Project context
-```
-
-### `/git:commit`, `/git:pr`
-```yaml
-Agents:
-  - git-manager.md
-  
-Skills:
-  - devops/
-```
-
-### `/docs:update`
-```yaml
-Agents:
-  - docs-manager.md
-  
-Skills:
-  - document-skills/
-  - docs-seeker/
-```
-
----
-
-## 📊 Special Commands
-
-### `/brainstorm`
-```yaml
-Agents:
-  - brainstormer.md
-  
-Skills:
-  - problem-solving/
-  - sequential-thinking/
-```
-
-### `/integrate:*` (sepay, polar)
-```yaml
-Agents:
-  - fullstack-developer.md
-  
-Skills:
-  - payment-integration/
-  - backend-development/
-```
-
----
-
-## 🔗 Quick Reference
-
-| Command | Primary Agent | Key Skills |
-|---------|---------------|------------|
-| `/plan` | planner | planning, sequential-thinking |
-| `/cook` | fullstack-developer | frontend, backend, web-frameworks |
-| `/fix` | debugger | debugging, problem-solving |
-| `/scout` | scout | research, docs-seeker |
-| `/test` | tester | code-review, debugging |
-| `/generate:page` | ui-ux-designer | frontend-design, web-frameworks |
-| `/generate:api` | fullstack-developer | backend, databases |
-| `/design/ui` | design-system-architect | ui-ux-pro-max, aesthetic |
-| `/design/domain` | ddd-architect | ddd-modular-monolith |

package/docs/FAQ.md

@@ -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

@@ -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"!