claude-autopm 1.15.1 → 1.15.3

package/README.md

@@ -226,7 +226,7 @@ Essential Components:
   ✅ Git repository - Initialized
 
 Optional Components:
-  ✅ MCP servers - 2 active (context7-docs, github-mcp)
+  ✅ MCP servers - 2 active (context7, github-mcp)
   ⚠️  Git hooks - Not installed (run: bash scripts/setup-hooks.sh)
   ✅ Node.js version - v20.10.0 (compatible)
 
@@ -382,10 +382,10 @@ autopm mcp agents
 🤖 Agents Using MCP
 
 ✅ react-frontend-engineer
-   └─ context7-docs
+   └─ context7
 
 ✅ python-backend-engineer
-   └─ context7-docs
+   └─ context7
    └─ sqlite-mcp
 
 📊 Summary:
@@ -393,7 +393,7 @@ autopm mcp agents
    Using MCP: 39 (74%)
 
 # Enable MCP servers
-autopm mcp enable context7-docs
+autopm mcp enable context7
 autopm mcp enable github-mcp
 
 # Configure API keys interactively
@@ -447,8 +447,8 @@ autopm mcp validate            # Validate all servers
 
 ### MCP Server Types
 
-- **Documentation** - `context7-docs` for live framework documentation (React, Python, AWS, etc.)
-- **Codebase** - `context7-codebase` for project analysis and navigation
+- **Documentation** - `context7` for live framework documentation (React, Python, AWS, etc.)
+- **Codebase** - `context7` for project analysis and navigation
 - **GitHub** - `github-mcp` for repository operations
 - **Databases** - `sqlite-mcp`, `postgresql-mcp`, `mongodb-mcp` for data operations
 - **Browser** - `playwright-mcp` for E2E testing and automation
@@ -457,7 +457,7 @@ autopm mcp validate            # Validate all servers
 
 ```bash
 # 1. Enable context7 documentation server
-autopm mcp enable context7-docs
+autopm mcp enable context7
 
 # 2. Configure API key
 cat > .claude/.env << EOF
@@ -472,7 +472,7 @@ autopm mcp sync
 autopm mcp diagnose
 
 # 5. Test connection
-autopm mcp test context7-docs
+autopm mcp test context7
 ```
 
 ### MCP Benefits

package/autopm/.claude/examples/mcp-servers.example.json

