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.