claude-autopm 1.10.3 β 1.10.4
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.
|
@@ -13,79 +13,12 @@ Display issue and sub-issues with detailed information.
|
|
|
13
13
|
|
|
14
14
|
## Instructions
|
|
15
15
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
Display issue header:
|
|
26
|
-
```
|
|
27
|
-
π« Issue #$ARGUMENTS: {Issue Title}
|
|
28
|
-
Status: {open/closed}
|
|
29
|
-
Labels: {labels}
|
|
30
|
-
Assignee: {assignee}
|
|
31
|
-
Created: {creation_date}
|
|
32
|
-
Updated: {last_update}
|
|
33
|
-
|
|
34
|
-
π Description:
|
|
35
|
-
{issue_description}
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
### 3. Local File Mapping
|
|
39
|
-
If local task file exists:
|
|
40
|
-
```
|
|
41
|
-
π Local Files:
|
|
42
|
-
Task file: .claude/epics/{epic_name}/{task_file}
|
|
43
|
-
Updates: .claude/epics/{epic_name}/updates/$ARGUMENTS/
|
|
44
|
-
Last local update: {timestamp}
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
### 4. Sub-Issues and Dependencies
|
|
48
|
-
Show related issues:
|
|
49
|
-
```
|
|
50
|
-
π Related Issues:
|
|
51
|
-
Parent Epic: #{epic_issue_number}
|
|
52
|
-
Dependencies: #{dep1}, #{dep2}
|
|
53
|
-
Blocking: #{blocked1}, #{blocked2}
|
|
54
|
-
Sub-tasks: #{sub1}, #{sub2}
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
### 5. Recent Activity
|
|
58
|
-
Display recent comments and updates:
|
|
59
|
-
```
|
|
60
|
-
π¬ Recent Activity:
|
|
61
|
-
{timestamp} - {author}: {comment_preview}
|
|
62
|
-
{timestamp} - {author}: {comment_preview}
|
|
63
|
-
|
|
64
|
-
View full thread: gh issue view #$ARGUMENTS --comments
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
### 6. Progress Tracking
|
|
68
|
-
If task file exists, show progress:
|
|
69
|
-
```
|
|
70
|
-
β
Acceptance Criteria:
|
|
71
|
-
β
Criterion 1 (completed)
|
|
72
|
-
π Criterion 2 (in progress)
|
|
73
|
-
βΈοΈ Criterion 3 (blocked)
|
|
74
|
-
β‘ Criterion 4 (not started)
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
### 7. Quick Actions
|
|
78
|
-
```
|
|
79
|
-
π Quick Actions:
|
|
80
|
-
Start work: /pm:issue-start $ARGUMENTS
|
|
81
|
-
Sync updates: /pm:issue-sync $ARGUMENTS
|
|
82
|
-
Add comment: gh issue comment #$ARGUMENTS --body "your comment"
|
|
83
|
-
View in browser: gh issue view #$ARGUMENTS --web
|
|
84
|
-
```
|
|
85
|
-
|
|
86
|
-
### 8. Error Handling
|
|
87
|
-
- Handle invalid issue numbers gracefully
|
|
88
|
-
- Check for network/authentication issues
|
|
89
|
-
- Provide helpful error messages and alternatives
|
|
90
|
-
|
|
91
|
-
Provide comprehensive issue information to help developers understand context and current status for Issue #$ARGUMENTS.
|
|
16
|
+
Run `node .claude/scripts/pm/issue-show.js $ARGUMENTS` using the Bash tool and show me the complete output.
|
|
17
|
+
|
|
18
|
+
This will display comprehensive information about the GitHub issue including:
|
|
19
|
+
1. Issue details and status
|
|
20
|
+
2. Local file mappings and task files
|
|
21
|
+
3. Sub-issues and dependencies
|
|
22
|
+
4. Recent activity and comments
|
|
23
|
+
5. Progress tracking with acceptance criteria
|
|
24
|
+
6. Quick action suggestions
|
|
@@ -11,165 +11,15 @@ Convert PRD to technical implementation epic.
|
|
|
11
11
|
/pm:prd-parse <feature_name>
|
|
12
12
|
```
|
|
13
13
|
|
|
14
|
-
## Required Rules
|
|
15
|
-
|
|
16
|
-
**IMPORTANT:** Before executing this command, read and follow:
|
|
17
|
-
- `.claude/rules/datetime.md` - For getting real current date/time
|
|
18
|
-
|
|
19
|
-
## Preflight Checklist
|
|
20
|
-
|
|
21
|
-
Before proceeding, complete these validation steps.
|
|
22
|
-
Do not bother the user with preflight checks progress ("I'm not going to ..."). Just do them and move on.
|
|
23
|
-
|
|
24
|
-
### Validation Steps
|
|
25
|
-
1. **Verify <feature_name> was provided as a parameter:**
|
|
26
|
-
- If not, tell user: "β <feature_name> was not provided as parameter. Please run: /pm:prd-parse <feature_name>"
|
|
27
|
-
- Stop execution if <feature_name> was not provided
|
|
28
|
-
|
|
29
|
-
2. **Verify PRD exists:**
|
|
30
|
-
- Check if `.claude/prds/$ARGUMENTS.md` exists
|
|
31
|
-
- If not found, tell user: "β PRD not found: $ARGUMENTS. First create it with: /pm:prd-new $ARGUMENTS"
|
|
32
|
-
- Stop execution if PRD doesn't exist
|
|
33
|
-
|
|
34
|
-
3. **Validate PRD frontmatter:**
|
|
35
|
-
- Verify PRD has valid frontmatter with: name, description, status, created
|
|
36
|
-
- If frontmatter is invalid or missing, tell user: "β Invalid PRD frontmatter. Please check: .claude/prds/$ARGUMENTS.md"
|
|
37
|
-
- Show what's missing or invalid
|
|
38
|
-
|
|
39
|
-
4. **Check for existing epic:**
|
|
40
|
-
- Check if `.claude/epics/$ARGUMENTS/epic.md` already exists
|
|
41
|
-
- If it exists, ask user: "β οΈ Epic '$ARGUMENTS' already exists. Overwrite? (yes/no)"
|
|
42
|
-
- Only proceed with explicit 'yes' confirmation
|
|
43
|
-
- If user says no, suggest: "View existing epic with: /pm:epic-show $ARGUMENTS"
|
|
44
|
-
|
|
45
|
-
5. **Verify directory permissions:**
|
|
46
|
-
- Ensure `.claude/epics/` directory exists or can be created
|
|
47
|
-
- If cannot create, tell user: "β Cannot create epic directory. Please check permissions."
|
|
48
|
-
|
|
49
14
|
## Instructions
|
|
50
15
|
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
### 1. Read the PRD
|
|
54
|
-
- Load the PRD from `.claude/prds/$ARGUMENTS.md`
|
|
55
|
-
- Analyze all requirements and constraints
|
|
56
|
-
- Understand the user stories and success criteria
|
|
57
|
-
- Extract the PRD description from frontmatter
|
|
58
|
-
|
|
59
|
-
### 2. Technical Analysis
|
|
60
|
-
- Identify architectural decisions needed
|
|
61
|
-
- Determine technology stack and approaches
|
|
62
|
-
- Map functional requirements to technical components
|
|
63
|
-
- Identify integration points and dependencies
|
|
64
|
-
|
|
65
|
-
### 3. File Format with Frontmatter
|
|
66
|
-
Create the epic file at: `.claude/epics/$ARGUMENTS/epic.md` with this exact structure:
|
|
67
|
-
|
|
68
|
-
```markdown
|
|
69
|
-
---
|
|
70
|
-
name: $ARGUMENTS
|
|
71
|
-
status: backlog
|
|
72
|
-
created: [Current ISO date/time]
|
|
73
|
-
progress: 0%
|
|
74
|
-
prd: .claude/prds/$ARGUMENTS.md
|
|
75
|
-
github: [Will be updated when synced to GitHub]
|
|
76
|
-
---
|
|
77
|
-
|
|
78
|
-
# Epic: $ARGUMENTS
|
|
79
|
-
|
|
80
|
-
## Overview
|
|
81
|
-
Brief technical summary of the implementation approach
|
|
82
|
-
|
|
83
|
-
## Architecture Decisions
|
|
84
|
-
- Key technical decisions and rationale
|
|
85
|
-
- Technology choices
|
|
86
|
-
- Design patterns to use
|
|
87
|
-
|
|
88
|
-
## Technical Approach
|
|
89
|
-
### Frontend Components
|
|
90
|
-
- UI components needed
|
|
91
|
-
- State management approach
|
|
92
|
-
- User interaction patterns
|
|
93
|
-
|
|
94
|
-
### Backend Services
|
|
95
|
-
- API endpoints required
|
|
96
|
-
- Data models and schema
|
|
97
|
-
- Business logic components
|
|
98
|
-
|
|
99
|
-
### Infrastructure
|
|
100
|
-
- Deployment considerations
|
|
101
|
-
- Scaling requirements
|
|
102
|
-
- Monitoring and observability
|
|
103
|
-
|
|
104
|
-
## Implementation Strategy
|
|
105
|
-
- Development phases
|
|
106
|
-
- Risk mitigation
|
|
107
|
-
- Testing approach
|
|
108
|
-
|
|
109
|
-
## Task Breakdown Preview
|
|
110
|
-
High-level task categories that will be created:
|
|
111
|
-
- [ ] Category 1: Description
|
|
112
|
-
- [ ] Category 2: Description
|
|
113
|
-
- [ ] etc.
|
|
114
|
-
|
|
115
|
-
## Dependencies
|
|
116
|
-
- External service dependencies
|
|
117
|
-
- Internal team dependencies
|
|
118
|
-
- Prerequisite work
|
|
119
|
-
|
|
120
|
-
## Success Criteria (Technical)
|
|
121
|
-
- Performance benchmarks
|
|
122
|
-
- Quality gates
|
|
123
|
-
- Acceptance criteria
|
|
124
|
-
|
|
125
|
-
## Estimated Effort
|
|
126
|
-
- Overall timeline estimate
|
|
127
|
-
- Resource requirements
|
|
128
|
-
- Critical path items
|
|
129
|
-
```
|
|
130
|
-
|
|
131
|
-
### 4. Frontmatter Guidelines
|
|
132
|
-
- **name**: Use the exact feature name (same as $ARGUMENTS)
|
|
133
|
-
- **status**: Always start with "backlog" for new epics
|
|
134
|
-
- **created**: Get REAL current datetime by running: `date -u +"%Y-%m-%dT%H:%M:%SZ"`
|
|
135
|
-
- **progress**: Always start with "0%" for new epics
|
|
136
|
-
- **prd**: Reference the source PRD file path
|
|
137
|
-
- **github**: Leave placeholder text - will be updated during sync
|
|
138
|
-
|
|
139
|
-
### 5. Output Location
|
|
140
|
-
Create the directory structure if it doesn't exist:
|
|
141
|
-
- `.claude/epics/$ARGUMENTS/` (directory)
|
|
142
|
-
- `.claude/epics/$ARGUMENTS/epic.md` (epic file)
|
|
143
|
-
|
|
144
|
-
### 6. Quality Validation
|
|
145
|
-
|
|
146
|
-
Before saving the epic, verify:
|
|
147
|
-
- [ ] All PRD requirements are addressed in the technical approach
|
|
148
|
-
- [ ] Task breakdown categories cover all implementation areas
|
|
149
|
-
- [ ] Dependencies are technically accurate
|
|
150
|
-
- [ ] Effort estimates are realistic
|
|
151
|
-
- [ ] Architecture decisions are justified
|
|
152
|
-
|
|
153
|
-
### 7. Post-Creation
|
|
154
|
-
|
|
155
|
-
After successfully creating the epic:
|
|
156
|
-
1. Confirm: "β
Epic created: .claude/epics/$ARGUMENTS/epic.md"
|
|
157
|
-
2. Show summary of:
|
|
158
|
-
- Number of task categories identified
|
|
159
|
-
- Key architecture decisions
|
|
160
|
-
- Estimated effort
|
|
161
|
-
3. Suggest next step: "Ready to break down into tasks? Run: /pm:epic-decompose $ARGUMENTS"
|
|
162
|
-
|
|
163
|
-
## Error Recovery
|
|
164
|
-
|
|
165
|
-
If any step fails:
|
|
166
|
-
- Clearly explain what went wrong
|
|
167
|
-
- If PRD is incomplete, list specific missing sections
|
|
168
|
-
- If technical approach is unclear, identify what needs clarification
|
|
169
|
-
- Never create an epic with incomplete information
|
|
16
|
+
Run `node .claude/scripts/pm/prd-parse.js $ARGUMENTS` using the Bash tool and show me the complete output.
|
|
170
17
|
|
|
171
|
-
|
|
18
|
+
This will convert the Product Requirements Document into a detailed technical implementation epic including:
|
|
19
|
+
1. Technical analysis and architecture decisions
|
|
20
|
+
2. Implementation strategy and phases
|
|
21
|
+
3. Task breakdown preview (limited to 10 or fewer tasks)
|
|
22
|
+
4. Dependencies and success criteria
|
|
23
|
+
5. Effort estimates and timeline
|
|
172
24
|
|
|
173
|
-
|
|
174
|
-
- Aim for as few tasks as possible and limit the total number of tasks to 10 or less.
|
|
175
|
-
- When creating the epic, identify ways to simplify and improve it. Look for ways to leverage existing functionality instead of creating more code when possible.
|
|
25
|
+
The script handles all validation, reads the PRD file, and creates the epic structure at `.claude/epics/$ARGUMENTS/epic.md`.
|