Skip to content

Autonomous AI profile switching system for Claude Code - 5 specialized experts working as a team.

License

Notifications You must be signed in to change notification settings

werc/claude-code-agents

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🚀 Claude Code Agents - Autonomous AI Agent System

Transform Claude Code from a simple assistant into a team of 7 specialized AI agents working autonomously on your projects.

⚡ Quick Demo

You: "I need an e-shop"

Claude: [Master → Task → Search → Coding → Data → Master]  
Result: Complete e-commerce solution with autonomous profile switching

🎯 What This Is

A revolutionary system that gives you 7 specialized AI agents that automatically collaborate:

  • 🌐 Master - Universal coordinator and main communication hub
  • 📋 Task - Project management, planning & workflow orchestration
  • 🔍 Search - Advanced research & information gathering with Matrix Search™
  • 💻 Coding - Professional development, debugging & architecture
  • 📊 Data - Analytics, insights & data science workflows
  • ✍️ Copywriter - Marketing copy, conversion optimization & brand voice
  • 🎨 Design - UX/UI design, accessibility & user experience

Key Benefits:

  • Autonomous operation - Agents switch automatically based on task needs
  • Specialized expertise - Each agent is optimized for specific domains
  • Seamless collaboration - Agents work together without user intervention
  • Production-ready output - Professional-grade solutions from day one

📦 Installation (2 minutes)

Prerequisites

  • Claude Code installed (npm install -g @anthropic-ai/claude-code)
  • Linux/Mac/WSL environment

Quick Setup

  1. Clone this repository

    git clone https://github.com/kuzmany/claude-code-agents.git
    cd claude-code-agents
  2. Copy agent configurations to Claude directory

    mkdir -p ~/.claude
    cp agents/* ~/.claude/
  3. Start using

    claude --dangerously-skip-permissions

The system is ready! Agents will switch automatically as needed.

🎮 How to Use

The system operates through slash commands and autonomous agent switching:

Slash Commands (Manual Control)

/master      # Switch to universal coordinator agent
/search      # Switch to advanced research agent  
/task        # Switch to project management agent
/coding      # Switch to professional development agent
/data        # Switch to analytics & data science agent
/copywriter  # Switch to marketing copywriter agent
/design      # Switch to UX/UI design agent
/current     # Show currently active agent

Autonomous Operation

Simply describe your need - the system automatically:

  1. Analyzes requirements
  2. Switches to appropriate expert agents
  3. Collaborates between agents as needed
  4. Delivers complete solutions

🚀 Key Features

🧠 Matrix Search™ - Advanced 3-level research system

  • Level 1: Quick scan (0-3 seconds)
  • Level 2: Deep dive with cross-referencing
  • Level 3: Expert analysis with source verification

⚡ Autonomous Switching - No manual intervention needed

  • Task analysis triggers appropriate agent changes
  • Seamless handoffs between expert domains
  • Context preservation across switches

🔥 Specialized Agents - Each optimized for specific workflows

  • Search: Ultimate research tool with brutal honesty
  • Task: Project orchestration and quality control
  • Coding: Production-ready development practices
  • Data: Advanced analytics and visualization
  • Copywriter: Conversion-focused marketing copy and brand voice
  • Design: User-centered design and accessibility expertise

📚 Agent System Details

All documentation is contained in this README. The system includes:

  • 7 Specialized Agents - Each optimized for specific tasks
  • Autonomous Switching - Agents change automatically based on context
  • Matrix Search™ - Advanced research capabilities with source verification
  • Production Focus - Every output is ready for real-world implementation
  • Slash Commands - Manual agent control when needed

🔥 Example Workflows

Research & Analysis

User: "Analyze cryptocurrency market trends for 2025"
System: [Search] → [Data] → [Task] → [Master]
Result: Comprehensive market analysis with predictions

Software Development

User: "Create a todo app with React and TypeScript"
System: [Task] → [Coding] → [Search] → [Coding] → [Master]
Result: Production-ready application with best practices

Business Planning

User: "Help me plan a startup launch strategy"
System: [Search] → [Task] → [Data] → [Master]
Result: Complete go-to-market strategy with data backing

Marketing Campaign

User: "Create converting landing page copy for our SaaS product"
System: [Search] → [Copywriter] → [Design] → [Task] → [Master]
Result: High-converting landing page with optimized copy and UX design

Product Design

User: "Design a user-friendly mobile app interface"
System: [Search] → [Design] → [Copywriter] → [Coding] → [Master]
Result: Complete UI/UX design with microcopy and implementation guide

🛠️ System Architecture

The agents work together seamlessly:

User Request → Master Analysis → Expert Agent Selection → Task Execution → Results
     ↓              ↓                      ↓                    ↓           ↓
Autonomous     Understands       Switches to            Specialized    Complete
Operation      Requirements      Needed Expert         Execution      Solution

Agent Flow Examples:

  • Complex Research: Search → Data → Task → Master
  • Software Project: Task → Coding → Search → Coding → Master
  • Business Analysis: Search → Data → Task → Coding → Master
  • Marketing Campaign: Search → Copywriter → Design → Task → Master
  • Product Launch: Task → Design → Copywriter → Data → Master

💡 Core Philosophy

"Brutal honesty over polite uncertainty. Real solutions over theoretical perfection."

System Principles:

  • Autonomous operation - Agents switch without asking permission
  • Specialized expertise - Each agent masters one domain
  • Collaborative intelligence - Agents work together automatically
  • Production focus - Every output is ready for real-world use

🚀 Quick Start

# 1. Clone repository
git clone https://github.com/kuzmany/claude-code-agents.git
cd claude-code-agents

# 2. Install agent configurations  
mkdir -p ~/.claude
cp agents/* ~/.claude/

# 3. Start Claude Code
claude --dangerously-skip-permissions

🤝 Contributing & License


Created with ❤️ for the Claude Code community
Star this repo if it saves you time!

About

Autonomous AI profile switching system for Claude Code - 5 specialized experts working as a team.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published