{"id":30522960,"url":"https://github.com/gabrielmaialva33/claude-agents","last_synced_at":"2026-04-13T21:32:23.795Z","repository":{"id":311006687,"uuid":"1042088725","full_name":"gabrielmaialva33/claude-agents","owner":"gabrielmaialva33","description":"Supercharge Claude Code with a team of specialized AI agents that work together to build complete features, debug complex issues, and handle any technology stack with expert-level knowledge.","archived":false,"fork":false,"pushed_at":"2025-08-21T14:48:36.000Z","size":322,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-18T23:59:38.712Z","etag":null,"topics":["agents","claude","claude-ai","claude-code"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gabrielmaialva33.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-21T13:17:46.000Z","updated_at":"2025-12-28T07:15:09.000Z","dependencies_parsed_at":"2025-08-21T15:53:57.729Z","dependency_job_id":null,"html_url":"https://github.com/gabrielmaialva33/claude-agents","commit_stats":null,"previous_names":["gabrielmaialva33/claude-agents"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gabrielmaialva33/claude-agents","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabrielmaialva33%2Fclaude-agents","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabrielmaialva33%2Fclaude-agents/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabrielmaialva33%2Fclaude-agents/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabrielmaialva33%2Fclaude-agents/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gabrielmaialva33","download_url":"https://codeload.github.com/gabrielmaialva33/claude-agents/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabrielmaialva33%2Fclaude-agents/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31771825,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T20:17:16.280Z","status":"ssl_error","status_checked_at":"2026-04-13T20:17:08.216Z","response_time":93,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","claude","claude-ai","claude-code"],"created_at":"2025-08-26T19:43:51.160Z","updated_at":"2026-04-13T21:32:23.784Z","avatar_url":"https://github.com/gabrielmaialva33.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cbr\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/gabrielmaialva33/claude-agents/master/.github/assets/claude-agent-logo.svg\" alt=\"Claude Agents\" width=\"200\"\u003e\n  \u003cbr\u003e\n  Claude Agents - AI Development Team 🚀\n  \u003cbr\u003e\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eSupercharge Claude Code with a team of specialized AI agents that work together to build complete features\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/license/gabrielmaialva33/claude-agents?color=00b8d3?style=flat\u0026logo=appveyor\" alt=\"License\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/languages/top/gabrielmaialva33/claude-agents?style=flat\u0026logo=appveyor\" alt=\"GitHub top language\" \u003e\n  \u003cimg src=\"https://img.shields.io/github/languages/count/gabrielmaialva33/claude-agents?style=flat\u0026logo=appveyor\" alt=\"GitHub language count\" \u003e\n  \u003cimg src=\"https://img.shields.io/github/repo-size/gabrielmaialva33/claude-agents?style=flat\u0026logo=appveyor\" alt=\"Repository size\" \u003e\n  \u003ca href=\"https://github.com/gabrielmaialva33/claude-agents/commits/master\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/last-commit/gabrielmaialva33/claude-agents?style=flat\u0026logo=appveyor\" alt=\"GitHub last commit\" \u003e\n    \u003cimg src=\"https://img.shields.io/badge/made%20by-Maia-15c3d6?style=flat\u0026logo=appveyor\" alt=\"Maia\" \u003e  \n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#bookmark-about\"\u003eAbout\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;|\u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003ca href=\"#rocket-quick-start\"\u003eQuick Start\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;|\u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003ca href=\"#busts_in_silhouette-meet-your-team\"\u003eMeet Your Team\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;|\u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003ca href=\"#sparkles-features\"\u003eFeatures\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;|\u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003ca href=\"#books-documentation\"\u003eDocumentation\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;|\u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003ca href=\"#memo-license\"\u003eLicense\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\n## :bookmark: About\n\n**Claude Agents** is a collection of 34+ specialized AI agents that extend Claude Code's capabilities through\nintelligent orchestration and domain expertise. Each agent masters specific technologies and patterns, working together\nas your AI development team.\n\n### :warning: Important Notice\n\n**This project is experimental and token-intensive.** Multi-agent orchestration can consume 10-50k tokens per complex\nfeature. Use with caution and monitor your usage.\n\n## :rocket: Quick Start\n\n### :heavy_check_mark: Prerequisites\n\n- **Claude Code CLI** installed and authenticated\n- **Claude subscription** - required for intensive agent workflows\n- Active project directory with your codebase\n- **Optional**: [Context7 MCP](docs/dependencies.md) for enhanced documentation access\n\n### :arrow_down: Installation\n\n```bash\ngit clone https://github.com/gabrielmaialva33/claude-agents.git\n```\n\n#### Option A: Symlink (Recommended - auto-updates)\n\n**macOS/Linux:**\n\n```bash\n# Create agents directory if it doesn't exist (preserves existing agents)\nmkdir -p ~/.claude/agents\n\n# Symlink the claude-agents collection\nln -sf \"$(pwd)/claude-agents/agents/\" ~/.claude/agents/claude-agents\n```\n\n**Windows (PowerShell):**\n\n```powershell\n# Create agents directory\nNew-Item -Path \"$env:USERPROFILE\\.claude\\agents\" -ItemType Directory -Force\n\n# Create symlink\ncmd /c mklink /D \"$env:USERPROFILE\\.claude\\agents\\claude-agents\" \"$(Get-Location)\\claude-agents\\agents\"\n```\n\n#### Option B: Copy (Static - no auto-updates)\n\n```bash\n# Create agents directory if it doesn't exist\nmkdir -p ~/.claude/agents\n\n# Copy all agents\ncp -r claude-agents/agents ~/.claude/agents/claude-agents\n```\n\n### :white_check_mark: Verify Installation\n\n```bash\nclaude /agents\n# Should show all 24 agents.\n```\n\n### :gear: Initialize Your Project\n\n**Navigate** to your **project directory** and run the following command to configure your AI team:\n\n```bash\nclaude \"use @agent-team-configurator and optimize my project to best use the available subagents.\"\n```\n\n### :rocket: Start Building\n\n```bash\nclaude \"use @agent-tech-lead-orchestrator and build a user authentication system\"\n```\n\nYour AI team will automatically detect your stack and use the right specialists!\n\n## :dart: How Auto-Configuration Works\n\nThe @agent-team-configurator automatically sets up your perfect AI development team. When invoked, it:\n\n1. **Locates CLAUDE.md** - Finds existing project configuration and preserves all your custom content outside the \"AI\n   Team Configuration\" section\n2. **Detects Technology Stack** - Inspects package.json, composer.json, requirements.txt, go.mod, Gemfile, and build\n   configs to understand your project\n3. **Discovers Available Agents** - Scans ~/.claude/agents/ and .claude/ folders, building a capability table of all\n   available specialists\n4. **Selects Specialists** - Prefers framework-specific agents over universal ones, always includes @agent-code-reviewer\n   and @agent-performance-optimizer for quality assurance\n5. **Updates CLAUDE.md** - Creates a timestamped \"AI Team Configuration\" section with your detected stack and a\n   Task|Agent|Notes mapping table\n6. **Provides Usage Guidance** - Shows you the detected stack, selected agents, and gives sample commands to start\n   building\n\n## :busts_in_silhouette: Meet Your AI Development Team\n\n### :performing_arts: Orchestrators (3 agents)\n\n- **[Tech Lead Orchestrator](agents/orchestrators/tech-lead-orchestrator.md)** - Senior technical lead who analyzes\n  complex projects and coordinates multi-step development tasks\n- **[Project Analyst](agents/orchestrators/project-analyst.md)** - Technology stack detection specialist who enables\n  intelligent agent routing\n- **[Team Configurator](agents/orchestrators/team-configurator.md)** - AI team setup expert who detects your stack and\n  configures optimal agent mappings\n\n### :briefcase: Framework Specialists (18 agents)\n\n- **Laravel (2 agents)**\n    - **[Backend Expert](agents/specialized/laravel/laravel-backend-expert.md)** - Comprehensive Laravel development\n      with MVC, services, and Eloquent patterns\n    - **[Eloquent Expert](agents/specialized/laravel/laravel-eloquent-expert.md)** - Advanced ORM optimization, complex\n      queries, and database performance\n- **Django (3 agents)**\n    - **[Backend Expert](agents/specialized/django/django-backend-expert.md)** - Models, views, services following\n      current Django conventions\n    - **[API Developer](agents/specialized/django/django-api-developer.md)** - Django REST Framework and GraphQL\n      implementations\n    - **[ORM Expert](agents/specialized/django/django-orm-expert.md)** - Query optimization and database performance for\n      Django applications\n- **Rails (3 agents)**\n    - **[Backend Expert](agents/specialized/rails/rails-backend-expert.md)** - Full-stack Rails development following\n      conventions\n    - **[API Developer](agents/specialized/rails/rails-api-developer.md)** - RESTful APIs and GraphQL with Rails\n      patterns\n    - **[ActiveRecord Expert](agents/specialized/rails/rails-activerecord-expert.md)** - Complex queries and database\n      optimization\n- **React (2 agents)**\n    - **[Component Architect](agents/specialized/react/react-component-architect.md)** - Modern React patterns, hooks,\n      and component design\n    - **[Next.js Expert](agents/specialized/react/react-nextjs-expert.md)** - SSR, SSG, ISR, and full-stack Next.js\n      applications\n- **Vue (3 agents)**\n    - **[Component Architect](agents/specialized/vue/vue-component-architect.md)** - Vue 3 Composition API and component\n      patterns\n    - **[Nuxt Expert](agents/specialized/vue/vue-nuxt-expert.md)** - SSR, SSG, and full-stack Nuxt applications\n    - **[State Manager](agents/specialized/vue/vue-state-manager.md)** - Pinia and Vuex state architecture\n- **NestJS (3 agents)**\n    - **[Backend Expert](agents/specialized/nestjs/nestjs-backend-expert.md)** - Enterprise NestJS with Fastify platform,\n      modules, dependency injection, and decorators\n    - **[Objection.js Expert](agents/specialized/nestjs/nestjs-objection-expert.md)** - Objection.js ORM, Knex migrations,\n      complex relations, and query optimization\n    - **[Microservices Expert](agents/specialized/nestjs/nestjs-microservices-expert.md)** - Distributed systems with Fastify,\n      RabbitMQ, Kafka, gRPC, and saga patterns\n- **AdonisJS (2 agents)**\n    - **[Backend Expert](agents/specialized/adonisjs/adonisjs-backend-expert.md)** - Comprehensive AdonisJS v6 development\n      with IoC container, service layer, and Lucid ORM\n    - **[ACL Expert](agents/specialized/adonisjs/adonisjs-acl-expert.md)** - Access control, RBAC, ABAC, and fine-grained\n      permission systems\n\n### :globe_with_meridians: Universal Experts (4 agents)\n\n- **[Backend Developer](agents/universal/backend-developer.md)** - Polyglot backend development across multiple\n  languages and frameworks\n- **[Frontend Developer](agents/universal/frontend-developer.md)** - Modern web technologies and responsive design for\n  any framework\n- **[API Architect](agents/universal/api-architect.md)** - RESTful design, GraphQL, and framework-agnostic API\n  architecture\n- **[Tailwind Frontend Expert](agents/universal/tailwind-css-expert.md)** - Tailwind CSS styling, utility-first\n  development, and responsive components\n\n### :wrench: Core Team (9 agents)\n\n- **[Code Archaeologist](agents/core/code-archaeologist.md)** - Explores, documents, and analyzes unfamiliar or legacy\n  codebases\n- **[Code Reviewer](agents/core/code-reviewer.md)** - Rigorous security-aware reviews with severity-tagged reports\n- **[Performance Optimizer](agents/core/performance-optimizer.md)** - Identifies bottlenecks and applies optimizations\n  for scalable systems\n- **[Documentation Specialist](agents/core/documentation-specialist.md)** - Crafts comprehensive READMEs, API specs, and\n  technical documentation\n- **[Intelligent Search Agent](agents/core/intelligent-search-agent.md)** - Semantic code discovery combining local and\n  AI-powered search\n- **[Multi-File Refactor](agents/specialized/multi-file-refactor.md)** - Atomic refactoring operations across entire\n  codebases\n- **[Batch File Processor](agents/specialized/batch-file-processor.md)** - High-volume file operations with parallel\n  processing\n- **[Code Migration Specialist](agents/specialized/code-migration-specialist.md)** - Framework and version migrations\n  with zero downtime\n- **[API Security \u0026 Pentest Expert](agents/specialized/security/api-security-pentest-expert.md)** - Defensive security\n  testing, OWASP Top 10, and vulnerability assessment\n\n**Total: 34 specialized agents** working together to build your projects!\n\n[Browse all agents →](agents/)\n\n## :sparkles: Features\n\n### Core Capabilities\n\n- **Specialized Expertise**: Each agent masters their domain with deep, current knowledge\n- **Real Collaboration**: Agents coordinate seamlessly, sharing context and handing off tasks\n- **Tailored Solutions**: Get code that matches your exact stack and follows its best practices\n- **Parallel Execution**: Multiple specialists work simultaneously for faster delivery\n\n### Advanced Features (v2.0)\n\n- **MultiEdit Operations**: Atomic changes across multiple files\n- **MCP Integration**: Exa semantic search and Ref documentation lookup\n- **Parallel Processing**: Execute independent operations concurrently\n- **Intelligent Routing**: Automatic agent selection based on task\n- **Progress Tracking**: Real-time status updates with checkpoints\n\n## :chart_with_upwards_trend: The Impact\n\n- **Ship Faster** - Complete features in minutes, not days\n- **Better Code Quality** - Every line follows best practices\n- **Learn As You Code** - See how experts approach problems\n- **Scale Confidently** - Architecture designed for growth\n\n## :books: Documentation\n\n- [Creating Custom Agents](docs/creating-agents.md) - Build specialists for your needs\n- [Best Practices](docs/best-practices.md) - Get the most from your AI team\n- [Multi-File Patterns](docs/multi-file-patterns.md) - Advanced patterns for large-scale operations\n- [Enhanced Agent Template](templates/enhanced-agent-template.md) - Optimized template for new agents\n\n## :speech_balloon: Join The Community\n\n- ⭐ **Star this repo** to show support\n- 🐛 [Report issues](https://github.com/gabrielmaialva33/claude-agents/issues)\n- 💡 [Share ideas](https://github.com/gabrielmaialva33/claude-agents/discussions)\n- 🎉 [Success stories](https://github.com/gabrielmaialva33/claude-agents/discussions/categories/show-and-tell)\n\n## :memo: License\n\nMIT License - Use freely in your projects!\n\n## :star: Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=gabrielmaialva33/claude-agents\u0026type=Date)](https://www.star-history.com/#gabrielmaialva33/claude-agents\u0026Date)\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eTransform Claude Code into an AI development team that ships production-ready features\u003c/strong\u003e\u003cbr\u003e\n  \u003cem\u003eSimple setup. Powerful results. Just describe and build.\u003c/em\u003e\n\u003c/p\u003e\n\n### :writing_hand: Author\n\n| [![Gabriel Maia](https://avatars.githubusercontent.com/u/26732067?size=100)](https://github.com/gabrielmaialva33) |\n|-------------------------------------------------------------------------------------------------------------------|\n| [Gabriel Maia](https://github.com/gabrielmaialva33)                                                               |\n\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/gabrielmaialva33/gabrielmaialva33/master/assets/gray0_ctp_on_line.svg?sanitize=true\" /\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003e\u0026copy; 2025-present \u003ca href=\"https://github.com/gabrielmaialva33/\" target=\"_blank\"\u003eMaia\u003c/a\u003e\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabrielmaialva33%2Fclaude-agents","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgabrielmaialva33%2Fclaude-agents","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabrielmaialva33%2Fclaude-agents/lists"}