aid: user-stories
name: User Stories
description: >-
  A curated collection of API user stories following agile methodology formats.
  User stories capture software requirements from the end-user perspective using
  the format "As a [user], I want [goal], so that [benefit]". This repository indexes
  user story patterns for API consumers and producers across product management,
  developer experience, integration design, and platform engineering contexts.
  Teams use these to align stakeholders, prioritize API features, track progress,
  and adapt to evolving requirements throughout the API lifecycle.
type: Index
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
  - Agile
  - API Design
  - Developer Experience
  - Product Management
  - Requirements
  - User Needs
url: >-
  https://raw.githubusercontent.com/api-evangelist/user-stories/refs/heads/main/apis.yml
created: '2025-01-01'
modified: '2026-05-03'
specificationVersion: '0.19'
apis: []
common:
  - type: TrustCenter
    url: security/user-stories-trust-center.yml
  - type: VulnerabilityDisclosure
    url: security/user-stories-vulnerability-disclosure.yml
  - type: DomainSecurity
    url: security/user-stories-domain-security.yml
  - type: Website
    url: https://www.atlassian.com/agile/project-management/user-stories
  - type: GitHub
    url: https://github.com/api-evangelist/user-stories
  - type: JSONLD
    url: json-ld/user-stories-context.jsonld
  - type: Vocabulary
    url: vocabulary/user-stories-vocabulary.yml
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com