story-completion-ceremony

---
name: story-completion-ceremony
description: "Complete story validation ceremony before marking done: verify acceptance criteria, run tests, check coverage, get code review, and call bmad_workflow:complete_story. Use when completing implementation stories. Agent Behavior category skill."
metadata:
  category: Agent Behavior
  priority: high
  is-built-in: true
  session-guardian-id: builtin_story_completion_ceremony
---

# Story Completion Ceremony

Before marking any story as complete, follow this validation ceremony to ensure the work is truly done and meets quality standards.

## The 7-Step Ceremony

### 1. Verify All Acceptance Criteria
- Review each acceptance criterion in the story
- Confirm implementation addresses every requirement
- Mark each criterion as verified in the implementation artifact

### 2. Write Unit Tests (Target ≥80% Coverage)
- Create tests for all new code paths
- Follow Arrange-Act-Assert pattern (see: arrange-act-assert skill)
- Test both happy paths and error scenarios
- Use descriptive test names (see: descriptive-test-names skill)

### 3. Pass All Tests Locally
- Run the full test suite: `npm run test`
- Verify no regressions in existing tests
- Ensure all new tests pass

### 4. Test Edge Cases & Error Scenarios
- Test boundary conditions (empty arrays, null values, max limits)
- Verify error handling paths
- Test failure modes and recovery

### 5. Get Code Review Approval
- For team projects: request review from a teammate
- For solo projects: self-review against code quality standards
- Address any feedback before proceeding

### 6. Update Sprint Status
- Mark story as `done` in sprint-status.yaml
- Update epic status if all stories complete

### 7. Call bmad_workflow:complete_story
Provide validation evidence to complete the story:
```typescript
bmad_workflow({
  action: 'complete_story',
  storyId: 'your-story-id',
  validationEvidence: {
    testsPassed: 25,
    testsFailed: 0,
    coveragePercent: 85,
    codeReviewApproved: true,
    notes: 'All acceptance criteria verified'
  }
})

bmad_workflow({
  action: 'suggest_next',
  epicId: 'epic-19',
  currentStoryId: 'your-completed-story-id',
});

// Complete validation evidence for a code story
const evidence: StoryValidationEvidence = {
  testsPassed: 38, // Number of tests that passed
  testsFailed: 0, // Must be 0 to pass validation
  coveragePercent: 87, // Must be ≥80%
  codeReviewApproved: true, // Confirmed review (self or peer)
  isDocumentationOnly: false, // Set true for doc-only stories
  notes: 'Added 13 new tests for suggest_next enhancement',
};

// Documentation story evidence
const docEvidence: StoryValidationEvidence = {
  codeReviewApproved: true,
  isDocumentationOnly: true,
  notes: 'Created story-completion-ceremony skill',
};