🧠 How to Write Better Jira Story Names

Writing better Jira story names helps improve team understanding, prioritization, and sprint planning. A good story title should be clear, concise, and action-oriented, summarizing the value or task in a way that's immediately understandable.

✅ Best Practices for Writing Story Names

Make it user-centric (for user stories)

If following Agile user story format:

✅ As a user, I want to reset my password so I can regain account access

You can shorten the story title for Jira while keeping this user-focus:

✅ Allow users to reset password via email
✅ User can reset password via email

🔁 Optional User Story Format (for full story description)

As a [user type], I want to [goal], so I can [benefit].

Example:

As a registered user, I want to reset my password, so I can regain access to my account.

📋 Jira Task Naming Pattern Template

Use this template to standardize Jira task(subtask) titles across the team.

✅ Recommended Format

[Tag] Action + What + (Optional: Why/Context)

Examples:

[API] Create endpoint for fetching product reviews
[UI] Fix button alignment on mobile devices
[Auth] Implement token refresh mechanism
[Bug] Resolve crash when submitting form without data
[Refactor] Clean up legacy cart reducer logic

🧩 Prefix Tags (Optional but Encouraged)

Tag	Use for...
`[UX]`	UX/UI work, for example, defining a new UI flow
`[FE]` or `[UI]`	Frontend / UI-related work
`[BE]` or `[API]`	Backend / API development
`[Auth]`	Authentication & authorization
`[Bug]`	Bug fixes
`[Refactor]`	Code cleanup/refactoring
`[Spike]`	Research or investigation tasks
`[DevOps]`	Infrastructure, CI/CD changes
`[Test]`	Test-related stories or improvements

🛠 Action Verbs

Start the title with a strong action verb:

Add, Create, Update, Fix, Remove, Implement, Enable, Support, Refactor, Optimize, Restrict, etc.

🎯 Focus on Value or Clarity

Make sure the title answers:

What is being done?
Why is it useful or necessary?

❌ Avoid These Patterns

Bad Example	Why it's bad
`Fix UI`	Too vague
`API changes`	Not descriptive
`Improve stuff`	Unclear what or why
`Refactor code`	Doesn't specify what code

✅ Good Examples

Story Type	Good Title Example
Feature	`[UI] Add dark mode toggle in user settings`
Bug	`[Bug] Fix 500 error on user registration`
Refactor	`[Refactor] Remove unused auth utility functions`
Research	`[Spike] Investigate caching strategy for search`
DevOps	`[DevOps] Set up staging deployment via GitHub Actions`

erkobridee/01_jira__write-better-story-names.md