story-done

Verifies completed stories' acceptance criteria, design consistency, and prepares completion reports.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill closes the loop between design and implementation by verifying that a completed story actually meets its acceptance criteria, conforms to GDD/ADR constraints, and has required test evidence and code review before marking it complete and updating sprint state.

Core Features & Use Cases

  • Acceptance Criteria Verification: Automates file, test, and grep checks and batches manual confirmation questions for subjective or unautomatable criteria.
  • Design & ADR Consistency: Cross-references TR registry entries, GDD sections, ADR decisions, and control manifest versions to surface deviations.
  • Gating & Collaboration: Spawns QA and lead-programmer review gates in full mode, prepares completion notes, updates story status and session state, and recommends the next ready story.
  • Use Case: Run at the end of implementing a Logic or Integration story to produce a traceability table, flag blocking gaps, prompt code review, and safely mark the story as Complete after user approval.

Quick Start

Run the skill on the current story to verify acceptance criteria, gather evidence, and propose marking the story Complete.

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 closing a story?

To verify acceptance criteria before closing a story, the skill locates the story file, runs automated file and test checks, and batches manual confirmation questions for subjective criteria. It then gathers evidence to ensure all story requirements are met before marking the story complete.

What is design adherence checking in story completion?

Design adherence checking cross-references the TR registry, GDD sections, ADR decisions, and control manifest versions against the implemented story. This surfaces any deviations from the intended architecture or design constraints before the story is marked complete.

How do I ensure code review and QA gates pass before updating sprint state?

To ensure code review and QA gates pass before updating sprint state, the skill spawns QA and lead-programmer review tasks in full mode. It prepares completion notes and safely updates the session state only after receiving user approval.

Does story verification work with ADR and GDD traceability?

Yes, story verification works with ADR and GDD traceability by cross-referencing these design documents during the review process. It generates a traceability table that flags blocking gaps between the implementation and the documented architectural decisions.

What do I need to set up to run automated story completion checks?

To run automated story completion checks, you need read and write access to the repository's story markdown files, tests, TR registry, and control manifest. The environment must also allow spawning QA and code-review tasks to validate the implementation fully.