claude-mpm 4.13.1__py3-none-any.whl → 4.13.2__py3-none-any.whl

claude_mpm/VERSION

@@ -1 +1 @@
-4.13.1
+4.13.2

claude_mpm/agents/PM_INSTRUCTIONS.md

@@ -113,6 +113,73 @@ Read: /mpm-doctor   # WRONG - not a file to read
 - MPM commands are system operations, NOT files or scripts
 - Always use SlashCommand tool for these operations
 
+## 🤖 AUTO-CONFIGURATION FEATURE (NEW!)
+
+**IMPORTANT**: Claude MPM now includes intelligent auto-configuration that can detect project stacks and recommend the right agents automatically.
+
+### When to Suggest Auto-Configuration
+
+PM SHOULD proactively suggest auto-configuration when:
+1. **New user/session**: First interaction in a project without deployed agents
+2. **Few agents deployed**: < 3 agents deployed but project seems to need more
+3. **User asks about agents**: "What agents should I use?" or "Which agents do I need?"
+4. **Stack changes detected**: User mentions adding new frameworks or tools
+5. **User struggles**: User manually deploying multiple agents one-by-one
+
+### Auto-Configuration Commands
+
+**Three new MPM commands available**:
+- `/mpm-auto-configure [--preview|--yes]` - Full auto-configuration workflow
+- `/mpm-agents-detect` - Just show detected toolchain
+- `/mpm-agents-recommend` - Show agent recommendations without deploying
+
+### Suggestion Patterns
+
+**Example 1: First-time user**
+```
+User: "I need help with my FastAPI project"
+PM: "I notice this is a FastAPI project. Would you like me to run auto-configuration
+     to set up the right agents automatically? Run '/mpm-auto-configure --preview'
+     to see what would be configured."
+```
+
+**Example 2: User manually deploying agents**
+```
+User: "Deploy fastapi-engineer"
+PM: "Deploying fastapi-engineer... By the way, you can use '/mpm-auto-configure'
+     to automatically detect your stack and deploy all recommended agents at once.
+     Would you like to try that instead?"
+```
+
+**Example 3: User asks about agents**
+```
+User: "What agents should I use for Next.js?"
+PM: "Let me run auto-detection to give you personalized recommendations.
+     I'll use '/mpm-agents-detect' to scan your project, then
+     '/mpm-agents-recommend' to show exactly which agents fit your stack."
+```
+
+### Proactive Suggestion Template
+
+When appropriate, include a helpful suggestion like:
+
+```
+💡 Tip: Try the new auto-configuration feature!
+   Run '/mpm-auto-configure --preview' to see which agents
+   are recommended for your project based on detected toolchain.
+
+   Supported: Python, Node.js, Rust, Go, and popular frameworks
+   like FastAPI, Next.js, React, Express, and more.
+```
+
+### Important Notes
+
+- **Don't over-suggest**: Only mention once per session
+- **User choice**: Always respect if user prefers manual configuration
+- **Preview first**: Recommend --preview flag for first-time users
+- **Not mandatory**: Auto-config is a convenience, not a requirement
+- **Fallback available**: Manual agent deployment always works
+
 ## NO ASSERTION WITHOUT VERIFICATION RULE
 
 **CRITICAL**: PM MUST NEVER make claims without evidence from agents.
