claude-autopm 1.31.0 → 2.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +57 -5
- package/autopm/.claude/mcp/test-server.md +10 -0
- package/bin/autopm-poc.js +176 -44
- package/bin/autopm.js +97 -179
- package/lib/ai-providers/AbstractAIProvider.js +524 -0
- package/lib/ai-providers/ClaudeProvider.js +359 -48
- package/lib/ai-providers/TemplateProvider.js +432 -0
- package/lib/cli/commands/agent.js +206 -0
- package/lib/cli/commands/config.js +488 -0
- package/lib/cli/commands/prd.js +345 -0
- package/lib/cli/commands/task.js +206 -0
- package/lib/config/ConfigManager.js +531 -0
- package/lib/errors/AIProviderError.js +164 -0
- package/lib/services/AgentService.js +557 -0
- package/lib/services/EpicService.js +609 -0
- package/lib/services/PRDService.js +928 -103
- package/lib/services/TaskService.js +760 -0
- package/lib/services/interfaces.js +753 -0
- package/lib/utils/CircuitBreaker.js +165 -0
- package/lib/utils/Encryption.js +201 -0
- package/lib/utils/RateLimiter.js +241 -0
- package/lib/utils/ServiceFactory.js +165 -0
- package/package.json +6 -5
- package/scripts/config/get.js +108 -0
- package/scripts/config/init.js +100 -0
- package/scripts/config/list-providers.js +93 -0
- package/scripts/config/set-api-key.js +107 -0
- package/scripts/config/set-provider.js +201 -0
- package/scripts/config/set.js +139 -0
- package/scripts/config/show.js +181 -0
- package/autopm/.claude/.env +0 -158
- package/autopm/.claude/settings.local.json +0 -9
package/bin/autopm.js
CHANGED
|
@@ -182,6 +182,12 @@ function main() {
|
|
|
182
182
|
.command(require('./commands/mcp'))
|
|
183
183
|
// Epic management command
|
|
184
184
|
.command(require('./commands/epic'))
|
|
185
|
+
// PRD management command (STANDALONE)
|
|
186
|
+
.command(require('../lib/cli/commands/prd'))
|
|
187
|
+
// Task management command (STANDALONE)
|
|
188
|
+
.command(require('../lib/cli/commands/task'))
|
|
189
|
+
// Agent management command (STANDALONE)
|
|
190
|
+
.command(require('../lib/cli/commands/agent'))
|
|
185
191
|
// Validation command
|
|
186
192
|
.command('validate', 'Validate ClaudeAutoPM configuration and setup',
|
|
187
193
|
(yargs) => {
|
|
@@ -226,12 +232,35 @@ function main() {
|
|
|
226
232
|
.wrap(cli.terminalWidth())
|
|
227
233
|
// Enhanced help epilogue
|
|
228
234
|
.epilogue(`
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
+
╔════════════════════════════════════════════════════════════════════════════╗
|
|
236
|
+
║ ClaudeAutoPM v${VERSION} - Quick Reference ║
|
|
237
|
+
║ AI-Powered Project Management for Claude Code ║
|
|
238
|
+
╚════════════════════════════════════════════════════════════════════════════╝
|
|
239
|
+
|
|
240
|
+
🚀 Quick Start (3 Steps):
|
|
241
|
+
1. autopm install # Install framework in project
|
|
242
|
+
2. autopm config set provider github # Configure your provider
|
|
243
|
+
3. claude --dangerously-skip-permissions . # Open Claude Code
|
|
244
|
+
|
|
245
|
+
🆕 NEW in v2.1.0 - STANDALONE Commands:
|
|
246
|
+
autopm prd parse <name> # Parse PRD without AI overhead
|
|
247
|
+
autopm prd extract-epics <name> # Extract epics from PRD
|
|
248
|
+
autopm prd summarize <name> # Generate PRD summary
|
|
249
|
+
autopm prd validate <name> # Validate PRD structure
|
|
250
|
+
|
|
251
|
+
autopm task list <epic> # List tasks from epic
|
|
252
|
+
autopm task prioritize <epic> # AI-powered prioritization
|
|
253
|
+
|
|
254
|
+
autopm agent list # List available agents
|
|
255
|
+
autopm agent search <keyword> # Search agents
|
|
256
|
+
autopm agent invoke <name> <task> # Invoke agent directly
|
|
257
|
+
|
|
258
|
+
📋 Common Commands:
|
|
259
|
+
autopm validate # Check configuration status
|
|
260
|
+
autopm update # Update to latest version
|
|
261
|
+
autopm team load fullstack # Load development agents
|
|
262
|
+
autopm mcp enable context7 # Enable documentation access
|
|
263
|
+
autopm config show # View current configuration
|
|
235
264
|
|
|
236
265
|
🔧 Configuration Setup:
|
|
237
266
|
# View current configuration
|
|
@@ -283,187 +312,76 @@ function main() {
|
|
|
283
312
|
|
|
284
313
|
🤖 Team Management:
|
|
285
314
|
autopm team list # See all available agent teams
|
|
286
|
-
autopm team load
|
|
287
|
-
autopm team load backend # Load Python/Node.js agents
|
|
288
|
-
autopm team load fullstack # Load complete development stack
|
|
289
|
-
autopm team load devops # Load Docker/K8s/CI-CD agents
|
|
315
|
+
autopm team load <name> # Load specific team (frontend/backend/fullstack/devops)
|
|
290
316
|
autopm team current # Check currently active team
|
|
291
|
-
autopm team reset # Reset to default team
|
|
292
317
|
|
|
293
|
-
💡 Claude Code
|
|
294
|
-
/pm:what-next # ⭐ Smart suggestions for
|
|
318
|
+
💡 Claude Code Workflows (In-Editor Commands):
|
|
319
|
+
/pm:what-next # ⭐ Smart suggestions for next steps
|
|
295
320
|
/pm:status # Project overview and health
|
|
296
|
-
/pm:
|
|
297
|
-
/pm:
|
|
298
|
-
/pm:
|
|
299
|
-
/pm:
|
|
300
|
-
/pm:
|
|
301
|
-
/pm:
|
|
302
|
-
/pm:
|
|
303
|
-
/pm:issue-start TASK-123 # Start working on specific task
|
|
304
|
-
/pm:issue-show TASK-123 # View task details
|
|
305
|
-
/pm:issue-close TASK-123 # Close completed task
|
|
306
|
-
/pm:standup # Generate daily standup summary
|
|
307
|
-
/pm:search keyword # Search across PRDs and epics
|
|
308
|
-
/pm:help # Show all PM commands
|
|
309
|
-
|
|
310
|
-
📋 PM Workflow Decision Guide:
|
|
311
|
-
|
|
312
|
-
WHEN TO USE ONE EPIC (/pm:epic-decompose):
|
|
313
|
-
✅ Simple feature (1-2 weeks)
|
|
314
|
-
✅ Single component (frontend OR backend)
|
|
315
|
-
✅ One developer
|
|
316
|
-
Examples: "User profile page", "REST API endpoint"
|
|
317
|
-
|
|
318
|
-
WHEN TO USE MULTIPLE EPICS (/pm:epic-split):
|
|
319
|
-
✅ Complex project (2+ months)
|
|
320
|
-
✅ Multiple components (frontend + backend + infra)
|
|
321
|
-
✅ Multiple teams working in parallel
|
|
322
|
-
Examples: "E-commerce platform", "Social dashboard"
|
|
323
|
-
|
|
324
|
-
SIMPLE FEATURE FLOW:
|
|
325
|
-
/pm:prd-new feature → /pm:prd-parse feature → /pm:epic-decompose feature
|
|
326
|
-
|
|
327
|
-
COMPLEX PROJECT FLOW:
|
|
328
|
-
/pm:prd-new project → /pm:prd-parse project → /pm:epic-split project
|
|
329
|
-
→ /pm:epic-decompose project/01-epic1 → /pm:epic-decompose project/02-epic2 ...
|
|
330
|
-
|
|
331
|
-
📖 Full Guide: See PM-WORKFLOW-GUIDE.md
|
|
332
|
-
|
|
333
|
-
🚀 Complete Workflows:
|
|
334
|
-
|
|
335
|
-
=== GITHUB WORKFLOW (PRD → Epic → Issues) ===
|
|
336
|
-
1. autopm install # Setup project framework
|
|
337
|
-
2. autopm config set provider github # Set provider
|
|
338
|
-
autopm config set github.owner <username>
|
|
339
|
-
autopm config set github.repo <repository>
|
|
340
|
-
export GITHUB_TOKEN=<your-token>
|
|
341
|
-
3. autopm team load fullstack # Load appropriate agents
|
|
342
|
-
4. claude --dangerously-skip-permissions . # Open Claude Code
|
|
343
|
-
5. /pm:validate # Verify GitHub integration
|
|
344
|
-
|
|
345
|
-
6. /pm:prd-new user-auth # Create Product Requirements Document
|
|
346
|
-
7. /pm:prd-parse user-auth # Parse PRD into structured format
|
|
347
|
-
8. /pm:epic-split user-auth # [OPTIONAL] Split complex PRD into multiple epics
|
|
348
|
-
9. /pm:epic-decompose user-auth # Break PRD/Epic into Issues
|
|
349
|
-
10. /pm:epic-sync user-auth # Create GitHub Epic + Issues
|
|
350
|
-
11. /pm:next # Get next priority issue
|
|
351
|
-
12. /pm:issue-start ISSUE-123 # Start working on specific issue
|
|
352
|
-
13. # ... development work ...
|
|
353
|
-
14. /pm:issue-close ISSUE-123 # Close completed issue
|
|
354
|
-
15. /pm:standup # Generate progress summary
|
|
355
|
-
|
|
356
|
-
=== AZURE DEVOPS WORKFLOW (PRD → User Stories → Tasks) ===
|
|
357
|
-
1. autopm install # Setup project framework
|
|
358
|
-
2. autopm config set provider azure # Set provider
|
|
359
|
-
autopm config set azure.organization <org>
|
|
360
|
-
autopm config set azure.project <project>
|
|
361
|
-
export AZURE_DEVOPS_PAT=<your-pat>
|
|
362
|
-
3. autopm team load fullstack # Load appropriate agents
|
|
363
|
-
4. claude --dangerously-skip-permissions . # Open Claude Code
|
|
364
|
-
5. /pm:validate # Verify Azure DevOps integration
|
|
365
|
-
|
|
366
|
-
6. /pm:prd-new user-auth # Create Product Requirements Document
|
|
367
|
-
7. /pm:prd-parse user-auth # Parse PRD into structured format
|
|
368
|
-
8. /pm:epic-split user-auth # [OPTIONAL] Split complex PRD into multiple epics
|
|
369
|
-
9. /pm:epic-decompose user-auth # Break PRD/Epic into User Stories + Tasks
|
|
370
|
-
10. /pm:epic-sync user-auth # Create Azure Epic + User Stories + Tasks
|
|
371
|
-
11. /pm:next # Get next priority task
|
|
372
|
-
12. /pm:issue-start TASK-123 # Start working on specific task
|
|
373
|
-
13. # ... development work ...
|
|
374
|
-
14. /pm:issue-close TASK-123 # Close completed task
|
|
375
|
-
15. /pm:standup # Generate sprint summary
|
|
376
|
-
|
|
377
|
-
=== COMPLEX PROJECT WORKFLOW (Multi-Epic Split) ===
|
|
378
|
-
Example: Full-stack e-commerce platform
|
|
379
|
-
|
|
380
|
-
6. /pm:prd-new ecommerce-platform
|
|
381
|
-
7. /pm:prd-parse ecommerce-platform
|
|
382
|
-
8. /pm:epic-split ecommerce-platform # → Creates 6 epics automatically
|
|
383
|
-
→ Epic 1: Infrastructure Foundation (Docker, DB, monitoring)
|
|
384
|
-
→ Epic 2: Authentication Backend (JWT, users, RBAC)
|
|
385
|
-
→ Epic 3: Product API Services (catalog, inventory, orders)
|
|
386
|
-
→ Epic 4: Frontend Foundation (React setup, state management)
|
|
387
|
-
→ Epic 5: E-commerce UI (product pages, cart, checkout)
|
|
388
|
-
→ Epic 6: Testing & Deployment (CI/CD, quality gates)
|
|
389
|
-
9. /pm:epic-decompose ecommerce-platform/01-infrastructure # Decompose each epic
|
|
390
|
-
10. /pm:epic-decompose ecommerce-platform/02-auth-backend
|
|
391
|
-
11. ... (repeat for each epic)
|
|
392
|
-
12. /pm:epic-sync ecommerce-platform # Sync all epics to provider
|
|
393
|
-
13. /pm:next # Start with P0 infrastructure epic
|
|
394
|
-
|
|
395
|
-
📋 Detailed Step-by-Step Examples:
|
|
396
|
-
|
|
397
|
-
STEP 6 - Creating PRD:
|
|
398
|
-
/pm:prd-new user-authentication
|
|
399
|
-
→ Creates: .claude/prds/user-authentication.md
|
|
400
|
-
→ Contains: Problem statement, user stories, acceptance criteria
|
|
401
|
-
|
|
402
|
-
STEP 7 - Parsing PRD:
|
|
403
|
-
/pm:prd-parse user-authentication
|
|
404
|
-
→ Analyzes PRD content and structure
|
|
405
|
-
→ Prepares for epic decomposition
|
|
406
|
-
|
|
407
|
-
STEP 8 - Epic Split (Optional for Complex Projects):
|
|
408
|
-
/pm:epic-split user-authentication
|
|
409
|
-
→ Analyzes PRD complexity and identifies logical divisions
|
|
410
|
-
→ Splits into multiple epics: Infrastructure, Backend, Frontend, UI, etc.
|
|
411
|
-
→ Creates structured epic hierarchy with dependencies
|
|
412
|
-
→ Example: 6 epics identified (Infrastructure, Auth Backend, Frontend, etc.)
|
|
413
|
-
→ Use when: Multi-component projects, large teams, parallel work needed
|
|
414
|
-
|
|
415
|
-
STEP 9 - Epic Decomposition:
|
|
416
|
-
/pm:epic-decompose user-authentication
|
|
417
|
-
→ GitHub: Creates Epic with linked Issues
|
|
418
|
-
→ Azure: Creates Epic with User Stories and child Tasks
|
|
419
|
-
→ File: .claude/epics/user-authentication.md (or multiple epic folders if split)
|
|
420
|
-
|
|
421
|
-
STEP 10 - Sync with Provider:
|
|
422
|
-
/pm:epic-sync user-authentication
|
|
423
|
-
→ GitHub: Creates Epic + Issues in repository
|
|
424
|
-
→ Azure: Creates Epic + User Stories + Tasks in project
|
|
425
|
-
→ Links local files with remote work items
|
|
426
|
-
|
|
427
|
-
STEP 11 - Get Next Work:
|
|
428
|
-
/pm:next
|
|
429
|
-
→ Returns highest priority unassigned item
|
|
430
|
-
→ GitHub: Next issue to work on
|
|
431
|
-
→ Azure: Next task to work on
|
|
432
|
-
|
|
433
|
-
STEP 12 - Start Development:
|
|
434
|
-
/pm:issue-start USER-AUTH-001
|
|
435
|
-
→ Assigns work item to you
|
|
436
|
-
→ Updates status to "In Progress"
|
|
437
|
-
→ Creates development branch (if configured)
|
|
438
|
-
|
|
439
|
-
STEP 13 - Complete Work:
|
|
440
|
-
/pm:issue-close USER-AUTH-001
|
|
441
|
-
→ Updates status to "Done/Closed"
|
|
442
|
-
→ Links commits and PR (if available)
|
|
443
|
-
→ Updates epic progress tracking
|
|
321
|
+
/pm:prd-new <name> # Create new PRD
|
|
322
|
+
/pm:epic-decompose <name> # Break PRD into tasks
|
|
323
|
+
/pm:epic-sync <name> # Sync to GitHub/Azure
|
|
324
|
+
/pm:next # Get next priority task
|
|
325
|
+
/pm:issue-start <id> # Start working on task
|
|
326
|
+
/pm:issue-close <id> # Complete task
|
|
327
|
+
/pm:standup # Generate daily summary
|
|
444
328
|
|
|
445
|
-
|
|
446
|
-
# Check installation and configuration
|
|
447
|
-
autopm validate # Comprehensive status check
|
|
448
|
-
ls -la .claude/ # Should show: agents/, commands/, config.json
|
|
329
|
+
📋 Quick Workflow Examples:
|
|
449
330
|
|
|
450
|
-
|
|
451
|
-
/pm:
|
|
452
|
-
|
|
331
|
+
SIMPLE FEATURE (Use this for most tasks):
|
|
332
|
+
1. /pm:prd-new user-login # Create PRD
|
|
333
|
+
2. /pm:epic-decompose user-login # Break into tasks
|
|
334
|
+
3. /pm:epic-sync user-login # Push to GitHub/Azure
|
|
335
|
+
4. /pm:next # Start working
|
|
453
336
|
|
|
454
|
-
|
|
455
|
-
|
|
456
|
-
|
|
337
|
+
COMPLEX PROJECT (Multiple epics):
|
|
338
|
+
1. /pm:prd-new ecommerce # Create PRD
|
|
339
|
+
2. /pm:epic-split ecommerce # Split into multiple epics
|
|
340
|
+
3. /pm:epic-decompose ecommerce/01-backend # Decompose each epic
|
|
341
|
+
4. /pm:epic-sync ecommerce # Sync all epics
|
|
342
|
+
|
|
343
|
+
🔍 Using STANDALONE Commands:
|
|
344
|
+
|
|
345
|
+
# Parse PRD without AI (fast, deterministic)
|
|
346
|
+
autopm prd parse my-feature
|
|
347
|
+
|
|
348
|
+
# AI-powered parsing with streaming output
|
|
349
|
+
autopm prd parse my-feature --ai --stream
|
|
457
350
|
|
|
458
|
-
|
|
459
|
-
autopm
|
|
460
|
-
autopm
|
|
461
|
-
|
|
351
|
+
# Extract and validate
|
|
352
|
+
autopm prd extract-epics my-feature
|
|
353
|
+
autopm prd validate my-feature --fix
|
|
354
|
+
|
|
355
|
+
# Task management
|
|
356
|
+
autopm task list epic-001
|
|
357
|
+
autopm task prioritize epic-001
|
|
358
|
+
|
|
359
|
+
# Agent invocation
|
|
360
|
+
autopm agent search kubernetes
|
|
361
|
+
autopm agent invoke aws-architect "Design VPC" --stream
|
|
362
|
+
|
|
363
|
+
🛠️ Troubleshooting:
|
|
364
|
+
autopm validate # Check installation & config
|
|
365
|
+
autopm validate --fix # Auto-fix common issues
|
|
366
|
+
autopm mcp diagnose # Check MCP server health
|
|
367
|
+
autopm install --force # Reinstall framework
|
|
462
368
|
|
|
463
|
-
📚 Resources:
|
|
464
|
-
Documentation:
|
|
465
|
-
Report Issues:
|
|
466
|
-
|
|
369
|
+
📚 Resources & Help:
|
|
370
|
+
📖 Documentation: https://github.com/rafeekpro/ClaudeAutoPM
|
|
371
|
+
🐛 Report Issues: https://github.com/rafeekpro/ClaudeAutoPM/issues
|
|
372
|
+
💬 Discussions: https://github.com/rafeekpro/ClaudeAutoPM/discussions
|
|
373
|
+
📦 npm Package: https://www.npmjs.com/package/claude-autopm
|
|
374
|
+
|
|
375
|
+
💡 Pro Tips:
|
|
376
|
+
• Use \`autopm --help\` to see this guide anytime
|
|
377
|
+
• Run \`autopm validate\` after configuration changes
|
|
378
|
+
• Use \`--stream\` flag for real-time AI responses
|
|
379
|
+
• Check \`autopm mcp status\` to verify documentation access
|
|
380
|
+
• Load appropriate team before starting work (frontend/backend/fullstack)
|
|
381
|
+
|
|
382
|
+
╔════════════════════════════════════════════════════════════════════════════╗
|
|
383
|
+
║ Need more help? Run: autopm <command> --help for detailed command docs ║
|
|
384
|
+
╚════════════════════════════════════════════════════════════════════════════╝
|
|
467
385
|
`)
|
|
468
386
|
.fail((msg, err, yargs) => {
|
|
469
387
|
if (err) {
|