claude-autopm 1.23.2 → 1.24.2

package/autopm/.claude/scripts/pm/prd-parse.js

@@ -295,9 +295,27 @@ class PrdParser {
       console.log(`  • Security: ${technicalApproach.security.length} controls`);
     }
 
+    // Determine if PRD is complex enough to suggest splitting
+    const componentCount =
+      (technicalApproach.frontend.length > 0 ? 1 : 0) +
+      (technicalApproach.backend.length > 0 ? 1 : 0) +
+      (technicalApproach.data.length > 0 ? 1 : 0) +
+      (technicalApproach.security.length > 0 ? 1 : 0);
+
+    const isComplexPrd = componentCount >= 3 || tasks.length > 10;
+
     console.log(`\n💡 Next Steps:`);
     console.log(`  1. Review epic: /pm:epic-show ${featureName}`);
-    console.log(`  2. Decompose into tasks: /pm:epic-decompose ${featureName}`);
+
+    if (isComplexPrd) {
+      console.log(`  2. Consider splitting into epics: /pm:epic-split ${featureName}`);
+      console.log(`     (Complex PRD detected - ${componentCount} components, ${tasks.length} tasks)`);
+      console.log(`     OR decompose as single epic: /pm:epic-decompose ${featureName}`);
+    } else {
+      console.log(`  2. Decompose into tasks: /pm:epic-decompose ${featureName}`);
+      console.log(`     (For complex PRDs, consider: /pm:epic-split ${featureName})`);
+    }
+
     console.log(`  3. Sync to GitHub: /pm:epic-sync ${featureName}`);
     console.log(`  4. Start implementation: /pm:issue-start TASK-1`);
 

package/autopm/.claude/templates/context-templates/progress.md.template

@@ -0,0 +1,25 @@
+# Project Progress
+
+## Current Status
+- Phase: [Phase name]
+- Progress: [X]%
+- Last Updated: [Date]
+
+## Completed
+- [x] Task 1
+- [x] Task 2
+
+## In Progress
+- [ ] Task 3
+- [ ] Task 4
+
+## Next Steps
+1. [Next action]
+2. [Next action]
+
+## Blockers
+- [Any blockers]
+
+## Recent Updates
+- [Recent change 1]
+- [Recent change 2]

package/autopm/.claude/templates/context-templates/project-brief.md.template

@@ -0,0 +1,19 @@
+# Project Brief
+
+## Project Name
+[Project name]
+
+## Scope & Objectives
+- Goal: [Primary goal]
+- Target users: [User base]
+- Key outcomes: [Expected results]
+
+## Constraints
+- Timeline: [Time constraints]
+- Resources: [Available resources]
+- Technical: [Technical limitations]
+
+## Success Criteria
+- [Success criterion 1]
+- [Success criterion 2]
+- [Success criterion 3]

package/autopm/.claude/templates/context-templates/project-structure.md.template

