-
-
Notifications
You must be signed in to change notification settings - Fork 6
PM_Commands
Rafal Lagowski edited this page Sep 14, 2025
·
1 revision
PM (Project Management) commands provide a unified interface for managing projects, issues, epics, and PRDs within Claude Code. These commands work across different providers (GitHub, Azure DevOps) through the provider abstraction layer.
All PM commands follow the pattern:
/pm:resource:action [parameters]
- pm: Project Management prefix
- resource: The type of resource (issue, epic, prd, etc.)
- action: The operation to perform (show, list, create, etc.)
| Command | Description |
|---|---|
/pm:help |
Show all available commands |
/pm:init |
Initialize project management |
/pm:status |
Show project status |
/pm:standup |
Generate standup report |
/pm:next |
Show next task to work on |
Display detailed information about an issue.
/pm:issue:show 123
# Output:
Issue #123: Implement user authentication
Status: In Progress
Assignee: @developer
Labels: backend, security
Description: Add JWT-based authentication...List all open issues.
/pm:issue:list
# Output:
Open Issues:
- #123: Implement user authentication [In Progress]
- #124: Add password reset [To Do]
- #125: Setup 2FA [Blocked]Start working on an issue.
/pm:issue:start 123
# Actions performed:
✓ Issue assigned to you
✓ Status changed to "In Progress"
✓ Branch created: feature/issue-123
✓ Context loaded for developmentClose an issue with optional comment.
/pm:issue:close 123 "Implemented JWT authentication"
# Actions performed:
✓ Issue closed
✓ Comment added
✓ PR linked if existsAnalyze issue and suggest implementation approach.
/pm:issue:analyze 123
# Output:
Analysis for Issue #123:
- Estimated effort: 8 hours
- Suggested approach: JWT with refresh tokens
- Dependencies: bcrypt, jsonwebtoken
- Test scenarios: 5 identifiedList all epics in the project.
/pm:epic:list
# Output:
Active Epics:
- Epic: User Management System [40% complete]
└─ #123: Authentication [Done]
└─ #124: Authorization [In Progress]
└─ #125: User Profile [To Do]Show epic details with child items.
/pm:epic:show user-management
# Output:
Epic: User Management System
Progress: 40% (4/10 issues complete)
Timeline: Sprint 3-5
Child Issues:
- Authentication ✓
- Authorization ⚡
- Profile Management ○Break down epic into manageable issues.
/pm:epic:decompose "Payment Integration"
# Creates:
- Setup payment provider
- Implement checkout flow
- Add payment methods
- Handle webhooks
- Add refund capabilityBegin work on an epic.
/pm:epic:start payment-integration
# Actions:
✓ Epic marked as active
✓ First issue selected
✓ Development branch created
✓ Context preparedCreate a new PRD.
/pm:prd:new "Mobile App MVP"
# Creates PRD with:
- Overview section
- User stories
- Technical requirements
- Success criteria
- TimelineList all PRDs.
/pm:prd:list
# Output:
Product Requirements:
1. Mobile App MVP [Draft]
2. API v2.0 [Approved]
3. Analytics Dashboard [In Review]Parse PRD and create work items.
/pm:prd:parse docs/mobile-app-prd.md
# Creates:
✓ Epic: Mobile App MVP
✓ 12 User Stories
✓ 28 Technical Tasks
✓ 5 Test ScenariosShow PRD implementation status.
/pm:prd:status mobile-app
# Output:
PRD: Mobile App MVP
Status: 35% Complete
- ✓ Authentication (100%)
- ⚡ Core Features (60%)
- ○ Push Notifications (0%)Initialize project management for the repository.
/pm:init
# Actions:
✓ Provider detected: GitHub
✓ Repository connected
✓ Labels created
✓ Milestones setup
✓ Project board initializedShow overall project status.
/pm:status
# Output:
Project Status:
- Sprint: 14 (Week 2)
- Velocity: 23 points/sprint
- Open Issues: 45
- In Progress: 8
- Blocked: 2
- Completed This Sprint: 12Generate daily standup report.
/pm:standup
# Output:
Daily Standup - 2024-01-15
Yesterday:
- Completed authentication module
- Fixed critical bug in payment flow
Today:
- Implement password reset
- Review PRs #45, #46
Blockers:
- Waiting for API documentationGet the next recommended task.
/pm:next
# Output:
Recommended Next Task:
Issue #124: Add password reset
Priority: High
Estimated: 4 hours
Dependencies: None
Context: Follows authentication workShow all blocked items.
/pm:blocked
# Output:
Blocked Items:
- #125: 2FA Setup - Awaiting security review
- #189: Data Migration - Database access needed
- Epic: Reporting - Missing requirementsClean up completed items.
/pm:clean
# Actions:
✓ Closed 12 completed issues
✓ Archived 3 old epics
✓ Removed stale branches
✓ Updated project boardSearch across all work items.
/pm:search "authentication"
# Results:
- Issue #123: JWT authentication
- Epic: User Management
- PRD: Security Requirements
- PR #45: Add auth middlewareValidate project configuration.
/pm:validate
# Output:
✓ GitHub connection valid
✓ Labels configured correctly
✓ Workflows active
✓ No orphaned issues
⚠ 2 issues missing estimatesSynchronize with remote provider.
/pm:sync
# Actions:
✓ Fetched latest issues
✓ Updated local cache
✓ Synced labels
✓ Refreshed milestonesImport issues from external source.
/pm:import jira-export.json
# Output:
Imported:
- 45 issues
- 8 epics
- 120 comments
- 15 labelsMerge one epic into another.
/pm:epic:merge old-auth new-auth
# Actions:
✓ Moved 8 issues
✓ Updated descriptions
✓ Archived source epicRefresh epic from child issues.
/pm:epic:refresh user-management
# Updates:
✓ Progress: 60% → 75%
✓ Status: Active → Near Completion
✓ Timeline: Updated estimatesUpdate test references in issues.
/pm:test:reference:update
# Actions:
✓ Scanned 45 issues
✓ Updated 12 test links
✓ Fixed 3 broken references- Issues map to GitHub Issues
- Epics use GitHub Projects
- PRDs stored as markdown in repo
- Labels for categorization
- Issues map to Work Items
- Epics use Azure Epics
- PRDs as wiki pages
- Area paths for organization
In .claude/config.json:
{
"projectManagement": {
"provider": "github",
"repository": "owner/repo",
"project": "Project Name",
"features": {
"auto_assign": true,
"auto_label": true,
"epic_tracking": true
}
}
}Create custom aliases in .claude/commands/pm/aliases.md:
/pm:todo → /pm:issue:list --assignee=@me --status=todo
/pm:wip → /pm:issue:list --status=in-progress
/pm:done → /pm:issue:list --status=done --sprint=current-
Regular Sync: Run
/pm:syncdaily -
Status Updates: Use
/pm:standupfor daily updates - Epic Decomposition: Break down epics before starting
-
Validation: Run
/pm:validateweekly -
Clean Up: Use
/pm:cleanat sprint end
/pm:help
# Shows all available commands
# If still not working:
- Check provider configuration
- Verify authentication
- Run /pm:init# Force refresh
/pm:sync --force
# Check connection
/pm:validate# Clear cache
/pm:clean --cache
# Optimize queries
/pm:sync --optimize