fix: Add explicit plan filename naming guidance (#76)
The /workflows:plan skill was producing inconsistent plan filenames (sometimes gibberish, sometimes descriptive) because it lacked explicit rules for converting issue titles to filenames. Changes: - Step 2: Added instruction to convert title to kebab-case filename with example transformation (feat: Add User Auth → feat-add-user-auth.md) - Output Format: Replaced vague <issue_title> placeholder with clear pattern and good/bad examples Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -49,8 +49,11 @@ Think like a product manager - what would make this issue clear and actionable?
|
|||||||
|
|
||||||
**Title & Categorization:**
|
**Title & Categorization:**
|
||||||
|
|
||||||
- [ ] Draft clear, searchable issue title using conventional format (e.g., `feat:`, `fix:`, `docs:`)
|
- [ ] Draft clear, searchable issue title using conventional format (e.g., `feat: Add user authentication`, `fix: Cart total calculation`)
|
||||||
- [ ] Determine issue type: enhancement, bug, refactor
|
- [ ] Determine issue type: enhancement, bug, refactor
|
||||||
|
- [ ] Convert title to kebab-case filename: strip prefix colon, lowercase, hyphens for spaces
|
||||||
|
- Example: `feat: Add User Authentication` → `feat-add-user-authentication.md`
|
||||||
|
- Keep it descriptive (3-5 words after prefix) so plans are findable by context
|
||||||
|
|
||||||
**Stakeholder Analysis:**
|
**Stakeholder Analysis:**
|
||||||
|
|
||||||
@@ -368,7 +371,19 @@ end
|
|||||||
|
|
||||||
## Output Format
|
## Output Format
|
||||||
|
|
||||||
Write the plan to `plans/<issue_title>.md`
|
**Filename:** Use the kebab-case filename from Step 2 Title & Categorization.
|
||||||
|
|
||||||
|
```
|
||||||
|
plans/<type>-<descriptive-name>.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Examples:
|
||||||
|
- ✅ `plans/feat-user-authentication-flow.md`
|
||||||
|
- ✅ `plans/fix-checkout-race-condition.md`
|
||||||
|
- ✅ `plans/refactor-api-client-extraction.md`
|
||||||
|
- ❌ `plans/plan-1.md` (not descriptive)
|
||||||
|
- ❌ `plans/new-feature.md` (too vague)
|
||||||
|
- ❌ `plans/feat: user auth.md` (invalid characters)
|
||||||
|
|
||||||
## Post-Generation Options
|
## Post-Generation Options
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user