gsd:add-backlog

Agent Skills › davepoon/buildwithclaude › gsd:add-backlog

gsd:add-backlog

GitHub

将未就绪的想法添加至999.x编号的待办停车场。读取ROADMAP.md获取下一序号，更新文档并创建对应阶段目录，最后提交更改。适用于收集暂不排期的创意或需求。

plugins/gsd/skills/add-backlog/SKILL.md davepoon/buildwithclaude

Trigger Scenarios

用户提出新想法但尚未准备好进入正式规划需要记录暂存的需求或创意以便后续回顾

Install

npx skills add davepoon/buildwithclaude --skill gsd:add-backlog -g -y

More Options

Non-standard path

npx skills add https://github.com/davepoon/buildwithclaude/tree/main/plugins/gsd/skills/add-backlog -g -y

Use without installing

npx skills use davepoon/buildwithclaude@gsd:add-backlog

指定 Agent (Claude Code)

npx skills add davepoon/buildwithclaude --skill gsd:add-backlog -a claude-code -g -y

安装 repo 全部 skill

npx skills add davepoon/buildwithclaude --all -g -y

预览 repo 内 skill

npx skills add davepoon/buildwithclaude --list

SKILL.md

Frontmatter

{
    "name": "gsd:add-backlog",
    "description": "Add an idea to the backlog parking lot (999.x numbering)",
    "allowed-tools": [
        "Read",
        "Write",
        "Bash"
    ],
    "argument-hint": "<description>"
}

Add a backlog item to the roadmap using 999.x numbering. Backlog items are unsequenced ideas that aren't ready for active planning — they live outside the normal phase sequence and accumulate context over time.

Read ROADMAP.md to find existing backlog entries:
```
cat .planning/ROADMAP.md
```
Find next backlog number:
```
NEXT=$(gsd-sdk query phase.next-decimal 999 --raw)
```
If no 999.x phases exist, start at 999.1.
Add to ROADMAP.md under a ## Backlog section. If the section doesn't exist, create it at the end. Write the ROADMAP entry BEFORE creating the directory — this ensures directory existence is always a reliable indicator that the phase is already registered, which prevents false duplicate detection in any hook that checks for existing 999.x directories (#2280):
```
## Backlog

### Phase {NEXT}: {description} (BACKLOG)

**Goal:** [Captured for future planning]
**Requirements:** TBD
**Plans:** 0 plans

Plans:
- [ ] TBD (promote with /gsd:review-backlog when ready)
```

Create the phase directory:

SLUG=$(gsd-sdk query generate-slug "$ARGUMENTS" --raw)
mkdir -p ".planning/phases/${NEXT}-${SLUG}"
touch ".planning/phases/${NEXT}-${SLUG}/.gitkeep"

Commit:

gsd-sdk query commit "docs: add backlog item ${NEXT} — ${ARGUMENTS}" .planning/ROADMAP.md ".planning/phases/${NEXT}-${SLUG}/.gitkeep"

Report:

## 📋 Backlog Item Added

Phase {NEXT}: {description}
Directory: .planning/phases/{NEXT}-{slug}/

This item lives in the backlog parking lot.
Use /gsd:discuss-phase {NEXT} to explore it further.
Use /gsd:review-backlog to promote items to active milestone.

- 999.x numbering keeps backlog items out of the active phase sequence - Phase directories are created immediately, so /gsd:discuss-phase and /gsd:plan-phase work on them - No `Depends on:` field — backlog items are unsequenced by definition - Sparse numbering is fine (999.1, 999.3) — always uses next-decimal

Version History

502fc01 Current 2026-07-05 15:11

Metadata

Files: 0
Version: 502fc01
Hash: 7836f015
Indexed: 2026-07-05 15:11

gsd:add-backlog

gsd:add-backlog

Trigger Scenarios

Install

SKILL.md

Version History

Same Skill Collection