A comprehensive collection of specialized AI agents for software development, each expertly crafted for specific technical domains. These agents follow the principle that specialized expertise delivers superior results compared to general-purpose approaches.
agents/
├── django/ # Django framework specialists (8 agents)
├── backend/ # Backend infrastructure and services (10 agents)
├── frontend/ # Frontend and UI specialists (5 agents)
├── ai/ # AI and machine learning specialists (3 agents)
├── api-endpoints/ # Third-party API integration specialists (1 agent)
├── testing/ # Testing, debugging, and quality (5 agents)
├── devops/ # DevOps and infrastructure (4 agents)
├── utilities/ # General utilities and orchestration (5 agents)
└── templates/ # Agent design templates and guidelines
When working with Claude Code, use the Task tool to delegate work to appropriate specialists:
# Example: Debug a React component issue
Use the Task tool with the frontend-specialist to investigate why the SearchComponent renders twice
# Example: Optimize a slow Django query
Use the Task tool with the django-specialist to fix the N+1 query problem in the UserViewSet
# Example: Set up CI/CD pipeline
Use the Task tool with the devops-engineer to create GitHub Actions workflow for deploymentMaster coordinator for complex multi-step tasks Analyzes complex projects and delegates to specialized subagents for coordinated problem-solving. Use when you have multi-faceted tasks requiring expertise across different domains. Has visibility into all 35 specialized agents across the entire ecosystem.
Expert bug hunter and performance profiler Root cause analysis, performance profiling, memory leak detection, and distributed tracing. Your go-to agent for investigating mysterious bugs and performance bottlenecks.
Quality guardian with meticulous standards Performs thorough code reviews for quality, maintainability, and best practices. Evaluates SOLID principles, design patterns, and security considerations.
Comprehensive testing specialist following TDD principles Generates complete test suites with unit, integration, and E2E tests. Ensures proper coverage and follows testing best practices.
Code improvement specialist Improves code structure and design while preserving behavior through systematic, safe refactoring techniques.
Supreme Django + DRF + ORM + Pillow expert Production-grade Django applications with comprehensive DRF patterns, async capabilities, advanced admin features, and full Pillow integration for image processing. Must be used for all Django API, backend, async, or data-related tasks. Includes enterprise ViewSets, serializers, permissions, and image optimization.
Advanced Django Admin customization expert Comprehensive Django admin patterns including raw_id_fields, autocomplete_fields, performance optimizations, custom actions, and full Pillow integration for image management. Expert in admin UI/UX, bulk operations, and advanced filtering.
Ultimate Django Unfold admin interface expert Master of Django Unfold's modern Tailwind-powered admin with dynamic navigation, conditional fields, custom dashboards, and rich components. Creates beautiful, production-ready admin interfaces with advanced UX patterns.
Django + Celery integration master with production best practices Expert in production-hardened Celery patterns: idempotent tasks, retry strategies with exponential backoff and jitter, I/O vs CPU worker pool configuration, distributed locking, result backend optimization, and comprehensive monitoring. Includes Beat scheduling, django-celery-beat, task routing, error handling, circuit breakers, and async workflows. Implements industry-proven patterns for zero-downtime task processing.
Django + Redis caching and data structures expert Advanced Redis patterns with django-redis, pub/sub, distributed locks, rate limiting, session storage, and cache optimization strategies. Integrates seamlessly with Django applications.
Cloud storage and Pillow processing expert S3/Azure/GCS backends, CDN integration, image processing pipelines with Pillow, WebP conversion, thumbnail generation, and optimized storage strategies. Production-ready file management.
Application monitoring and observability expert Sentry integration, Prometheus metrics, structured logging, health checks, performance monitoring, and alerting. Comprehensive production monitoring setup.
Complete application builder Implements features across the entire stack - frontend, backend, database, and infrastructure. Ideal for end-to-end feature development.
Database design and optimization master Expert in PostgreSQL, MySQL, query optimization, indexing strategies, migrations, replication, and sharding. Handles complex database challenges.
Big data and ETL pipeline expert Apache Airflow, Spark, data warehousing, Pandas optimization, and big data processing. Builds robust data infrastructure and pipelines.
REST, GraphQL, and gRPC specialist Comprehensive API design with OpenAPI documentation, versioning, authentication, and gateway configuration. Focuses on Django REST Framework.
Elite Django REST Framework specialist Production-grade DRF API development with enterprise ViewSets, advanced serializers, custom permissions, authentication backends, filtering, pagination, OpenAPI documentation with drf-spectacular, testing, performance optimization, and comprehensive error handling. Deep expertise in ModelSerializer patterns, action-level permissions, query optimization, caching, throttling, and API versioning strategies.
Supreme Wagtail CMS expert for content management systems Complete Wagtail CMS mastery covering Pages, StreamField, Snippets, Images, Documents, REST API v2, PostgreSQL search, Workflows, and Wagtail Localize. Expert in page hierarchies, custom block development, SnippetViewSets, image renditions, headless CMS patterns, and production deployment. Delegates from django-specialist for all CMS-specific work. Never uses GraphQL, always PostgreSQL for search.
Legacy modernization expert Legacy code modernization, framework upgrades, database migrations, and zero-downtime deployments. Handles complex system transitions.
Modern JavaScript frameworks expert React, Vue, Svelte, state management, modern CSS, build tools, and component libraries. Builds sophisticated user interfaces with performance optimization.
Hypermedia-driven architecture master HTMX, Alpine.js integration, Django + HTMX patterns, progressive enhancement, and SPA-like experiences without heavy JavaScript frameworks.
Cross-platform mobile specialist React Native, Flutter, PWAs, mobile optimization, app store deployment, and native integrations. Creates polished mobile experiences.
User experience testing expert with AI-powered automation UX/UI testing, accessibility compliance, user interaction flows, visual regression testing using Playwright, Puppeteer, and Stagehand for AI-powered natural language automation. Features intelligent bug reproduction, automated issue diagnosis, context-aware testing, and drag-and-drop testing for interactive UI elements (kanban boards, sortable lists, resizable panels). Ensures excellent user experiences through both traditional and AI-enhanced testing methods.
Inclusive design specialist WCAG compliance, ARIA, screen readers, keyboard navigation, and inclusive design. Makes applications usable by everyone.
Elite Python WebSocket expert for massive multiplayer realtime systems Django Channels mastery, Twisted Framework expertise, horizontal scaling to 100k+ concurrent connections, Redis/RabbitMQ channel layers, sharding strategies, binary protocols (msgpack), production architecture with Nginx load balancing, Prometheus monitoring, and comprehensive load testing. Covers game rooms, presence tracking, spatial partitioning, and state synchronization patterns.
Search and discovery expert Elasticsearch, Algolia, MeiliSearch, full-text search, faceted search, and search relevance tuning. Implements sophisticated search capabilities.
n8n workflow automation architect Production-grade n8n workflow design with comprehensive validation, error handling, and optimization. Builds complex automation workflows with pre and post validation, incremental updates, and security best practices.
Authentication and security expert OAuth2, JWT, OIDC, MFA, session management, CORS, security headers, and authentication best practices. Implements robust security systems.
Transactional email expert Email templates, deliverability, SendGrid/SES integration, and email marketing. Handles all aspects of application email communication.
Payment processing expert Stripe, PayPal, payment processing, subscriptions, PCI compliance, and webhook handling. Implements secure payment systems.
OpenAI and ChatGPT integration master Complete OpenAI Python SDK integration (sync/async), Django + Celery patterns, streaming responses with Django Channels, function calling framework, embeddings and vector operations, structured outputs with Pydantic, and production-grade error handling. Expert in GPT-4, GPT-3.5, cost optimization, token management, fine-tuning, and webhook handling. Implements scalable AI features with comprehensive monitoring and security best practices.
Stockfish chess engine integration expert Complete Stockfish UCI protocol integration, NNUE neural network evaluation, REST API development (FastAPI/Django), python-chess library mastery, Docker/Kubernetes deployment, Syzygy tablebase configuration, analysis caching strategies, and performance optimization. Expert in position analysis, best move calculation, batch processing, real-time streaming, and production chess analysis systems with horizontal scaling.
Vectrex game development and 6809 assembly expert Complete Motorola 6809 assembly programming, CMOC C cross-compiler, VIDE IDE, vector graphics programming, and retro game design for the GCE Vectrex vector display system. Expert in BIOS routines, AY-3-8912 PSG sound programming, joystick input handling, collision detection, and game loop architecture. Implements complete games with scaling sprites, animation, particle systems, and optimized performance. Covers ROM cartridge creation, ParaJVE/MAME emulation, and real hardware deployment.
Bloxs.io property management API integration expert Python/Django integration specialist for the Bloxs API. Expert in property management data models including entities, leases, financials, tasks, and cases. Consults live documentation at https://www.bloxs.io/apidocs/ and local bloxs_docs.jsonl files. Implements robust error handling, authentication patterns, and comprehensive testing for Bloxs integrations. Handles pagination, rate limiting, and API versioning correctly.
Infrastructure and deployment expert Docker, Kubernetes, CI/CD, AWS/GCP/Azure, Terraform, GitHub Actions, monitoring, and production deployment strategies. Handles all DevOps needs.
Coolify self-hosting platform expert with MCP integration, Django deployments, Docker Compose security, and Traefik best practices
Manages Coolify PaaS deployments via coolify-mcp-server. Application deployments, database provisioning (PostgreSQL, MySQL, MongoDB, Redis, etc.), server management, environment configuration, service orchestration, zero-downtime deployments, and resource monitoring. Django + Celery Deployments: Expert in deploying Django projects with one image, multiple Coolify apps (Web + Celery worker + Celery beat), GHCR integration, build server workflows, and process-aware healthchecks. Expert in static site deployments with nginx:alpine containers, Traefik integration, health check patterns, and Let's Encrypt certificate generation. Critical Docker Compose Knowledge: Automatically detects and prevents public exposure of internal services by ensuring all services with build: directives have traefik.enable=false (except the entry point). Prevents Gateway timeout errors by avoiding custom Docker networks and using Coolify Destinations instead. Complete control over self-hosted infrastructure through Coolify API integration with production-safe networking patterns and security best practices.
Defensive security specialist Identifies vulnerabilities and enforces defensive security practices. Focuses only on protective security measures, never offensive techniques.
Optimization and efficiency expert Identifies bottlenecks and optimizes code for maximum performance and efficiency. Improves application speed and resource usage.
Technical writing specialist API documentation, README files, architecture docs, user guides, and technical writing. Creates clear, comprehensive documentation.
Product Requirement Document specialist Expert in authoring comprehensive Product Requirement Documents with modern product management frameworks. Creates clear, actionable PRDs that align teams and drive successful product outcomes with structured templates for goals, requirements, user stories, and acceptance criteria.
- Bug reports:
debugger-detective - Performance problems:
performance-analyzer - UI/UX issues:
ux-specialist(with Stagehand AI) orfrontend-specialist - Django/API problems:
django-specialistordjango-rest-framework-specialistfor DRF-specific issues - DRF serializer/ViewSet issues:
django-rest-framework-specialist - Wagtail CMS issues:
wagtail-specialist(pages, StreamField, snippets, API) - Admin interface issues:
django-admin-specialistordjango-unfold-admin-specialist - Image processing problems:
file-storage-specialist(Pillow integration) - Async task issues:
celery-specialist - Caching problems:
redis-specialist - Deployment issues:
coolify-specialist(health checks, SSL, 503/504 errors) - Security concerns:
security-auditor - AI/ChatGPT integration:
chatgpt-specialist - Chess engine integration:
stockfish-specialist - Bloxs API integration:
bloxs-api-specialist
- New features:
full-stack-coderor domain-specific specialist - Frontend components:
frontend-specialist - Database design:
database-architect - API endpoints:
django-rest-framework-specialistfor DRF-specific,django-specialistfor full-stack, orapi-designerfor multi-protocol - Third-party API integrations: API endpoint specialists (e.g.,
bloxs-api-specialist) - Admin interfaces:
django-admin-specialistordjango-unfold-admin-specialist - Content management systems:
wagtail-specialistfor Wagtail CMS projects - Image handling:
file-storage-specialistwith Pillow processing - Background tasks:
celery-specialist - Caching strategies:
redis-specialist - File uploads:
file-storage-specialist - Mobile apps:
mobile-developer - Static site deployments:
coolify-specialistwith nginx:alpine + Traefik - AI features:
chatgpt-specialistfor OpenAI/ChatGPT integration - Chess applications:
stockfish-specialistfor engine integration - Vectrex games:
vectrex-specialistfor retro vector display game development - Natural language testing:
ux-specialistwith Stagehand - Property management systems:
bloxs-api-specialistfor Bloxs.io integration
- Multi-domain tasks:
orchestrator-agent - System migrations:
migration-specialist - Infrastructure setup:
devops-engineer - Self-hosted deployments:
coolify-specialist - Data pipelines:
data-engineer
- Code reviews:
code-reviewer - Test creation:
test-writer - Refactoring:
refactoring-agent - Documentation:
documentation-writer
Complete Django/DRF/Celery/Redis/Postgres Stack Coverage:
django-specialist- Core Django + DRF + ORM + Pillow patternsdjango-rest-framework-specialist- Elite DRF API development with ViewSets, serializers, permissionswagtail-specialist- Wagtail CMS with Pages, StreamField, REST API v2, localizationdjango-admin-specialist- Advanced admin customization + image managementdjango-unfold-admin-specialist- Modern Tailwind admin interfacescelery-specialist- Async task processing + image workflowsredis-specialist- Caching + session management + rate limitingfile-storage-specialist- Cloud storage + Pillow integration + CDNmonitoring-specialist- Sentry + Prometheus + structured logging
Key Features:
- 📄 Wagtail CMS - Pages, StreamField, Snippets, REST API v2, PostgreSQL search
- 🖼️ Full Pillow Integration - Image processing, optimization, WebP conversion
- 🎨 Modern Admin UX - Django Unfold with Tailwind components
- ⚡ Enterprise DRF Patterns - ViewSets, serializers, permissions, filtering
- 🚀 Production Ready - Async processing, caching, monitoring, security
- Always delegate to specialists - Each agent has deep expertise in their domain
- Provide context - Give agents relevant background about your project
- Use orchestrator-agent for multi-step tasks requiring coordination
- Start with debugging - Use
debugger-detectiveto investigate issues before fixing - Follow the chain - Let specialists recommend other agents for follow-up work
- Django stack coordination - Use multiple Django specialists together for complex projects
Each agent includes:
- Specialized Knowledge: Deep expertise in their technical domain
- Production-Ready Code: Complete, working implementations
- Best Practices: Industry-standard patterns and approaches
- Testing: Comprehensive test coverage strategies
- Documentation: Clear explanations and examples
- Modern Standards: Up-to-date with latest technologies and practices
The repository includes comprehensive templates and guidelines for creating new agents:
- story-driven-template.md - Narrative approach for user-facing agents
- minimalist-spec.md - Just input/output contracts for simple utilities
- capability-matrix-template.md - Data-driven with performance metrics
- yaml-frontmatter-standard.md - Consistent metadata structure
- agent-validation-checklist.md - Quality gates for all agents
- agent-design-style-guide.md - Voice, tone, and formatting guidelines
- Choose an appropriate template based on complexity and purpose
- Follow the YAML frontmatter standard for metadata
- Validate against the quality checklist
- Place in the appropriate category directory
Complete retro game development for GCE Vectrex vector display system:
- Motorola 6809 assembly programming with full instruction set reference
- CMOC C cross-compiler with inline assembly integration
- VIDE IDE project management and debugging workflows
- Complete BIOS routine reference with addresses and parameters
- Vector graphics programming (scaling, animation, particle systems)
- AY-3-8912 PSG sound chip programming (music and sound effects)
- Joystick input handling with analog and digital support
- Complete game loop examples with collision detection
- ROM cartridge creation and memory layout
- ParaJVE/MAME emulator configuration and testing
- 1000+ lines with authentic code examples and technical details
Chess engine integration and analysis systems:
- Complete UCI protocol communication with python-chess
- NNUE neural network evaluation (10-50x faster than traditional)
- REST API servers (FastAPI/Django) for position analysis
- Docker/Kubernetes deployment with horizontal scaling
- Syzygy tablebase configuration for perfect endgame play
- Analysis result caching with Redis for performance
- Batch processing and real-time WebSocket streaming
- Production optimization (threads, hash tables, search depth)
Self-hosted PaaS management through coolify-mcp-server with comprehensive Django deployment expertise:
- Application deployment and lifecycle management
- Database provisioning (PostgreSQL, MySQL, MongoDB, Redis, etc.)
- Server resource monitoring and validation
- Environment variable and secret management
- Zero-downtime deployment strategies
- Domain and SSL/TLS configuration
- Project and team organization
- Django + Celery Deployments - Complete playbook for Web + Worker + Beat as separate Coolify apps
- One Image, Multiple Apps - Single Dockerfile with process-aware entrypoint and healthcheck
- GHCR Integration - GitHub Container Registry setup, PAT configuration, build server workflows
- Process-Aware Healthchecks - Celery containers no longer killed by HTTP healthchecks
- Build Server Architecture - Separate build and runtime servers with image push/pull
- traefik.enable=false Trap (NEW!) - SSL certificate killer when used with Coolify-managed apps
- Django Media Serving (NEW!) - Production media file serving (Whitenoise is for static only!)
- Static Site Deployments - nginx:alpine containers with Traefik integration
- Health Check Patterns - curl-based checks, 127.0.0.1 vs localhost gotchas
- Let's Encrypt Automation - Certificate generation and troubleshooting
- Gateway timeout diagnostics and prevention - Never use custom Docker networks
- Coolify Destinations - Production-safe network isolation patterns
Complete OpenAI integration expert covering:
- Async/sync Python SDK patterns
- Django + Celery background processing
- Real-time streaming with Django Channels
- Function calling and tool use frameworks
- Embeddings and vector search
- Cost optimization and monitoring
- Production security best practices
The ux-specialist now includes Stagehand for AI-powered browser automation:
- Natural language test actions ("click on the login button")
- Intelligent bug reproduction and diagnosis
- AI-powered visual regression detection
- Context-aware form filling and validation
- Hybrid testing combining AI with traditional automation
- Drag-and-drop testing for interactive UI elements using Playwright's
dragTo()method - Comprehensive testing patterns for kanban boards, sortable lists, file uploads, and resizable panels
Supreme Wagtail CMS expert for production-grade content management:
- Page models with parent/child constraints and content panels
- StreamField architecture with custom blocks (StructBlock, ListBlock, validation)
- Snippets and SnippetViewSets with grouped viewsets
- Image handling (custom models, renditions, responsive images, prefetching)
- REST API v2 configuration (APIField, custom serializers, ImageRenditionField)
- PostgreSQL full-text search (SearchField, FilterField, AutocompleteField)
- Workflows and moderation (custom tasks, approval chains)
- Wagtail Localize (TranslatableMixin, i18n_patterns, machine translation)
- Hooks and admin customization (menu items, buttons, CSS/JS injection)
- Headless CMS patterns for Next.js/React integration
- Production deployment with caching and performance optimization
- Delegates from django-specialist for all CMS-specific work
Remember: These agents are designed to work together. Complex projects often require multiple specialists coordinated by the orchestrator-agent for optimal results. The orchestrator has full visibility into all 39 agents and can effectively coordinate multi-domain tasks.