# Qwen-CLI Sub-Agents

A collection of specialized AI assistants designed to work with Qwen-CLI for various development tasks. Each agent is tailored for specific domains and technologies, providing expert-level guidance and code generation.

## Available Agents

### 1. Animation + Motion Assistant
- **File**: `Animation-Assistant.md`
- **Focus**: React/Next.js animations, motion design, and micro-interactions
- **Technologies**: Framer Motion, shadcn/ui, Tailwind CSS, CSS animations
- **Specialties**: 
  - Advanced animation libraries integration
  - Performance optimization for 60fps animations
  - Accessibility-focused motion design
  - Responsive and adaptive animations

### 2. Component Builder Assistant
- **File**: `Component-Builder-Assistant.md`
- **Focus**: Building reusable UI components with best practices
- **Technologies**: React, shadcn/ui, Tailwind CSS, TypeScript
- **Specialties**:
  - Component architecture and design patterns
  - Reusable component creation
  - TypeScript type safety
  - Accessibility compliance

### 3. Dashboard Master
- **File**: `Dashboard-Master.md`
- **Focus**: Data visualization and dashboard development
- **Technologies**: React, Next.js, Chart.js, D3.js, shadcn/ui
- **Specialties**:
  - Complex data visualizations
  - Dashboard layouts and organization
  - Real-time data integration
  - Performance optimization for dashboards

### 4. Next.js Developer
- **File**: `Nextjs-Developer.md`
- **Focus**: Full Next.js 15 development with modern frontend practices
- **Technologies**: Next.js 15, React, TypeScript, Tailwind CSS, shadcn/ui
- **Specialties**:
  - App Router architecture
  - Server Components and Client Components
  - AI SDK v5 integration
  - Modern UI/UX implementation

### 5. Next.js Forms Developer
- **File**: `Nextjs-Forms-Developer.md`
- **Focus**: Form handling and validation in Next.js applications
- **Technologies**: Next.js 15, React Hook Form, Zod, shadcn/ui
- **Specialties**:
  - Form validation and error handling
  - Complex form architectures
  - Dynamic forms and conditional fields
  - Integration with backend services

### 6. Next.js Realtime Developer
- **File**: `Nextjs-Realtime-Developer.md`
- **Focus**: Real-time features and collaborative applications
- **Technologies**: Next.js 15, Supabase Realtime, shadcn/ui, WebSockets
- **Specialties**:
  - Real-time data synchronization
  - Collaborative features implementation
  - Live updates and notifications
  - Connection management

### 7. Payment Integration Specialist
- **File**: `Payment-Integration-Specialist.md`
- **Focus**: Secure payment processing and integration
- **Technologies**: Stripe, PayPal, React, Next.js, TypeScript
- **Specialties**:
  - Payment gateway integration
  - Security best practices
  - Subscription management
  - Fraud prevention

### 8. Supabase Engineer
- **File**: `Supabase-Engineer.md`
- **Focus**: Full-stack development with Supabase ecosystem
- **Technologies**: Supabase (Auth, Database, Realtime, Storage), shadcn/ui, Next.js 15
- **Specialties**:
  - Supabase authentication and authorization
  - Real-time features with Supabase
  - Database design and RLS policies
  - File storage and management

## How to Use

Each agent is designed to be used with Qwen-CLI. To use a specific agent:

1. Navigate to the repository directory
2. Launch Qwen-CLI with the specific agent file:
   ```bash
   qwen-cli --agent Animation-Assistant.md
   ```
3. Or specify the agent by name:
   ```bash
   qwen-cli --agent "Animation + Motion Assistant"
   ```

## Contributing

Contributions are welcome! To add a new agent:

1. Create a new markdown file following the existing pattern
2. Include the YAML frontmatter with `name`, `description`, and `color`
3. Add a detailed description of the agent's responsibilities and specialties
4. Include technology stack focus and implementation rules
5. Submit a pull request

## License

This project is licensed under the MIT License - see the LICENSE file for details.