claude-autopm 1.18.0 → 1.20.1

package/autopm/.claude/templates/claude-templates/addons/docker-agents.md

@@ -4,21 +4,21 @@ Use Docker-aware agents for containerized development:
 
 ### Docker Specialists (PRIMARY)
 
-#### docker-expert
+#### docker-containerization-expert
 **Use for**: Dockerfile optimization, multi-stage builds, security
 - Container best practices
 - Image size optimization
 - Security scanning
 - Registry management
 
-#### docker-compose-expert
+#### docker-containerization-expert
 **Use for**: Multi-container orchestration, service dependencies
 - Development environment setup
 - Service networking
 - Volume management
 - Environment configuration
 
-#### docker-development-orchestrator
+#### docker-containerization-expert
 **Use for**: Development workflows, hot reload setup
 - Volume mounting strategies
 - Development vs production configs
@@ -47,7 +47,7 @@ Use Docker-aware agents for containerized development:
 - Build optimization in Docker
 - Environment variable injection
 
-#### fastapi-backend-engineer
+#### python-backend-engineer
 - Async Python in containers
 - Uvicorn/Gunicorn configuration
 - Health check endpoints

package/autopm/.claude/templates/claude-templates/addons/minimal-agents.md

@@ -26,7 +26,7 @@ Use appropriate agents for traditional development:
 - Component architecture and state management
 - Traditional build tools (webpack, vite)
 
-#### playwright-test-engineer
+#### frontend-testing-engineer
 - E2E testing with native runners
 - Cross-browser testing
 - Test automation frameworks

package/autopm/.claude/templates/issue-decomposition/api.yaml

@@ -28,7 +28,7 @@ streams:
 
   backend:
     name: "API Implementation"
-    agent: "python-backend-expert"
+    agent: "python-backend-engineer"
     priority: 2
     parameters:
       framework: "fastapi"
@@ -63,7 +63,7 @@ streams:
 
   integration:
     name: "Integration Layer"
-    agent: "python-backend-expert"
+    agent: "python-backend-engineer"
     priority: 4
     dependencies: ["middleware"]
     tasks:

package/autopm/.claude/templates/issue-decomposition/auth.yaml

@@ -30,7 +30,7 @@ streams:
 
   backend:
     name: "Service Layer"
-    agent: "python-backend-expert"
+    agent: "python-backend-engineer"
     priority: 2
     parameters:
       framework: "fastapi"
@@ -49,7 +49,7 @@ streams:
 
   api:
     name: "API Endpoints"
-    agent: "fastapi-backend-engineer"
+    agent: "python-backend-engineer"
     priority: 3
     dependencies: ["backend"]
     tasks:
@@ -68,7 +68,7 @@ streams:
 
   frontend:
     name: "UI Components"
-    agent: "react-ui-expert"
+    agent: "react-frontend-engineer"
     priority: 4
     parameters:
       framework: "mui"
@@ -91,7 +91,7 @@ streams:
 
   tests:
     name: "Test Suite"
-    agent: "playwright-test-engineer"
+    agent: "frontend-testing-engineer"
     priority: 5
     dependencies: ["frontend", "api"]
     tasks:

package/autopm/.claude/templates/issue-decomposition/crud.yaml

@@ -29,7 +29,7 @@ streams:
 
   backend:
     name: "Service Layer"
-    agent: "python-backend-expert"
+    agent: "python-backend-engineer"
     priority: 2
     parameters:
       framework: "fastapi"
@@ -48,7 +48,7 @@ streams:
 
   api:
     name: "REST API Endpoints"
-    agent: "fastapi-backend-engineer"
+    agent: "python-backend-engineer"
     priority: 3
     dependencies: ["backend"]
     tasks:
@@ -65,7 +65,7 @@ streams:
 
   frontend:
     name: "UI Components"
-    agent: "react-ui-expert"
+    agent: "react-frontend-engineer"
     priority: 4
     parameters:
       framework: "mui"

package/autopm/.claude/templates/issue-decomposition/default.yaml

@@ -18,7 +18,7 @@ streams:
 
   backend:
     name: "Backend Implementation"
