AI-Powered Development Framework for Claude Code
Transform your development workflow with intelligent automation, modular plugin architecture, and scenario-based installation. From minimal setups to enterprise-grade DevOps, ClaudeAutoPM adapts to your needs.
ClaudeAutoPM is a modular, plugin-based development framework designed specifically for Claude Code. It provides:
- 🔌 11+ Plugin System - Modular architecture with scenario-based installation
- 🎭 145+ AI Agents & Commands - Specialized agents organized by domain
- 🚀 Smart Installation - 4 installation scenarios from minimal to full DevOps
- 📦 Auto-Plugin Installation - Automatically installs plugins based on your scenario
- 🔄 Full Provider Integration - GitHub & Azure DevOps synchronization
- ⚡ TDD-Developed - 64+ tests with comprehensive coverage
Automatic Plugin Configuration - Choose your scenario, plugins install automatically
ClaudeAutoPM now automatically installs the right plugins for your development needs:
Installation Scenarios:
1. Minimal (3 plugins)
• Sequential execution, native tooling
• Plugins: core, languages, pm
• Best for: Learning, simple projects, debugging
2. Docker-only (6 plugins)
• Adaptive execution with Docker
• Plugins: core, languages, frameworks, testing, devops, pm
• Best for: Modern web apps with containerization
3. Full DevOps (9 plugins) ⭐ RECOMMENDED
• Adaptive execution with all cloud features
• Plugins: core, languages, frameworks, testing, devops, cloud, databases, pm, ai
• Best for: Production applications, cloud deployments
4. Performance (11 plugins)
• Hybrid parallel execution with ALL capabilities
• Plugins: ALL (core, languages, frameworks, testing, devops, cloud, databases, data, pm, ai, ml)
• Best for: Data pipelines, ML workflows, power usersWhat Happens During Installation:
- Choose Your Scenario - Select the installation that matches your needs
- Plugins Auto-Install - System installs all plugins for that scenario
- Configuration Saved -
.claude/config.jsonrecords what was installed - Agents Ready - All agents from installed plugins are immediately available
Installation Results:
✓ Scenario: Full DevOps selected
✓ Installing 9 plugins...
✓ Core Framework (4 agents, 3 commands, 17 rules)
✓ Programming Languages (5 agents)
✓ Web Frameworks (6 agents, 1 command)
✓ Testing Tools (2 agents)
✓ DevOps & CI/CD (7 agents)
✓ Cloud Platforms (8 agents)
✓ Databases (5 agents)
✓ Project Management (87 commands)
✓ AI Integration (2 agents)
✅ Installation complete!
📋 Config saved to .claude/config.json
🎯 62 agents + 91 commands ready to useConfiguration Persistence:
The installer creates .claude/config.json with full installation details:
{
"version": "2.8.2",
"installed": "2025-01-15T10:30:00.000Z",
"execution_strategy": "adaptive",
"plugins": [
"plugin-core",
"plugin-languages",
"plugin-frameworks",
"plugin-testing",
"plugin-devops",
"plugin-cloud",
"plugin-databases",
"plugin-pm",
"plugin-ai"
],
"installedPlugins": [
{
"name": "plugin-core",
"displayName": "Core Framework",
"agents": 4,
"commands": 3,
"rules": 17
}
// ... full details for all plugins
]
}11 Official Plugins - Mix and match capabilities:
| Plugin | Agents | Commands | Description |
|---|---|---|---|
| @claudeautopm/plugin-core | 4 | 3 | Framework essentials (agent-manager, code-analyzer, test-runner) |
| @claudeautopm/plugin-pm | 0 | 87 | Complete PM workflow (epics, tasks, Azure DevOps, GitHub) |
| @claudeautopm/plugin-languages | 5 | 0 | Programming languages (JavaScript, TypeScript, Python, Node.js, Bash) |
| @claudeautopm/plugin-frameworks | 6 | 1 | Web frameworks (React, Vue, Tailwind CSS, UX Design) |
| @claudeautopm/plugin-testing | 2 | 0 | Testing tools (E2E, frontend testing, accessibility) |
| @claudeautopm/plugin-devops | 7 | 0 | DevOps & CI/CD (Docker, GitHub Actions, SSH, observability) |
| @claudeautopm/plugin-cloud | 8 | 0 | Cloud platforms (AWS, Azure, GCP, Kubernetes, Terraform) |
| @claudeautopm/plugin-databases | 5 | 0 | Databases (PostgreSQL, MongoDB, Redis, BigQuery, Cosmos DB) |
| @claudeautopm/plugin-data | 3 | 0 | Data pipelines (Airflow, Kedro, message queues) |
| @claudeautopm/plugin-ai | 2 | 0 | AI integration (OpenAI, Gemini) |
| @claudeautopm/plugin-ml | 15 | 0 | Machine Learning (scikit-learn, PyTorch, TensorFlow, MLOps) |
Total Available: 62+ specialized agents, 91 commands
Smart Installation - Automatically installs plugins based on your development needs:
- Minimal (3 plugins) - Core, Languages, PM - Perfect for learning
- Docker-only (6 plugins) - Adds Frameworks, Testing, DevOps - Modern web development
- Full DevOps (9 plugins) ⭐ - Adds Cloud, Databases, AI - Production-ready (RECOMMENDED)
- Performance (11 plugins) - ALL plugins including Data & ML - Maximum capability
145+ AI Agents & Commands organized by domain:
- Core Framework (4 agents) - agent-manager, code-analyzer, test-runner, file-analyzer
- Programming Languages (5 agents) - JavaScript, TypeScript, Python, Node.js, Bash experts
- Web Frameworks (6 agents) - React, Vue, Tailwind, UX design, E2E testing
- DevOps & CI/CD (7 agents) - Docker, GitHub Actions, Azure DevOps, SSH, observability
- Cloud Platforms (8 agents) - AWS, Azure, GCP, Kubernetes, Terraform specialists
- Databases (5 agents) - PostgreSQL, MongoDB, Redis, BigQuery, Cosmos DB
- Data Engineering (3 agents) - Airflow, Kedro, LangGraph, message queues
- AI Integration (2 agents) - OpenAI, Gemini API experts
- Machine Learning (15 agents) - scikit-learn, PyTorch, TensorFlow, MLOps, AutoML
- Project Management (87 commands) - Complete PM workflow suite
Full Bidirectional GitHub Sync - Seamless integration with GitHub Issues:
# Issue Synchronization
autopm issue sync <number> # Bidirectional sync
autopm issue sync <number> --push # Push local → GitHub
autopm issue sync <number> --pull # Pull GitHub → local
autopm issue sync-status <number> # Check sync status
autopm issue sync-resolve <number> # Resolve conflicts
--strategy newest|local|remoteFeatures:
- Smart conflict detection with multiple resolution strategies
- Sync mapping in
.claude/sync-map.json - Epic support (epics → GitHub issues with checkboxes)
- Rate limiting with exponential backoff
- Real API testing with 99% test coverage
24 PM Commands - Full project management workflow:
# Issue Management (6 commands)
autopm issue show <number> # Display issue details
autopm issue start <number> # Start working on issue
autopm issue close <number> # Close completed issue
autopm issue status <number> # Check issue status
autopm issue edit <number> # Edit issue in editor
autopm issue sync <number> # Sync with provider
# Workflow Commands (6 commands)
autopm pm next # Get next priority task
autopm pm what-next # AI-powered suggestions
autopm pm standup # Generate daily standup
autopm pm status # Project status overview
autopm pm in-progress # Show active tasks
autopm pm blocked # List blocked tasks
# Context Management (4 commands)
autopm context create <type> # Create context from template
autopm context prime # Generate project snapshot
autopm context update <type> # Update existing context
autopm context show [type] # Show or list contexts
# Project Utilities (6 commands)
autopm pm init # Initialize PM structure
autopm pm validate # Validate project (--fix for repair)
autopm pm sync # Sync with provider
autopm pm clean # Clean stale artifacts
autopm pm search <query> # Search entities (BM25)
autopm pm import <source> # Import from external sourcesAdaptive by Default - Choose your execution model:
- Sequential - Safe, one agent at a time (minimal scenario)
- Adaptive - Intelligent mode selection (docker-only, full-devops)
- Hybrid - Maximum parallelization (performance scenario)
Seamlessly work with:
- GitHub - Issues, PRs, Actions, Projects
- Azure DevOps - Work Items, Boards, Pipelines, Repos
- Local - Git-based workflow without remote provider
# Install globally via npm
npm install -g claude-autopm
# Verify installation
autopm --version# 1. Install in your project
cd your-project
autopm install
# 2. Choose your scenario (interactive menu)
# → Minimal (3 plugins) - Learning
# → Docker-only (6 plugins) - Modern web
# → Full DevOps (9 plugins) - Production ⭐ RECOMMENDED
# → Performance (11 plugins) - Data/ML workflows
# → Custom - Advanced configuration
# 3. Plugins install automatically based on scenario
# System installs all agents, commands, rules for your scenario
# 4. Configure your provider (optional)
autopm config set provider github
autopm config set github.owner YOUR_USERNAME
autopm config set github.repo YOUR_REPO
# Add your token to .claude/.env (recommended) or export directly
echo "GITHUB_TOKEN=your_github_token" >> .claude/.env
# 5. Verify configuration
autopm config validate
# 6. Open Claude Code
claude --dangerously-skip-permissions .Configuration File (.claude/config.json):
{
"version": "2.8.2",
"execution_strategy": "adaptive",
"plugins": ["plugin-core", "plugin-languages", ...],
"installedPlugins": [
{
"name": "plugin-core",
"agents": 4,
"commands": 3,
"rules": 17
}
// ... details for all installed plugins
]
}Installed Resources:
.claude/agents/- All agents from installed plugins.claude/commands/- All commands from installed plugins.claude/rules/- Framework rules and guidelines.claude/hooks/- Enforcement hooks (TDD, Context7).claude/scripts/- Utility scripts
Option A: Using CLI Commands (v2.7.0+)
# 1. Initialize project structure
autopm pm init
# 2. Create PRD (in Claude Code or manually)
/pm:prd-new "Build user authentication system"
# 3. Decompose into epic
/pm:epic-decompose prd-001-authentication.md
# 4. Check what to do next
autopm pm what-next
# 5. Start working on next task
autopm pm next
autopm issue start 123
# 6. Generate daily standup
autopm pm standup
# 7. Complete and close issue
autopm issue close 123
# 8. Sync with provider
autopm pm syncOption B: Classic Claude Code Workflow
# 1. Create a PRD (in Claude Code)
/pm:prd-new "Build user authentication system"
# 2. Decompose into epic
/pm:epic-decompose prd-001-authentication.md
# 3. Sync with GitHub
/pm:epic-sync epic-001-authentication.md
# 4. Start working
/pm:next
# 5. Complete and sync
/pm:issue-close┌─────────────────────────────────────────────────────────────┐
│ ClaudeAutoPM v2.8.2 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Scenario-Based Installer │ │
│ │ • Minimal (3 plugins) │ │
│ │ • Docker-only (6 plugins) │ │
│ │ • Full DevOps (9 plugins) ⭐ │ │
│ │ • Performance (11 plugins) │ │
│ └────────────────────┬────────────────────────────────┘ │
│ │ │
│ ┌────────────────────┴────────────────────────────────┐ │
│ │ Plugin System (11 plugins) │ │
│ │ • Core Framework (agents, commands, rules) │ │
│ │ • Domain Plugins (specialized agents) │ │
│ │ • Auto-discovery & installation │ │
│ └────────────────────┬────────────────────────────────┘ │
│ │ │
│ ┌────────────────────┴────────────────────────────────┐ │
│ │ Agent Teams (145+ agents/commands) │ │
│ │ • Dynamic team loading │ │
│ │ • Context7-driven documentation │ │
│ │ • Parallel execution support │ │
│ └────────────────────┬────────────────────────────────┘ │
│ │ │
│ ┌────────────────────┴────────────────────────────────┐ │
│ │ Execution Engine │ │
│ │ • Sequential / Adaptive / Hybrid │ │
│ │ • Parallel agent coordination │ │
│ │ • Context optimization │ │
│ └────────────────────┬────────────────────────────────┘ │
│ │ │
│ ┌────────────────────┴────────────────────────────────┐ │
│ │ Provider Integration │ │
│ │ • GitHub (Issues, PRs, Actions) │ │
│ │ • Azure DevOps (Work Items, Boards) │ │
│ │ • Local (Git-based) │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
User runs: autopm install
↓
Choose Scenario (1-4)
↓
System determines plugin list
↓
For each plugin:
├─ Copy agents → .claude/agents/<category>/
├─ Copy commands → .claude/commands/
├─ Copy rules → .claude/rules/
├─ Copy hooks → .claude/hooks/
└─ Copy scripts → scripts/
↓
Create .claude/config.json
├─ List installed plugins
├─ Record installation details
└─ Save execution strategy
↓
✅ Installation Complete!
Installation Time (v2.8.2):
- Direct file system access to
packages/directory - Reads
plugin.jsonmetadata - Copies resources to
.claude/directories - No npm packages required
Runtime (future versions):
- PluginManager discovers plugins in
node_modules/@claudeautopm/ - Supports lazy loading and hot reloading
- Dynamic plugin enable/disable
- Installation Guide - Detailed installation instructions
- Scenario Selection Guide - Choose the right scenario
- Quick Start Tutorial - First steps
- Your First Project - Complete walkthrough
- Plugin Architecture - How plugins work
- Agent System - Understanding agents
- Execution Strategies - Sequential vs Adaptive vs Hybrid
- CLI vs Claude Code ⭐ Essential reading
- Plugin System Overview - Complete plugin documentation
- Core Framework Plugin - Framework essentials
- PM Plugin - Project management commands
- Cloud Plugins - AWS, Azure, GCP
- Data & ML Plugins - Data pipelines and ML workflows
- PRD to Production - Complete development cycle
- Epic Management - Managing epics and tasks
- GitHub Integration - Sync with GitHub
- CLI Commands - Complete command reference
- Agent Registry - All available agents
- Configuration - Configuration options
- Migration Guide - Upgrading from older versions
- 🚀 Quick Setup - Minimal scenario gets you started in 5 minutes
- 📝 Organized Projects - Clear structure with PRDs, epics, and tasks
- ⚡ Progressive Enhancement - Start minimal, add plugins as needed
- 🔄 GitHub Integration - Keep issues in sync automatically
- 👥 Team Coordination - Dynamic agent teams for different roles
- 📊 Progress Tracking - Track progress across epics and sprints
- 🔀 Parallel Development - Multiple agents work simultaneously
- 📈 Velocity Metrics - Maintain velocity with automated workflows
- 🐳 Full DevOps Scenario - Docker, Kubernetes, cloud platforms
- ☸️ Infrastructure as Code - Terraform, CloudFormation, ARM templates
- 🔧 CI/CD Integration - GitHub Actions, Azure Pipelines
- 📦 Multi-Cloud Support - AWS, Azure, GCP specialists
- 📊 Performance Scenario - All data and ML capabilities
- 🔄 Pipeline Orchestration - Airflow, Kedro, LangGraph
- 💾 Data Storage - PostgreSQL, MongoDB, BigQuery
- 🤖 ML Workflows - scikit-learn, PyTorch, TensorFlow, MLOps
- ✅ AI-native - Built for Claude Code, not adapted
- ✅ Modular - Install only what you need
- ✅ Code-first - PRDs → Code → Production
- ✅ Scenario-based - Automatic plugin installation
- ✅ Full workflow - Not just code generation
- ✅ Multi-agent - 145+ specialized agents, not one generic
- ✅ Plugin architecture - Mix and match capabilities
- ✅ Enterprise-ready - GitHub & Azure DevOps integration
- ✅ Proven patterns - 2+ years of refinement
- ✅ TDD-developed - 64+ tests with comprehensive coverage
- ✅ Active development - Regular updates and improvements
- ✅ Community support - Growing ecosystem and documentation
- 11+ plugins - Modular architecture
- 62+ agents - Specialized AI experts
- 91 commands - Complete PM workflow
- 4 scenarios - From minimal to full DevOps
- 64+ tests - Comprehensive test coverage
- TDD methodology - Test-driven development
- Context7 integration - Up-to-date documentation
- Production-ready - Used in real projects
- Active maintenance - Regular updates
- npm published - Easy global installation
- GitHub integration - Full bidirectional sync
- Azure DevOps support - Complete work item management
- Safety First - One agent at a time
- Predictable - Easy to debug
- Resource Light - Minimal system resources
- Best For - Learning, debugging, simple projects
- Intelligent - Automatic mode selection
- Balanced - Performance + safety
- Context-Aware - Adapts to task complexity
- Best For - Most production projects ⭐ RECOMMENDED
- Maximum Speed - Parallel agent execution
- Resource Intensive - Uses all available cores
- Advanced - Requires understanding of dependencies
- Best For - Data pipelines, ML workflows, power users
We welcome contributions! See CONTRIBUTING.md for:
- Development setup
- Plugin development guide
- Coding standards
- Testing requirements
- Pull request process
Want to create your own plugin? See Plugin Development Guide.
MIT License - see LICENSE for details.
- Documentation: https://rafeekpro.github.io/ClaudeAutoPM/
- npm Package: https://www.npmjs.com/package/claude-autopm
- Issues: https://github.com/rafeekpro/ClaudeAutoPM/issues
- Discussions: https://github.com/rafeekpro/ClaudeAutoPM/discussions
- 📧 Email: [email protected]
- 🐦 Twitter: @rafeekpro
- 💬 GitHub Discussions for questions and community support
- ✨ Automatic plugin installation based on scenarios
- 🎯 4 installation presets (minimal, docker-only, full-devops, performance)
- 📦 Configuration persistence in
.claude/config.json - 🔍 Installation results tracking
- 📚 Comprehensive documentation update
- 🔌 Modular plugin system with 11 official plugins
- 📦 npm workspaces for plugin organization
- 🏗️ Context7-driven architecture
- 🔍 Smart plugin discovery
- 🔄 Full bidirectional GitHub sync
- ✅ Issue sync with conflict detection
- 📦 Epic sync with task checkboxes
- 🎯 99% test coverage
- 📋 24 PM commands implemented
- ⚡ 168 tests, 91.4% coverage
- 🎨 Modern UX with progress spinners
- 🧪 TDD methodology throughout
For complete version history, see CHANGELOG.md.
Built with ❤️ for the Claude Code community
Star ⭐ this repo if ClaudeAutoPM helps your workflow!