gsd-add-backlog

Create a backlog entry and phase directory from a ROADMAP.md description.

Updated Aug 15, 2025
One-click install
npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-add-backlog-gesmith0606
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-add-backlog
Source: https://github.com/gesmith0606/nfl_data_engineering/tree/main/.claude/skills/gsd-add-backlog
Command: npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-add-backlog-gesmith0606

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

backlog items drift and accumulate outside active planning; this skill adds ideas to the roadmap backlog using a deterministic 999.x numbering scheme.

Core Features & Use Cases

  • Automates backlog capture: creates a formal backlog entry in ROADMAP.md with proper phase numbering.
  • Structured phase creation: initializes .planning/phases/NEXT-<slug> directories and commits them for traceability.
  • Backlog governance: updates ROADMAP.md under a Backlog section so future work is organized and reviewable.

Quick Start

Add a new backlog item description to ROADMAP.md and run the gsd tool to assign the next 999.x phase.

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 roadmap markdown file automatically?

To add backlog items to a roadmap, this skill reads ROADMAP.md, determines the next 999.x phase number, creates a slug from your description, and appends the entry with phase metadata.

What is the 999.x phase numbering scheme used for in backlog planning?

The 999.x phase numbering scheme provides a deterministic way to organize backlog items in ROADMAP.md, ensuring future work is structured, reviewable, and separated from active roadmap phases.

How do I initialize a phase directory for a new backlog item?

To initialize a phase directory, the skill generates a slug from your description, creates the folder under .planning/phases, adds a .gitkeep file, and commits the changes for traceability.

Does this backlog automation tool require specific dependencies to run?

No specific dependencies are required to run this backlog automation tool, as it operates independently by reading and updating your existing ROADMAP.md file structure.

Can I use this to prevent backlog drift outside of active planning phases?

Yes, you can use this to prevent backlog drift by formally capturing ideas directly into the ROADMAP.md Backlog section, keeping unassigned work organized and traceable.