What is the Backlog Refinement Advisor skill?
Backlog Refinement Advisor is a product management skill by deanpeters for Claude Code, Cursor, Codex and other AI coding agents. Get backlog items ready for planning: understood, small, testable. Use when planning stalls on unclear tickets, or items keep growing and bouncing back mid-sprint.
Take a backlog item (or a pile of them) from vague to ready: understood well enough that the team can size it, small enough to finish in a sprint, and testable enough that "done" is not an argument.
When to use it
Use when planning stalls on unclear tickets, or items keep growing and bouncing back mid-sprint.
What the SKILL.md covers
- Purpose
- Input
- Key Concepts
- What "Ready" Means
- The Four Moves
- Keep Refinement Short and Regular
- Right-Size the Detail
- Acceptance in Plain Words
- The Whole Team Refines
- Facilitation Source of Truth
- Author
- deanpeters
- Pack
- deanpeters/Product-Manager-Skills (30 skills)
- Category
- Product management, #111 of 185
- Alyn Score
- 69 / 99
- Files
- 1
- License
- Not stated
- Last updated
- 2 days ago
- Works with
- Claude Code, Claude, Cursor, Codex, Gemini CLI, Copilot
Backlog Refinement Advisor compared to similar skills
| Skill | Alyn Score | GitHub stars | Updated |
|---|---|---|---|
| Backlog Refinement Advisor · deanpeters | 69 | 8k | 2 days ago |
| Deliver User Stories · product-on-purpose | 68 | 805 | 2 days ago |
| Wwas · phuryn | 78 | 28k | 7 days ago |
| Decomposition Planning Roadmap · tech-leads-club | 71 | 7.2k | 4 days ago |
Install Backlog Refinement Advisor
Pick your agent. Every command is ready to paste.
npx alyn-cli add backlog-refinement-advisorDetects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.
npx skills add deanpeters/Product-Manager-Skills --skill backlog-refinement-advisorOr use the open skills CLI directly.
01
Install it
Run the command above, or upload the folder in Claude.
02
Ask naturally
Describe the task. Your agent loads backlog-refinement-advisor when the request matches its description.
03
Name it if needed
If it does not trigger, say “use the backlog-refinement-advisor skill”. In Codex, type $backlog-refinement-advisor.
Backlog Refinement Advisor
Purpose
Take a backlog item (or a pile of them) from vague to ready: understood well enough that the team can size it, small enough to finish in a sprint, and testable enough that "done" is not an argument.
Refinement is where planning is won or lost. Items that arrive in planning half-understood turn into a long meeting, an estimate nobody trusts, and a ticket that bounces back on day six.
The sentence to keep in your head: refinement is a short, regular conversation about the next few weeks of work, not a meeting that grooms the whole backlog. Ready is a conversation outcome, not a field in the tool.
Input
Works best with: The item, epic, or list you want ready, and when the team plans next.
Also useful: The team's current definition of ready (if any), the acceptance criteria written so far, known dependencies, and how often items bounce mid-sprint.
Anything supplied with the invocation itself (text after the skill name, a pasted context dump, or
an appended ARGUMENTS: line) counts as answers already given. Use it and skip whatever it covers;
don't re-ask.
Arriving empty-handed? That works too. The skill asks what the item is and what's unclear, and recommends the smallest refinement move. It sizes the effort to the item: a small fix gets one line of acceptance, a risky epic gets a conversation and possibly a spike.
Example invocations:
Epic: dispatcher can reschedule jobs from a map. Planning is Thursday and nobody can size it.Item: replace the discontinued relay on the NFA-500 power board. Unclear what testing is needed.
Key Concepts
What "Ready" Means
An item is ready when the team can answer yes to all of these (the team sets its own list; this is a starting point):
- Understood. We know why it matters and who it's for.
- Small. It can finish within one sprint, ideally in a few days.
- Testable. We can say what "done" looks like: acceptance a tester could check.
- Unblocked. Its dependencies are known and available (or an owner and a date).
- Sized. The team has put a size on it and trusts it.
An item that fails one of these goes to the move that fixes it. An item that is ready should not be refined again.
The Four Moves
| Move | When | What it does |
|---|---|---|
| Clarify | The why or the what is fuzzy | A short conversation with the person who knows, ending with acceptance in plain words |
| Split | It's too big for one sprint | Cut into thin vertical slices that each deliver value (user-story-splitting, epic-breakdown-advisor) |
| Spike | The unknown is technical or physical and blocks sizing | A time-boxed investigation (a day or two) that ends with a decision, not a deliverable |
| Park | It isn't coming soon, or nobody can say why it matters | Leave it out of the near backlog; revisit when a decision depends on it |
Parking is a legitimate answer. A backlog that holds everything holds nothing.
Keep Refinement Short and Regular
A common rhythm: a short refinement session every week or so, looking only at the next one or two sprints' worth of work. Beyond that horizon, detail goes stale before it's used. Aim for 2-3 items in depth rather than 20 in passing, and stop when the next sprint is covered.
Right-Size the Detail
Detail should match risk and distance. A small, obvious fix needs a line of acceptance. A risky, cross-team epic needs a real conversation, a split, and maybe a spike. Over-specifying a small item wastes time; under-specifying a risky one costs a sprint. Ask how reversible and how costly a wrong guess would be.
Acceptance in Plain Words
Acceptance criteria say what must be true, in terms anyone can check, without prescribing the implementation: "A dispatcher can drag a job to another technician and see a conflict warning," not "use component X." For hardware and service work, acceptance may be a test result, a certification step, or a checklist.
The Whole Team Refines
Engineers, a designer, and a tester in the room catch gaps a PM alone won't. The PM brings the why and the priority. The team brings feasibility, size, and the questions. If only the PM refines, planning becomes the first time anyone else sees the item.
Facilitation Source of Truth
Use workshop-facilitation as the interaction protocol:
heads-up, one question per turn, numbered options, and best-guess mode on request.
Default entry mode: Guided · set in pm-skills.config.yaml (library-wide default or a per-skill override); the user's own choice in the session always wins. On the first turn, offer all three modes, then open in the default without waiting for a pick: Guided asks the first question, Context dump invites the paste, Best guess asks for a one-sentence minimum and drafts with every assumption labeled.
Anti-Patterns (what this is NOT)
- Not a grooming marathon. Short and regular beats long and rare.
- Not estimation by the PM. The team sizes.
- Not prioritization. See
prioritization-advisor. - Not a specification exercise. Ready means enough to start, not everything.
Application
This skill asks up to 4 adaptive questions, then recommends the move.
Question 1 of 4: What's the item, and when does the team need it?
Agent asks:
"Which item (or epic) do you want ready, and when does the team plan next?"
Listen for scale and risk. A small fix, a risky epic, and a vague idea need different moves.
Question 2 of 4: What's missing?
Agent asks:
"What's the main gap?
- We don't agree what it's for, or what 'done' is (unclear)
- It's too big for one sprint (large)
- There's an unknown that blocks sizing (technical or physical unknown)
- It's blocked by something outside the team (dependency)
- I'm not sure anyone needs it soon (maybe park)"
Map to the move: 1 → clarify. 2 → split. 3 → spike. 4 → name the owner and date, then decide whether to start anyway. 5 → park.
Question 3 of 4: How risky is a wrong guess?
Agent asks:
"If the team guesses wrong on this, how costly is it?
- Cheap and reversible (a small change we can undo)
- Moderate (a sprint of rework)
- Expensive or hard to undo (a customer commitment, hardware tooling, a certification)"
Size the detail: 1 → one line of acceptance and go. 2 → clarify and size together. 3 → clarify, split, and spike before committing, and name what a lighter pass would leave uncovered.
Question 4 of 4: Who's in the conversation?
Agent asks:
"Who can be in the room: engineering, design, test, the person who knows the customer?"
Fit the session: missing voices become named questions to take away. If only the PM is available, say what will probably surface in planning.
Final Step: Recommend the move
## Refinement Move: [item]
**Move:** [Clarify / Split / Spike / Park], because [one line tied to their answers]
**Detail level:** [light / standard / thorough], because a wrong guess is [cheap / moderate / costly].
A lighter pass would leave [uncovered].
### Make it ready
- **Understood:** [the why and who, in one line]
- **Acceptance (plain words):** [what a tester could check]
- **Slices (if split):** [thin vertical slices, first one deliverable]
- **Spike (if any):** [question, time box, what decision it ends with]
- **Dependencies:** [owner and date]
### Ready check
Understood ☐ Small ☐ Testable ☐ Unblocked ☐ Sized ☐
### Next
1. [action]
2. [action]
Examples
Example A: SaaS, a large epic
User: "Epic: dispatchers can reschedule jobs from a map. Planning is Thursday and nobody can size it."
Agent (Q2): → 2 (large). (Q3): → 2 (moderate). (Q4): "PM, two engineers, a designer."
Move: Split, with one clarifying question first. Detail level: standard (a sprint of rework if wrong). First clarify the why (is it reschedule speed or visibility?). Then slice: (1) show jobs on a map, read-only; (2) drag a job to another technician; (3) conflict warning on drop. Slice 1 is deliverable alone. Acceptance for slice 2: "A dispatcher can drag a job to another technician and sees a conflict warning if skills don't match." Ready check: slices 1 and 2 ready for Thursday; slice 3 parked until slice 2 ships.
Example B: Industrial, an unknown that blocks sizing
User: "Item: replace the discontinued relay on the NFA-500 power board. We don't know what testing is needed."
Agent (Q2): → 3 (unknown). (Q3): → 3 (expensive: certification).
Move: Spike, then clarify. Detail level: thorough (a re-evaluation could void listing). Spike (two days, owner: compliance engineer): ask the assessment body whether a like-for-like relay needs re-evaluation, and get one quote for a drop-in replacement. It ends with a decision: replace now, or last-time-buy. Don't size the item until the spike closes. A lighter pass would leave the certification risk uncovered until it becomes a schedule problem.
Common Pitfalls
Pitfall 1: Refining Everything
Symptom: A two-hour weekly grooming of the whole backlog. Consequence: Detail goes stale and meetings feel pointless. Fix: Refine only the next one or two sprints' work, a few items deep.
Pitfall 2: Ready Is a Field in the Tool
Symptom: The "ready" flag is set by the PM alone. Consequence: Planning discovers the gaps, and items bounce. Fix: Ready is the outcome of a conversation with the team.
Pitfall 3: Over-Specifying Small Items
Symptom: A page of acceptance for a one-line fix. Consequence: Time wasted and the team stops reading. Fix: Match detail to risk.
Pitfall 4: Skipping the Spike
Symptom: An unknown gets a guess for an estimate. Consequence: A surprise on day six. Fix: A time-boxed spike that ends with a decision.
Pitfall 5: Never Parking
Symptom: The backlog holds every idea ever raised. Consequence: Nobody trusts it, and refinement drowns in it. Fix: Park what isn't coming soon, and revisit it when a decision needs it.
Pitfall 6: Refining Without the Team
Symptom: The PM prepares tickets alone. Consequence: Feasibility surfaces in planning. Fix: Engineers, design, and test are in the conversation.
References
Related Skills
sprint-planning: downstream; plans with ready itemsuser-storyanduser-story-splitting: write and slice itemsepic-breakdown-advisor: break a large epic downprioritization-advisor: the order of the backlogworkshop-facilitation: interaction protocol
External Frameworks
- Backlog refinement and Definition of Ready: common agile practice; The Scrum Guide describes refinement as ongoing.
- INVEST (Independent, Negotiable, Valuable, Estimable, Small, Testable): Bill Wake.
- Vertical slicing: Richard Lawrence's splitting patterns (Humanizing Work).
Provenance
Distilled from practitioner experience coaching product and engineering teams on backlog practice.
Tips for Backlog Refinement Advisor
- • Start a fresh session after installing so your agent picks up the new skill.
- • It is part of a pack with 30 skills. Install only the ones you need with --skill to keep triggers precise.
- • If two skills overlap, mention the one you want by name.
Questions about Backlog Refinement Advisor
What does the Backlog Refinement Advisor skill do?
Get backlog items ready for planning: understood, small, testable. Use when planning stalls on unclear tickets, or items keep growing and bouncing back mid-sprint.
How do I install Backlog Refinement Advisor?
Run "npx alyn-cli add backlog-refinement-advisor" in your project. The Alyn CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.
Does Backlog Refinement Advisor work in Cursor and Codex?
Yes. Backlog Refinement Advisor uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.
When should I use the Backlog Refinement Advisor skill?
Use when planning stalls on unclear tickets, or items keep growing and bouncing back mid-sprint.
What is inside the Backlog Refinement Advisor skill?
The SKILL.md covers Purpose, Input, Key Concepts, What "Ready" Means, The Four Moves, Keep Refinement Short and Regular.
What is a good alternative to Backlog Refinement Advisor?
Deliver User Stories by product-on-purpose is the highest-ranked similar skill from another creator, with an Alyn Score of 68 compared to 69 for Backlog Refinement Advisor.
Is Backlog Refinement Advisor free?
Backlog Refinement Advisor is open source on GitHub. It is free to install; check the license before commercial use.
Who made Backlog Refinement Advisor?
Backlog Refinement Advisor is published by deanpeters in the deanpeters/Product-Manager-Skills repository, together with 29 other skills.