@@ -0,0 +1,23 @@
+# Project Structure
+
+## Directory Layout
+```
+project/
+├── src/           # Source code
+├── test/          # Tests
+├── .claude/       # AutoPM configuration
+└── docs/          # Documentation
+```
+
+## Key Files
+- **package.json**: Dependencies and scripts
+- **.claude/**: PM configuration
+- **README.md**: Project documentation
+
+## Module Organization
+- [Module description]
+- [Module description]
+
+## Configuration Files
+- [Config file and purpose]
+- [Config file and purpose]

package/autopm/.claude/templates/context-templates/tech-context.md.template

@@ -0,0 +1,23 @@
+# Technical Context
+
+## Technology Stack
+- **Frontend**: [Technologies]
+- **Backend**: [Technologies]
+- **Database**: [Database]
+- **Infrastructure**: [Infrastructure]
+
+## Development Environment
+- Node.js: [version]
+- Package Manager: [npm/yarn/pnpm]
+- Testing Framework: [Jest/etc]
+
+## Dependencies
+[Key dependencies and their purposes]
+
+## Architecture Patterns
+- [Pattern 1]
+- [Pattern 2]
+
+## Development Practices
+- [Practice 1]
+- [Practice 2]

package/package.json

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

package/scripts/fix-invalid-command-refs.sh

@@ -0,0 +1,141 @@
+#!/bin/bash
+# Fix invalid command references in documentation
+
+set -e
+
+echo "🔧 Fixing invalid command references..."
+
+# Replacement map (escaped for use in sed)
+declare -A REPLACEMENTS=(
+  ["\/pm:epic-new"]="\/pm:prd-new"
+  ["\/pm:done"]="\/pm:issue-close"
+  ["\/pm:next-task"]="\/pm:next"
+  ["\/pm:epic-resolve"]="\/pm:epic-close"
+  ["\/pm:epic-stop"]="\/pm:epic-close"
+  ["\/pm:prd-split"]="\/pm:epic-split"
+)
+
+# Commands to remove (no replacement) - escaped
+REMOVE_COMMANDS=(
+  "\/pm:azure-next"
+  "\/pm:azure-sync"
+  "\/pm:board"
+  "\/pm:build"
+  "\/pm:config"
+  "\/pm:optimize"
+  "\/pm:pr-create"
+  "\/pm:pr-list"
+  "\/pm:query"
+  "\/pm:release"
+  "\/pm:report"
+  "\/pm:resource"
+  "\/pm:resource-action"
+  "\/pm:sprint"
+  "\/pm:sprint-status"
+  "\/pm:sync-all"
+  "\/pm:test"
+  "\/pm:todo"
+  "\/pm:wip"
+)
+
+# Generic commands to remove (too vague) - escaped
+GENERIC_COMMANDS=(
+  "\/pm:epic"
+  "\/pm:issue"
+  "\/pm:prd"
+  "\/pm:pr"
+)
+
+total_changes=0
+
+# Function to replace in file
+replace_in_file() {
+  local file="$1"
+  local old="$2"
+  local new="$3"
+
+  if grep -q "$old" "$file" 2>/dev/null; then
+    if [[ "$OSTYPE" == "darwin"* ]]; then
+      sed -i '' "s|$old|$new|g" "$file"
+    else
+      sed -i "s|$old|$new|g" "$file"
+    fi
+    echo "  ✓ $file: $old → $new"
+    ((total_changes++))
+  fi
+}
+
+# Function to remove command references
+remove_from_file() {
+  local file="$1"
+  local cmd="$2"
+
+  if grep -q "$cmd" "$file" 2>/dev/null; then
+    # Remove lines containing the command
+    if [[ "$OSTYPE" == "darwin"* ]]; then
+      sed -i '' "/$cmd/d" "$file"
+    else
+      sed -i "/$cmd/d" "$file"
+    fi
+    echo "  ✗ $file: removed $cmd"
+    ((total_changes++))
+  fi
+}
+
+echo ""
+echo "=== Replacing commands with correct alternatives ==="
+for old in "${!REPLACEMENTS[@]}"; do
+  new="${REPLACEMENTS[$old]}"
+  echo ""
+  echo "Replacing: $old → $new"
+
+  # Find files with this command (excluding our analysis doc and script)
+  while IFS= read -r file; do
+    if [[ "$file" != *"MISSING-COMMANDS-ANALYSIS.md"* ]] && \
+       [[ "$file" != *"fix-invalid-command-refs.sh"* ]]; then
+      replace_in_file "$file" "$old" "$new"
+    fi
+  done < <(grep -rl "$old" . --include="*.md" 2>/dev/null || true)
+done
+
+echo ""
+echo "=== Removing commands with no replacement ==="
+for cmd in "${REMOVE_COMMANDS[@]}"; do
+  echo ""
+  echo "Removing: $cmd"
+
+  while IFS= read -r file; do
+    if [[ "$file" != *"MISSING-COMMANDS-ANALYSIS.md"* ]] && \
+       [[ "$file" != *"fix-invalid-command-refs.sh"* ]]; then
+      remove_from_file "$file" "$cmd"
+    fi
+  done < <(grep -rl "$cmd" . --include="*.md" 2>/dev/null || true)
+done
+
+echo ""
+echo "=== Removing generic commands (too vague) ==="
+for cmd in "${GENERIC_COMMANDS[@]}"; do
+  echo ""
+  echo "Removing: $cmd (too vague - use specific commands instead)"
+
+  while IFS= read -r file; do
+    if [[ "$file" != *"MISSING-COMMANDS-ANALYSIS.md"* ]] && \
+       [[ "$file" != *"fix-invalid-command-refs.sh"* ]] && \
+       [[ "$file" != *"COMMANDS.md"* ]]; then
+      # Only remove if it's standalone, not part of a longer command
+      if grep -E "$cmd[[:space:]]|$cmd\$|$cmd\`" "$file" &>/dev/null; then
+        remove_from_file "$file" "$cmd"
+      fi
+    fi
+  done < <(grep -rl "$cmd" . --include="*.md" 2>/dev/null || true)
+done
+
+echo ""
+echo "════════════════════════════════════════════"
+echo "✅ Complete! Total changes: $total_changes"
+echo "════════════════════════════════════════════"
+echo ""
+echo "Next steps:"
+echo "1. Review changes: git diff"
+echo "2. Test affected documentation"
+echo "3. Commit: git add . && git commit -m 'fix: remove invalid command references'"

package/scripts/fix-invalid-refs-simple.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+# Simple script to fix invalid command references
+
+set -e
+
+echo "🔧 Fixing invalid command references..."
+echo ""
+
+total=0
+
+# Function to safely replace
+safe_replace() {
+  local old="$1"
+  local new="$2"
+  local desc="$3"
+
+  echo "Replacing: $old → $new ($desc)"
+
+  # Find and replace (exclude our analysis docs)
+  find . -name "*.md" -type f ! -path "*/MISSING-COMMANDS-ANALYSIS.md" ! -path "*/node_modules/*" -exec grep -l "$old" {} \; 2>/dev/null | while read file; do
+    if [[ "$OSTYPE" == "darwin"* ]]; then
+      sed -i '' "s|$old|$new|g" "$file"
+    else
+      sed -i "s|$old|$new|g" "$file"
+    fi
+    echo "  ✓ $file"
+    ((total++)) || true
+  done
+}
+
+# Replacements
+echo "=== Step 1: Replacing with correct alternatives ==="
+safe_replace "/pm:epic-new" "/pm:prd-new" "create PRD first"
+safe_replace "/pm:done" "/pm:issue-close" "close issue"
+safe_replace "/pm:next-task" "/pm:next" "get next task"
+safe_replace "/pm:epic-resolve" "/pm:epic-close" "close epic"
+safe_replace "/pm:epic-stop" "/pm:epic-close" "close epic"
+safe_replace "/pm:prd-split" "/pm:epic-split" "split after parse"
+
+echo ""
+echo "✅ Replacements complete!"
+echo ""
+echo "📝 Note: The following invalid commands still exist in docs:"
+echo "   - Azure commands (/pm:azure-*)"
+echo "   - Generic commands (/pm:epic, /pm:issue, /pm:prd, /pm:pr)"
+echo "   - Other unimplemented commands"
+echo ""
+echo "These should be manually reviewed and removed/updated in context."
+echo "See docs/MISSING-COMMANDS-ANALYSIS.md for full list."