Verified:GitHub

story-workflow

Orchestrate AI-assisted story refinement across ADO, Jira, GitLab, GitHub, and Zoho.

11|4|Updated Apr 27, 2026

Search Tags:#workflow #story #claude-code #analyze #refine #groom

One-click install

npx skills add https://github.com/MostAshraf/ai-sdlc-harness --skill story-workflow-mostashraf

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: story-workflow
Source: https://github.com/MostAshraf/ai-sdlc-harness/tree/main/skills/story-workflow
Command: npx skills add https://github.com/MostAshraf/ai-sdlc-harness --skill story-workflow-mostashraf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Refine, analyze, improve, and groom user stories / issues with structured templates and codebase-aware technical analysis. Integrates with the configured work item provider (ADO, Jira, GitLab, GitHub, and local markdown files) via MCP or the filesystem to read and post back to work items.

Core Features & Use Cases

Provide a consistent workflow for story refinement, readiness analysis, and technical grooming using canonical templates.
Route commands to provider adapters (improve, analyze, refine, groom) and load context from the workspace.
Automatically generate and enforce Open Questions, Acceptance Criteria structure, and Open Points in future sessions.

Quick Start

Invoke /story-workflow <command> <work-item-id> to begin a workflow.

Frequently Asked Questions about story-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I refine and groom user stories using AI with Jira or Azure DevOps?▼

Story refinement and grooming integrates with Jira, ADO, GitLab, GitHub, and local markdown to read work items, load team context, and apply structured templates for readiness analysis and technical improvements.

Can I automatically generate acceptance criteria and open questions for user stories?▼

Yes, story grooming automatically generates and enforces structured Acceptance Criteria, Open Questions, and Open Points in future sessions using canonical templates loaded from your workspace context.

How do I analyze a user story's technical readiness against my codebase?▼

Story readiness analysis evaluates work items by reading team context and codebase-aware technical data, guiding refinement actions through commands like improve, analyze, refine, and groom routed to your configured provider.

Does story workflow support local markdown files instead of Jira or ADO?▼

Yes, local markdown files are fully supported as a provider alongside ADO, Jira, GitLab, GitHub, and Zoho, allowing you to read and post back refinements directly via MCP or the filesystem.

How do I start an AI-assisted story improvement workflow for a specific issue?▼

Invoke the workflow by passing a command such as improve, analyze, refine, or groom along with your target work-item ID, which routes to the appropriate provider adapter to load context and apply templates.

What is the best way to structure user story templates for AI-assisted grooming?▼

Story grooming enforces a SKILL.md structure requiring frontmatter with name and description at root, optionally including scripts, references, and assets to standardize refinement across your team.