List backlog items:
ls -d .planning/phases/999* 2>/dev/null || echo "No backlog items found"Read ROADMAP.md and extract all 999.x phase entries:
cat .planning/ROADMAP.mdShow each backlog item with its description, any accumulated context (CONTEXT.md, RESEARCH.md), and creation date.
Present the list to the user via AskUserQuestion:
- For each backlog item, show: phase number, description, accumulated artifacts
- Options per item: Promote (move to active), Keep (leave in backlog), Remove (delete)
For items to PROMOTE:
- Find the next sequential phase number in the active milestone
- Rename the directory from
999.x-slugto{new_num}-slug:NEW_NUM=$(node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" phase add "${DESCRIPTION}" --raw) - Move accumulated artifacts to the new phase directory
- Update ROADMAP.md: move the entry from
## Backlogsection to the active phase list - Remove
(BACKLOG)marker - Add appropriate
**Depends on:**field
For items to REMOVE:
- Delete the phase directory
- Remove the entry from ROADMAP.md
## Backlogsection
Commit changes:
node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" commit "docs: review backlog — promoted N, removed M" --files .planning/ROADMAP.mdReport summary:
## 📋 Backlog Review Complete Promoted: {list of promoted items with new phase numbers} Kept: {list of items remaining in backlog} Removed: {list of deleted items}
Gsd Review Backlog
Review and promote backlog items to active milestone
Gsd Review Backlog by coco-research · 011ab64
npx skillmds@latest add coco-research/gsd-review-backlog File contents
---name: gsd-review-backlogdescription: Review and promote backlog items to active milestone---<objective>Review all 999.x backlog items and optionally promote them into the activemilestone sequence or remove stale entries.</objective><process>1. **List backlog items:** ```bash ls -d .planning/phases/999* 2>/dev/null || echo "No backlog items found" ```2. **Read ROADMAP.md** and extract all 999.x phase entries: ```bash cat .planning/ROADMAP.md ``` Show each backlog item with its description, any accumulated context (CONTEXT.md, RESEARCH.md), and creation date.3. **Present the list to the user** via AskUserQuestion: - For each backlog item, show: phase number, description, accumulated artifacts - Options per item: **Promote** (move to active), **Keep** (leave in backlog), **Remove** (delete)4. **For items to PROMOTE:** - Find the next sequential phase number in the active milestone - Rename the directory from `999.x-slug` to `{new_num}-slug`: ```bash NEW_NUM=$(node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" phase add "${DESCRIPTION}" --raw) ``` - Move accumulated artifacts to the new phase directory - Update ROADMAP.md: move the entry from `## Backlog` section to the active phase list - Remove `(BACKLOG)` marker - Add appropriate `**Depends on:**` field5. **For items to REMOVE:** - Delete the phase directory - Remove the entry from ROADMAP.md `## Backlog` section6. **Commit changes:** ```bash node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" commit "docs: review backlog — promoted N, removed M" --files .planning/ROADMAP.md ```7. **Report summary:** ``` ## 📋 Backlog Review Complete Promoted: {list of promoted items with new phase numbers} Kept: {list of items remaining in backlog} Removed: {list of deleted items} ```</process>
coco-research/coco/tree/main/systems/gsd/skills/gsd-review-backlog commit 011ab64bf4
Frequently asked questions
Run npx skillmds@latest add coco-research/gsd-review-backlog in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Review and promote backlog items to active milestone It is listed under Product & Planning on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
coco-research (@coco-research) published this skill. Their other Agent Skills are listed on their SkillMD profile.