Skip to content

cedricfarinazzo/agile-sprint-close

v1.7.1MIT

Close a sprint with debt review, closeout, QA validation, and retrospective workflows.

agile-sprint-close

Close plugin — ends the sprint cleanly: housekeeping, a global engineering+product gate, post-merge QA sign-off, and the retrospective that feeds the next iteration. Uses the gh CLI + git and Confluence + Jira.

Part of agile-skills. Needs gh + the Atlassian MCP.

Install

/plugin marketplace add cedricfarinazzo/agile-skills
/plugin install agile-sprint-close@agile-skills
/reload-plugins

Skills (run in this order)

#SkillRoleTrigger
12agile-12-tech-debt-sweeppre-closeout housekeeping — audit cross-repo leakage, useless CI, prebuild-image wins, CLAUDE.md/SKILL.md cruft, misplaced artifacts. Report before apply"tech debt sweep", "cleanup sweep", "housekeeping"
13agile-13-sprint-closeoutmandatory epic-level gate, 3 lenses (below)"sprint closeout", "close sprint", "/sprint-closeout"
14agile-14-qa-validationQA, confirm-after-merge (below)"validate the story", "QA check", "confirm ACs"
15agile-15-retrosprint retro in Confluence + Roadmap update (index, child page, and the published Roadmap Artifact — now carrying real delivered-vs-committed numbers); feeds the next iteration"run retro", "sprint retrospective", "what did we learn"

Codex: install with codex plugin add agile-sprint-close@agile-skills and invoke a user-facing skill as $<skill-name>. Artifact publication is optional; record its absence and keep Confluence as the complete result. See the compatibility guide.

Sprint closeout — the third review layer

agile-13-sprint-closeout is a global, impartial review of the whole wired-together sprint against its goal — distinct from the per-PR reviews (author self-review + independent merge review, which already happened). Three lenses:

  1. Engineer — does the system actually work on a freshly rebuilt dev stack? (smoke + integration)
  2. Architect / PM — does delivered code match the documented intent (Vision/PRD/ADR/Roadmap/epic ACs)?
  3. Tech Lead — does it hold up under an impartial deep review of all sprint diffs?

Phase 6.5 audits the merge train's Jira links with a bundled stdlib script (skills/agile-13-sprint-closeout/scripts/audit_merge_train_links.py; tests beside it, python3 -m pytest that dir).

A single Critical from any lens blocks closeout. It publishes a report to the Closeouts Confluence folder (sibling of Retrospectives), which the retro reads. Catches the "every AC green in isolation, but the wired system is broken" class of bug.

QA — confirm-after-merge only

By the time agile-14-qa-validation runs, the Story is already Done (merged via the merge train, which owns the Done transition). QA confirms the ACs hold on main and stamps a sign-off comment — it never transitions the Story. A post-merge regression is filed as a new Bug (linked is caused by, Story labelled qa-regression), never a reopen — reversing a Done story would lose the merge audit trail.

Retro → next iteration

agile-15-retro writes the retro page in the Retrospectives folder, reads the closeout report, marks the iteration ✅ Complete in the Roadmap index + child page, and hands its outputs (velocity, feedback, debt, actions) to agile-5-roadmap (ITERATION mode) to plan the next iteration.

Confluence layout

Retrospectives and Closeouts are sibling folders under the project root — never nested. See the canonical folder tree.

Where it fits

After agile-merge-review; loops back to agile-planning (roadmap iteration). See the full cycle.