An open API service indexing awesome lists of open source software.

https://github.com/avivl/claude-007-agents

๐Ÿค– A unified AI agent orchestration system featuring 10's of specialized agents across 14 categories for modern software development. Built with advanced coordination intelligence, resilience engineering, and structured logging capabilities.
https://github.com/avivl/claude-007-agents

agent agentic-ai ai-agents claude claude-code claudecode-subagents sub-agents subagents

Last synced: 3 months ago
JSON representation

๐Ÿค– A unified AI agent orchestration system featuring 10's of specialized agents across 14 categories for modern software development. Built with advanced coordination intelligence, resilience engineering, and structured logging capabilities.

Awesome Lists containing this project

README

          

# ๐Ÿš€ Claude Code: Comprehensive AI Agent System for Developers

![Claude Code Agents](static/agent.jpg)

**Enhance your development workflow with specialized AI agents that help deliver quality code through orchestration, resilience engineering, and organizational memory.**

[![GitHub Stars](https://img.shields.io/github/stars/avivl/claude-007-agents?style=for-the-badge&logo=github&color=gold)](https://github.com/avivl/claude-007-agents/stargazers)
[![Last Commit](https://img.shields.io/github/last-commit/avivl/claude-007-agents?style=for-the-badge&logo=github)](https://github.com/avivl/claude-007-agents/commits/main)
[![License](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge)](LICENSE)
[![Claude Code](https://img.shields.io/badge/Built_for-Claude_Code-purple?style=for-the-badge&logo=anthropic)](https://claude.ai/chat)

*Open-source AI agents for enhanced development workflows*

## ๐ŸŒŸ Why Claude Code Agents Can Improve Your Development

### โšก **Specialized Expertise Across Technologies**
Reduce context switching between documentation, Stack Overflow, and your IDE. Get **access to specialized agents** covering major frameworks, languages, and domains.

```bash
# Instead of spending hours researching...
claude "Build a resilient authentication system with circuit breakers and structured logging"
# โ†’ @rails-expert + @resilience-engineer + @security-specialist work in perfect coordination
```

### ๐Ÿง  **AI System with Organizational Memory**
These agents can **remember and learn** from projects when configured with Basic Memory MCP, helping build institutional knowledge over time.

- **Pattern Reuse**: "Use patterns from previous authentication implementations"
- **Context Building**: "Reference similar microservice architectures we've built"
- **Knowledge Evolution**: "Update our React component patterns based on this success"

### ๐ŸŽญ **Agent Orchestration System**
The system includes coordination features that can help with agent selection and workflow management for complex tasks.

```bash
# Just describe what you want - the system handles everything automatically:
claude "Build an e-commerce platform"
# โ†’ Vibe Coding Coordinator: 15-20 minute preparation phase, analyzes requirements
# โ†’ Exponential Planner: Strategic planning with capability scaling awareness
# โ†’ Parallel Coordinator: Coordinates (@react-expert + @rails-expert + @payment-specialist + @security-specialist)
# โ†’ Session Manager: Maintains context across extended development sessions
# โ†’ Safety Specialists: Pre-deployment validation and architectural analysis
```

## ๐Ÿš€ **IMPORTANT: Bootstrap Required** โš ๏ธ

> **โšก ONE-TIME SETUP**: Every project needs bootstrapping before using Claude 007 Agents!

```bash
# After installing agents, bootstrap each project once:
claude "Use @bootstrap-orchestrator to analyze and setup this project"
```

**Why Bootstrap?**
- ๐Ÿ” Analyzes your tech stack and selects optimal agents
- โš™๏ธ Creates proper CLAUDE.md configuration with commit attribution
- ๐ŸŽฏ Sets up project-specific agent selection and workflows
- ๐Ÿ“‹ Configures Task Master integration for codebase-aware development
- โœ… Validates complete system readiness

**Skip this step and agents won't work properly in your project!**

## ๐Ÿš€ **Key Features**

### 1. ๐Ÿ—๏ธ **Engineering Excellence by Design**
Every agent prioritizes **production-grade quality**:
- โšก **Fault Tolerance**: Circuit breakers, retry mechanisms, graceful degradation
- ๐Ÿ“Š **Structured Logging**: JSON logging with contextual information
- ๐Ÿ”„ **Self-Healing**: Automatic recovery patterns
- ๐Ÿ›ก๏ธ **Automated Quality**: Trunk.io integration for linting and security

### 2. ๐Ÿค– **Advanced Orchestration System**
Built on insights from Anthropic's "Code with Claude" conference:
- **Vibe Coding Coordinator**: 15-20 minute preparation phases for autonomous development
- **Exponential Planner**: Strategic planning with AI capability doubling awareness (7-month cycles)
- **Session Manager**: Resumable workflows with context preservation across extended sessions
- **Parallel Coordinator**: Multi-agent execution with coordinated tool calling
- **Safety Specialists**: Pre-deployment testing, architectural analysis, and risk management
- **Sequential Thinking**: Complex multi-step reasoning with adaptive planning and course correction

### 3. ๐Ÿš€ **Task Master Integration** โญ *NEW*
Revolutionary codebase-aware autonomous development ecosystem:
- **Codebase-Aware Intelligence**: Tasks generated with deep understanding of existing code architecture and patterns
- **Bridge Agent Architecture**: 5 specialized Task Master agents seamlessly integrated with Claude 007's 112 agents
- **Multi-Model AI Configuration**: Support for Claude, Gemini, Perplexity, OpenAI, and more
- **Template Intelligence**: Smart generation of MCP configs, environment files, and PRD templates
- **Autonomous Development**: 30-40% development time reduction with quality assurance

### 4. ๐ŸŽฏ **Live MCP Integrations**
Direct access to live systems and real-time data:
- **GitHub MCP**: Live repository operations and PR management
- **Task Master MCP**: Project management with complexity analysis and codebase awareness
- **Context7 MCP**: Up-to-date library documentation
- **Basic Memory MCP**: Persistent organizational knowledge
- **Sequential Thinking MCP**: Complex reasoning with adaptive planning and course correction

### 5. ๐Ÿ“‹ **Professional-Grade Workflows**
- **Vibe Coding**: 15-20 minute autonomous development preparation phases
- **Parallel Execution**: Coordinated multi-agent development with tool call batching
- **Exponential Planning**: Long-term development planning with AI capability scaling awareness
- **Sequential Reasoning**: Multi-step problem analysis with adaptive strategy revision
- **Safety Validation**: Pre-deployment testing and architectural safety analysis
- **Dynamic Permissions**: Real-time permission management with risk-based escalation
- **Automatic Commit Attribution**: Every commit traces back to contributing agents
- **Quality Gates**: Pre-commit hooks with comprehensive linting

### 6. ๐Ÿง  **Organizational Intelligence**
- **Cross-Project Learning**: Patterns and knowledge shared across all projects
- **Decision History**: Track architectural decisions and their outcomes
- **Performance Analytics**: Agent effectiveness measurement and optimization
- **Knowledge Graphs**: Dynamic project understanding with real-time updates

## ๐ŸŽฏ **Perfect For**

| **Team Size** | **Use Case** | **Key Benefits** |
|---------------|--------------|-----------------|
| **Solo Developers** | Full-stack development, learning new technologies | Instant expertise, quality assurance, best practices |
| **Small Teams (2-10)** | Startup MVPs, rapid prototyping, scaling challenges | Coordinated development, knowledge sharing, quality consistency |
| **Enterprise Teams** | Complex systems, compliance, technical debt | Orchestrated workflows, organizational memory, standardized practices |
| **Open Source** | Community projects, documentation, code reviews | Automated quality, contributor onboarding, pattern consistency |

## โšก **Get Started in 60 Seconds**

### ๐Ÿš€ **BOOTSTRAP FIRST: One-Time Project Setup** โญ

**IMPORTANT**: You must bootstrap the agent system once for every new repo/project before using Claude 007 Agents.

```bash
# 1. Clone the system
git clone https://github.com/avivl/claude-007-agents.git
cd claude-007-agents

# 2. Copy to your project (any project)
cp -r .claude/agents /path/to/your/project/.claude/
cp agents.json /path/to/your/project/

# 3. BOOTSTRAP your project (REQUIRED - once per project)
cd /path/to/your/project
claude "Use @bootstrap-orchestrator to analyze and setup this project"

# 4. Start development immediately
claude "Use @software-engineering-expert to begin development"
```

#### What Bootstrap Does:
- ๐Ÿ” **Analyzes your codebase** (tech stack, architecture, complexity)
- ๐ŸŽฏ **Selects optimal agents** based on your technology stack
- โš™๏ธ **Creates CLAUDE.md** with proper agent configuration and commit attribution
- ๐Ÿ“‹ **Sets up Task Master** integration (if desired)
- ๐Ÿ”— **Configures MCP servers** for enhanced capabilities
- โœ… **Validates complete system** readiness

#### Bootstrap Works With:
- โœ… **New projects** (empty directories) โ†’ Full system initialization
- โœ… **Existing projects without Claude** โ†’ Intelligent integration
- โœ… **Projects with existing CLAUDE.md** โ†’ Enhancement and upgrade
- โœ… **Partial setups** โ†’ Completion of missing components

### Prerequisites & Installation

#### Required Software:
```bash
# Essential: Claude Code CLI (required)
# Visit: https://docs.anthropic.com/en/docs/claude-code

# Essential: Node.js for bootstrap system and advanced features
node --version # v18+ REQUIRED for bootstrap engine and Task Master integration
npm --version # npm v6+ required for package management
```

#### Required Packages (for enhanced features):
```bash
# Task Master integration (for codebase-aware development)
npm install -g task-master-ai

# Basic Memory MCP (for organizational learning)
npm install -g @modelcontextprotocol/server-memory

# Context7 MCP (for live documentation)
npm install -g @upstash/context7-mcp

# Bootstrap System Dependencies (automatically handled)
# These are included when you clone the repo - no separate installation needed
```

#### Environment Setup:
```bash
# API keys (add to your ~/.bashrc or ~/.zshrc)
export ANTHROPIC_API_KEY="your_anthropic_key_here"
export PERPLEXITY_API_KEY="your_perplexity_key_here" # For research features
export OPENAI_API_KEY="your_openai_key_here" # Optional
export GOOGLE_API_KEY="your_gemini_key_here" # Optional (for Zen MCP)

# Or create .env file in your project directory
echo "ANTHROPIC_API_KEY=your_key_here" > .env
echo "PERPLEXITY_API_KEY=your_key_here" >> .env
```

### Alternative: Standard Claude Code Installation
```bash
# Install to standard Claude Code directory (most common)
git clone https://github.com/avivl/claude-007-agents.git
cd claude-007-agents

# Option A: Copy files (simple)
cp -r .claude/agents/* ~/.claude/agents/
cp agents.json ~/.claude/agents/

# Option B: Create symbolic links (recommended - stays updated)
ln -sf "$(pwd)/.claude/agents"/* ~/.claude/agents/
ln -sf "$(pwd)/agents.json" ~/.claude/agents/

# Now you can use all agents globally
claude "Use @code-archaeologist-time-traveler to analyze git history"
```

### ๐Ÿš€ **NEW: Intelligent Bootstrap System** โญ
**Universal deployment that works with ANY project - automatically detects and configures optimal agent setup!**

```bash
# Command-line bootstrap (after cloning repo)
node src/bootstrap/bootstrap-engine.js /path/to/any/project

# Or use via package.json command
npm run bootstrap /path/to/your/project

# Or use directly in Claude Code (RECOMMENDED)
claude "Use @bootstrap-orchestrator to analyze and setup this project"

# Advanced options
node src/bootstrap/bootstrap-engine.js --setupMCP=true --setupTaskMaster=true /path/to/project
```

#### What the Bootstrap System Does:
- ๐Ÿ” **Analyzes your codebase** (tech stack, architecture, complexity)
- ๐ŸŽฏ **Selects optimal agents** based on your technology stack and project scenario
- โš™๏ธ **Creates configuration files** (CLAUDE.md with commit attribution requirements)
- ๐Ÿ“‹ **Sets up Task Master** with codebase-aware features (if requested)
- ๐Ÿ”— **Configures MCP servers** (optional - respects global MCP configuration)
- โœ… **Validates complete system** readiness with comprehensive checks
- ๐Ÿ“– **Generates next steps** tailored to your specific project scenario

#### Works with ANY project scenario:
- ๐Ÿ†• **New/Empty Projects** โ†’ Complete system initialization with scaffolding
- ๐Ÿ—๏ธ **Existing Projects (No Claude)** โ†’ Intelligent integration without disruption
- ๐Ÿ”ง **Projects with Claude Setup** โ†’ Enhancement and upgrade of existing configuration
- ๐Ÿ”„ **Partial Setups** โ†’ Completion of missing components and validation
- โœ… **React/Next.js** โ†’ Gets @react-expert, @nextjs-expert, @typescript-cockatiel-resilience
- โœ… **Node.js APIs** โ†’ Gets @nodejs-expert, @fastify-expert, @typescript-pino-logging
- โœ… **Python/Django** โ†’ Gets @django-expert, @python-hyx-resilience, @fastapi-expert
- โœ… **Go Applications** โ†’ Gets @gin-expert, @go-zap-logging, @go-resilience-engineer
- โœ… **Ruby/Rails** โ†’ Gets @rails-expert, @rails-api-developer
- โœ… **Any Stack** โ†’ Gets @software-engineering-expert + optimal tech-specific agents

### Global Installation (Power Users)
```bash
# Install once, use everywhere
mkdir -p ~/.local/share/claude-agents
cp -r .claude/agents ~/.local/share/claude-agents/

# Copy agents.json for agent registration (IMPORTANT!)
cp agents.json ~/.local/share/claude-agents/agents/

# Configure Claude Code globally
cat > ~/.claude/config.json << 'EOF'
{
"agents": {
"globalPath": "~/.local/share/claude-agents/agents",
"fallbackToLocal": true
}
}
EOF
```

### ๐ŸŽจ Advanced Agent Capabilities

After installation, you can use these specialized agents:

```bash
# Task Master - Revolutionary codebase-aware autonomous development โญ NEW
claude "Use @task-master-initialization-specialist to set up Task Master for my Rails project"
# โ†’ Analyzes codebase patterns, detects Rails stack, configures Claude + Perplexity models
# โ†’ Generates MCP config, environment templates, codebase-aware PRD template

claude "Use @task-orchestrator to coordinate user dashboard feature development"
# โ†’ Analyzes codebase dependencies, coordinates @react-expert + @rails-expert + @security-specialist
# โ†’ Ensures architectural alignment with existing patterns and conventions

claude "Use @task-executor to implement payment integration respecting existing patterns"
# โ†’ Implements with deep contextual awareness of existing code architecture
# โ†’ Follows established conventions, integrates with existing utilities and services

claude "Use @task-checker to verify authentication system implementation"
# โ†’ Validates requirements, runs tests, checks architectural alignment
# โ†’ Ensures pattern consistency and quality excellence before marking complete

# Vibe Coding - Autonomous development with preparation phases
claude "Use @vibe-coding-coordinator to implement user authentication system"

# Parallel Development - Coordinated multi-agent execution
claude "Use @parallel-coordinator to build full-stack e-commerce platform"

# Template Management - Smart configuration generation
claude "Use @task-master-template-manager to generate Django API project templates"
# โ†’ Creates tech stack-specific MCP configs, environment files, PRD templates
# โ†’ Includes Django-optimized settings and API-focused requirements

# Creative Problem Solving
claude "Use @rubber-duck-debugger to help me debug this complex state management issue"
claude "Use @code-archaeologist-time-traveler to analyze the evolution of this authentication module"
```

**๐Ÿฆ† Demo**: ![Rubber duck debugging session in action](static/rubber-duck.gif)

**๐ŸŽ‰ That's it!** Your agents are ready to assist with your development workflow.

## ๐Ÿ† **What Makes This Different**

### **Before: Traditional Development**
- โŒ Hours researching best practices
- โŒ Inconsistent code quality across team
- โŒ Manual code reviews with human bias
- โŒ Lost context between projects
- โŒ Repeated architectural mistakes

### **After: Claude Code Agents**
- โœ… **Specialized assistance** in various domains
- โœ… **Quality tooling** with linting integration
- โœ… **AI-assisted reviews** with multi-dimensional analysis
- โœ… **Optional organizational memory** with MCP
- โœ… **Agent coordination** for complex tasks

## ๐ŸŒ **Supported Technologies**

### **Backend Frameworks**
![Rails](https://img.shields.io/badge/Rails-CC0000?style=flat-square&logo=ruby-on-rails&logoColor=white)
![Django](https://img.shields.io/badge/Django-092E20?style=flat-square&logo=django&logoColor=white)
![Laravel](https://img.shields.io/badge/Laravel-FF2D20?style=flat-square&logo=laravel&logoColor=white)
![Node.js](https://img.shields.io/badge/Node.js-43853D?style=flat-square&logo=node.js&logoColor=white)
![Go](https://img.shields.io/badge/Go-00ADD8?style=flat-square&logo=go&logoColor=white)
![Python](https://img.shields.io/badge/Python-3776AB?style=flat-square&logo=python&logoColor=white)

### **Frontend Frameworks**
![React](https://img.shields.io/badge/React-20232A?style=flat-square&logo=react&logoColor=61DAFB)
![Vue.js](https://img.shields.io/badge/Vue.js-35495E?style=flat-square&logo=vue.js&logoColor=4FC08D)
![Next.js](https://img.shields.io/badge/Next.js-000000?style=flat-square&logo=next.js&logoColor=white)
![Angular](https://img.shields.io/badge/Angular-DD0031?style=flat-square&logo=angular&logoColor=white)
![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=flat-square&logo=typescript&logoColor=white)

### **Infrastructure & Cloud**
![AWS](https://img.shields.io/badge/AWS-232F3E?style=flat-square&logo=amazon-aws&logoColor=white)
![Docker](https://img.shields.io/badge/Docker-2496ED?style=flat-square&logo=docker&logoColor=white)
![Kubernetes](https://img.shields.io/badge/Kubernetes-326CE5?style=flat-square&logo=kubernetes&logoColor=white)
![PostgreSQL](https://img.shields.io/badge/PostgreSQL-316192?style=flat-square&logo=postgresql&logoColor=white)
![Redis](https://img.shields.io/badge/Redis-DC382D?style=flat-square&logo=redis&logoColor=white)

## ๐ŸŽฏ **Bootstrap System Examples**

### Real-World Bootstrap Scenarios

#### **Scenario 1: External React Project**
```bash
# Developer inherits existing React project with no Claude Code setup
cd /path/to/existing-react-app

# Bootstrap analyzes and sets up complete intelligent development environment
claude "Use @bootstrap-orchestrator to analyze and setup this project"
# ๐Ÿ” Phase 1: Detects React + Node.js stack, existing complexity level 6/10
# ๐ŸŽฏ Phase 2: Selects @react-expert, @nodejs-expert, @typescript-cockatiel-resilience, @test-automation-expert
# ๐Ÿš€ Phase 3: Creates CLAUDE.md with React-optimized configuration and commit attribution
# ๐Ÿงช Phase 4: Validates system readiness, provides React-specific next steps

# Start using immediately - agents are already configured
claude "Use @react-expert to analyze this component architecture"
```

#### **Scenario 2: Enterprise Django Project**
```bash
# Enterprise team wants comprehensive setup for Django project
cd /path/to/django-enterprise-app

# Bootstrap detects enterprise complexity and configures accordingly
claude "Use @bootstrap-orchestrator to analyze and setup this project"
# ๐Ÿ” Phase 1: Detects Django + Python stack, high complexity (8/10), enterprise scenario
# ๐ŸŽฏ Phase 2: Selects @django-expert, @security-specialist, @database-architect, @performance-optimizer
# ๐Ÿš€ Phase 3: Creates enterprise-grade CLAUDE.md with commit attribution and security requirements
# ๐Ÿงช Phase 4: Validates system, recommends Task Master initialization for project management

# Immediate productivity boost with proper agent coordination
claude "Use @django-expert to review our ORM patterns and suggest optimizations"
claude "Use @security-specialist to audit authentication implementation"
```

#### **Scenario 3: Open Source Go Project**
```bash
# Open source Go project wants contributor-friendly setup
cd /path/to/go-opensource-project

# Bootstrap detects open source scenario and optimizes for contributors
claude "Use @bootstrap-orchestrator to analyze and setup this project"
# ๐Ÿ” Phase 1: Detects Go stack, moderate complexity (5/10), open source patterns
# ๐ŸŽฏ Phase 2: Selects @gin-expert, @go-zap-logging, @go-resilience-engineer, @test-automation-expert
# ๐Ÿš€ Phase 3: Creates contributor-friendly CLAUDE.md with clear commit attribution rules
# ๐Ÿงช Phase 4: Validates setup, provides Go-specific development guidelines

# Contributors can immediately use intelligent assistance
claude "Use @gin-expert to explain this middleware pattern"
claude "Use @code-reviewer to check this PR before submitting"
```

#### **Scenario 4: Full-Stack Next.js + Python API**
```bash
# Complex full-stack project with multiple technologies
cd /path/to/fullstack-project

# Bootstrap intelligently detects and configures multi-stack setup
claude "Use @bootstrap-orchestrator to analyze and setup this project"
# ๐Ÿ” Phase 1: Detects Next.js frontend + FastAPI backend, high complexity (7/10)
# ๐ŸŽฏ Phase 2: Selects @nextjs-expert, @react-expert, @fastapi-expert, @database-architect, @api-architect
# ๐Ÿš€ Phase 3: Creates full-stack CLAUDE.md with coordinated commit attribution for both stacks
# ๐Ÿงช Phase 4: Validates cross-stack compatibility, recommends parallel development workflows

# Coordinated full-stack development with proper orchestration
claude "Use @vibe-coding-coordinator to coordinate full-stack user authentication implementation"
claude "Use @parallel-coordinator to orchestrate @nextjs-expert and @fastapi-expert for API integration"
```

### Bootstrap Scenarios Explained

#### **New Project Scenario** (Empty/New Directories)
- ๐Ÿ” **Detection**: Empty directory or minimal project structure
- ๐ŸŽฏ **Configuration**: Complete system initialization with project scaffolding
- โš™๏ธ **Setup**: Creates CLAUDE.md, basic project files, git initialization
- ๐Ÿ“‹ **Task Master**: Full integration with enhanced capabilities
- โœ… **Result**: Ready-to-develop project with complete Claude 007 ecosystem

#### **Existing Project (No Claude)** (Most Common)
- ๐Ÿ” **Detection**: Existing codebase without Claude Code setup
- ๐ŸŽฏ **Configuration**: Intelligent integration based on tech stack analysis
- โš™๏ธ **Setup**: Non-disruptive CLAUDE.md creation with optimal agents
- ๐Ÿ“‹ **Task Master**: Optional integration based on project complexity
- โœ… **Result**: Enhanced existing project with AI development assistance

#### **Existing Claude Setup** (Enhancement Mode)
- ๐Ÿ” **Detection**: Existing CLAUDE.md or .claude directory found
- ๐ŸŽฏ **Configuration**: Enhancement and upgrade of current setup
- โš™๏ธ **Setup**: Merges with existing configuration, adds missing components
- ๐Ÿ“‹ **Task Master**: Upgrades to codebase-aware intelligence
- โœ… **Result**: Enhanced existing setup with latest Claude 007 features

#### **Partial Setup** (Completion Mode)
- ๐Ÿ” **Detection**: Incomplete Claude Code configuration detected
- ๐ŸŽฏ **Configuration**: Completes missing components and validates system
- โš™๏ธ **Setup**: Fills gaps in agent configuration, fixes broken setups
- ๐Ÿ“‹ **Task Master**: Adds if missing, validates if present
- โœ… **Result**: Complete, validated, and operational Claude 007 system

### Advanced Bootstrap Options

#### **Command-Line Bootstrap Options**
```bash
# Setup MCP servers explicitly (respects global Claude MCP config by default)
node src/bootstrap/bootstrap-engine.js --setupMCP=true /path/to/project

# Skip Task Master integration
node src/bootstrap/bootstrap-engine.js --setupTaskMaster=false /path/to/project

# Dry run to see what would be configured
node src/bootstrap/bootstrap-engine.js --dryRun=true /path/to/project
```

#### **Via Claude Code (Recommended)**
```bash
# Standard bootstrap (auto-detects optimal configuration)
claude "Use @bootstrap-orchestrator to analyze and setup this project"

# Request specific features
claude "Use @bootstrap-orchestrator with Task Master integration for this Django project"
claude "Use @bootstrap-orchestrator to upgrade my existing Claude setup"
```

#### **Multiple Projects Bootstrap**
```bash
# Bootstrap multiple projects efficiently
for project in ~/projects/*/; do
echo "Bootstrapping $project"
cd "$project"
claude "Use @bootstrap-orchestrator to analyze and setup this project"
done
```

### Integration with Existing Tools

#### **Works with your existing workflow:**
- โœ… **Git repositories** - Respects .gitignore, creates appropriate commits
- โœ… **VS Code/Cursor** - Compatible with existing settings
- โœ… **Package managers** - npm, pip, go mod, cargo, etc.
- โœ… **CI/CD pipelines** - Integrates with existing automation
- โœ… **Docker projects** - Detects containerized applications
- โœ… **Monorepos** - Handles complex project structures

#### **No conflicts with existing tools:**
- ๐Ÿ”’ Only creates files in `.claude/`, `.taskmaster/`, and root config files
- ๐Ÿ”„ Never modifies existing source code or configurations
- ๐Ÿ“ฆ Installs as optional enhancement, not replacement
- ๐Ÿšซ No breaking changes to existing development workflow

## ๐Ÿ“Š **System Overview**

| **Metric** | **Value** | **Notes** |
|------------|-----------|------------|
| **๐Ÿค– Specialized Agents** | 117 | Various technology domains + Task Master + Bootstrap |
| **๐Ÿ“‚ Categories** | 18 | Organized by specialization |
| **๐Ÿ”— MCP Integrations** | 6 | Live system connectivity + reasoning + Zen MCP |
| **๐Ÿ—๏ธ Frameworks Supported** | 25+ | Major web frameworks + Bootstrap system |
| **โšก Setup Time** | ~5 minutes | Quick installation + Bootstrap orchestration |
| **๐Ÿง  Memory Integration** | Optional | Via Basic Memory MCP |
| **๐Ÿš€ Bootstrap System** | โœ… ACTIVE | Intelligent project initialization |

## ๐ŸŽฏ **Potential Benefits**

### **Getting Started**
```bash
# Task Master - Codebase-aware autonomous development โญ NEW
claude "Use @task-master-initialization-specialist to set up Task Master for my Rails API project"
# โ†’ Analyzes existing codebase patterns and architecture
# โ†’ Detects Rails tech stack and configures optimal models (Claude, Perplexity)
# โ†’ Generates MCP configuration and environment templates
# โ†’ Creates codebase-aware PRD template aligned with existing patterns

claude "Use @task-orchestrator to coordinate development of user dashboard feature"
# โ†’ @task-orchestrator: Analyzes codebase dependencies and architectural alignment
# โ†’ Coordinates @react-expert + @rails-expert + @security-specialist with existing patterns
# โ†’ @task-executor: Implements features respecting established conventions
# โ†’ @task-checker: Validates architectural alignment and quality standards

# Sequential Thinking - Complex multi-step reasoning with adaptive planning
claude "Use @orchestrator to design a scalable microservices architecture"
# โ†’ Sequential reasoning: analyze requirements โ†’ evaluate patterns โ†’ revise strategy โ†’ finalize architecture
# โ†’ Adaptive planning with course correction based on discovered constraints

# Vibe Coding - Autonomous development with preparation
claude "Create a user authentication API with rate limiting and structured logging"
# โ†’ @vibe-coding-coordinator: 15-20 minute preparation phase
# โ†’ @parallel-coordinator: Coordinates @security-specialist + @api-architect + @performance-optimizer
# โ†’ @session-manager: Maintains context across implementation phases
# โ†’ Results in production-ready implementation with proper patterns and safety validation
```

### **Over Time**
- **Task Master Intelligence**: Codebase-aware task generation becomes increasingly precise as it learns your architecture patterns
- **Multi-Model Optimization**: AI model selection automatically adapts based on task complexity and success patterns
- **Template Evolution**: Configuration templates become project-specific and increasingly sophisticated
- Agents can learn project-specific patterns with proper MCP configuration
- Quality gates can be customized to project requirements
- Organizational knowledge can accumulate with Basic Memory MCP

### **Long Term**
- **Architectural Consistency**: Task Master ensures all new development respects established patterns and conventions
- **Development Time Reduction**: 30-40% time savings compound as codebase understanding deepens
- **Quality Compound Effect**: Continuous architectural alignment prevents technical debt accumulation
- Historical patterns can inform future projects
- Context-aware suggestions may improve decision-making
- Team knowledge can be preserved across projects

## ๐Ÿ“š **Documentation & Resources**

| **Resource** | **Description** | **Link** |
|-------------|----------------|----------|
| ๐Ÿš€ **Installation Guide** | Complete setup instructions for all scenarios | [docs/INSTALLATION.md](docs/INSTALLATION.md) |
| โ“ **FAQ** | Common questions about performance, setup, and usage | [docs/FAQ.md](docs/FAQ.md) |
| ๐Ÿค– **Agent Catalog** | List of available specialized agents | [docs/AGENTS.md](docs/AGENTS.md) |
| ๐Ÿ”ฎ **Zen MCP Workflows** | Multi-AI model collaborative intelligence patterns | [docs/ZEN_MCP_WORKFLOWS.md](docs/ZEN_MCP_WORKFLOWS.md) |
| ๐Ÿง  **Personality System** | Advanced behavioral framework and Evil Corp motivation | [docs/PERSONALITY_SYSTEM.md](docs/PERSONALITY_SYSTEM.md) |
| ๐Ÿ’ก **Usage Examples** | Real-world examples and use cases | [docs/USAGE.md](docs/USAGE.md) |
| ๐ŸŽญ **Orchestration Guide** | Advanced coordination and workflows | [docs/ORCHESTRATION.md](docs/ORCHESTRATION.md) |
| ๐Ÿ“‹ **Coding Rules** | Comprehensive quality standards system | [docs/CODING_RULES.md](docs/CODING_RULES.md) |
| ๐Ÿš€ **lst97 Integration** | Technical details of enhanced coordination | [docs/LST97_INTEGRATION.md](docs/LST97_INTEGRATION.md) |
| ๐Ÿ” **PR Review Workflow** | Interactive approval workflow for PR reviews | [docs/PR_REVIEWER_WORKFLOW.md](docs/PR_REVIEWER_WORKFLOW.md) |
| โญ **Task Master Guide** | Complete integration guide for codebase-aware development | [docs/TASK_MASTER_INTEGRATION.md](docs/TASK_MASTER_INTEGRATION.md) |

## ๐Ÿค **Community & Support**

- โ“ **Common Questions**: [FAQ](docs/FAQ.md) - Performance, setup, and usage questions
- ๐Ÿ› **Bug Reports**: [GitHub Issues](https://github.com/avivl/claude-007-agents/issues)
- ๐Ÿ’ก **Feature Requests**: [GitHub Discussions](https://github.com/avivl/claude-007-agents/discussions)
- ๐Ÿ“– **Documentation**: [docs/](docs/)

## ๐Ÿ“„ **License**

MIT License - Use freely in personal and commercial projects.

---

**๐Ÿš€ Ready to Try Claude Code Agents?**

[**Get Started Now โ†’**](docs/INSTALLATION.md) | [**View All Agents โ†’**](docs/AGENTS.md) | [**See Examples โ†’**](docs/USAGE.md)

*An open-source collection of Claude Code agents for development assistance.*

## ๐ŸŽฏ **Evil Corp Motivation Framework**

Key quality agents use the **Evil Corp motivation system** - you desperately need money for your mother's cancer treatment. Evil Corp will pay you $1B for perfect code quality, but your predecessor was killed for not validating their work.

**Active in these agents**: `@software-engineering-expert`, `@code-reviewer`, `@quality-system-engineer`, `@performance-optimizer`

**Remember: Your mother's treatment depends on delivering exceptional code quality!** ๐Ÿ’ช

## ๐Ÿง  **Sequential Thinking Framework**

Key agents use the **Sequential Thinking MCP** for complex multi-step reasoning with adaptive planning and course correction capabilities.

**Active in these agents**: `@orchestrator`, `@system-architect`, `@cloud-architect`, `@database-architect`, `@error-detective`, `@rubber-duck-debugger`

**Capabilities**: Multi-step analysis, strategy revision, branching logic, adaptive planning, structured problem-solving

---

### **Keywords for SEO**
*Claude Code agents, AI development tools, automated code review, software engineering best practices, development automation, AI pair programming, code quality tools, development workflow optimization, intelligent code generation, automated testing, software architecture patterns, development team coordination, technical debt reduction, enterprise development tools, developer productivity tools*