story-done

Validate acceptance criteria, surface DoD and ADR deviations, and update story status to Complete.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It streamlines the end-to-end process of closing stories by validating acceptance criteria, surfacing DoD and ADR deviations, prompting necessary code reviews, and updating status to Complete with a transparent completion log.

Core Features & Use Cases

  • Validate every Acceptance Criteria against implementation and document deviations.
  • Update the story status to Complete and surface the next ready story from the sprint.
  • Orchestrate Phase-driven QA, code reviews, and completion notes to ensure traceability.

Quick Start

Run the story-done workflow on a finished story and follow the prompts to finalize status and log completion notes.

Frequently Asked Questions about story-done

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

FAQPage Schema
How do I validate acceptance criteria before closing an agile story?

Validating acceptance criteria before closing an agile story involves checking the implementation against defined requirements and surfacing any deviations. Automating this story closure process ensures traceability, prompts necessary code reviews, and confirms QA readiness before updating the story status to Complete.

What is the best way to ensure traceability during sprint story closure?

The best way to ensure traceability during sprint story closure is to orchestrate phase-driven QA, code reviews, and completion logging. This validates acceptance criteria, surfaces architecture decision record deviations, and generates a transparent completion report for consistent handoffs.

How do I automate code review prompts and QA readiness for finished user stories?

Automating code review prompts and QA readiness requires running an end-to-end story closure workflow. This process validates acceptance criteria, documents any deviations from the Definition of Done, updates the story to Complete, and surfaces the next ready story from the sprint backlog.

Can I automatically surface the next ready story after updating a story to Complete?

Yes, you can automatically surface the next ready story after updating a story to Complete by using an automated closure workflow. It finalizes the current story status, logs completion notes, and immediately identifies the next actionable item for the sprint.

Why do I need to document DoD and ADR deviations when completing a story?

Documenting DoD and ADR deviations when completing a story is necessary to maintain transparent handoffs and traceability across agile phases. Surfacing these deviations during story closure validates QA readiness and provides a clear completion log for future reference.

Does automated story closure work for agile teams checking Definition of Done compliance?

Yes, automated story closure works for agile teams checking Definition of Done compliance by validating acceptance criteria and surfacing any DoD deviations. It orchestrates phase-driven QA and code reviews to ensure consistent handoffs before updating the story status to Complete.