What problem does it solve? Closing a long-running epic in an aiwf-tracked project involves many error-prone steps: verifying every milestone is done, harvesting decisions into ADRs, updating the changelog, promoting the epic status, and merging the integration branch with correct provenance trailers. Doing this by hand risks untrailered merge commits, stale changelogs, ended authorization scopes, and unvalidated merges reaching mainline. ## Core Features & Use Cases - Precondition verification: Confirms all milestones are done, the working tree is clean, the local CI gate is green after reconciling with mainline, and no claimed-closed gaps remain open. - Wrap artefact scaffolding: Creates wrap.md capturing delivered milestones, a changelog entry composed from milestone release notes, ratified ADRs, decisions, and follow-up gaps. - Declared-sequence gate: Executes the terminal local sequence (wrap-artefact commit, promote-to-done, roadmap regen, trailered merge) under one explicit human approval gate, with push and branch deletions as separate gates. - Use Case: After the final milestone of epic E-0012 merges, ask the assistant to wrap the epic; it verifies preconditions, drafts the wrap artefact and changelog entry, runs a scoped doc-lint, and drives the gated commit-and-merge sequence. ## Quick Start Ask the assistant to wrap epic E-NNNN once every milestone in it shows status done, and approve the declared sequence of commits it presents.
