anchi-toolkit 1.0.0

package/docs/CODEBASE.md

@@ -0,0 +1,178 @@
+# 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/CODE_STYLE.md

@@ -0,0 +1,333 @@
+# Code Standards
+
+> ⚠️ **Template:** Điền coding conventions của team vào đây.
+
+---
+
+## 🎯 Preset Đang Dùng
+
+> **Conventions thay đổi theo preset:**
+
+| Aspect | Rapid | Professional | Enterprise |
+|--------|-------|--------------|------------|
+| Structure | Flat | Modules | DDD Layers |
+| Logic | Inline OK | Service pattern | Domain + Application |
+| Validation | Optional | Zod required | Zod + Domain rules |
+| Testing | Basic | Unit tests | Full coverage |
+
+> 💡 Đánh dấu preset tại `docs/PROJECT.md`
+
+---
+
+## Naming Conventions
+
+### Files & Folders
+
+| Type | Convention | Example |
+|------|------------|---------|
+| Components | PascalCase | `ProductCard.tsx` |
+| Hooks | camelCase + use | `useProducts.ts` |
+| Utils | camelCase | `formatCurrency.ts` |
+| Types | PascalCase | `Product.types.ts` |
+| Constants | UPPER_SNAKE | `API_ENDPOINTS.ts` |
+| Pages (Next.js) | lowercase | `page.tsx` |
+
+### Variables & Functions
+
+| Type | Convention | Example |
+|------|------------|---------|
+| Variables | camelCase | `userName`, `isLoading` |
+| Functions | camelCase | `getUserById`, `handleSubmit` |
+| Constants | UPPER_SNAKE | `MAX_RETRY_COUNT` |
+| Boolean | is/has/can prefix | `isActive`, `hasPermission` |
+| Event handlers | handle prefix | `handleClick`, `handleSubmit` |
+
+### Components
+
+| Type | Convention | Example |
+|------|------------|---------|
+| Component name | PascalCase | `ProductCard` |
+| Props interface | ComponentNameProps | `ProductCardProps` |
+| File name | Same as component | `ProductCard.tsx` |
+
+---
+
+## Folder Structure
+
+```
+[Điền folder structure chuẩn của dự án]
+
+src/
+├── app/                    # [Mô tả]
+├── components/             # [Mô tả]
+├── lib/                    # [Mô tả]
+└── ...
+```
+
+---
+
+## TypeScript Standards
+
+### Type Definitions
+
+```typescript
+// ✅ DO: Use interface for object shapes
+interface User {
+  id: string;
+  name: string;
+  email: string;
+}
+
+// ✅ DO: Use type for unions, intersections
+type Status = 'pending' | 'active' | 'inactive';
+
+// ❌ DON'T: Use any
+const data: any = fetchData(); // Bad
+
+// ✅ DO: Use unknown and narrow
+const data: unknown = fetchData();
+if (isUser(data)) {
+  // Now data is typed as User
+}
+```
+
+### Null Handling
+
+```typescript
+// ✅ DO: Use optional chaining
+const name = user?.profile?.name;
+
+// ✅ DO: Use nullish coalescing
+const value = data ?? defaultValue;
+
+// ❌ DON'T: Use non-null assertion without checking
+const name = user!.name; // Dangerous
+```
+
+---
+
+## Component Standards
+
+### Component Structure
+
+```tsx
+// 1. Imports
+import { useState } from 'react';
+import { Button } from '@/components/ui';
+
+// 2. Types
+interface ProductCardProps {
+  product: Product;
+  onAddToCart?: (id: string) => void;
+}
+
+// 3. Component
+export function ProductCard({ product, onAddToCart }: ProductCardProps) {
+  // 3a. Hooks
+  const [isLoading, setIsLoading] = useState(false);
+  
+  // 3b. Handlers
+  const handleClick = () => {
+    onAddToCart?.(product.id);
+  };
+  
+  // 3c. Render
+  return (
+    <div className="...">
+      {/* JSX */}
+    </div>
+  );
+}
+```
+
+### Props Guidelines
+
+```typescript
+// ✅ DO: Destructure props
+function Button({ children, variant = 'primary' }: ButtonProps) {}
+
+// ✅ DO: Use default values
+interface ButtonProps {
+  variant?: 'primary' | 'secondary';
+  size?: 'sm' | 'md' | 'lg';
+}
+
+// ❌ DON'T: Pass too many props (max 5-7)
+```
+
+---
+
+## Styling Standards
+
+### TailwindCSS
+
+```tsx
+// ✅ DO: Use semantic class order
+<div className="
+  flex items-center justify-between  // Layout
+  w-full h-12                        // Sizing
+  px-4 py-2                          // Spacing
+  bg-white border rounded-lg         // Visual
+  hover:bg-gray-50                   // States
+  transition-colors                  // Animation
+">
+
+// ✅ DO: Extract repeated patterns
+const cardStyles = "rounded-lg border p-4 shadow-sm";
+
+// ❌ DON'T: Inline complex styles
+<div style={{ display: 'flex', ... }}> // Bad
+```
+
+### CSS Variables
+
+```css
+/* ✅ DO: Use design tokens */
+:root {
+  --color-primary: #3b82f6;
+  --color-background: #ffffff;
+  --radius-default: 0.5rem;
+}
+
+/* Use in Tailwind */
+/* tailwind.config.js */
+colors: {
+  primary: 'var(--color-primary)',
+}
+```
+
+---
+
+## API Standards
+
+### Naming
+
+```typescript
+// ✅ DO: RESTful naming
+GET    /api/users          // List
+GET    /api/users/:id      // Get one
+POST   /api/users          // Create
+PUT    /api/users/:id      // Update
+DELETE /api/users/:id      // Delete
+
+// ✅ DO: Use plural nouns
+/api/products     // Not: /api/product
+/api/categories   // Not: /api/category
+```
+
+### Response Format
+
+```typescript
+// Success response
+{
+  "success": true,
+  "data": { ... },
+  "meta": { "page": 1, "total": 100 }
+}
+
+// Error response
+{
+  "success": false,
+  "error": {
+    "code": "VALIDATION_ERROR",
+    "message": "Invalid email format"
+  }
+}
+```
+
+---
+
+## Git Standards
+
+### Branch Naming
+
+```
+feature/[ticket-id]-short-description
+bugfix/[ticket-id]-short-description
+hotfix/[ticket-id]-short-description
+
+Examples:
+feature/ABC-123-add-user-auth
+bugfix/ABC-456-fix-login-error
+```
+
+### Commit Messages
+
+```
+type(scope): description
+
+Types:
+- feat: New feature
+- fix: Bug fix
+- docs: Documentation
+- style: Formatting
+- refactor: Code refactoring
+- test: Adding tests
+- chore: Maintenance
+
+Examples:
+feat(auth): add Google OAuth login
+fix(cart): resolve quantity update issue
+docs(readme): update installation steps
+```
+
+---
+
+## Testing Standards
+
+### Test Naming
+
+```typescript
+describe('ProductCard', () => {
+  it('should render product name', () => {});
+  it('should call onAddToCart when button clicked', () => {});
+  it('should show loading state while adding', () => {});
+});
+```
+
+### Test Coverage
+
+| Type | Minimum Coverage |
+|------|------------------|
+| Unit Tests | [X]% |
+| Integration Tests | [X]% |
+| E2E Tests | Critical paths |
+
+---
+
+## Error Handling
+
+```typescript
+// ✅ DO: Use try-catch with proper typing
+try {
+  const result = await fetchData();
+} catch (error) {
+  if (error instanceof ApiError) {
+    // Handle API error
+  }
+  throw error;
+}
+
+// ✅ DO: User-friendly error messages
+throw new Error('Unable to save product. Please try again.');
+
+// ❌ DON'T: Expose technical details to users
+throw new Error('SQL Error: Duplicate key violation'); // Bad
+```
+
+---
+
+## DO NOT
+
+- ❌ Use `any` type
+- ❌ Commit `.env` files
+- ❌ Leave `console.log` in production code
+- ❌ Use magic numbers without constants
+- ❌ Write functions > 50 lines
+- ❌ Create files > 300 lines
+- ❌ Skip error handling
+- ❌ Ignore TypeScript errors
+
+---
+
+> 💡 **Tip:** Cập nhật file này khi team có conventions mới. AI sẽ đọc file này để generate code đúng chuẩn.

package/docs/COMMAND_MAPPING.md

@@ -0,0 +1,217 @@
+# 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 |