close-out-story

Runs the Definition of Done checklist and closes a story after its testplan passes.

Updated May 25, 2026
One-click install
npx skills add https://github.com/DATA-AI-XYZ/Tandem --skill close-out-story-data-ai-xyz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: close-out-story
Source: https://github.com/DATA-AI-XYZ/Tandem/tree/main/skills/close-out-story
Command: npx skills add https://github.com/DATA-AI-XYZ/Tandem --skill close-out-story-data-ai-xyz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It prevents unfinished work from being marked done by enforcing a mechanical Definition of Done gate before a story's status flips to done, keeping quality evidence, decisions, and tech debt recorded in the repo instead of lost in chat. ## Core Features & Use Cases - DoD gate enforcement: Verifies acceptance criteria, passing test cases, scoped lint/type/test/build checks, ADR linkage, and backlog capture before allowing closure. - AI code review integration: Delegates diffs to a peer-review step, generates an HTML review artefact, and blocks closure on blocker-severity findings. - Project state updates: Flips story status atomically, updates MONITOR progress, removes WIP entries, regenerates dashboards, and appends a retro ledger line. - Use Case: After all test cases in a story's testplan pass, run the close-out to validate the DoD checklist, record the review outcome, and mark the story done with MONITOR updated in the same step. ## Quick Start Ask the assistant to close out the current story and run the Definition of Done check now that its testplan is fully passing.

Frequently Asked Questions about close-out-story

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

FAQPage Schema
How do I close a story after its testplan passes?

Run the close-out once every test case in the paired testplan shows PASS. It executes the Definition of Done checklist, and only if all items pass does it flip the story status to done and update MONITOR in the same step.

What does the Definition of Done checklist verify?

The DoD checklist verifies ticked acceptance criteria, passing test cases, scoped lint, type check, unit tests and build, an AI code review with zero blocker findings, linked ADRs, and captured tech debt as backlog entries.

What happens if a DoD item fails during close-out?

The close-out stops immediately without flipping the status to done. It shows the DoD result table, lists each gap with the smallest proposed fix, and asks the user before continuing.

When is the AI code review required before closing a story?

The review always runs if the story ships test code or the diff exceeds 50 net lines across more than two files. It is skipped only for typo fixes, copy edits, or pure frontmatter changes, and any blocker-severity finding prevents closure.

Does closing a story automatically commit the changes?

No, the close-out never auto-commits. It reports the uncommitted file count from git status, notes that done means verified on disk rather than committed, and asks whether to commit only on explicit user request.