# Ae Sdd Finish

> Close a change set and sync its specs to canonical

- Skill: `shanepadgett/ae-sdd-finish` (Agent Skill)
- Install (CLI): `npx skillmds@latest add shanepadgett/ae-sdd-finish`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shanepadgett/ae-sdd-finish/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: shanepadgett (https://skillmd.com/u/shanepadgett)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/shanepadgett/ae-sdd-finish

---


### Required Skills (Must Load)

- `spec-driven-development` (state management, completion workflow)

# Finish Change Set

Close the change set and sync specs to canonical.

## Inputs

> [!IMPORTANT]
> Resolve the change set by running `ls changes/ | grep -v archive/`. If exactly one directory exists, use it. Only prompt the user when multiple change sets are present.

## Instructions

1. **Verify prerequisites**: Load `spec-driven-development` skill and read state. Confirm phase is `reconcile` and status is `complete` per skill guidelines.

2. **Sync specs**: Use the CLI merge command:
   - Inspect canonical spec inventory first with `ae sdd spec list` (no flag by default)
   - Run a dry run preview first: `ae sdd spec merge --dry-run [<change-name>] [--specs-dir <dir>]`
   - Present dry run results (created/modified/skipped) and any blockers
   - Wait for user approval
   - Apply merge: `ae sdd spec merge [<change-name>] [--specs-dir <dir>]`

3. **Update state**: Mark phase and status as complete per skill guidelines.

4. **Cleanup** (separate approval):
   - Keep artifacts intact
   - Archive to `changes/archive/<name>/`
   - Delete `changes/<name>/` (specs synced)

   Ask user to choose.

5. **Report**: Summarize merge results (created/modified/skipped counts), state update, and cleanup action.

## Example

```text
Verified phase=reconcile, status=complete
Dry run: merge 3 new, 2 modified specs
User approved merge
Applied: docs/specs/a.md, docs/specs/b.md, docs/specs/c.md created; docs/specs/d.md modified
State updated to complete
Archived to changes/archive/feature-x/
```

Success: change set closed, specs synced, state updated, cleanup completed per preference.