✨ Why Claude Sub-Agents?

• 🧠 Specialized Intelligence: Each agent is an expert in its domain
• ⚡ Zero Configuration: Pre-built agents work out of the box
• 🎨 Fully Customizable: Create agents that match your workflow
• 🔄 Smart Context Management: Agents operate in isolated contexts
• 🛠️ Developer First: Built by developers, for developers
• 🔗 Context-Forge Integration: Seamlessly works with context-forge projects and PRPs

🎉 New in v1.4.0 - Context-Forge Integration

• 🛠️ Full Context-Forge Support: Automatic detection and smart integration
• 📦 Init Command: claude-agents init for one-command project setup
• 🧹 Uninstall Command: Bulk removal with cleanup options
• 📁 Smart Command Organization: No conflicts with existing context-forge commands
• ⚡ Concurrent Execution Rules: Enforces best practices for maximum performance
• 📝 CLAUDE.md Integration: Appends configuration without overwriting
• 🎯 PRP Awareness: Agents understand and work with your existing PRPs

🚀 Installation

NPM (Recommended)

npm install -g @webdevtoday/claude-agents

Yarn

yarn global add @webdevtoday/claude-agents

From Source

git clone https://github.com/webdevtodayjason/sub-agents.git
cd sub-agents
npm install
npm link

⚡ Quick Start

For New Projects

# Initialize all agents in your project
claude-agents init

# List available agents
claude-agents list

For Context-Forge Projects

# Initialize with context-forge awareness
claude-agents init --respect-context-forge

# Agents will:
# - Detect existing PRPs and CLAUDE.md
# - Place commands in .claude/commands/agents/
# - Append to CLAUDE.md without overwriting
# - Work alongside your existing setup

Example Agent Tasks

# Project Planning - Reads and understands your PRPs
claude-agents run project-planner --task "Create implementation roadmap from existing PRPs"
claude-agents run project-planner --task "Break down auth-prp into sprint tasks"

# API Development - PRP-aware implementation
claude-agents run api-developer --task "Implement user endpoints from feature-auth-prp.md"
claude-agents run api-developer --task "Create REST API following our conventions"

# Frontend Development
claude-agents run frontend-developer --task "Build login UI matching dark-theme-ui-prp"
claude-agents run frontend-developer --task "Create dashboard from feature-dashboard-prp.md"

# Testing & Quality
claude-agents run tdd-specialist --task "Create tests for authentication flow"
claude-agents run code-reviewer --task "Review API endpoints for security"
claude-agents run security-scanner --task "Scan authentication implementation"

# Documentation
claude-agents run api-documenter --task "Generate OpenAPI spec from implemented endpoints"
claude-agents run doc-writer --task "Update Implementation.md with progress"

# Debugging & Refactoring
claude-agents run debugger --task "Analyze login timeout issue"
claude-agents run refactor --task "Improve error handling in auth module"

# DevOps & Deployment
claude-agents run devops-engineer --task "Setup CI/CD for main branch"
claude-agents run devops-engineer --task "Create Docker configuration"

# Product & Marketing
claude-agents run product-manager --task "Create user stories from PRPs"
claude-agents run marketing-writer --task "Write feature announcement for auth system"

Using in Claude Code

# Via slash commands (in .claude/commands/agents/)
> /agent-review            # Triggers code review
> /agent-api              # Triggers API development
> /agent-debug login issue # Debug specific problem

# Via Task tool
> Task("project-planner: analyze all PRPs and create sprint plan")
> Task("api-developer: implement endpoints from feature-auth-prp.md")
> Task("frontend-developer: build UI from feature-dashboard-prp.md")

📋 Available Sub-Agents

| Agent Name | Description | Slash Command | |------------|-------------|---------------| | code-reviewer | Expert code review specialist for quality, security, and maintainability | /review | | test-runner | Automated test execution specialist that runs tests and fixes failures | /test [pattern] | | debugger | Expert debugging specialist for analyzing errors, stack traces, and fixing issues | /debug [error] | | refactor | Code refactoring specialist for improving code structure, patterns, and maintainability | /refactor [target] | | doc-writer | Documentation specialist for creating and updating technical documentation, API docs, and README files | /document [type] | | security-scanner | Security vulnerability scanner that detects common security issues and suggests fixes | /security-scan [path] | | shadcn-ui-builder | UI/UX specialist for designing and implementing interfaces using ShadCN UI components | /ui or /shadcn | | project-planner | Strategic planning specialist for project decomposition and workflow management | /plan [project] | | api-developer | Backend API development specialist for REST, GraphQL, and microservices | /api [spec] | | frontend-developer | Frontend development specialist for modern web applications | /frontend [feature] | | tdd-specialist | Test-Driven Development specialist for comprehensive testing strategies | /tdd [component] | | api-documenter | API documentation specialist for OpenAPI, Swagger, and technical docs | /apidoc [endpoint] | | devops-engineer | DevOps specialist for CI/CD, infrastructure automation, and deployment | /devops [task] | | product-manager | Product management specialist for requirements, roadmaps, and user stories | /product [feature] | | marketing-writer | Marketing content specialist for technical marketing and product messaging | /marketing [content] |

🤖 Detailed Agent Descriptions

🔍 Code Reviewer

Your personal code quality guardian

• Comprehensive security analysis
• Best practices enforcement
• Performance optimization suggestions
• Clean code principles

# Install
claude-agents install code-reviewer

# Use
> /review

🧪 Test Runner

Intelligent test automation specialist

• Auto-detects test frameworks
• Fixes failing tests automatically
• Improves test coverage
• Supports all major languages

# Install
claude-agents install test-runner

# Use
> /test
> /test src/**/*.test.js

🐛 Debugger

Expert problem solver and bug hunter

• Root cause analysis
• Stack trace interpretation
• Performance profiling
• Memory leak detection

# Install
claude-agents install debugger

# Use
> /debug Cannot read property 'map' of undefined

🔧 Refactor Assistant

Code transformation specialist

• Apply design patterns
• Modernize legacy code
• Improve code structure
• Maintain functionality

# Install
claude-agents install refactor

# Use
> /refactor improve performance
> /refactor apply SOLID principles

📝 Documentation Writer

Technical writing expert

• API documentation
• README generation
• Architecture docs
• Code comments

# Install
claude-agents install doc-writer

# Use
> /document API
> /document architecture

🔒 Security Scanner

Vulnerability detection specialist

• Secret detection
• OWASP compliance
• Dependency auditing
• Security best practices

# Install
claude-agents install security-scanner

# Use
> /security-scan
> /security-scan src/api/

🎨 ShadCN UI Builder

Your expert UI/UX implementation specialist

• Modern component-based UI development
• Accessibility-first design approach
• Responsive interface implementation
• ShadCN component ecosystem expertise
• Design system compliance

# Install
claude-agents install shadcn-ui-builder

# Use
> /ui create a login page
> /shadcn implement dashboard with sidebar

📋 Project Planner

Strategic planning and task decomposition expert

• Project architecture design
• Task breakdown and prioritization
• Dependency mapping
• Timeline estimation
• Risk as