finalise
Status lifecycle: see
references/document-status-lifecycle.md
Finalise Story/Task
Overview
Mark a story or task as complete by verifying it against a comprehensive Definition of Done (DoD) checklist. This skill automates the verification of acceptance criteria, unit tests, code reviews, documentation updates, security reviews, and compliance checks. A bug report is finalised in bug mode (/finalise --bug <bug-file>): the same DoD run as a fix-evidence check, with the story/task-shaped steps skipped by a list stated once — see § "Document kind — story, task, or bug" below.
Parallel DoD Verification Approach: This skill dispatches four read-only Explore subagents in a single parallel message to perform DoD checks (AC traceability, security, compliance, docs/changelog). Each agent returns a structured YAML result. Main context writes the DoD running summary in one consolidated pass per section after aggregation — not per individual check. This gives:
- ~3–4× wall-clock speedup vs serial verification
- ≥80% reduction in DoD-summary file writes (≤6 writes vs ~25 baseline)
- Partial-failure isolation: one failed agent marks that section for manual review; others continue
- Complete audit trail: each section write contains full evidence citations from the agent YAML
Based on the verification results, it either marks the story/task as "Accepted" with generated artifacts, or lists specific gaps that need to be addressed.