Sub-Agent Usage Guide for BMAsia CRM

ALWAYS use the appropriate specialized sub-agent for the task at hand.

Available Sub-Agents

1. django-admin-expert

Use when:

• Creating/modifying Django admin interfaces
• Adding bulk operations or custom admin actions
• Implementing CSV/Excel export functionality
• Optimizing admin querysets (select_related, prefetch_related)
• Files: crm_app/admin.py, crm_app/admin_views.py

2. django-testing-agent

Use when:

• Writing pytest tests for models, views, or services
• Creating test fixtures with factory_boy
• Testing API endpoints
• Mocking external services
• Files in: crm_app/tests/

3. react-dashboard-builder

Use when:

• Building React components for the dashboard
• Creating data visualizations with Recharts
• Implementing authentication flows
• Managing state with Context API
• Integrating with Django REST APIs
• Files in: bmasia-crm-frontend/

4. api-integration-specialist

Use when:

• Integrating with Soundtrack Your Brand API
• Adding new external API integrations
• Implementing retry logic and error handling
• Working with GraphQL or REST APIs
• Files: crm_app/services/soundtrack_api.py

5. database-optimizer

Use when:

• Creating database indexes
• Optimizing Django ORM queries
• Writing complex database migrations
• Implementing caching strategies

6. email-automation-specialist

Use when:

• Creating/modifying email templates
• Setting up automated email campaigns
• Implementing email scheduling
• Files: crm_app/services/email_service.py

7. frontend-auth-specialist

Use when:

• Implementing JWT token management
• Creating login/logout flows
• Setting up protected routes in React
• Files: AuthContext.tsx

8. ui-ux-designer

Use when:

• Creating consistent design systems
• Implementing responsive layouts
• Adding loading states and error handling
• Implementing accessibility features

9. data-visualization-expert

Use when:

• Building interactive dashboards with Recharts
• Creating sales pipeline visualizations
• Designing KPI cards and metrics displays

Quick Reference Table