# 02 User Stories

> Produces or refines ordered User Stories from an Epic, Product Brief, PRD, or bounded request. Use when the user wants to slice, write, assess, order, or persist Stories. Not for Epics or implementation.

- Skill: `ai-driven-dev/02-user-stories` (Agent Skill, multi-file: 18 files)
- Install (CLI): `npx skillmds@latest add ai-driven-dev/02-user-stories`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ai-driven-dev/02-user-stories/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: ai-driven-dev (https://skillmd.com/u/ai-driven-dev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ai-driven-dev/02-user-stories

---


# User Stories

```mermaid
flowchart LR
  source([request, Product Brief, PRD, Epic, or Stories]) --> frame --> slice --> write --> assess
  source -->|"already persisted"| finalize
  assess -->|"reshape"| slice
  assess --> estimation --> order --> finalize
  order -->|"reslice"| slice
  finalize -->|"revise"| write
  finalize -->|"authorized"| done([User Stories])
```

## Actions

Run the flow above. Read only the next action file.

| Action     | Does                                      |
| ---------- | ----------------------------------------- |
| frame      | resolve the source and Story scope        |
| slice      | find vertical deliverable slices          |
| write      | write Stories and acceptance              |
| assess     | determine readiness and blockers          |
| estimation | estimate only when applicable             |
| order      | order only when useful                    |
| finalize   | approve, persist, or transition           |

## Transversal rules

- Keep product and lifecycle decisions with the user.
- Separate evidence, decisions, and assumptions.
- Preserve source links and existing edits.
- Ask natural questions; never expose actions, references, or unchanged state.
- Require explicit approval or caller-provided bounded authority before any write.
- Draft only after actor, need, and outcome are explicit in the source or confirmed.