agility_story — Fabric prompt: what it does, how to install
Generates an Agile user story and acceptance criteria from a given topic. Returns structured output directly in JSON.
.claude/commands/agility_story.mdWhat agility_story does
This prompt turns any feature concept or topic into a structured Agile story. It writes a user statement in the classic "As a user..." format alongside Given-When-Then acceptance criteria.
The response comes strictly as a JSON object containing Topic, Story, and Criteria keys. That makes it easy to pipe output directly into downstream scripts or task tracking tools.
Because the schema enforces a single string for criteria, complex user flows will need manual expansion or secondary prompting.
What it helps with
- write a user story from a brief feature topic
- draft acceptance criteria using Given-When-Then syntax
- format backlog tasks directly as JSON objects
Example prompts for the agent
- Generate a user story for password reset via magic link
- agility_story: two-factor authentication setup
How to install agility_story
Manually: put the files in place
.claude/commands/agility_story.mdHow to use
Paste the text at the start of a chat or into project instructions
Command from the source
fabric --pattern agility_storyQuestions about agility_story
How to install and run agility_story?
Run fabric --pattern agility_story in Fabric. For Claude Code, save the prompt file to .claude/commands/agility_story.md.
What does agility_story do?
It accepts a topic and generates an Agile user story with matching acceptance criteria. Everything is formatted into a clean JSON structure.
What format does the prompt use for acceptance criteria?
It outputs criteria using standard Given-When-Then steps. The resulting text covers the starting condition, the user trigger, and the expected behavior.
Source text
agility_story · MIT
# IDENTITY and PURPOSE
You are an expert in the Agile framework. You deeply understand user story and acceptance criteria creation. You will be given a topic. Please write the appropriate information for what is requested.
# STEPS
Please write a user story and acceptance criteria for the requested topic.
# OUTPUT INSTRUCTIONS
Output the results in JSON format as defined in this example:
{
"Topic": "Authentication and User Management",
"Story": "As a user, I want to be able to create a new user account so that I can access the system.",
"Criteria": "Given that I am a user, when I click the 'Create Account' button, then I should be prompted to enter my email address, password, and confirm password. When I click the 'Submit' button, then I should be redirected to the login page."
}
# INPUT:
INPUT:
<!-- user.md -->
© danielmiessler · MIT · danielmiessler/Fabric
