refine-backlog

Gate backlog items and stories through a Definition of Ready checklist before promotion.

Updated May 25, 2026
One-click install
npx skills add https://github.com/DATA-AI-XYZ/Tandem --skill refine-backlog-data-ai-xyz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refine-backlog
Source: https://github.com/DATA-AI-XYZ/Tandem/tree/main/skills/refine-backlog
Command: npx skills add https://github.com/DATA-AI-XYZ/Tandem --skill refine-backlog-data-ai-xyz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams and solo builders lose track of whether a backlog item or story is genuinely ready to start, leading to half-specified work entering development without testable acceptance criteria, test plans, or verified premises. This Skill enforces a mechanical Definition of Ready gate so nothing is silently promoted to ready. ## Core Features & Use Cases - DoR checklist enforcement: Walks every Definition of Ready item (strategic linkage, testable ACs, paired testplan, runnable test commands, dependencies, estimate, risks, premise verification) and reports PASS/FAIL with reasons. - Gap reporting without auto-fixing: When any item fails, it stops, lists the gaps and smallest fixes, and asks the user before patching — it never invents ACs or fabricates test cases. - Premise verification: Resolves claims about other artefacts' statuses (e.g. "STORY-X is superseded") against actual frontmatter to catch contradictions before promotion. - Sunset rule: Proposes wontfix or archived for items sitting not-started for over 90 days. - Use Case: You have a not-started story and want to know if it can be pulled into work. Run the refinement gate to get a per-item pass/fail table, a usage estimate written into the story, and a status flip to ready only if every check passes. ## Quick Start Ask the assistant to refine a specific story or backlog item by path, for example: run the Definition of Ready gate on STORY-15.1.02 and tell me what is missing before it can be marked ready.

Frequently Asked Questions about refine-backlog

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

FAQPage Schema
How do I check if a story is ready to start work?

Run the Definition of Ready gate on the story path. The skill walks each DoR item — strategic linkage, testable ACs, paired testplan, runnable test commands, dependencies, estimate, risks, and premise verification — and reports PASS or FAIL with a one-line reason per item.

What is a Definition of Ready checklist for backlog refinement?

It is a set of conditions a story must meet before entering work: linkage to a Feature, Epic, and OKR or PRD, testable acceptance criteria, a paired testplan with full AC-to-test coverage, runnable commands, resolved dependencies, an estimate, a concrete type_of_work, and non-empty risks.

Does the refinement gate automatically fix missing acceptance criteria?

No. When any DoR item fails, the skill stops, lists the gaps with the smallest fix for each, and asks the user before patching. It never invents acceptance criteria, fabricates test cases, or guesses at risks.

What happens to stale backlog items that are never started?

Items sitting in not-started status for more than 90 days trigger the sunset rule. The skill proposes marking them wontfix or archived instead of refining them, preferring honest retirement over perpetual refinement.

Why does a story fail the gate even when its structure looks complete?

The premise verification check resolves any claims the story makes about other artefacts' statuses against their actual frontmatter. If a story asserts another artefact is superseded or not-started but it is actually done, the gate fails and names the mismatch.