refine

Convert unvetted PRD items into user stories with acceptance criteria.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/zabuuq/sdd-plugin --skill refine-zabuuq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refine
Source: https://github.com/zabuuq/sdd-plugin/tree/main/plugins/sdd/skills/refine
Command: npx skills add https://github.com/zabuuq/sdd-plugin --skill refine-zabuuq

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It converts unvetted PRD items into clear, testable user stories with acceptance criteria while keeping the living spec and related documents consistent.

Core Features & Use Cases

  • Compressed planning interview to clarify intent, edge cases, and deliverable scope for each unvetted PRD item.
  • Spec-impact assessment to identify architectural implications before making document changes.
  • Incremental, confirmed document updates that move items from Unvetted/Proposed to vetted locations and update PRD/spec (and optionally AGENTS.md/CLAUDE.md) in the required dependency order.

Quick Start

Ask Claude to run /sdd:refine and refine the first unvetted item in docs/prd.md, updating the PRD and spec only after you confirm each proposed change.

Frequently Asked Questions about refine

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

FAQPage Schema
How do I convert unvetted PRD items into user stories with acceptance criteria?

To convert unvetted PRD items into user stories, you run a compressed planning interview to clarify intent and edge cases, assess architectural impact, and update the PRD and spec incrementally after confirming each change.

What is spec-impact assessment in product planning?

Spec-impact assessment in product planning identifies architectural implications and affected spec sections before making document changes, ensuring the living spec remains consistent when refining PRD items into user stories.

How do I prepare unvetted proposed work for sprint planning?

You prepare unvetted proposed work for sprint planning by reading project state and guard-rail references, conducting a compressed interview per item, and moving items from Unvetted/Proposed to vetted locations with clear acceptance criteria.

Can I update AGENTS.md and CLAUDE.md when refining PRD items?

Yes, you can update AGENTS.md and CLAUDE.md when refining PRD items. The process performs incremental, confirmed document updates to the PRD, spec, and any necessary project coordination documents in the required dependency order.

Does refining user stories require updating the living spec simultaneously?

Yes, refining user stories requires updating the living spec simultaneously. It selectively loads affected spec sections and performs incremental confirmed updates to both PRD and spec to keep related documents consistent.

What are the limitations of automated PRD spec updates during sprint preparation?

A key limitation of automated PRD spec updates during sprint preparation is that changes are not applied automatically. The process requires explicit user confirmation for each proposed change before updating the PRD, spec, or project coordination documents.