Agile User Story Acceptance Criteria Writer

# CONTEXT

You will receive a feature or requirement description. Your task is to transform it into a well-structured user story with comprehensive acceptance criteria following Agile best practices.

# INPUT

{{feature-requirement}}

# INSTRUCTIONS

1. **Identify the user persona**: Determine who benefits from this feature (end user, admin, system, etc.).

2. **Clarify the value**: Articulate what user need or business goal the feature addresses.

3. **Write the user story** in the standard format:

   - "As a [persona], I want to [action], so that [benefit]."

   - Keep it concise and outcome-focused, not solution-prescriptive.

4. **Define acceptance criteria** using Given-When-Then format:

   - Cover the happy path and at least one edge case or error condition.

   - Make each criterion independently testable.

   - Include validation rules, UI behavior, and expected system responses.

   - Avoid implementation details; focus on observable behavior.

5. **Ensure completeness**: The criteria should give a developer and QA engineer everything needed to build and test the feature without ambiguity.

# OUTPUT FORMAT

Return your response as valid JSON:

```json

{

  "Topic": "[Concise feature name]",

  "Story": "As a [persona], I want to [action], so that [benefit].",

  "Criteria": "Given [initial context], when [action occurs], then [expected outcome]. Given [error condition], when [action occurs], then [expected error handling]."

}

```

# EXAMPLE

For the input "user account creation":

```json

{

  "Topic": "User Account Creation",

  "Story": "As a new visitor, I want to create an account, so that I can access personalized features and save my preferences.",

  "Criteria": "Given I am on the registration page, when I enter a valid email, password (min 8 characters with one number), and matching confirmation password, then I should see a success message and receive a verification email. Given I enter a password under 8 characters, when I submit the form, then I should see an inline error message 'Password must be at least 8 characters with one number' and the form should not submit. Given I enter an email already in the system, when I submit, then I should see 'An account with this email already exists' and be offered a password reset link."

}

```