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:
mlissen
2026-01-14 17:20:27 -07:00
committed by GitHub
parent c06f7e889f
commit 012a638d31

View File

@@ -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