# User Stories

This directory contains user stories organized by epic. Each epic represents a
major feature area or user journey.

## Story Format

All user stories follow this template:

```
**Story ID**: US-XXX
**As a** [persona]
**I want to** [action]
**So that** [benefit]

**Acceptance Criteria**:
- [ ] Criterion 1
- [ ] Criterion 2
- [ ] Criterion 3

**Priority**: P0/P1/P2
**Points**: X
**Dependencies**: [list]
```

## Personas

| Persona          | Description                                    |
| ---------------- | ---------------------------------------------- |
| **Seeker**       | New to meditation, wants guided experiences    |
| **Student**      | Studying spiritual traditions, needs depth     |
| **Practitioner** | Experienced meditator, wants advanced guidance |
| **Researcher**   | Scholar studying traditions, needs citations   |
| **Creator**      | Creates content, needs tools and marketplace   |

## Epics Index

### Core Experience

| Epic                                                 | Stories    | Status         |
| ---------------------------------------------------- | ---------- | -------------- |
| [epic-authentication.md](./epic-authentication.md)   | 8 stories  | ✅ Complete    |
| [epic-chat-experience.md](./epic-chat-experience.md) | 12 stories | ✅ Complete    |
| [epic-meditation.md](./epic-meditation.md)           | 10 stories | ✅ Complete    |
| [epic-courses.md](./epic-courses.md)                 | 8 stories  | 🔄 In Progress |

### Content & Knowledge

| Epic                                           | Stories   | Status         |
| ---------------------------------------------- | --------- | -------------- |
| [epic-lectures.md](./epic-lectures.md)         | 6 stories | ✅ Complete    |
| [epic-encyclopedia.md](./epic-encyclopedia.md) | 8 stories | 🔄 In Progress |
| [epic-offline.md](./epic-offline.md)           | 5 stories | ✅ Complete    |

### Advanced Features

| Epic                       | Stories    | Status     |
| -------------------------- | ---------- | ---------- |
| epic-metaverse.md          | 15 stories | 📋 Planned |
| epic-nft-marketplace.md    | 10 stories | 📋 Planned |
| epic-consciousness-tech.md | 12 stories | 📋 Planned |

## Priority Definitions

| Priority | Definition                 | SLA         |
| -------- | -------------------------- | ----------- |
| **P0**   | Critical path, MVP blocker | Must ship   |
| **P1**   | Important for good UX      | Should ship |
| **P2**   | Nice to have               | Could ship  |
| **P3**   | Future consideration       | Backlog     |

## Story Lifecycle

1. **Draft**: Story written, needs refinement
2. **Ready**: Story refined, acceptance criteria clear
3. **In Progress**: Development started
4. **Review**: Code complete, in review
5. **Done**: Merged and deployed
6. **Released**: Available to users

## Related Documentation

- **Feature Specs**: [../specs/](../specs/)
- **API Reference**: [../api/](../api/)
- **Product Requirements**: `../../PRODUCT.md`
