gsd-add-backlog

Add backlog items to a roadmap with 999.x numbering and commit changes.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/dobrinz123/claude-skills-share --skill gsd-add-backlog-dobrinz123
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-add-backlog
Source: https://github.com/dobrinz123/claude-skills-share/tree/main/skills/gsd-add-backlog
Command: npx skills add https://github.com/dobrinz123/claude-skills-share --skill gsd-add-backlog-dobrinz123

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Capture unsequenced ideas and park them in a project's backlog outside the active phase sequence so they don't block current planning or milestone work. This automates selecting the next 999.x decimal, creating a phase directory, and updating the roadmap so ideas are preserved with minimal friction.

Core Features & Use Cases

  • Automated numbering: Finds the next available 999.x backlog number using the repository's gsd-tools utilities so numbering remains consistent.
  • Directory and metadata creation: Generates a phase directory with a slug and a placeholder .gitkeep, and inserts a standardized backlog entry under a Backlog section in .planning/ROADMAP.md.
  • Commit and reporting: Stages and commits the ROADMAP and created phase directory, and reports the created phase and how to continue working on it.
  • Use Case: Quickly capture feature ideas, research topics, or low-priority tasks during meetings without interrupting active milestone planning.

Quick Start

Use the assistant command /gsd-add-backlog to add "Improve onboarding flow" to the backlog.

Frequently Asked Questions about gsd-add-backlog

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

FAQPage Schema
How do I add backlog items to a project roadmap without disrupting active milestones?

To add backlog items without disrupting active milestones, you can park unsequenced ideas into a 999.x numbering sequence. This updates the ROADMAP.md under a Backlog section and creates a phase directory, keeping ideas outside the active phase sequence.

What is the 999.x numbering convention used for in project backlog management?

The 999.x numbering convention is used to sequence backlog items in project planning. It automatically finds the next available decimal to maintain consistent numbering for unsequenced ideas captured outside active milestones.

How do I quickly capture feature ideas during meetings into a Git roadmap?

You can quickly capture feature ideas during meetings by adding them to the project backlog. The system generates a phase directory with a slug, inserts a standardized entry into the .planning/ROADMAP.md, and commits the changes using Git.

Do I need a specific repository structure to use automated backlog phase management?

Yes, automated backlog phase management requires a project planning repository that maintains a .planning/ROADMAP.md file and phase directories. The system also relies on the repository's gsd-tools utilities to determine the next backlog number.

Can I use this backlog tool with any Git repository or do I need gsd-tools?

You need gsd-tools utilities within your Git repository to use this backlog tool. The system depends on these utilities to determine the next 999.x decimal and to commit the roadmap and phase directory updates correctly.

What gets created on disk when I park a new idea into the backlog?

When you park a new idea into the backlog, a phase directory with a generated slug and a placeholder .gitkeep file is created. The ROADMAP.md is then updated with a standardized backlog entry and committed.