gds-dev-story

Implements sprint stories from spec files using a red-green-refactor workflow with status tracking.

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/watchthelight/shatterfish --skill gds-dev-story-watchthelight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gds-dev-story
Source: https://github.com/watchthelight/shatterfish/tree/main/.claude/skills/gds-dev-story
Command: npx skills add https://github.com/watchthelight/shatterfish --skill gds-dev-story-watchthelight

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It automates the disciplined execution of a development story: finding the next ready story in a sprint plan, implementing each task with test-driven development, and keeping story files and sprint status in sync without losing track of progress. ## Core Features & Use Cases - Story Discovery & Loading: Finds the next ready-for-dev story from sprint-status.yaml or a user-provided story file path. - TDD Implementation Loop: Executes each task with red-green-refactor cycles, running tests and validations before marking tasks complete. - Review Continuation: Detects prior code review findings and prioritizes unresolved review follow-up items before regular tasks. - Use Case: A developer says "dev this story" and the workflow implements all tasks, updates checkboxes, File List, Change Log, and sets the story status to review. ## Quick Start Ask the assistant to dev the next story in the sprint plan or provide a specific story file path to implement.

Frequently Asked Questions about gds-dev-story

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

FAQPage Schema
How do I implement the next story in a sprint plan automatically?

Invoke the dev story workflow and it reads sprint-status.yaml to find the first story marked ready-for-dev, loads its full spec, and implements every task in order. You can also pass an explicit story file path to develop a specific story.

How does the dev story workflow handle test-driven development?

Each task follows a red-green-refactor cycle: failing tests are written first, then minimal code makes them pass, then the code is refactored while keeping tests green. A task is only marked complete when all tests exist and pass with no regressions.

Can the workflow resume a story after a code review?

Yes. It detects a Senior Developer Review section in the story file, counts unchecked review follow-up items, and prioritizes resolving those findings before continuing with regular tasks, marking both the task and the review action item as resolved.

What happens when no ready-for-dev stories exist in the sprint?

The workflow reports that no ready stories were found and offers options: run create-story to draft a new story, run validate-create-story for a quality check, provide a specific story file path, or review the current sprint status.

When does the dev story workflow halt instead of completing?

It halts when the story file is inaccessible, requirements are ambiguous, new dependencies beyond the spec are needed, three consecutive implementation failures occur, required configuration is missing, or definition-of-done validation fails.