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

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