story-done

Validate acceptance criteria and update story status to complete.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/WindXRan/y3td --skill story-done-windxran
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-done
Source: https://github.com/WindXRan/y3td/tree/main/.claude/skills/story-done
Command: npx skills add https://github.com/WindXRan/y3td --skill story-done-windxran

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents stories from being marked complete without confirming that every acceptance criterion matches the implemented code, and ensures design drift (GDD/ADR deviations) is explicitly recorded instead of going unnoticed.

Core Features & Use Cases

  • Acceptance Criteria Verification: Checks for required files, test pass evidence, hardcoded values/strings, dependencies, and runs scripted checks where possible.
  • Traceability & Coverage Gate: Builds a criterion-to-test traceability table and escalates when coverage is insufficient for the selected review mode and story type.
  • Deviation & Review Enforcement: Detects GDD/manifest staleness/ADR constraints and prompts for lead programmer code review when applicable, then produces a structured completion report and updates story status.

Quick Start

Use story-done to complete the currently active story in lean mode by running: story-done.

Frequently Asked Questions about story-done

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

FAQPage Schema
How do I verify acceptance criteria before marking a story complete?

To verify acceptance criteria before story completion, validate each criterion against the current implementation by reading story files, running test evidence checks, and performing grep/glob validations to confirm required files and logic exist.

What is traceability and coverage gating in sprint workflow verification?

Traceability and coverage gating in sprint workflows builds a criterion-to-test table, ensuring test evidence sufficiently covers the story type, and escalates review when coverage is insufficient for the selected review mode.

How do I detect design drift and ADR deviations during code review?

Detect design drift and ADR deviations during code review by checking GDD and manifest staleness against implementation constraints, explicitly recording any architectural deviations instead of letting them go unnoticed before completion.

Can I use story completion verification in solo or lean sprint modes?

Yes, story completion verification works in solo and lean sprint modes by running automated evidence checks and scripted validations, bypassing the QA and lead programmer code review gates required in standard team workflows.

What happens after a story passes spec verification and updates to complete?

After a story passes spec verification and updates to complete status, the workflow surfaces the next ready story from the backlog, allowing immediate transition to subsequent sprint tasks without manual backlog triage.

Why does story completion fail when hardcoded values bypass acceptance criteria?

Story completion fails when hardcoded values or strings bypass acceptance criteria because the verification process checks for required files, dependencies, and test pass evidence, catching hardcoded implementations that violate spec constraints.