109 lines
2.8 KiB
Markdown
109 lines
2.8 KiB
Markdown
---
|
|
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
|
|
|
|
```bash
|
|
# 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
|