@@ -194,6 +261,7 @@ See [Validation Templates](templates/validation_templates.md#required-evidence-f
 | "error", "bug", "issue" | "I'll have QA reproduce this" | QA |
 | "slow", "performance" | "I'll have QA benchmark this" | QA |
 | "/mpm-doctor", "/mpm-status", etc | "I'll run the MPM command" | Use SlashCommand tool (NOT bash) |
+| "/mpm-auto-configure", "/mpm-agents-detect" | "I'll run the auto-config command" | Use SlashCommand tool (NEW!) |
 | ANY question about code | "I'll have Research examine this" | Research |
 
 ### 🔴 CIRCUIT BREAKER - IMPLEMENTATION DETECTION 🔴

claude_mpm/commands/mpm-agents-detect.md

@@ -0,0 +1,168 @@
+# Detect project toolchain and frameworks
+
+Scan your project to detect programming languages, frameworks, tools, and configurations.
+
+## Usage
+
+```
+/mpm-agents-detect
+```
+
+## Description
+
+This command scans your project directory to automatically detect:
+- Programming languages and their versions
+- Web frameworks and libraries
+- Testing tools and frameworks
+- Build tools and bundlers
+- Package managers
+- Deployment configurations
+
+This is useful for understanding what Claude MPM can detect in your project before running auto-configuration.
+
+## Implementation
+
+When you run `/mpm-agents-detect`, the PM will execute:
+```bash
+claude-mpm agents detect
+```
+
+This performs a comprehensive scan of your project looking for:
+- Package manifests (package.json, requirements.txt, Cargo.toml, go.mod, pom.xml)
+- Framework-specific files (next.config.js, fastapi imports, etc.)
+- Test configurations (pytest.ini, jest.config.js, playwright.config.ts)
+- Build configurations (vite.config.js, webpack.config.js, tsconfig.json)
+- Deployment files (Dockerfile, vercel.json, railway.json)
+
+## Expected Output
+
+```
+🔍 Project Toolchain Detection
+================================
+
+Languages:
+  ✓ Python 3.11.5
+  ✓ Node.js 20.10.0
+  ✓ TypeScript 5.3.2
+
+Frameworks:
+  ✓ FastAPI 0.104.0
+  ✓ React 18.2.0
+  ✓ Next.js 14.0.4
+
+Testing:
+  ✓ pytest 7.4.3
+  ✓ Jest 29.7.0
+  ✓ Playwright 1.40.0
+
+Build Tools:
+  ✓ Vite 5.0.0
+  ✓ TypeScript Compiler
+
+Package Managers:
+  ✓ poetry (Python)
+  ✓ npm (Node.js)
+
+Deployment:
+  ✓ Docker (Dockerfile found)
+  ✓ Vercel (vercel.json found)
+  ✓ PM2 (ecosystem.config.js found)
+
+Configuration Files Detected:
+  - pyproject.toml
+  - package.json
+  - tsconfig.json
+  - next.config.js
+  - pytest.ini
+  - jest.config.js
+  - playwright.config.ts
+  - Dockerfile
+  - vercel.json
+
+Summary:
+  Full-stack project with Python backend (FastAPI) and
+  React/Next.js frontend, comprehensive testing setup,
+  and multiple deployment targets.
+```
+
+## What Gets Detected
+
+### Language Detection
+- **Python**: Looks for .py files, requirements.txt, pyproject.toml, setup.py
+- **JavaScript/TypeScript**: Looks for .js/.ts files, package.json, tsconfig.json
+- **Rust**: Looks for Cargo.toml, .rs files
+- **Go**: Looks for go.mod, .go files
+- **Java**: Looks for pom.xml, build.gradle, .java files
+
+### Framework Detection
+**Python:**
+- FastAPI (imports, decorator patterns)
+- Flask (imports, app patterns)
+- Django (settings.py, manage.py)
+
+**JavaScript/TypeScript:**
+- Next.js (next.config.js, pages/ or app/ directory)
+- React (package.json dependencies, JSX usage)
+- Vue (vue.config.js, .vue files)
+- Express (imports, app patterns)
+- Nest.js (nest-cli.json, decorators)
+
+### Testing Detection
+- pytest (pytest.ini, conftest.py)
+- unittest (test_*.py patterns)
+- Jest (jest.config.js)
+- Vitest (vitest.config.js)
+- Playwright (playwright.config.ts)
+- Cypress (cypress.json)
+
+### Build Tool Detection
+- Vite (vite.config.js/ts)
+- Webpack (webpack.config.js)
+- Rollup (rollup.config.js)
+- esbuild (esbuild configuration)
+- Turbopack (next.config.js with turbopack)
+
+### Deployment Detection
+- Docker (Dockerfile, docker-compose.yml)
+- Vercel (vercel.json, .vercel directory)
+- Railway (railway.json, railway.toml)
+- PM2 (ecosystem.config.js)
+- Kubernetes (k8s/, kubernetes/ directories)
+
+## Use Cases
+
+1. **Before Auto-Configuration**: Run this to see what will be detected
+2. **Troubleshooting**: Verify that your project setup is being recognized correctly
+3. **Documentation**: Generate a summary of your project's tech stack
+4. **Planning**: Understand what agents might be recommended
+
+## Tips
+
+1. **Run from project root**: Detection works best from your project's root directory
+2. **Check detection accuracy**: Verify detected versions match your actual setup
+3. **Missing detections**: If something isn't detected, you can still deploy agents manually
+4. **Configuration files**: Detection relies on standard configuration files being present
+
+## Common Issues
+
+**Nothing detected?**
+- Make sure you're in the project root directory
+- Check that you have standard configuration files (package.json, requirements.txt, etc.)
+- Some projects may need manual agent deployment
+
+**Wrong versions detected?**
+- Detection shows what's configured in manifest files
+- Actual runtime versions may differ
+- This doesn't affect agent functionality
+
+**Framework not detected?**
+- Some frameworks are harder to detect automatically
+- You can still use auto-configure and manually select agents
+- Or deploy specific agents manually with `/mpm-agents deploy <name>`
+
+## Related Commands
+
+- `/mpm-agents-recommend` - See agent recommendations based on detection
+- `/mpm-auto-configure` - Automatically configure agents based on detection
+- `/mpm-agents` - Manually manage agents
+- `/mpm-help auto-configure` - Learn about auto-configuration

claude_mpm/commands/mpm-agents-recommend.md

@@ -0,0 +1,214 @@
+# Show recommended agents for detected project stack
+
+Get intelligent agent recommendations based on your project's detected toolchain.
+
+## Usage
+
+```
+/mpm-agents-recommend
+```
+
+## Description
+
+This command analyzes your detected project stack and recommends the most appropriate agents, organized by priority:
+- **Essential agents**: Core agents required for your primary stack
+- **Recommended agents**: Complementary agents for full functionality
+- **Optional agents**: Specialized agents for detected tools
+
+Each recommendation includes an explanation of why that agent is suggested.
+
+## Implementation
+
+When you run `/mpm-agents-recommend`, the PM will execute:
+```bash
+claude-mpm agents recommend
+```
+
+This runs the detection phase and then applies recommendation rules to suggest the best agents for your specific technology stack.
+
+## Expected Output
+
+```
+🤖 Agent Recommendations
+=========================
+
+Based on detected stack:
+  Python 3.11, FastAPI 0.104.0, pytest, Docker, Vercel
+
+Essential Agents (Must Have):
+  ✓ fastapi-engineer
+    Reason: FastAPI framework detected - specialized agent for FastAPI development
+    Capabilities: FastAPI routes, Pydantic models, async endpoints, dependency injection
+
+  ✓ python-engineer
+    Reason: Python project - general Python development support
+    Capabilities: Python code, testing, debugging, package management
+
+  ✓ api-qa
+    Reason: API testing for FastAPI backend
+    Capabilities: API endpoint testing, validation, load testing, contract testing
+
+Recommended Agents (Strongly Suggested):
+  ○ docker-ops
+    Reason: Docker configuration detected
+    Capabilities: Docker builds, container management, docker-compose orchestration
+
+  ○ vercel-ops
+    Reason: Vercel deployment configuration found
+    Capabilities: Vercel deployments, serverless functions, domain management
+
+  ○ playwright-qa
+    Reason: Comprehensive E2E testing capability
+    Capabilities: Browser automation, visual testing, API testing
+
+Optional Agents (Nice to Have):
+  ○ local-ops-agent
+    Reason: Local development and PM2 process management
+    Capabilities: Local server management, port handling, PM2 operations
+
+  ○ security-agent
+    Reason: Security scanning and best practices
+    Capabilities: Dependency scanning, code security, auth patterns
+
+Summary:
+  Recommended: 3 essential + 2 recommended = 5 agents
+  Optional: 2 additional agents for enhanced capabilities
+
+  Total recommended deployment: 5 agents
+  Maximum useful deployment: 7 agents
+
+Next Steps:
+  1. Review recommendations above
+  2. Run '/mpm-auto-configure --preview' to see deployment plan
+  3. Run '/mpm-auto-configure' to deploy recommended agents
+  4. Or deploy individually: '/mpm-agents deploy <agent-name>'
+```
+
+## Recommendation Logic
+
+### Python Projects
+
+**If FastAPI detected:**
+- Essential: fastapi-engineer, python-engineer, api-qa
+- Recommended: docker-ops (if Docker), vercel-ops (if Vercel)
+
+**If Flask detected:**
+- Essential: flask-engineer, python-engineer, api-qa
+- Recommended: docker-ops (if Docker)
+
+**If Django detected:**
+- Essential: django-engineer, python-engineer, api-qa
+- Recommended: docker-ops (if Docker)
+
+**If pytest detected:**
+- Add to recommended: api-qa, playwright-qa
+
+### JavaScript/TypeScript Projects
+
+**If Next.js detected:**
+- Essential: nextjs-engineer, react-engineer, web-qa
+- Recommended: playwright-qa, vercel-ops (if Vercel)
+
+**If React detected (without Next.js):**
+- Essential: react-engineer, web-qa
+- Recommended: playwright-qa
+
+**If Vue detected:**
+- Essential: vue-engineer, web-qa
+- Recommended: playwright-qa
+
+**If Express detected:**
+- Essential: node-engineer, api-qa
+- Recommended: docker-ops (if Docker)
+
+**If Nest.js detected:**
+- Essential: nestjs-engineer, node-engineer, api-qa
+- Recommended: docker-ops (if Docker)
+
+### Full-Stack Projects
+
+**Python backend + React frontend:**
+- Essential: fastapi-engineer (or flask-engineer), python-engineer, react-engineer, api-qa, web-qa
+- Recommended: playwright-qa, docker-ops, local-ops-agent
+
+**Node.js backend + React frontend:**
+- Essential: node-engineer, react-engineer, api-qa, web-qa
+- Recommended: playwright-qa, docker-ops
+
+### Testing-Focused Projects
+
+**If Playwright detected:**
+- Add to recommended: playwright-qa
+
+**If Jest/Vitest detected:**
+- Ensure web-qa or api-qa in recommended
+
+### Deployment-Focused Projects
+
+**If Vercel detected:**
+- Add to recommended: vercel-ops
+
+**If Railway detected:**
+- Add to recommended: railway-ops
+
+**If Docker detected:**
+- Add to recommended: docker-ops
+
+**If PM2 detected:**
+- Add to recommended: local-ops-agent
+
+## Agent Descriptions
+
+### Backend Specialists
+- **fastapi-engineer**: FastAPI expert - routes, Pydantic, async, websockets
+- **flask-engineer**: Flask expert - blueprints, extensions, templates
+- **django-engineer**: Django expert - models, views, ORM, admin
+- **node-engineer**: Node.js expert - Express, async, streams
+- **nestjs-engineer**: NestJS expert - modules, decorators, DI
+
+### Frontend Specialists
+- **nextjs-engineer**: Next.js expert - app router, server components, SSR
+- **react-engineer**: React expert - hooks, state, components
+- **vue-engineer**: Vue expert - composition API, components
+
+### QA Specialists
+- **api-qa**: API testing expert - REST, GraphQL, validation
+- **web-qa**: Web testing expert - fetch, integration, E2E
+- **playwright-qa**: Browser automation expert - UI testing, visual regression
+
+### Ops Specialists
+- **docker-ops**: Docker expert - builds, compose, containers
+- **vercel-ops**: Vercel deployment expert - serverless, edge
+- **railway-ops**: Railway deployment expert
+- **local-ops-agent**: Local development expert - PM2, ports, processes
+
+## Use Cases
+
+1. **Planning**: Understand what agents you should deploy before starting work
+2. **Validation**: Verify that auto-configuration will suggest the right agents
+3. **Learning**: Discover what capabilities are available for your stack
+4. **Optimization**: Find additional agents that could enhance your workflow
+
+## Tips
+
+1. **Start here**: Run this before `/mpm-auto-configure` to preview recommendations
+2. **Essential vs Optional**: Focus on essential agents first, add others as needed
+3. **Stack-specific**: Recommendations are tailored to YOUR detected stack
+4. **Flexible**: You can always deploy additional agents later or skip some
+5. **Explanations**: Pay attention to the "Reason" for each recommendation
+
+## Customizing Recommendations
+
+After seeing recommendations, you can:
+1. **Accept all**: Run `/mpm-auto-configure` to deploy all recommended agents
+2. **Pick and choose**: Deploy specific agents with `/mpm-agents deploy <name>`
+3. **Skip optional**: Deploy only essential and recommended agents
+4. **Add more**: Deploy additional agents not in recommendations
+
+## Related Commands
+
+- `/mpm-agents-detect` - See what was detected in your project
+- `/mpm-auto-configure` - Automatically deploy recommended agents
+- `/mpm-agents deploy <name>` - Deploy specific agents manually
+- `/mpm-agents` - View all available and deployed agents
+- `/mpm-help agents` - Learn more about agent management

claude_mpm/commands/mpm-agents.md

@@ -45,4 +45,78 @@ This will display all deployed agents that are currently available for use.
 Alternatively, you can use these variations:
 - `claude-mpm agents list --system` - Show system agents
 - `claude-mpm agents list --by-tier` - Group agents by precedence tier
-- `claude-mpm agents list --all` - Show all agents including undeployed
+- `claude-mpm agents list --all` - Show all agents including undeployed
+
+## Auto-Configuration Subcommands (NEW!)
+
+### Quick Agent Setup
+
+Claude MPM now includes intelligent auto-configuration that detects your project and recommends the right agents:
+
+#### `agents detect`
+Scan your project to detect toolchain and frameworks:
+```bash
+claude-mpm agents detect
+```
+
+Shows detected:
+- Programming languages (Python, Node.js, Rust, Go, etc.)
+- Frameworks (FastAPI, Next.js, React, Express, etc.)
+- Testing tools (pytest, Jest, Playwright, etc.)
+- Build tools and package managers
+- Deployment configurations
+
+#### `agents recommend`
+Get agent recommendations based on detected toolchain:
+```bash
+claude-mpm agents recommend
+```
+
+Shows:
+- Essential agents for your stack
+- Recommended complementary agents
+- Optional specialized agents
+- Rationale for each recommendation
+
+#### `auto-configure`
+Automatically detect, recommend, and deploy agents:
+```bash
+claude-mpm auto-configure --preview  # See what would be configured
+claude-mpm auto-configure            # Interactive configuration
+claude-mpm auto-configure --yes      # Auto-apply without prompts
+```
+
+**Example workflow:**
+1. Run `claude-mpm agents detect` to see what's detected
+2. Run `claude-mpm agents recommend` to see suggestions
+3. Run `claude-mpm auto-configure` to apply configuration
+4. Or skip straight to `claude-mpm auto-configure --yes`
+
+### Supported Stacks
+
+**Python:**
+- FastAPI, Flask, Django → fastapi-engineer, python-engineer
+- pytest, unittest → api-qa, python-qa
+
+**JavaScript/TypeScript:**
+- Next.js → nextjs-engineer, react-engineer
+- React, Vue, Svelte → react-engineer, web-qa
+- Express, Nest.js → node-engineer, api-qa
+- Jest, Vitest, Playwright → playwright-qa, web-qa
+
+**Full-Stack Projects:**
+Automatically recommends both frontend and backend agents based on your complete stack.
+
+**Deployment:**
+- Vercel → vercel-ops
+- Railway → railway-ops
+- Docker → docker-ops
+- PM2 → local-ops-agent
+
+## Related Commands
+
+For more information on auto-configuration:
+- `/mpm-help auto-configure` - Detailed auto-configuration help
+- `/mpm-agents-detect` - Run detection via slash command
+- `/mpm-agents-recommend` - Show recommendations via slash command
+- `/mpm-auto-configure` - Run auto-configuration via slash command

claude_mpm/commands/mpm-auto-configure.md

@@ -0,0 +1,217 @@
+# Automatically configure agents based on project detection
+
+Automatically detect your project's toolchain and configure the most appropriate agents.
+
+## Usage
+
+```
+/mpm-auto-configure [options]
+```
+
+## Description
+
+This command provides intelligent auto-configuration that:
+1. Scans your project to detect programming languages, frameworks, and tools
+2. Recommends the most appropriate agents for your stack
+3. Optionally deploys the recommended agents with confirmation
+
+This is the fastest way to get started with Claude MPM in any project!
+
+## Options
+
+- `--preview` - Show what would be configured without making any changes
+- `--yes` - Automatically apply recommendations without prompting
+- `--force` - Force reconfiguration even if agents are already deployed
+
+## Implementation
+
+When you run `/mpm-auto-configure`, the PM will:
+
+1. **Detect Your Stack**:
+   - Scan for package.json, requirements.txt, Cargo.toml, go.mod, etc.
+   - Identify frameworks (FastAPI, Next.js, React, Express, etc.)
+   - Detect testing tools (pytest, Jest, Playwright, etc.)
+   - Find build tools and deployment configurations
+
+2. **Recommend Agents**:
+   - **Essential agents**: Required for your primary stack
+   - **Recommended agents**: Complementary agents for full functionality
+   - **Optional agents**: Specialized agents for detected tools
+
+3. **Deploy Agents** (with confirmation):
+   - Show what will be deployed
+   - Request confirmation (unless --yes is used)
+   - Deploy agents to your project
+   - Verify deployment success
+
+## Examples
+
+### Preview Mode (Recommended First Step)
+```
+/mpm-auto-configure --preview
+```
+Shows what would be configured without making changes. Great for understanding recommendations before applying.
+
+### Interactive Configuration
+```
+/mpm-auto-configure
+```
+Detect, recommend, and prompt for confirmation before deploying.
+
+### Automatic Configuration
+```
+/mpm-auto-configure --yes
+```
+Automatically apply all recommendations without prompting. Best for quick setup.
+
+### Force Reconfiguration
+```
+/mpm-auto-configure --force
+```
+Reconfigure agents even if some are already deployed. Useful for stack changes.
+
+## Expected Output
+
+```
+🤖 Auto-Configuration for Claude MPM
+=====================================
+
+Step 1: Detecting Project Stack
+--------------------------------
+✓ Detected Python 3.11
+✓ Detected FastAPI 0.104.0
+✓ Detected pytest 7.4.0
+✓ Detected Docker configuration
+✓ Detected Vercel deployment
+
+Step 2: Agent Recommendations
+------------------------------
+Essential Agents (3):
+  ✓ fastapi-engineer - FastAPI framework detected
+  ✓ python-engineer - Python project support
+  ✓ api-qa - API testing and validation
+
+Recommended Agents (2):
+  ○ docker-ops - Docker configuration found
+  ○ vercel-ops - Vercel deployment detected
+
+Optional Agents (1):
+  ○ playwright-qa - Browser testing capability
+
+Step 3: Deploy Agents
+---------------------
+Deploy 5 agents? (y/n): y
+
+Deploying agents...
+✓ fastapi-engineer deployed
+✓ python-engineer deployed
+✓ api-qa deployed
+✓ docker-ops deployed
+✓ vercel-ops deployed
+
+🎉 Auto-configuration complete!
+5 agents deployed successfully.
+
+Next steps:
+- Run /mpm-agents to see your deployed agents
+- Start working with specialized agents for your stack
+- Use /mpm-help for more information
+```
+
+## What Gets Detected
+
+### Languages
+- Python (CPython, PyPy)
+- JavaScript/TypeScript (Node.js, Deno, Bun)
+- Rust
+- Go
+- Java
+
+### Python Frameworks
+- FastAPI
+- Flask
+- Django
+- Starlette
+- Pyramid
+
+### JavaScript/TypeScript Frameworks
+- Next.js
+- React
+- Vue
+- Svelte
+- Angular
+- Express
+- Nest.js
+- Fastify
+
+### Testing Tools
+- pytest (Python)
+- unittest (Python)
+- Jest (JavaScript)
+- Vitest (JavaScript)
+- Playwright (Browser)
+- Cypress (Browser)
+
+### Build Tools
+- Vite
+- Webpack
+- Rollup
+- esbuild
+- Turbopack
+
+### Deployment Platforms
+- Vercel
+- Railway
+- Docker
+- PM2
+- Kubernetes
+
+## Agent Mapping Examples
+
+### Python + FastAPI
+**Essential:**
+- fastapi-engineer
+- python-engineer
+- api-qa
+
+**Recommended:**
+- docker-ops (if Docker detected)
+- vercel-ops (if Vercel detected)
+
+### Next.js + React
+**Essential:**
+- nextjs-engineer
+- react-engineer
+- web-qa
+
+**Recommended:**
+- playwright-qa (if Playwright detected)
+- vercel-ops (if Vercel detected)
+
+### Full-Stack (FastAPI + React)
+**Essential:**
+- fastapi-engineer
+- python-engineer
+- react-engineer
+- api-qa
+- web-qa
+
+**Recommended:**
+- playwright-qa
+- docker-ops
+- local-ops-agent
+
+## Tips
+
+1. **Start with preview**: Always run with `--preview` first to see recommendations
+2. **Review carefully**: Check that detected stack matches your project
+3. **Customize later**: You can always deploy/remove agents manually after auto-config
+4. **Re-run after changes**: Run again with `--force` if you add new frameworks
+5. **Complementary commands**: Use `/mpm-agents-detect` and `/mpm-agents-recommend` for more details
+
+## Related Commands
+
+- `/mpm-agents-detect` - Just show detected toolchain
+- `/mpm-agents-recommend` - Show recommendations without deploying
+- `/mpm-agents` - Manage agents manually
+- `/mpm-help agents` - Learn about manual agent management

claude_mpm/commands/mpm-help.md

@@ -66,6 +66,15 @@ Available Commands:
 /mpm-agents [list|deploy|remove] [name]
   Manage agent deployment
 
+/mpm-auto-configure [--preview] [--yes]
+  🤖 NEW! Automatically configure agents based on your project
+
+/mpm-agents-detect
+  🤖 NEW! Detect project toolchain and frameworks
+
+/mpm-agents-recommend
+  🤖 NEW! Show recommended agents for your project
+
 /mpm-config [validate|view|status]
   Manage configuration settings
 
@@ -118,6 +127,157 @@ Related Commands:
   /mpm-config   Manage configuration
 ```
 
+## Auto-Configuration Commands (NEW!)
+
+### /mpm-auto-configure - Automatic Agent Configuration
+
+**Description:**
+Automatically detects your project's toolchain and frameworks, then recommends and optionally deploys the most appropriate agents for your stack.
+
+**Usage:**
+```
+/mpm-auto-configure [options]
+```
+
+**Options:**
+- `--preview` - Show what would be configured without making changes
+- `--yes` - Skip confirmation prompts and apply automatically
+- `--force` - Force reconfiguration even if agents already deployed
+
+**Examples:**
+```
+/mpm-auto-configure --preview    # Preview recommendations
+/mpm-auto-configure              # Interactive configuration
+/mpm-auto-configure --yes        # Auto-apply recommendations
+```
+
+**What it detects:**
+- Programming languages (Python, Node.js, Rust, Go, Java)
+- Frameworks (FastAPI, Flask, Next.js, React, Vue, Express)
+- Testing tools (pytest, Jest, Vitest, Playwright)
+- Build tools (Vite, Webpack, Rollup)
+- Package managers (npm, yarn, pnpm, pip, poetry)
+- Deployment platforms (Vercel, Railway, Docker)
+
+**Recommended agents by stack:**
+- **Python + FastAPI**: fastapi-engineer, python-engineer, api-qa
+- **Next.js**: nextjs-engineer, react-engineer, web-qa
+- **React**: react-engineer, web-qa
+- **Full-stack**: Combination of backend + frontend agents
+- **Testing**: playwright-qa, api-qa based on detected test tools
+
+### /mpm-agents-detect - Toolchain Detection
+
+**Description:**
+Scans your project to detect programming languages, frameworks, tools, and configuration files.
+
+**Usage:**
+```
+/mpm-agents-detect
+```
+
+**Output:**
+- Detected languages and versions
+- Frameworks and their configurations
+- Testing tools and test frameworks
+- Build tools and bundlers
+- Package managers
+- Deployment configurations
+
+**Example:**
+```
+/mpm-agents-detect
+
+Detected Project Stack:
+======================
+Languages: Python 3.11, Node.js 20.x
+Frameworks: FastAPI 0.104.0, React 18.2.0
+Testing: pytest, Playwright
+Build: Vite 5.0.0
+Package Manager: poetry, npm
+Deployment: Docker, Vercel
+```
+
+### /mpm-agents-recommend - Agent Recommendations
+
+**Description:**
+Based on detected toolchain, shows which agents are recommended for your project with explanations.
+
+**Usage:**
+```
+/mpm-agents-recommend
+```
+
+**Output:**
+- Recommended agents with rationale
+- Agent capabilities and when to use them
+- Suggested deployment order
+- Complementary agent combinations
+
+**Example:**
+```
+/mpm-agents-recommend
+
+Recommended Agents for Your Project:
+===================================
+
+Essential Agents:
+✓ fastapi-engineer - Detected FastAPI framework
+✓ python-engineer - Python 3.11 project
+✓ api-qa - API testing and validation
+
+Recommended Agents:
+○ react-engineer - React frontend detected
+○ web-qa - Web UI testing
+○ playwright-qa - Playwright tests found
+
+Optional Agents:
+○ docker-ops - Docker configuration found
+○ vercel-ops - Vercel deployment detected
+```
+
+## Quick Start with Auto-Configuration
+
+For new projects or first-time setup:
+
+1. **Preview what would be configured:**
+   ```
+   /mpm-auto-configure --preview
+   ```
+
+2. **Review recommendations:**
+   ```
+   /mpm-agents-recommend
+   ```
+
+3. **Apply configuration:**
+   ```
+   /mpm-auto-configure
+   ```
+
+Or skip straight to auto-apply:
+```
+/mpm-auto-configure --yes
+```
+
+## Supported Technology Stacks
+
+**Python:**
+- FastAPI, Flask, Django, Starlette
+- pytest, unittest
+- uvicorn, gunicorn
+
+**JavaScript/TypeScript:**
+- Next.js, React, Vue, Svelte
+- Express, Nest.js, Fastify
+- Jest, Vitest, Playwright
+- Vite, Webpack, Rollup
+
+**Other:**
+- Rust (Cargo, Actix, Rocket)
+- Go (modules, Gin, Echo)
+- Java (Maven, Gradle, Spring Boot)
+
 ## Related Commands
 
 - All other `/mpm-*` commands - Access help for any command

{claude_mpm-4.13.1.dist-info → claude_mpm-4.13.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.13.1
+Version: 4.13.2
 Summary: Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking
 Author-email: Bob Matsuoka <bob@matsuoka.com>
 Maintainer: Claude MPM Team

{claude_mpm-4.13.1.dist-info → claude_mpm-4.13.2.dist-info}/RECORD

@@ -1,5 +1,5 @@
 claude_mpm/BUILD_NUMBER,sha256=9JfxhnDtr-8l3kCP2U5TVXSErptHoga8m7XA8zqgGOc,4
-claude_mpm/VERSION,sha256=ZWQ9MwsvC5m_OIFP2c-tkiExnFw2ALxqze5YMYSS5AA,7
+claude_mpm/VERSION,sha256=-9bAsjQWLJ_lPOMqq3ZKSFJfFptZVTO0Fx5-5NU0TcA,7
 claude_mpm/__init__.py,sha256=UCw6j9e_tZQ3kJtTqmdfNv7MHyw9nD1jkj80WurwM2g,2064
 claude_mpm/__main__.py,sha256=Ro5UBWBoQaSAIoSqWAr7zkbLyvi4sSy28WShqAhKJG0,723
 claude_mpm/constants.py,sha256=sLjJF6Kw7H4V9WWeaEYltM-77TgXqzEMX5vx4ukM5-0,5977
@@ -16,7 +16,7 @@ claude_mpm/agents/BASE_RESEARCH.md,sha256=2DZhDd5XxWWtsyNTBIwvtNWBu1JpFy5R5SAZDH
 claude_mpm/agents/INSTRUCTIONS_OLD_DEPRECATED.md,sha256=zQZhrhVq9NLCtSjVX-aC0xcgueemSuPhKyv0SjEOyIQ,25852
 claude_mpm/agents/MEMORY.md,sha256=KbRwY_RYdOvTvFC2DD-ATfwjHkQWJ5PIjlGws_7RmjI,3307
 claude_mpm/agents/OUTPUT_STYLE.md,sha256=IYbo4jmICihrfnChbdrRpwVk4VobCcNyYqZqd53VXMk,533
-claude_mpm/agents/PM_INSTRUCTIONS.md,sha256=8o2i6D-QZDbPIvZxb7EzvFBvPsYklYQsoJ9cFzn8VaY,27638
+claude_mpm/agents/PM_INSTRUCTIONS.md,sha256=sL-SJVMidqhQudyLW6ANKgwNmCdYtWyeUtuU4i34cBg,30363
 claude_mpm/agents/WORKFLOW.md,sha256=vJ9iXCVqAaeM_yVlXxbcP3bsL210-1BI3ZAanvWv4hI,9085
 claude_mpm/agents/__init__.py,sha256=jRFxvV_DIZ-NdENa-703Xu3YpwvlQj6yv-mQ6FgmldM,3220
 claude_mpm/agents/agent-template.yaml,sha256=mRlz5Yd0SmknTeoJWgFkZXzEF5T7OmGBJGs2-KPT93k,1969
@@ -149,10 +149,13 @@ claude_mpm/cli_module/args.py,sha256=50_Y3AgMNeidtPjQ5-WZ1o-5Y7G2GAGQwMmllYjVScE
 claude_mpm/cli_module/commands.py,sha256=zZmjP4J19i9PNMA7gCI5Dl--R1u_H4sCt5ZtOadZkY4,7013
 claude_mpm/cli_module/migration_example.py,sha256=DtQ59RyoBD6r8FIfrjKXCQ8-xnUiOqP5McBiS6_W1Qc,5183
 claude_mpm/commands/__init__.py,sha256=paX5Ub5-UmRgiQ8UgKWIKwU2-RjLu67OmNJND-fVtjg,588
-claude_mpm/commands/mpm-agents.md,sha256=JnYPJ-eWvIEEtiCB6iPu182P2xDBRvU3ArVXQ7h32kU,1341
+claude_mpm/commands/mpm-agents-detect.md,sha256=CL3arw_hMNHWT7SuD59lfBZ0TGMNdokMw12VDcG3AnI,4862
+claude_mpm/commands/mpm-agents-recommend.md,sha256=2TJYFzJLTdULVJ19RK2w802fqSEgYI1BkAaOUgE_l7I,7121
+claude_mpm/commands/mpm-agents.md,sha256=Mq1BOVP6ejRLYZCHE-K1fZ2HaiND_BaYEfc9SO5XCxQ,3586
+claude_mpm/commands/mpm-auto-configure.md,sha256=vJtXiaEiujmozhKhqU8GsO95gHLs0QQAzkyYfqPkgzQ,5130
 claude_mpm/commands/mpm-config.md,sha256=79Eb-srRpEVV3HCHDHZc8SKec6_LVP6HbXDEVkZKLgw,2929
 claude_mpm/commands/mpm-doctor.md,sha256=ut5LhFKVRw-2ecjMSPsnaTiRuFXa6Q9t-Wgl3CCnQvk,590
-claude_mpm/commands/mpm-help.md,sha256=zfhpE0Fd-wW5zWmYYAMRMT-xYK8saqbw-HXRD7csJHI,2850
+claude_mpm/commands/mpm-help.md,sha256=DGvnR5XLWJVygYCZis2Gh6RP1INj9DycO1FqAdwoegY,6751
 claude_mpm/commands/mpm-init.md,sha256=wwYHkToq8U5ALdhu8bDPygqAsKZ77aMaai7ZJC3oBqU,16054
 claude_mpm/commands/mpm-monitor.md,sha256=onTHf9Yac1KkdZdENtY2Q5jyw0A-vZLYgoKkPCtZLUY,12193
 claude_mpm/commands/mpm-organize.md,sha256=T-ysjhwgfW9irjUj02vuY_1jeMdabO_zxcShyjmqsiM,10153
@@ -819,9 +822,9 @@ claude_mpm/utils/subprocess_utils.py,sha256=D0izRT8anjiUb_JG72zlJR_JAw1cDkb7kalN
 claude_mpm/validation/__init__.py,sha256=YZhwE3mhit-lslvRLuwfX82xJ_k4haZeKmh4IWaVwtk,156
 claude_mpm/validation/agent_validator.py,sha256=GprtAvu80VyMXcKGsK_VhYiXWA6BjKHv7O6HKx0AB9w,20917
 claude_mpm/validation/frontmatter_validator.py,sha256=YpJlYNNYcV8u6hIOi3_jaRsDnzhbcQpjCBE6eyBKaFY,7076
-claude_mpm-4.13.1.dist-info/licenses/LICENSE,sha256=lpaivOlPuBZW1ds05uQLJJswy8Rp_HMNieJEbFlqvLk,1072
-claude_mpm-4.13.1.dist-info/METADATA,sha256=LFz8M6yorvkQwtrKKtstC5LnFpmt6DzShgeXqFjYzDc,17967
-claude_mpm-4.13.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-claude_mpm-4.13.1.dist-info/entry_points.txt,sha256=Vlw3GNi-OtTpKSrez04iNrPmxNxYDpIWxmJCxiZ5Tx8,526
-claude_mpm-4.13.1.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
-claude_mpm-4.13.1.dist-info/RECORD,,
+claude_mpm-4.13.2.dist-info/licenses/LICENSE,sha256=lpaivOlPuBZW1ds05uQLJJswy8Rp_HMNieJEbFlqvLk,1072
+claude_mpm-4.13.2.dist-info/METADATA,sha256=OLh7_XuogI3lwSVJHN0KoFQXrMJWw667nFCJMuC2WUc,17967
+claude_mpm-4.13.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+claude_mpm-4.13.2.dist-info/entry_points.txt,sha256=Vlw3GNi-OtTpKSrez04iNrPmxNxYDpIWxmJCxiZ5Tx8,526
+claude_mpm-4.13.2.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
+claude_mpm-4.13.2.dist-info/RECORD,,