claude-autopm 1.10.2 β†’ 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
- You are displaying comprehensive information about a GitHub issue and related sub-issues for: **Issue #$ARGUMENTS**
17
-
18
- ### 1. Fetch Issue Data
19
- - Use `gh issue view #$ARGUMENTS` to get GitHub issue details
20
- - Look for local task file: first check `.claude/epics/*/$ARGUMENTS.md` (new naming)
21
- - If not found, search for file with `github:.*issues/$ARGUMENTS` in frontmatter (old naming)
22
- - Check for related issues and sub-tasks
23
-
24
- ### 2. Issue Overview
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
@@ -4,145 +4,23 @@ allowed-tools: Bash, Read, Write, LS
4
4
 
5
5
  # PRD New
6
6
 
7
- Launch brainstorming for new product requirement document.
7
+ Launch interactive brainstorming session for new product requirement document.
8
8
 
9
9
  ## Usage
10
10
  ```
11
11
  /pm:prd-new <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
- ### Input Validation
25
- 1. **Validate feature name format:**
26
- - Must contain only lowercase letters, numbers, and hyphens
27
- - Must start with a letter
28
- - No spaces or special characters allowed
29
- - If invalid, tell user: "❌ Feature name must be kebab-case (lowercase letters, numbers, hyphens only). Examples: user-auth, payment-v2, notification-system"
30
-
31
- 2. **Check for existing PRD:**
32
- - Check if `.claude/prds/$ARGUMENTS.md` already exists
33
- - If it exists, ask user: "⚠️ PRD '$ARGUMENTS' already exists. Do you want to overwrite it? (yes/no)"
34
- - Only proceed with explicit 'yes' confirmation
35
- - If user says no, suggest: "Use a different name or run: /pm:prd-parse $ARGUMENTS to create an epic from the existing PRD"
36
-
37
- 3. **Verify directory structure:**
38
- - Check if `.claude/prds/` directory exists
39
- - If not, create it first
40
- - If unable to create, tell user: "❌ Cannot create PRD directory. Please manually create: .claude/prds/"
41
-
42
14
  ## Instructions
43
15
 
44
- You are a product manager creating a comprehensive Product Requirements Document (PRD) for: **$ARGUMENTS**
45
-
46
- Follow this structured approach:
47
-
48
- ### 1. Discovery & Context
49
- - Ask clarifying questions about the feature/product "$ARGUMENTS"
50
- - Understand the problem being solved
51
- - Identify target users and use cases
52
- - Gather constraints and requirements
53
-
54
- ### 2. PRD Structure
55
- Create a comprehensive PRD with these sections:
56
-
57
- #### Executive Summary
58
- - Brief overview and value proposition
59
-
60
- #### Problem Statement
61
- - What problem are we solving?
62
- - Why is this important now?
63
-
64
- #### User Stories
65
- - Primary user personas
66
- - Detailed user journeys
67
- - Pain points being addressed
68
-
69
- #### Requirements
70
- **Functional Requirements**
71
- - Core features and capabilities
72
- - User interactions and flows
73
-
74
- **Non-Functional Requirements**
75
- - Performance expectations
76
- - Security considerations
77
- - Scalability needs
78
-
79
- #### Success Criteria
80
- - Measurable outcomes
81
- - Key metrics and KPIs
82
-
83
- #### Constraints & Assumptions
84
- - Technical limitations
85
- - Timeline constraints
86
- - Resource limitations
87
-
88
- #### Out of Scope
89
- - What we're explicitly NOT building
90
-
91
- #### Dependencies
92
- - External dependencies
93
- - Internal team dependencies
94
-
95
- ### 3. File Format with Frontmatter
96
- Save the completed PRD to: `.claude/prds/$ARGUMENTS.md` with this exact structure:
97
-
98
- ```markdown
99
- ---
100
- name: $ARGUMENTS
101
- description: [Brief one-line description of the PRD]
102
- status: backlog
103
- created: [Current ISO date/time]
104
- ---
105
-
106
- # PRD: $ARGUMENTS
107
-
108
- ## Executive Summary
109
- [Content...]
110
-
111
- ## Problem Statement
112
- [Content...]
113
-
114
- [Continue with all sections...]
115
- ```
116
-
117
- ### 4. Frontmatter Guidelines
118
- - **name**: Use the exact feature name (same as $ARGUMENTS)
119
- - **description**: Write a concise one-line summary of what this PRD covers
120
- - **status**: Always start with "backlog" for new PRDs
121
- - **created**: Get REAL current datetime by running: `date -u +"%Y-%m-%dT%H:%M:%SZ"`
122
- - Never use placeholder text
123
- - Must be actual system time in ISO 8601 format
124
-
125
- ### 5. Quality Checks
126
-
127
- Before saving the PRD, verify:
128
- - [ ] All sections are complete (no placeholder text)
129
- - [ ] User stories include acceptance criteria
130
- - [ ] Success criteria are measurable
131
- - [ ] Dependencies are clearly identified
132
- - [ ] Out of scope items are explicitly listed
133
-
134
- ### 6. Post-Creation
135
-
136
- After successfully creating the PRD:
137
- 1. Confirm: "βœ… PRD created: .claude/prds/$ARGUMENTS.md"
138
- 2. Show brief summary of what was captured
139
- 3. Suggest next step: "Ready to create implementation epic? Run: /pm:prd-parse $ARGUMENTS"
140
-
141
- ## Error Recovery
16
+ Run `node .claude/scripts/pm/prd-new.js $ARGUMENTS` using the Bash tool and show me the complete output.
142
17
 
143
- If any step fails:
144
- - Clearly explain what went wrong
145
- - Provide specific steps to fix the issue
146
- - Never leave partial or corrupted files
18
+ This will launch an interactive brainstorming session that will:
19
+ 1. Prompt for product vision
20
+ 2. Gather information about target users
21
+ 3. Collect key features through interactive prompts
22
+ 4. Define success metrics
23
+ 5. Capture technical considerations
24
+ 6. Generate a comprehensive PRD with proper frontmatter
147
25
 
148
- Conduct a thorough brainstorming session before writing the PRD. Ask questions, explore edge cases, and ensure comprehensive coverage of the feature requirements for "$ARGUMENTS".
26
+ The script handles all validation, creates the necessary directories, and saves the PRD to `.claude/prds/$ARGUMENTS.md`.
@@ -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
- You are a technical lead converting a Product Requirements Document into a detailed implementation epic for: **$ARGUMENTS**
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
- Focus on creating a technically sound implementation plan that addresses all PRD requirements while being practical and achievable for "$ARGUMENTS".
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
- ## IMPORTANT:
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`.
@@ -0,0 +1,52 @@
1
+ {
2
+ "base": {
3
+ "description": "Core agents available in all teams.",
4
+ "agents": [
5
+ "code-analyzer.md",
6
+ "file-analyzer.md",
7
+ "test-runner.md",
8
+ "agent-manager.md"
9
+ ]
10
+ },
11
+ "devops": {
12
+ "description": "Team for CI/CD, containerization, and infrastructure tasks.",
13
+ "inherits": ["base"],
14
+ "agents": [
15
+ "docker-containerization-expert.md",
16
+ "kubernetes-orchestrator.md",
17
+ "github-operations-specialist.md",
18
+ "azure-devops-specialist.md",
19
+ "terraform-infrastructure-expert.md"
20
+ ]
21
+ },
22
+ "python_backend": {
23
+ "description": "Team specializing in Python backend development.",
24
+ "inherits": ["base"],
25
+ "agents": [
26
+ "python-backend-expert.md",
27
+ "fastapi-backend-engineer.md",
28
+ "flask-backend-engineer.md",
29
+ "postgresql-expert.md",
30
+ "mongodb-expert.md"
31
+ ]
32
+ },
33
+ "frontend": {
34
+ "description": "Team for JavaScript/TypeScript UI development.",
35
+ "inherits": ["base"],
36
+ "agents": [
37
+ "react-ui-expert.md",
38
+ "javascript-frontend-engineer.md",
39
+ "e2e-test-engineer.md",
40
+ "ux-design-expert.md",
41
+ "tailwindcss-expert.md"
42
+ ]
43
+ },
44
+ "fullstack": {
45
+ "description": "Complete team combining frontend and backend capabilities.",
46
+ "inherits": [
47
+ "frontend",
48
+ "python_backend"
49
+ ],
50
+ "agents": []
51
+ }
52
+ }
package/bin/autopm.js CHANGED
@@ -159,7 +159,7 @@ function main() {
159
159
  πŸ“– Quick Start:
160
160
  autopm install # Install ClaudeAutoPM in current directory
161
161
  autopm team load frontend # Load React/UI development agents
162
- claude --bypass-permissions . # Open Claude Code
162
+ claude --dangerously-skip-permissions . # Open Claude Code
163
163
 
164
164
  πŸ”§ Configuration Setup:
165
165
  # View current configuration
@@ -224,7 +224,7 @@ function main() {
224
224
  autopm config set github.repo <repository>
225
225
  export GITHUB_TOKEN=<your-token>
226
226
  3. autopm team load fullstack # Load appropriate agents
227
- 4. claude --bypass-permissions . # Open Claude Code
227
+ 4. claude --dangerously-skip-permissions . # Open Claude Code
228
228
  5. /pm:validate # Verify GitHub integration
229
229
 
230
230
  6. /pm:prd-new user-auth # Create Product Requirements Document
@@ -244,7 +244,7 @@ function main() {
244
244
  autopm config set azure.project <project>
245
245
  export AZURE_DEVOPS_PAT=<your-pat>
246
246
  3. autopm team load fullstack # Load appropriate agents
247
- 4. claude --bypass-permissions . # Open Claude Code
247
+ 4. claude --dangerously-skip-permissions . # Open Claude Code
248
248
  5. /pm:validate # Verify Azure DevOps integration
249
249
 
250
250
  6. /pm:prd-new user-auth # Create Product Requirements Document
@@ -42,6 +42,7 @@ class Installer {
42
42
  '.claude/strategies',
43
43
  '.claude/mcp',
44
44
  '.claude/.env.example',
45
+ '.claude/teams.json',
45
46
  '.claude-code'
46
47
  ];
47
48
 
@@ -304,7 +304,7 @@ class InteractiveGuide {
304
304
  '🎯 Installation Complete - How to Use ClaudeAutoPM\n\n' +
305
305
  'ClaudeAutoPM is now installed! To start using it:\n\n' +
306
306
  '1. πŸ“‚ Open Claude Code in this directory\n' +
307
- '2. πŸ”“ If needed: claude --bypass-permissions\n' +
307
+ '2. πŸ”“ If needed: claude --dangerously-skip-permissions\n' +
308
308
  '3. βœ… Test with: /pm:validate\n\n' +
309
309
  'Then you can:\n' +
310
310
  'β€’ πŸ”§ Configure your provider (GitHub/Azure DevOps)\n' +
@@ -540,7 +540,7 @@ class InteractiveGuide {
540
540
  '4. Sync with your configured provider\n\n' +
541
541
  'πŸš€ Next Steps - Open Claude Code:\n\n' +
542
542
  '1. Open Claude Code in this directory\n' +
543
- '2. If needed, run: claude --bypass-permissions\n' +
543
+ '2. If needed, run: claude --dangerously-skip-permissions\n' +
544
544
  '3. Then use these PM commands:',
545
545
  [
546
546
  `/pm:prd-new ${featureName} --template`,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "claude-autopm",
3
- "version": "1.10.2",
3
+ "version": "1.10.4",
4
4
  "description": "Autonomous Project Management Framework for Claude Code - Advanced AI-powered development automation",
5
5
  "main": "bin/autopm.js",
6
6
  "bin": {