claude-autopm 3.1.0 → 3.1.2

package/packages/plugin-pm/commands/pm:prd-new.md

@@ -4,11 +4,11 @@ allowed-tools: Bash, Read, Write, LS
 
 # PRD New
 
-Launch interactive brainstorming session for new product requirement document.
+Create new product requirement document - interactively or from existing content.
 
 ## Usage
 ```
-/pm:prd-new <feature_name> [--local]
+/pm:prd-new <feature_name> [options]
 ```
 
 ## Flags
@@ -19,11 +19,62 @@ Launch interactive brainstorming session for new product requirement document.
 : No GitHub/Azure synchronization required
 : Ideal for working offline or without remote provider configured
 
-Example:
+`--content`, `-c`
+: PRD content for non-interactive mode
+: Use `@filepath` to read from file (e.g., `--content @/path/to/draft.md`)
+: Use inline text for short content (e.g., `--content "# My PRD..."`)
+: Skips interactive wizard completely
+: Ideal for importing existing PRDs or automated workflows
+
+`--force`, `-f`
+: Overwrite existing PRD file if it exists
+
+`--priority`, `-p`
+: Set PRD priority (P0/P1/P2/P3, default: P2)
+
+`--timeline`
+: Set PRD timeline (e.g., "Q1 2025")
+
+## Examples
+
+### Interactive mode (default)
+```
+/pm:prd-new user-authentication
+```
+
+### Local mode
 ```
 /pm:prd-new user-authentication --local
 ```
 
+### From existing file
+```
+/pm:prd-new payment-gateway --content @docs/drafts/payment-prd.md
+```
+
+### From clipboard/inline content
+```
+/pm:prd-new api-v2 --content "# API v2 Redesign
+
+## Problem Statement
+Current API has performance issues...
+
+## Goals
+1. Improve response times
+2. Better error handling
+"
+```
+
+### With metadata
+```
+/pm:prd-new critical-fix --content @bug-report.md --priority P0 --timeline "This Sprint"
+```
+
+### Force overwrite
+```
+/pm:prd-new existing-feature --content @updated-prd.md --force
+```
+
 ## Required Documentation Access
 
 **MANDATORY:** Before creating PRDs, query Context7 for best practices:
@@ -42,6 +93,43 @@ Example:
 
 ## Instructions
 
+### Mode Detection
+
+Parse the arguments to detect the mode:
+- If `--content @<filepath>` is present → **Content from file mode**
+- If `--content "<text>"` is present → **Content from inline text mode**
+- Otherwise → **Interactive mode**
+
+### Content from File Mode (`--content @filepath`)
+
+1. Extract the file path from `--content @<filepath>` argument
+2. Use the Read tool to read the source file content
+3. Check if target PRD already exists at `.claude/prds/<feature_name>.md`
+   - If exists and `--force` not provided → Error and stop
+   - If exists and `--force` provided → Continue (will overwrite)
+4. Prepare the PRD content:
+   - If source content starts with `---` (has frontmatter) → Use as-is
+   - If no frontmatter → Add frontmatter with:
+     ```yaml
+     ---
+     title: <feature_name>
+     status: draft
+     priority: <from --priority or P2>
+     created: <current ISO timestamp>
+     author: <from git config or "unknown">
+     timeline: <from --timeline or "TBD">
+     ---
+     ```
+5. Create directory `.claude/prds/` if it doesn't exist (use Bash: `mkdir -p .claude/prds`)
+6. Write the PRD file using the Write tool to `.claude/prds/<feature_name>.md`
+7. Confirm success and show next steps
+
+### Content from Inline Text Mode (`--content "text"`)
+
+Same as file mode, but use the inline text directly instead of reading from file.
+
+### Interactive Mode (default)
+
 Run `node .claude/scripts/pm/prd-new.js $ARGUMENTS` using the Bash tool and show me the complete output.
 
 This will launch an interactive brainstorming session that will:
@@ -52,4 +140,16 @@ This will launch an interactive brainstorming session that will:
 5. Capture technical considerations
 6. Generate a comprehensive PRD with proper frontmatter
 
-The script handles all validation, creates the necessary directories, and saves the PRD to `.claude/prds/$ARGUMENTS.md`.
+The script handles all validation, creates the necessary directories, and saves the PRD to `.claude/prds/<feature_name>.md`.
+
+## Output
+
+After successful PRD creation, show:
+```
+✅ PRD created: .claude/prds/<feature_name>.md
+
+📋 Next steps:
+  1. Review: /pm:prd-show <feature_name>
+  2. Edit:   /pm:prd-edit <feature_name>
+  3. Parse:  /pm:prd-parse <feature_name>
+```