OpenParable
Skip to content
← Back to skills

Gsd:add Backlog

Productivity
gsd:add-backlog

Gsd:add Backlog is an Agent Skill for productivity published in the davepoon/buildwithclaude repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Add an idea to the backlog parking lot (999.x numbering)

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/davepoon/buildwithclaude/blob/HEAD/plugins/gsd/skills/add-backlog/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/gsd-add-backlog, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

  1. Read ROADMAP.md to find existing backlog entries:

    cat .planning/ROADMAP.md
    
  2. Find next backlog number:

    NEXT=$(gsd-sdk query phase.next-decimal 999 --raw)
    

    If no 999.x phases exist, start at 999.1.

  3. 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)
    
  4. Create the phase directory:

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

    gsd-sdk query commit "docs: add backlog item ${NEXT} — ${ARGUMENTS}" .planning/ROADMAP.md ".planning/phases/${NEXT}-${SLUG}/.gitkeep"
    
  6. 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.