From aiwf-extensions
Closes an aiwf milestone — verifies all ACs met, runs scoped doc-lint, finalizes the tracking doc, promotes status to done, prepares the wrap commit. Use when the user says "wrap M-NNN" or "finish the cache milestone" and self-review per `aiwfx-start-milestone` has passed. Commit and push require explicit human approval.
How this skill is triggered — by the user, by Claude, or both
Slash command
/aiwf-extensions:aiwfx-wrap-milestoneThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Closes a milestone. Verifies completeness, reconciles the tracking doc, promotes the milestone to `done`, prepares the single wrap commit.
Closes a milestone. Verifies completeness, reconciles the tracking doc, promotes the milestone to done, prepares the single wrap commit.
The milestone's implementation is complete and self-reviewed (aiwfx-start-milestone step 6 ran clean). The user says: "wrap M-NNN", "finish M-007", "close out the cache milestone".
If the milestone isn't actually done — failing tests, unmet ACs, broken build — stop and report. Don't paper over.
If anything is red, stop and report. Wrap does not paper over failure.
TODO / FIXME left behind. If they're intentional, document them in the tracking doc's ## Reviewer notes section. If they're unintentional, fix or open as gaps (aiwf add gap --title "..." --discovered-in M-NNN).Invoke wf-doc-lint against the milestone's change-set (every file the milestone branch touched since diverging from its base). Append the report to the tracking doc's ## Doc findings section.
If the report is clean, note "doc-lint: clean" and continue. If findings:
## Reviewer notes for the reviewer to consider; don't block wrap.wf-doc-lint reports only — it does not rewrite prose. Any prose changes happen here as deliberate edits.
**Completed:** <today>.
**Commits:** <SHA list> — every commit on the milestone branch.
## Acceptance criteria — every AC checked.
## Work log — final entry per AC; one-line outcomes with commit SHAs.
## Validation — paste the test-suite and build results.
## Deferrals — list any work this milestone deliberately punted; for each, open a gap entity so it survives:
aiwf add gap --title "<deferred-work>" --discovered-in M-NNN
Then mirror the resulting G-NNN id under ## Deferrals.
## Decisions made during implementation — confirm every mid-flight decision is captured (each should already have an ADR-NNNN or D-NNN from aiwfx-record-decision invocations during work).
aiwf promote M-NNN done
aiwf validates in_progress → done, rewrites frontmatter, commits with aiwf-verb: promote trailers. The promote commit is separate from the implementation commits — it captures the moment of closure.
aiwf render roadmap --write
The roadmap reflects the milestone's new status without hand-edits.
git add work/tracking/M-NNN-<slug>.md
git status
git diff --staged --stat
Draft a conventional commit message: feat(<scope>): <one-line summary> (M-NNN).
Show the user:
git diff --staged --statStop and wait for explicit "commit" approval.
git commit -m "<approved-message>"
Confirm with the user before pushing. Then:
git push -u origin milestone/M-NNN-<slug>
Open the PR if the project's flow is PR-driven. Reference the milestone id in the PR title.
--no-ff to preserve the milestone shape).aiwf render roadmap --write once more if the merge introduced any state aiwf would notice.Append to work/agent-history/builder.md (or whichever agent drove the work):
Keep entries concise (2–5 lines each). If the file exceeds ~200 lines, summarize older entries.
aiwfx-start-milestone's self-review.aiwf cancel M-NNN). Don't wrap broken work as done.wf-patch.If this is the last milestone in the epic: → aiwfx-wrap-epic E-NN.
Otherwise: → aiwfx-start-milestone <next-M>.
npx claudepluginhub 23min/ai-workflow-rituals --plugin aiwf-extensionsProvides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.