From aiwf-extensions
Closes an aiwf epic — verifies all milestones done, scaffolds a wrap artefact, harvests ADR candidates, runs scoped doc-lint, merges the epic branch into mainline, promotes the epic to done. Use when the user says "wrap E-NN" or "close the auth epic" and every milestone in the epic is wrapped. 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-epicThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Closes an epic. The epic itself is a coordination unit — closing it means: every milestone is `done`, the integration branch merges to mainline, the wrap artefact captures what shipped and what didn't, and the epic's status flips to `done`.
Closes an epic. The epic itself is a coordination unit — closing it means: every milestone is done, the integration branch merges to mainline, the wrap artefact captures what shipped and what didn't, and the epic's status flips to done.
aiwfx-release. This skill ends the planning unit.tig / gitk keep labelling history); origin branches for completed milestones are deleted to reduce remote refname clutter.status: done. Run aiwf check and verify; if any are still in_progress or draft, stop and surface them.main).If any precondition fails, stop and report. Do not improvise around an unfinished epic.
Create work/epics/E-NN-<slug>/wrap.md (staged, not yet committed):
# Epic wrap — E-NN
**Date:** <today>
**Closed by:** <actor>
**Integration target:** main
**Epic branch:** epic/E-NN-<slug>
**Merge commit:** <SHA — filled at step 5>
## Milestones delivered
- M-NNN — <title> (merged <short-sha>)
- M-NNN — <title> (merged <short-sha>)
## Summary
Two to four sentences on what shipped and why. Reference the goal from the epic spec; honest about what scope shifted mid-flight.
## ADRs ratified
- ADR-NNNN — <slug> (or "none")
## Decisions captured
- D-NNN — <slug> (or "none")
## Follow-ups carried forward
- G-NNN — <slug> (gap that survives the epic)
## Handoff
What is ready for the next epic; what is deliberately left open.
Use reference-phrasing for any list-derived count ("every ADR listed in ADRs ratified" rather than "all 4 ADRs"). Avoids drift.
Walk the epic's commits. For each candidate decision, ask: "Would a future reader regret missing the reasoning?" Signals an ADR is warranted:
For each candidate, invoke aiwfx-record-decision and choose ADR (architectural, durable) or D-NNN (project-scoped, more local). Record the resulting ids in the wrap artefact's ## ADRs ratified or ## Decisions captured section.
Invoke wf-doc-lint against the epic's change-set (every file touched on epic/E-NN-<slug> since it diverged from the integration target).
Append the report to wrap.md under a ## Doc findings section. If findings include broken references or removed-feature docs, fix or open as gaps before proceeding. wf-doc-lint reports only — prose fixes are deliberate edits here.
doneaiwf promote E-NN done
aiwf validates active → done, rewrites frontmatter, commits with aiwf-verb: promote. (If the epic is still proposed, that means no milestone ever started — wrap doesn't apply. Investigate.)
Add completed: <YYYY-MM-DD> to the epic spec frontmatter as a separate edit (the date stamp is yours; aiwf owns status:).
Confirm with the user. Then:
git checkout main
git pull --ff-only origin main
git merge --no-ff epic/E-NN-<slug>
--no-ff preserves the epic as a single merge commit; full history is recoverable via git log <merge-sha>^2. Record the merge SHA in wrap.md.
Do not push yet.
git add work/epics/E-NN-<slug>/wrap.md
git add work/epics/E-NN-<slug>/epic.md # for the `completed:` date
git status
Show the user:
git diff --staged.chore(E-NN): wrap epic — <one-line summary>.Stop and wait for "commit" approval.
git commit -m "<approved-message>"
Confirm. Then:
git push origin main
Plan the deletions first. List the milestone and epic branches to delete. For each, verify it's merged:
git branch -r --merged main | grep "milestone/M-NNN"
git branch -r --merged main | grep "epic/E-NN"
If a branch isn't shown as merged, stop and report — don't force.
After explicit approval per branch (or batch approval for the full list), delete on origin only:
git push origin --delete milestone/M-NNN-<slug>
git push origin --delete epic/E-NN-<slug>
Local branches are not touched. Operators prune local branches on their own schedule.
aiwf render roadmap --write
Append to work/agent-history/<agent>.md (whoever closed the epic): patterns that worked across the epic, pitfalls, conventions established. 2–5 line entries. Roll up older history if the file exceeds ~200 lines.
done before wrap — aiwf check and aiwf history E-NN confirm.in_progress. Run aiwf check first.wf-patch.Releases, changelogs, version tags, package publishing, deployment. Those belong to aiwfx-release.
If a release follows: → aiwfx-release.
If not: → aiwfx-plan-epic for whatever's next, or stop here.
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.