@@ -2,27 +2,10 @@
   "mcpServers": {
     "context7": {
       "command": "npx",
-      "args": ["@upstash/context7-mcp"],
+      "args": ["-y", "@upstash/context7-mcp"],
       "env": {
-        "CONTEXT7_API_KEY": "${CONTEXT7_API_KEY:-}",
-        "CONTEXT7_MCP_URL": "${CONTEXT7_MCP_URL:-https://mcp.context7.com/mcp}",
-        "CONTEXT7_API_URL": "${CONTEXT7_API_URL:-https://context7.com/api/v1}",
-        "CONTEXT7_WORKSPACE": "${CONTEXT7_WORKSPACE:-}",
-        "CONTEXT7_MODE": "documentation"
-      },
-      "envFile": ".claude/.env"
-    },
-    "context7": {
-      "command": "npx",
-      "args": ["@upstash/context7-mcp"],
-      "env": {
-        "CONTEXT7_API_KEY": "${CONTEXT7_API_KEY:-}",
-        "CONTEXT7_MCP_URL": "${CONTEXT7_MCP_URL:-https://mcp.context7.com/mcp}",
-        "CONTEXT7_API_URL": "${CONTEXT7_API_URL:-https://context7.com/api/v1}",
-        "CONTEXT7_WORKSPACE": "${CONTEXT7_WORKSPACE:-}",
-        "CONTEXT7_MODE": "codebase"
-      },
-      "envFile": ".claude/.env"
+        "DEFAULT_MINIMUM_TOKENS": "${DEFAULT_MINIMUM_TOKENS:-10000}"
+      }
     },
     "playwright-mcp": {
       "command": "npx",

package/autopm/.claude/mcp/MCP-REGISTRY.md

@@ -11,13 +11,8 @@ This document provides guidance on MCP (Model Context Protocol) server managemen
 Example MCP server configurations are available in `.claude/examples/mcp/`:
 
 ### context7
-**Description**: Context7 documentation server for accessing technical documentation
-**Use Cases**: API documentation, framework guides, technical references
-**Example**: `.claude/examples/mcp/context7.md`
-
-### context7
-**Description**: Context7 codebase server for project code analysis
-**Use Cases**: Code navigation, project analysis, dependency tracking
+**Description**: Context7 MCP server - up-to-date documentation database for any library or framework
+**Use Cases**: API documentation, framework guides, technical references, library lookups
 **Example**: `.claude/examples/mcp/context7.md`
 
 ### playwright-mcp

package/autopm/.claude/mcp/context7.md

@@ -0,0 +1,205 @@
+---
+name: context7
+command: npx
+args: ["-y", "@upstash/context7-mcp"]
+description: MCP server for Context7 - Up-to-date documentation database
+category: documentation
+status: inactive
+env:
+  DEFAULT_MINIMUM_TOKENS: "${DEFAULT_MINIMUM_TOKENS:-10000}"
+---
+
+# Context7 MCP Server
+
+Official MCP server for [Context7](https://context7.com) - provides up-to-date documentation for libraries and frameworks.
+
+## 🎯 Features
+
+- **Up-to-date Documentation**: Always current library documentation
+- **Smart Search**: Resolve library names to Context7 IDs
+- **Token Control**: Configure minimum tokens for documentation retrieval
+- **Multi-library Support**: Access documentation for any supported library
+
+## 📦 Installation
+
+### Option 1: Using AutoPM (Recommended)
+
+```bash
+# Install from npm with automatic configuration
+autopm mcp install @upstash/context7-mcp --enable
+
+# Configure API key
+echo "CONTEXT7_API_KEY=your-key-here" >> .claude/.env
+
+# Test connection
+autopm mcp test context7
+```
+
+### Option 2: Manual Setup
+
+```bash
+# Copy this example to your project
+cp .claude/examples/mcp/context7.md .claude/mcp/
+
+# Enable the server
+autopm mcp enable context7
+
+# Sync configuration
+autopm mcp sync
+```
+
+## 🔑 Configuration
+
+### Environment Variables
+
+Add to `.claude/.env`:
+
+```bash
+# Optional: Minimum tokens for documentation retrieval (default: 10000)
+DEFAULT_MINIMUM_TOKENS=10000
+```
+
+Note: Context7 API key is not required for basic usage.
+
+## 🔧 Available Tools
+
+### 1. `resolve-library-id`
+Resolves a general library name into a Context7-compatible library ID.
+
+**Example:**
+```
+Library: "react" → ID: "react/latest"
+Library: "nextjs" → ID: "next/latest"
+```
+
+### 2. `get-library-docs`
+Fetches documentation for a library using a Context7-compatible library ID.
+
+**Parameters:**
+- `libraryId` (required): Context7 library ID (e.g., "react/latest")
+- `topic` (optional): Specific topic to focus on
+- `tokens` (optional): Minimum tokens to retrieve (default: 10000)
+
+**Example:**
+```
+get-library-docs("react/latest", topic="hooks")
+get-library-docs("nextjs/14", topic="app-router", tokens=15000)
+```
+
+## 📚 Usage in Agent Definitions
+
+Reference Context7 documentation in your agents:
+
+```markdown
+## MCP Servers Used
+
+This agent uses Context7 for up-to-date documentation:
+- `mcp://context7/react/latest` - React documentation
+- `mcp://context7/nextjs/14` - Next.js 14 documentation
+- `mcp://context7/typescript/latest` - TypeScript reference
+```
+
+## 🧪 Testing
+
+```bash
+# Test the connection
+autopm mcp test context7
+
+# Check status
+autopm mcp status
+
+# Verify in Claude Code
+/mcp
+```
+
+## 🔐 Security
+
+- Context7 MCP server does not require authentication for basic usage
+- Never commit `.claude/.env` with sensitive data
+- Review Context7's [privacy policy](https://context7.com/privacy)
+
+## 📖 Supported Libraries
+
+Context7 supports hundreds of libraries including:
+- **Frontend**: React, Vue, Angular, Svelte, Next.js
+- **Backend**: Express, Fastify, NestJS, Django, Flask
+- **Databases**: PostgreSQL, MongoDB, Redis, MySQL
+- **Cloud**: AWS, Azure, GCP services
+- **And many more...**
+
+Visit [Context7](https://context7.com) to browse all available documentation.
+
+## 🆘 Troubleshooting
+
+### Server Not Starting
+
+```bash
+# Check npm package is available
+npm view @upstash/context7-mcp
+
+# Reinstall
+npm install -g @upstash/context7-mcp
+
+# Test manually
+npx -y @upstash/context7-mcp
+```
+
+### Library Not Found
+
+Use `resolve-library-id` to find the correct library ID:
+```
+resolve-library-id("your-library-name")
+```
+
+### Token Limit Issues
+
+Adjust `DEFAULT_MINIMUM_TOKENS` in your environment:
+```bash
+echo "DEFAULT_MINIMUM_TOKENS=5000" >> .claude/.env
+```
+
+## 🔗 Links
+
+- **NPM Package**: https://www.npmjs.com/package/@upstash/context7-mcp
+- **GitHub**: https://github.com/upstash/context7
+- **Context7 Website**: https://context7.com
+- **Documentation**: https://upstash.com/docs/redis/integrations/mcp
+- **Blog Post**: https://upstash.com/blog/context7-mcp
+
+## 📝 Example Agent Configuration
+
+```markdown
+---
+name: react-expert
+description: React development expert with Context7 documentation
+mcpServers:
+  - context7
+---
+
+# React Expert Agent
+
+This agent has access to:
+- `mcp://context7/react/latest` - Current React documentation
+- `mcp://context7/react-router/latest` - React Router docs
+- `mcp://context7/redux/latest` - Redux documentation
+```
+
+## 🎓 Best Practices
+
+1. **Use Specific Library IDs**: `react/18` instead of `react/latest` for stability
+2. **Configure Token Limits**: Adjust based on your needs
+3. **Cache Results**: Context7 provides fresh docs but cache for performance
+4. **Topic Filtering**: Use specific topics to reduce token usage
+5. **Test Regularly**: Ensure documentation sources are accessible
+
+## 🆕 Updates
+
+Context7 MCP server is actively maintained by Upstash. Check for updates:
+
+```bash
+npm update -g @upstash/context7-mcp
+```
+
+---
+
+**Need help?** Visit [Context7 documentation](https://context7.com) or [Upstash support](https://upstash.com/support)

package/autopm/.claude/mcp/github-mcp.md

@@ -0,0 +1,350 @@
+---
+name: github-mcp
+command: npx
+args: ["@modelcontextprotocol/server-github"]
+env:
+  GITHUB_PERSONAL_ACCESS_TOKEN: "${GITHUB_TOKEN:-}"
+  GITHUB_API_URL: "${GITHUB_API_URL:-https://api.github.com}"
+envFile: .claude/.env
+description: GitHub MCP server for repository management and collaboration
+category: integration
+status: active
+version: ">=1.0.0"
+---
+
+# GitHub MCP Server
+
+## Description
+
+The GitHub MCP Server provides comprehensive GitHub integration through the Model Context Protocol, enabling repository management, issue tracking, pull request workflows, and collaborative development features.
+
+## Features
+
+- **Repository Management**: Create, clone, configure repositories
+- **Issue Tracking**: Create, update, search issues
+- **Pull Requests**: Create, review, merge PRs
+- **Actions/Workflows**: Manage GitHub Actions
+- **Code Search**: Search across repositories
+- **Release Management**: Create and manage releases
+- **Team Collaboration**: Manage teams and permissions
+
+## Configuration
+
+### Required Environment Variables
+
+- `GITHUB_PERSONAL_ACCESS_TOKEN`: Your GitHub PAT (required)
+
+### Optional Environment Variables
+
+- `GITHUB_API_URL`: GitHub API endpoint (for GitHub Enterprise)
+- `GITHUB_DEFAULT_OWNER`: Default repository owner
+- `GITHUB_DEFAULT_REPO`: Default repository name
+
+### Token Permissions
+
+Required scopes for full functionality:
+```
+repo          - Full repository access
+workflow      - GitHub Actions workflows
+write:packages - Package registry
+admin:org     - Organization management (optional)
+gist          - Gist creation (optional)
+```
+
+## Usage Examples
+
+### Basic Setup
+
+```bash
+# Enable the server
+autopm mcp enable github-mcp
+
+# Configure authentication
+echo "GITHUB_TOKEN=ghp_your_token_here" >> .claude/.env
+
+# For a specific repository
+echo "GITHUB_DEFAULT_OWNER=your-username" >> .claude/.env
+echo "GITHUB_DEFAULT_REPO=your-repo" >> .claude/.env
+
+# Sync configuration
+autopm mcp sync
+```
+
+### Integration with Agents
+
+Commonly used with:
+- `github-operations-specialist` - For DevOps workflows
+- `code-analyzer` - For PR reviews
+- `test-runner` - For CI/CD integration
+
+## MCP Commands
+
+### Repository Operations
+
+```javascript
+// Get repository info
+github.getRepository({ owner, repo })
+
+// Create repository
+github.createRepository({
+  name: "new-repo",
+  description: "Repository description",
+  private: false,
+  auto_init: true
+})
+
+// List repositories
+github.listRepositories({ type: "owner" })
+```
+
+### Issue Management
+
+```javascript
+// Create issue
+github.createIssue({
+  title: "Bug: Application crashes",
+  body: "Detailed description...",
+  labels: ["bug", "high-priority"],
+  assignees: ["username"]
+})
+
+// Update issue
+github.updateIssue({
+  issue_number: 123,
+  state: "closed",
+  labels: ["resolved"]
+})
+
+// Search issues
+github.searchIssues({
+  query: "is:open label:bug"
+})
+```
+
+### Pull Request Workflows
+
+```javascript
+// Create PR
+github.createPullRequest({
+  title: "Feature: Add new functionality",
+  head: "feature-branch",
+  base: "main",
+  body: "PR description..."
+})
+
+// Review PR
+github.createReview({
+  pull_number: 456,
+  event: "APPROVE",
+  body: "LGTM!"
+})
+
+// Merge PR
+github.mergePullRequest({
+  pull_number: 456,
+  merge_method: "squash"
+})
+```
+
+### GitHub Actions
+
+```javascript
+// Trigger workflow
+github.triggerWorkflow({
+  workflow_id: "ci.yml",
+  ref: "main",
+  inputs: { environment: "production" }
+})
+
+// Get workflow runs
+github.listWorkflowRuns({
+  workflow_id: "ci.yml",
+  status: "completed"
+})
+```
+
+## Advanced Features
+
+### Code Search
+
+```javascript
+// Search code
+github.searchCode({
+  query: "function TODO in:file language:js repo:owner/repo"
+})
+
+// Search commits
+github.searchCommits({
+  query: "fix bug author:username"
+})
+```
+
+### Release Management
+
+```javascript
+// Create release
+github.createRelease({
+  tag_name: "v1.0.0",
+  name: "Version 1.0.0",
+  body: "Release notes...",
+  draft: false,
+  prerelease: false
+})
+
+// Upload release asset
+github.uploadReleaseAsset({
+  release_id: 789,
+  name: "app.zip",
+  data: fileBuffer
+})
+```
+
+### Webhooks
+
+```javascript
+// Create webhook
+github.createWebhook({
+  config: {
+    url: "https://example.com/webhook",
+    content_type: "json"
+  },
+  events: ["push", "pull_request"]
+})
+```
+
+## Workflow Integration
+
+### Automated PR Workflow
+
+```yaml
+workflow:
+  - create_branch: feature/new-feature
+  - commit_changes:
+      message: "Add new feature"
+  - create_pr:
+      title: "Feature: New functionality"
+      reviewers: ["reviewer1", "reviewer2"]
+  - wait_for_checks: true
+  - auto_merge:
+      method: squash
+      delete_branch: true
+```
+
+### Issue Triage
+
+```yaml
+triage:
+  rules:
+    - if: "title contains 'bug'"
+      then:
+        - add_label: bug
+        - assign_to: bug-team
+    - if: "title contains 'feature'"
+      then:
+        - add_label: enhancement
+        - add_to_project: feature-requests
+```
+
+## Best Practices
+
+1. **Authentication**
+   - Use fine-grained PATs
+   - Rotate tokens regularly
+   - Store securely in .env
+
+2. **Rate Limiting**
+   - Monitor API usage
+   - Implement caching
+   - Use conditional requests
+
+3. **Branch Protection**
+   - Require PR reviews
+   - Enable status checks
+   - Protect main branch
+
+4. **Automation**
+   - Use GitHub Actions for CI/CD
+   - Automate repetitive tasks
+   - Implement proper error handling
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Authentication Failed**
+   - Verify token is valid
+   - Check token permissions
+   - Ensure token hasn't expired
+
+2. **Rate Limit Exceeded**
+   - Check rate limit status
+   - Implement exponential backoff
+   - Use authenticated requests
+
+3. **Permission Denied**
+   - Verify repository access
+   - Check organization permissions
+   - Ensure proper token scopes
+
+### Debug Mode
+
+```bash
+# Enable debug logging
+export GITHUB_DEBUG=true
+export NODE_DEBUG=github
+```
+
+## Security Considerations
+
+1. **Token Security**
+   - Never commit tokens
+   - Use environment variables
+   - Implement token rotation
+
+2. **Repository Access**
+   - Use least privilege principle
+   - Review collaborator permissions
+   - Enable 2FA
+
+3. **Webhook Security**
+   - Validate webhook signatures
+   - Use HTTPS endpoints
+   - Implement IP allowlisting
+
+## GitHub Enterprise
+
+For GitHub Enterprise Server:
+
+```bash
+# Configure enterprise URL
+export GITHUB_API_URL=https://github.enterprise.com/api/v3
+export GITHUB_GRAPHQL_URL=https://github.enterprise.com/api/graphql
+```
+
+## Rate Limits
+
+### API Limits
+- Authenticated: 5,000 requests/hour
+- Search: 30 requests/minute
+- GraphQL: 5,000 points/hour
+
+### Checking Rate Limit
+
+```javascript
+github.getRateLimit()
+// Returns: { limit, remaining, reset }
+```
+
+## Version History
+
+- **1.0.0**: Initial MCP integration
+- **1.1.0**: Added Actions support
+- **1.2.0**: GraphQL API integration
+- **1.3.0**: Enterprise support
+- **1.4.0**: Advanced search capabilities
+
+## Related Resources
+
+- [GitHub API Documentation](https://docs.github.com/en/rest)
+- [GitHub Actions](https://docs.github.com/en/actions)
+- [GitHub Operations Specialist](../agents/devops/github-operations-specialist.md)

package/autopm/.claude/mcp/playwright-mcp.md

@@ -0,0 +1,312 @@
+---
+name: playwright-mcp
+command: npx
+args: ["@playwright/mcp"]
+env:
+  PLAYWRIGHT_BROWSER: "${PLAYWRIGHT_BROWSER:-chromium}"
+  PLAYWRIGHT_HEADLESS: "${PLAYWRIGHT_HEADLESS:-true}"
+envFile: .claude/.env
+description: Playwright MCP server for browser automation and E2E testing
+category: testing
+status: active
+version: ">=1.0.0"
+---
+
+# Playwright MCP Server
+
+## Description
+
+The Playwright MCP Server enables browser automation, visual testing, and end-to-end testing capabilities through the Model Context Protocol. It provides direct browser control for testing web applications, capturing screenshots, and validating user interfaces.
+
+## Features
+
+- **Browser Automation**: Control Chromium, Firefox, and WebKit
+- **Visual Testing**: Screenshot capture and comparison
+- **E2E Testing**: Automated user flow testing
+- **Accessibility Testing**: WCAG compliance checks
+- **Performance Monitoring**: Page load metrics
+- **Network Interception**: Mock API responses
+- **Mobile Emulation**: Test responsive designs
+
+## Configuration
+
+### Environment Variables
+
+- `PLAYWRIGHT_BROWSER`: Browser engine (chromium|firefox|webkit)
+- `PLAYWRIGHT_HEADLESS`: Run in headless mode (true|false)
+- `PLAYWRIGHT_SLOW_MO`: Slow down operations by ms
+- `PLAYWRIGHT_TIMEOUT`: Default timeout in ms
+- `PLAYWRIGHT_VIDEO`: Record videos (on|off|retain-on-failure)
+- `PLAYWRIGHT_TRACE`: Record traces (on|off|retain-on-failure)
+
+### Browser Options
+
+```yaml
+browsers:
+  chromium:
+    channel: chrome  # or 'msedge', 'chrome-beta'
+    args:
+      - --disable-dev-shm-usage
+      - --no-sandbox
+  firefox:
+    firefoxUserPrefs:
+      "media.navigator.streams.fake": true
+  webkit:
+    # Safari-specific options
+```
+
+## Usage Examples
+
+### Basic Setup
+
+```bash
+# Enable the server
+autopm mcp enable playwright-mcp
+
+# Configure for headed mode during development
+echo "PLAYWRIGHT_HEADLESS=false" >> .claude/.env
+echo "PLAYWRIGHT_SLOW_MO=100" >> .claude/.env
+
+# Sync configuration
+autopm mcp sync
+```
+
+### Integration with Agents
+
+Used extensively with:
+- `e2e-test-engineer` - For E2E test creation
+- `react-frontend-engineer` - For UI testing
+- `ux-design-expert` - For visual regression
+
+### Test Examples
+
+```javascript
+// Navigation
+await page.goto('https://example.com');
+
+// Interaction
+await page.click('button#submit');
+await page.fill('input#email', 'test@example.com');
+
+// Assertions
+await expect(page).toHaveTitle('Example Site');
+await expect(page.locator('.message')).toBeVisible();
+
+// Screenshots
+await page.screenshot({ path: 'screenshot.png' });
+```
+
+## MCP Commands
+
+### Navigation
+- `navigate(url)` - Go to URL
+- `reload()` - Reload page
+- `goBack()` - Navigate back
+- `goForward()` - Navigate forward
+
+### Interaction
+- `click(selector)` - Click element
+- `fill(selector, value)` - Fill input
+- `select(selector, value)` - Select option
+- `check(selector)` - Check checkbox
+- `press(key)` - Press keyboard key
+
+### Validation
+- `screenshot(options)` - Capture screenshot
+- `textContent(selector)` - Get text
+- `isVisible(selector)` - Check visibility
+- `waitForSelector(selector)` - Wait for element
+
+## Visual Testing
+
+### Screenshot Comparison
+
+```yaml
+visual_testing:
+  baseline_dir: .playwright/baselines
+  diff_dir: .playwright/diffs
+  threshold: 0.2  # 20% difference threshold
+  ignore_areas:
+    - selector: .timestamp
+    - selector: .dynamic-content
+```
+
+### Full Page Screenshots
+
+```javascript
+await page.screenshot({
+  fullPage: true,
+  animations: 'disabled',
+  mask: ['.sensitive-data']
+});
+```
+
+## Mobile Testing
+
+### Device Emulation
+
+```javascript
+// iPhone 12
+{
+  viewport: { width: 390, height: 844 },
+  userAgent: 'Mozilla/5.0 (iPhone...)',
+  deviceScaleFactor: 3,
+  isMobile: true,
+  hasTouch: true
+}
+```
+
+### Responsive Testing
+
+```yaml
+viewports:
+  - name: mobile
+    width: 375
+    height: 667
+  - name: tablet
+    width: 768
+    height: 1024
+  - name: desktop
+    width: 1920
+    height: 1080
+```
+
+## Performance Testing
+
+### Metrics Collection
+
+```javascript
+const metrics = await page.metrics();
+// Returns: JSHeapUsedSize, Timestamp, etc.
+
+const performance = await page.evaluate(() =>
+  JSON.stringify(window.performance.timing)
+);
+```
+
+### Network Monitoring
+
+```javascript
+// Monitor requests
+page.on('request', request => {
+  console.log('Request:', request.url());
+});
+
+// Mock responses
+await page.route('**/api/*', route => {
+  route.fulfill({
+    status: 200,
+    body: JSON.stringify({ mocked: true })
+  });
+});
+```
+
+## Accessibility Testing
+
+### ARIA Validation
+
+```javascript
+const accessibilityTree = await page.accessibility.snapshot();
+```
+
+### Keyboard Navigation
+
+```javascript
+await page.keyboard.press('Tab');
+await page.keyboard.press('Enter');
+```
+
+## Debugging
+
+### Debug Mode
+
+```bash
+# Enable debugging
+export DEBUG=pw:api
+export PWDEBUG=1
+
+# Slow mode for debugging
+export PLAYWRIGHT_SLOW_MO=1000
+```
+
+### Trace Viewer
+
+```bash
+# Record trace
+npx playwright test --trace on
+
+# View trace
+npx playwright show-trace trace.zip
+```
+
+## Best Practices
+
+1. **Selectors**
+   - Use data-testid attributes
+   - Avoid fragile CSS selectors
+   - Prefer user-facing attributes
+
+2. **Waits**
+   - Use auto-waiting
+   - Avoid hard-coded delays
+   - Wait for specific conditions
+
+3. **Test Isolation**
+   - Fresh browser context per test
+   - Clean up test data
+   - No test interdependencies
+
+4. **Error Handling**
+   - Comprehensive error messages
+   - Screenshot on failure
+   - Trace on failure
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Browser Launch Failed**
+   - Install system dependencies
+   - Check browser binaries
+   - Verify permissions
+
+2. **Timeout Errors**
+   - Increase timeout values
+   - Check network conditions
+   - Verify element selectors
+
+3. **Flaky Tests**
+   - Add proper waits
+   - Mock external dependencies
+   - Use retry logic
+
+## Security Considerations
+
+1. **Credentials**
+   - Never hardcode passwords
+   - Use environment variables
+   - Implement secure storage
+
+2. **Cross-Origin**
+   - Handle CORS properly
+   - Use context isolation
+   - Validate origins
+
+3. **Data Privacy**
+   - Mask sensitive data in screenshots
+   - Clear cookies/storage
+   - Use test data only
+
+## Version History
+
+- **1.0.0**: Initial MCP integration
+- **1.1.0**: Added visual testing
+- **1.2.0**: Mobile emulation support
+- **1.3.0**: Performance metrics
+- **1.4.0**: Accessibility testing
+
+## Related Resources
+
+- [Playwright Documentation](https://playwright.dev)
+- [MCP Browser Control](https://modelcontextprotocol.org/browser)
+- [E2E Test Engineer Agent](../agents/frameworks/e2e-test-engineer.md)

package/bin/autopm.js

@@ -257,7 +257,7 @@ function main() {
 🔌 MCP (Model Context Protocol) Management:
    # List and manage MCP servers
    autopm mcp list                  # List all available MCP servers
-   autopm mcp enable context7-docs  # Enable documentation server
+   autopm mcp enable context7  # Enable documentation server
    autopm mcp sync                  # Sync configuration to .claude/mcp-servers.json
 
    # Agent Analysis
@@ -269,7 +269,7 @@ function main() {
    # Configuration & Diagnostics
    autopm mcp setup                 # Interactive API key setup
    autopm mcp diagnose              # Run comprehensive diagnostics
-   autopm mcp test context7-docs    # Test MCP server connection
+   autopm mcp test context7    # Test MCP server connection
    autopm mcp status                # Show all MCP servers status
 
 🔑 Token Setup:

package/bin/commands/mcp.js

@@ -70,14 +70,14 @@ module.exports = {
       .example('autopm mcp install @modelcontextprotocol/server-filesystem', 'Install MCP server from npm')
       .example('autopm mcp install @upstash/context7-mcp --enable', 'Install and enable immediately')
       .example('autopm mcp uninstall filesystem', 'Uninstall MCP server')
-      .example('autopm mcp enable context7-docs', 'Enable context7 documentation server')
+      .example('autopm mcp enable context7', 'Enable context7 documentation server')
       .example('autopm mcp agents', 'List all agents using MCP')
       .example('autopm mcp agent react-frontend-engineer', 'Show MCP config for specific agent')
       .example('autopm mcp usage', 'Show MCP usage statistics')
       .example('autopm mcp setup', 'Interactive API key setup')
       .example('autopm mcp check', 'Quick MCP configuration check')
       .example('autopm mcp diagnose', 'Run MCP diagnostics')
-      .example('autopm mcp test context7-docs', 'Test MCP server connection')
+      .example('autopm mcp test context7', 'Test MCP server connection')
       .example('autopm mcp tree', 'Show agent-MCP dependency tree')
       .example('autopm mcp status', 'Show MCP servers status');
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-autopm",
-  "version": "1.15.1",
+  "version": "1.15.3",
   "description": "Autonomous Project Management Framework for Claude Code - Advanced AI-powered development automation",
   "main": "bin/autopm.js",
   "bin": {

package/scripts/mcp-handler.js

@@ -1594,8 +1594,7 @@ ${pkg.repository?.url ? `- Repository: ${pkg.repository.url}` : ''}
    */
   _getCredentialInfo(serverName) {
     const info = {
-      'context7-docs': '→ Sign up at https://context7.com and get API key from dashboard',
-      'context7-codebase': '→ Same credentials as context7-docs',
+      'context7': '→ Sign up at https://context7.com and get API key from dashboard',
       'github-mcp': '→ Generate token at https://github.com/settings/tokens',
       'playwright-mcp': '→ No credentials needed - uses local Playwright installation'
     };