gh-launchcg-claude-marketplace-pub-plugins-ai-sdlc/commands/create-story.md

description

description
Create an AI-ready user story from natural language requirements

Create Story Command

Generate a well-structured, AI-ready user story from natural language requirements.

Usage

/create-story [requirements]

Parameters

requirements (required)

• Natural language description of what you need
• Can be a feature request, conversation transcript, or rough notes
• Include as much context as possible

--project (optional)

• Jira project key to create story in
• Example: --project PROJ

--type (optional)

• Story type: feature, bug, technical, spike
• Default: feature

Examples

# Create from feature request
/create-story Users need to export their dashboard data to PDF for sharing with stakeholders

# Create with project specified
/create-story --project HR Users need password reset functionality

# Create technical story
/create-story --type technical We need to migrate from MySQL to PostgreSQL for better JSON support

# Create bug fix story
/create-story --type bug The export button doesn't work when there's no data in the dashboard

What This Command Does

1. Parses Requirements

   • Extracts user persona
   • Identifies capability needed
   • Determines business value
   • Notes any constraints

2. Generates Story

   • Creates structured user story
   • Follows "As a... I want... So that..." format
   • Adds context and technical approach

3. Creates Acceptance Criteria

   • Generates Given/When/Then scenarios
   • Covers happy path, edge cases, errors
   • Ensures testability

4. Validates Readiness

   • Checks against Definition of Ready
   • Scores on 7 criteria
   • Provides improvement suggestions

5. Offers Jira Creation

   • Option to create in Jira
   • Links acceptance criteria
   • Adds AI-ready label

Output

The command produces a complete user story with:

• Structured story content
• Comprehensive acceptance criteria
• DoR validation score
• AI-readiness assessment

Prerequisites

Required:

• None for story generation

Troubleshooting

"Requirements too vague"

Solution: Add more context about who the user is and what outcome they need

"Cannot determine user persona"

Solution: Specify who will use this feature (e.g., "admin users", "customers", "API consumers")

"Scope too large"

Solution: The command will suggest breaking into multiple stories

Best Practices

1. Be Specific: Include concrete examples of what users need
2. Explain Why: Mention the business value or problem being solved
3. Note Constraints: Mention any technical or business limitations
4. Include Context: Background information helps generate better stories

---

Agent Invoked: user-story-creation Skills Used: story-creator, acceptance-criteria-generator, dor-validator