OpenSkillIndex← back to search
claude-codeproductivity

Cursor-rules-java 014-agile-user-story

Guides the creation of agile user stories and Gherkin feature files. Use when the user wants to create a user story, write acceptance criteria, define Gherkin scenarios, or author BDD feature files. Part of the skills-for-java project

install
source · Clone the upstream repo
git clone https://github.com/jabrena/cursor-rules-java
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/jabrena/cursor-rules-java "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/014-agile-user-story" ~/.claude/skills/jabrena-cursor-rules-java-014-agile-user-story && rm -rf "$T"
manifest: skills/014-agile-user-story/SKILL.md
tags
#agile#user-stories#gherkin#bdd#testing#markdown
source content

Create Agile User Stories and Gherkin Feature Files

Guide the agent to ask targeted questions to gather details for a user story and its Gherkin acceptance criteria, then generate a Markdown user story and a separate Gherkin 

.feature
file. This is an interactive SKILL.

What is covered in this Skill?

  • User story core details: title, persona, goal, benefit
  • Gherkin feature file: Feature name, background steps, scenarios
  • Acceptance criteria: Given / When / Then with data examples
  • File naming and linking between user story and feature file
  • INVEST quality validation before finalization (Independent, Negotiable, Valuable, Estimable, Small, Testable)

Constraints

Before generating artifacts, gather all required information through structured questions. Use exact wording from the template and wait for user responses.

  • MANDATORY: Ask questions from the template one-by-one in strict order before generating any artifacts
  • MUST: Read the reference template fresh and use exact wording—do not use cached questions
  • MUST: Wait for user response after each question or block before proceeding
  • MUST: Repeat scenario questions for each additional scenario when user indicates more scenarios
  • MUST: Validate the final user story against INVEST and present a pass/fail checkpoint for each criterion before finalizing

When to use this skill

  • Create a user story
  • Write a user story
  • I need to write a user story

Reference

For detailed guidance, examples, and constraints, see references/014-agile-user-story.md.