cleanup-branch

Invoke /cleanup-branch on the feature branch to regroup its commits into fewer logically grouped conventional commits. It creates a backup branch first, rewrites history locally, and verifies the resulting tree is byte-for-byte identical to the original.

This Skill regroups commits rather than squashing to one, preserving logical separation while keeping the final tree identical. It uses the merge-base with the trunk as the regroup base and verifies the tree after rewriting.

No, it is strictly local and never pushes, fetches, rebases, or merges. If the branch has an upstream, the user must run git push --force-with-lease themselves, since a hook blocks the agent from force pushing.

It refuses when the current branch is the trunk, the working tree is dirty, or the branch has one commit or fewer above the merge-base. Commit or stash changes and switch to a feature branch before retrying.

The procedure restores the branch from the backup, leaving it unchanged. If the closing project gate is red due to pre-existing failures, the rewritten history is kept, the backup is retained, and the failures are reported without being fixed.