stories
Installation
SKILL.md
Job Stories & User Stories
Translate requirements into stories that a team can pick up and build. Prefer job stories over user stories — situations are more actionable than personas.
Why Job Stories Over User Stories
User stories anchor on a persona: "As a project manager..." But the same person behaves differently depending on context. A project manager at 9am triaging is doing a different job than at 3pm reporting to stakeholders.
Job stories anchor on the situation, which is what actually drives behavior.
| Format | Example | Strength |
|---|---|---|
| Job story: When [situation], I want to [motivation], so I can [outcome] | When I'm reviewing pull requests before standup, I want to see which ones block other work, so I can prioritize reviews that unblock the team | Captures context that shapes the solution |
| User story: As a [role], I want to [action], so that [benefit] | As a tech lead, I want to see PR priorities, so that I can review efficiently | Vague on when/why this matters |
Use user stories if the team is already fluent in them. Don't fight process for its own sake. But write the situation into the description either way.