aiwfx-wrap-milestone

Closes an aiwf milestone by verifying ACs, running reviews, and preparing the wrap commit.

Updated May 9, 2026
One-click install
npx skills add https://github.com/23min/aiwf --skill aiwfx-wrap-milestone-23min
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aiwfx-wrap-milestone
Source: https://github.com/23min/aiwf/tree/main/internal/skills/embedded-rituals/plugins/aiwf-extensions/skills/aiwfx-wrap-milestone
Command: npx skills add https://github.com/23min/aiwf --skill aiwfx-wrap-milestone-23min

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Closing a milestone in an aiwf-tracked project involves many error-prone steps: verifying every acceptance criterion is met, running independent code and design reviews, finalizing the milestone spec's wrap-side sections, promoting status to done, and producing correctly trailered git commits. This Skill orchestrates that entire closure ritual so nothing is skipped and no inconsistent state reaches the remote. ## Core Features & Use Cases - Completion verification: Walks every AC in the milestone spec, runs aiwf check, the full test suite, build, and lint gate, and stops if anything is red. - Independent two-lens review: Dispatches fresh-context reviewers for code quality (wf-review-code) and design quality (wf-rethink) over the milestone's full change-set, with corrective commits for blocking findings. - Spec finalization and gated commit: Fills in Release note, Validation, Deferrals, and Reviewer notes sections, regenerates the roadmap, and prepares a trailered wrap commit that requires explicit human approval before commit and push. - Use Case: After finishing implementation of milestone M-0007, tell the assistant to wrap it; the Skill verifies all gates, runs the review loop, closes any gaps the milestone fixed, promotes the milestone to done, and merges the milestone branch into the epic branch with proper aiwf trailers. ## Quick Start Ask the assistant to wrap milestone M-NNNN once its implementation is complete and the readiness check from aiwfx-start-milestone has passed.

Frequently Asked Questions about aiwfx-wrap-milestone

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

FAQPage Schema
How do I close a milestone in an aiwf project?

Invoke the wrap ritual by saying "wrap M-NNNN" after the milestone's readiness check has passed. The Skill verifies all ACs are terminal, runs tests, build, and lint, performs an independent review, finalizes the spec, and prepares the wrap commit for your approval.

What happens if tests or lint fail during milestone wrap?

The wrap stops immediately and reports the failure. The Skill does not paper over red gates; you must fix the failing tests, build errors, or lint findings before the wrap can proceed.

Does the milestone wrap commit and push automatically?

No. Commit, push, and the terminal close sequence are each separate explicit human approval gates. The Skill shows the staged diff, proposed commit message, and a summary, then waits for your explicit approval before proceeding.

Why does the wrap require an independent code review?

The review gates milestone closure with a fresh-context reviewer having no authorship attachment, covering both code quality and design quality lenses. Blocking findings become corrective commits on the milestone branch before any AC flips to met.

What git trailers does the wrap commit need?

The wrap commit carries three exact trailers: aiwf-verb: wrap-milestone, aiwf-entity: M-NNNN, and aiwf-actor: human/<id>. Missing or mis-cased trailers trip the kernel's provenance and trailer-keys findings.