-    agent: "python-backend-expert"
+    agent: "python-backend-engineer"
     priority: 2
     dependencies: ["analysis"]
     tasks:

package/autopm/.claude/templates/issue-decomposition/ui-feature.yaml

@@ -30,7 +30,7 @@ streams:
 
   components:
     name: "Component Development"
-    agent: "react-ui-expert"
+    agent: "react-frontend-engineer"
     priority: 2
     parameters:
       framework: "mui"
@@ -83,7 +83,7 @@ streams:
 
   tests:
     name: "Testing & QA"
-    agent: "playwright-test-engineer"
+    agent: "frontend-testing-engineer"
     priority: 5
     dependencies: ["integration"]
     tasks:

package/bin/autopm.js

@@ -291,7 +291,9 @@ function main() {
    autopm team reset                # Reset to default team
 
 💡 Claude Code PM Commands:
+   /pm:what-next                    # ⭐ Smart suggestions for what to do next
    /pm:status                       # Project overview and health
+   /pm:context                      # Show current project context and progress
    /pm:validate                     # Validate configuration
    /pm:prd-new feature-name         # Create new Product Requirements Document
    /pm:prd-parse feature-name       # Parse PRD into epic structure
@@ -305,6 +307,29 @@ function main() {
    /pm:search keyword               # Search across PRDs and epics
    /pm:help                         # Show all PM commands
 
+📋 PM Workflow Decision Guide:
+
+   WHEN TO USE ONE EPIC (/pm:epic-decompose):
+   ✅ Simple feature (1-2 weeks)
+   ✅ Single component (frontend OR backend)
+   ✅ One developer
+   Examples: "User profile page", "REST API endpoint"
+
+   WHEN TO USE MULTIPLE EPICS (/pm:epic-split):
+   ✅ Complex project (2+ months)
+   ✅ Multiple components (frontend + backend + infra)
+   ✅ Multiple teams working in parallel
+   Examples: "E-commerce platform", "Social dashboard"
+
+   SIMPLE FEATURE FLOW:
+   /pm:prd-new feature → /pm:prd-parse feature → /pm:epic-decompose feature
+
+   COMPLEX PROJECT FLOW:
+   /pm:prd-new project → /pm:prd-parse project → /pm:epic-split project
+   → /pm:epic-decompose project/01-epic1 → /pm:epic-decompose project/02-epic2 ...
+
+   📖 Full Guide: See PM-WORKFLOW-GUIDE.md
+
 🚀 Complete Workflows:
 
    === GITHUB WORKFLOW (PRD → Epic → Issues) ===

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-autopm",
-  "version": "1.18.0",
+  "version": "1.20.1",
   "description": "Autonomous Project Management Framework for Claude Code - Advanced AI-powered development automation",
   "main": "bin/autopm.js",
   "bin": {
@@ -129,7 +129,6 @@
     "yargs": "^17.7.2"
   },
   "devDependencies": {
-    "@babel/preset-env": "^7.28.3",
     "@jest/globals": "^30.1.2",
     "@types/jest": "^30.0.0",
     "axios": "^1.12.2",

package/lib/agentExecutor.js.deprecated

@@ -1,101 +0,0 @@
-/**
- * Agent Executor Module
- * Handles execution of AI agents with prompts
- */
-
-const fs = require('fs-extra');
-const path = require('path');
-const { spawn } = require('child_process');
-const colors = require('./utils/colors');
-
-class AgentExecutor {
-  constructor() {
-    this.agentsPath = path.join(__dirname, '../autopm/.claude/agents');
-  }
-
-  /**
-   * Execute an agent with the given prompt
-   * @param {string} agentType - The type of agent to execute
-   * @param {string} prompt - The prompt to send to the agent
-   * @param {Object} context - Additional context for the agent
-   * @returns {Promise<Object>} The result of the agent execution
-   */
-  async run(agentType, prompt, context = {}) {
-    console.log(colors.blue(`🤖 Preparing ${agentType} agent...`));
-
-    try {
-      // Replace $ARGUMENTS in prompt with actual arguments
-      let finalPrompt = prompt;
-      if (context.arguments) {
-        finalPrompt = prompt.replace(/\$ARGUMENTS/g, context.arguments);
-      }
-
-      // Check if we're in Claude Code environment
-      const isClaudeCode = process.env.CLAUDE_CODE === 'true' ||
-                          process.env.ANTHROPIC_WORKSPACE === 'true';
-
-      if (isClaudeCode) {
-        // If in Claude Code, use the Task tool
-        console.log(colors.cyan('📋 Executing via Claude Code Task tool...'));
-        console.log(colors.gray('Prompt:'), finalPrompt.substring(0, 200) + '...');
-
-        // Claude Code should handle this through its Task tool
-        // This would be invoked by Claude when running the command
-        return {
-          status: 'success',
-          agent: agentType,
-          message: 'Agent should be executed via Claude Code Task tool',
-          prompt: finalPrompt,
-          context: context
-        };
-      }
-
-      // Not in Claude Code - show instructions
-      console.log();
-      console.log(colors.yellow('⚠️  This command requires Claude Code'));
-      console.log();
-      console.log(colors.cyan('To use AI-powered commands:'));
-      console.log();
-      console.log(colors.green('1. Open your project in Claude Code'));
-      console.log(colors.gray('2. Run commands directly in chat:'));
-      console.log(colors.gray(`   /pm:prd-new ${context.arguments || 'feature-name'}`));
-      console.log();
-      console.log(colors.blue('Why Claude Code?'));
-      console.log(colors.gray('• Interactive brainstorming sessions'));
-      console.log(colors.gray('• Intelligent context understanding'));
-      console.log(colors.gray('• Real-time Q&A during PRD creation'));
-      console.log();
-      console.log(colors.cyan('📝 What this command would do:'));
-      console.log(colors.gray('─'.repeat(60)));
-
-      // Show a summary of the command intent
-      if (agentType === 'pm-specialist' && context.arguments) {
-        console.log(colors.white(`Create PRD for: ${context.arguments}`));
-        console.log();
-        console.log('The AI agent would:');
-        console.log('1. Ask clarifying questions about the feature');
-        console.log('2. Help define user stories and requirements');
-        console.log('3. Generate comprehensive PRD document');
-        console.log(`4. Save to: .claude/prds/${context.arguments}.md`);
-      } else {
-        console.log(finalPrompt.substring(0, 300) + '...');
-      }
-      console.log(colors.gray('─'.repeat(60)));
-
-      return {
-        status: 'claude-required',
-        agent: agentType,
-        message: 'Claude Code required for AI-powered commands',
-        prompt: finalPrompt,
-        context: context
-      };
-
-    } catch (error) {
-      console.error(colors.red(`❌ Agent execution failed: ${error.message}`));
-      throw error;
-    }
-  }
-
-}
-
-module.exports = new AgentExecutor();

package/lib/azure/cache.js

@@ -1,80 +0,0 @@
-/**
- * Simple cache implementation for Azure DevOps API responses
- * Uses LRU (Least Recently Used) eviction policy
- */
-
-class AzureCache {
-  constructor(options = {}) {
-    this.ttl = options.ttl || 5 * 60 * 1000; // 5 minutes default
-    this.maxSize = options.maxSize || 100;
-    this.cache = new Map();
-    this.stats = { hits: 0, misses: 0 };
-  }
-
-  get(key) {
-    const item = this.cache.get(key);
-
-    if (!item) {
-      this.stats.misses++;
-      return null;
-    }
-
-    if (this.isExpired(item)) {
-      this.cache.delete(key);
-      this.stats.misses++;
-      return null;
-    }
-
-    // Move to end (most recently used)
-    this.cache.delete(key);
-    this.cache.set(key, item);
-
-    this.stats.hits++;
-    return item.value;
-  }
-
-  set(key, value) {
-    // Remove oldest item if at capacity
-    if (this.cache.size >= this.maxSize && !this.cache.has(key)) {
-      const firstKey = this.cache.keys().next().value;
-      this.cache.delete(firstKey);
-    }
-
-    this.cache.set(key, {
-      value,
-      timestamp: Date.now()
-    });
-  }
-
-  isExpired(item) {
-    return Date.now() - item.timestamp > this.ttl;
-  }
-
-  clear() {
-    this.cache.clear();
-    this.stats = { hits: 0, misses: 0 };
-  }
-
-  getStats() {
-    const total = this.stats.hits + this.stats.misses;
-    const hitRate = total > 0 ? (this.stats.hits / total * 100).toFixed(2) : 0;
-
-    return {
-      ...this.stats,
-      hitRate: `${hitRate}%`,
-      size: this.cache.size,
-      maxSize: this.maxSize
-    };
-  }
-
-  // Clean up expired entries
-  cleanup() {
-    for (const [key, item] of this.cache.entries()) {
-      if (this.isExpired(item)) {
-        this.cache.delete(key);
-      }
-    }
-  }
-}
-
-module.exports = AzureCache;

package/lib/azure/client.js

@@ -1,77 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Azure DevOps Client
- * Wrapper for Azure DevOps REST API
- */
-
-class AzureDevOpsClient {
-  constructor(options = {}) {
-    this.organization = options.organization;
-    this.project = options.project;
-    this.token = options.token;
-    this.baseUrl = `https://dev.azure.com/${this.organization}`;
-  }
-
-  /**
-   * Create work item
-   */
-  async createWorkItem(options) {
-    // This would make actual API call
-    console.log(`Creating ${options.type} work item`);
-    return {
-      id: Math.floor(Math.random() * 10000),
-      fields: options.fields,
-      url: `${this.baseUrl}/${this.project}/_workitems/edit/${Math.floor(Math.random() * 10000)}`
-    };
-  }
-
-  /**
-   * Update work item
-   */
-  async updateWorkItem(options) {
-    console.log(`Updating work item ${options.id}`);
-    return {
-      id: options.id,
-      fields: options.fields
-    };
-  }
-
-  /**
-   * Get work item
-   */
-  async getWorkItem(options) {
-    console.log(`Getting work item ${options.id}`);
-    return {
-      id: options.id,
-      fields: {
-        'System.Title': 'Work Item',
-        'System.State': 'Active'
-      }
-    };
-  }
-}
-
-/**
- * Create client instance
- */
-function createClient(options) {
-  return new AzureDevOpsClient(options);
-}
-
-/**
- * Get default client
- */
-function getClient() {
-  return createClient({
-    organization: process.env.AZURE_DEVOPS_ORG,
-    project: process.env.AZURE_DEVOPS_PROJECT,
-    token: process.env.AZURE_DEVOPS_PAT
-  });
-}
-
-module.exports = {
-  AzureDevOpsClient,
-  createClient,
-  getClient
-};

package/lib/azure/formatter.js

@@ -1,177 +0,0 @@
-/**
- * Azure DevOps Output Formatter
- * Formats work items and sprint data for console display
- */
-
-const Table = require('table').table;
-const chalk = require('chalk');
-
-class AzureFormatter {
-  static formatWorkItems(items, options = {}) {
-    if (!items || items.length === 0) {
-      return chalk.yellow('No work items found.');
-    }
-
-    const headers = this.getHeaders(options);
-    const rows = items.map(item => this.formatWorkItem(item, options));
-
-    const tableConfig = {
-      header: {
-        alignment: 'center',
-        content: chalk.cyan.bold('Work Items')
-      }
-    };
-
-    return Table([headers, ...rows], tableConfig);
-  }
-
-  static getHeaders(options) {
-    const headers = [
-      chalk.bold('ID'),
-      chalk.bold('Type'),
-      chalk.bold('Title'),
-      chalk.bold('State'),
-      chalk.bold('Assigned To')
-    ];
-
-    if (options.showRemaining) {
-      headers.push(chalk.bold('Remaining'));
-    }
-
-    if (options.showPriority) {
-      headers.push(chalk.bold('Priority'));
-    }
-
-    return headers;
-  }
-
-  static formatWorkItem(item, options) {
-    const fields = item.fields || {};
-    const row = [
-      chalk.blue(item.id),
-      this.getTypeIcon(fields['System.WorkItemType']),
-      this.truncate(fields['System.Title'], 50),
-      this.getStateColor(fields['System.State']),
-      this.getAssignedTo(fields['System.AssignedTo'])
-    ];
-
-    if (options.showRemaining) {
-      row.push(fields['Microsoft.VSTS.Scheduling.RemainingWork'] || '-');
-    }
-
-    if (options.showPriority) {
-      row.push(fields['Microsoft.VSTS.Common.Priority'] || '-');
-    }
-
-    return row;
-  }
-
-  static getTypeIcon(type) {
-    const icons = {
-      'Task': '📋 Task',
-      'Bug': '🐛 Bug',
-      'User Story': '📖 Story',
-      'Feature': '🎯 Feature',
-      'Epic': '🏔️  Epic'
-    };
-    return icons[type] || type;
-  }
-
-  static getStateColor(state) {
-    const colors = {
-      'New': chalk.gray(state),
-      'Active': chalk.blue(state),
-      'In Progress': chalk.yellow(state),
-      'Resolved': chalk.green(state),
-      'Closed': chalk.dim(state),
-      'Done': chalk.green(state),
-      'Removed': chalk.strikethrough(state)
-    };
-    return colors[state] || state;
-  }
-
-  static getAssignedTo(assignedTo) {
-    if (!assignedTo) return chalk.gray('Unassigned');
-    const name = assignedTo.displayName || assignedTo.uniqueName || assignedTo;
-    return this.truncate(name, 20);
-  }
-
-  static truncate(text, length) {
-    if (!text) return '';
-    if (text.length <= length) return text;
-    return text.substring(0, length - 3) + '...';
-  }
-
-  static formatSummary(items) {
-    if (!items || items.length === 0) {
-      return '';
-    }
-
-    const states = {};
-    const types = {};
-    let totalRemaining = 0;
-
-    items.forEach(item => {
-      const fields = item.fields || {};
-      const state = fields['System.State'];
-      const type = fields['System.WorkItemType'];
-      const remaining = fields['Microsoft.VSTS.Scheduling.RemainingWork'] || 0;
-
-      states[state] = (states[state] || 0) + 1;
-      types[type] = (types[type] || 0) + 1;
-      totalRemaining += remaining;
-    });
-
-    const lines = [];
-    lines.push(chalk.bold('\n📊 Summary:'));
-    lines.push(`Total items: ${chalk.cyan(items.length)}`);
-
-    if (Object.keys(types).length > 0) {
-      lines.push('\nBy Type:');
-      Object.entries(types).forEach(([type, count]) => {
-        lines.push(`  ${this.getTypeIcon(type)}: ${count}`);
-      });
-    }
-
-    if (Object.keys(states).length > 0) {
-      lines.push('\nBy State:');
-      Object.entries(states).forEach(([state, count]) => {
-        lines.push(`  ${this.getStateColor(state)}: ${count}`);
-      });
-    }
-
-    if (totalRemaining > 0) {
-      lines.push(`\nTotal Remaining Work: ${chalk.yellow(totalRemaining + ' hours')}`);
-    }
-
-    return lines.join('\n');
-  }
-
-  static formatSprintInfo(sprint) {
-    if (!sprint) {
-      return chalk.yellow('No active sprint found.');
-    }
-
-    const attributes = sprint.attributes || {};
-    const startDate = attributes.startDate ? new Date(attributes.startDate).toLocaleDateString() : 'N/A';
-    const endDate = attributes.finishDate ? new Date(attributes.finishDate).toLocaleDateString() : 'N/A';
-
-    return chalk.cyan.bold(`\n🏃 Current Sprint: ${sprint.name}\n`) +
-           `  Start: ${startDate}\n` +
-           `  End: ${endDate}\n`;
-  }
-
-  static formatError(error) {
-    return chalk.red(`\n❌ Error: ${error.message}\n`);
-  }
-
-  static formatSuccess(message) {
-    return chalk.green(`\n✅ ${message}\n`);
-  }
-
-  static formatWarning(message) {
-    return chalk.yellow(`\n⚠️  ${message}\n`);
-  }
-}
-
-module.exports = AzureFormatter;