process-refine-story

Refines draft user stories into sprint-ready specifications with acceptance criteria and risk classification.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/learnn-com/engineering-kb --skill process-refine-story-learnn-com
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: process-refine-story
Source: https://github.com/learnn-com/engineering-kb/tree/main/.skills/process-refine-story
Command: npx skills add https://github.com/learnn-com/engineering-kb --skill process-refine-story-learnn-com

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Draft user stories often lack the detail needed for development: no testable acceptance criteria, no technical analysis, no sizing, and no shared understanding between stakeholders. This Skill transforms a rough Draft story into a Ready specification through a single structured refinement path, eliminating ambiguity before sprint planning. ## Core Features & Use Cases - Shared-Understanding Sync: Runs a blocking phase-0 alignment gate (via /capability-grill) covering goal, acceptance criteria, edge cases, dependencies, design, and risks before any section is authored. - Given-When-Then Acceptance Criteria: Expands requirements into testable scenarios, business rules, and edge cases with explicit human approval gates at every step. - Domain & Coupling Analysis: Optionally composes /process-map-subdomains and /process-map-contexts to classify the touched capability and record coupling risks in the story body. - Shift-Left Risk Classification: Writes a quality-model classification matrix into the story's Classification section via /capability-classify. - Use Case: A product owner has a backlog of Draft stories before sprint planning. Run the skill to auto-select the highest-priority Draft story, align on scope, produce acceptance criteria and sizing, and transition the issue to Ready in the PM tool. ## Quick Start Ask the AI to refine story #42 from Draft to Ready, or omit the story ID to refine the highest-priority Draft story in the backlog.

Frequently Asked Questions about process-refine-story

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

FAQPage Schema
How do I refine a user story from Draft to Ready?▼

Invoke the skill with a story identifier like #42, or omit it to auto-select the highest-priority Draft story. It runs a shared-understanding sync, then produces acceptance criteria, technical analysis, sizing, and updates the PM tool issue to Ready.

What acceptance criteria format does story refinement use?▼

Acceptance criteria are written as Given-When-Then scenarios, accompanied by measurable business rules and edge case handling. Each proposed set requires explicit developer approval before being finalized in the story body.

Can story refinement work without the composed capability skills installed?▼

Yes, it degrades gracefully. Missing /capability-grill falls back to per-step approval gates, missing map or classify skills skip domain placement and the risk matrix with warnings, and refinement still completes.

What happens if a story is already refined or partially refined?▼

The skill detects which of the twelve template sections are present. Fully Ready stories are confirmed and offered selective section updates; partial refinements resume from the first missing section without redoing completed work.

When should I not use this skill for a user story?▼

Do not use it to size an already-refined story; use /capability-estimate instead. It also halts when no shared understanding is reached, the story is not found, or the PM tool is inaccessible.